itchgrep

itchgrep.com

ゲームに最適な資産を発見してください

？テキストクエリを使用してitch.ioアセットを検索します。タグだけに頼らずに必要なものを見つけてください。

itchgrep.comにアクセスして、探索を開始してください。

？私たちのコミュニティに参加してください

私たちは持っていますか？ Discord Server！それは、ゲーム開発と私たちが情熱を注いでいるプロジェクトについて共有、学び、話し合う場所です。お気軽にご参加ください！

？かゆみをサポートします

あなたのサポートは私たちの情熱を促進し、サーバーを実行し続けるのに役立ちます！あなたが私たちがしていることに感謝し、私たちの旅に貢献したいなら、考えてみてください。

• ？コーヒーを買う！あなたの寛大さは非常に高く評価されており、すべてのカップにより、私はクールなものに取り組み続けることができます。

？ TechStack

• 行く
• テンプル
• ブリーブ
• htmx
• Googleクラウド
• Docker

これらのツールとテクノロジーは、Itchgrepの開発者とユーザーの両方にシームレスで効率的なエクスペリエンスを提供するように注意して選択されました。

？建築

ローカルで実行されます

貢献したい場合、または自分で使用するためにプロジェクトをローカルに実行する場合は、以下の指示に従ってください。

このプロジェクトは、Linux上に構築され、維持されています。 Windowsで実行することは一般に不可能であるとは思いませんが、TaskFileはLinuxコマンドを使用して書かれています。

ツーリングの依存関係

• ゴラン
• タスク
• Docker
• gcloud

ランニング

プロジェクトは2つのサービスに分割されます。

• itch.ioから資産のリストを取得する責任のあるdataservice
• webserver 、保存されたデータを検索ツールで提示します。

付属のタスクファイルを使用して、これらのサービスを実行します。

• task local-dataservice GCSのローカルインスタンスを使用してdataserviceを起動します。トリガーエンドポイントにGETリクエストを送信します： curl -X GET "localhost:8080/trigger-fetch" 。これにより、サービスはitch.ioからデータをスクレイプし、ITにインデックスを付け、データとインデックスの両方をローカルGCSに保存します。

• !!上記の実行方法は現在適切に機能していません。これについての支援を探しています。問題＃1を参照してください。その間task local-dataservice-temp-fixを使用します。これにより、Dockerなしでdataserviceが実行されます。
• task local-webserver DockerコンテナでWebサーバーを構築して実行し、ローカルGCSと別のコンテナで実行します。 Templテンプレートはビルド中にコピーされませんが、コンテナ内で生成されます。
• task templ 、任意の.templファイルから.goファイルを生成します。これは、構築/実行には必要ではなく、コードの完了を提供し、言語サーバーが不平を言うのを防ぐために必要です。

クラウドに展開します

このプロジェクトは、Google Cloud Runでdataserviceとwebserver両方をホストすることを目的として作成されました。資産データは、Google Cloud Storeに保存されることを目的としています。

Google Cloud Runは任意のサーバーレスプラットフォームに置き換えることができ、Google Cloud Storeは任意のオブジェクトストアに置き換えることができますが、これが目標である場合はいくつかの作業が必要になり、次の指示でGoogle Cloud Servicesが想定されます。

Google Cloudにプロジェクトを展開するには、以下の手順に従ってください。

gcloudのセットアップ

いくつかの準備ステップ：

• Google Cloudコンソールにプロジェクトを設定していることを確認してください。
• プロジェクトでは、 itchgrep-dataという名前のオブジェクトストアを作成します。 （ここで別の名前を使用することもできますが、ファイルinternal/storage/storage.goのconstを変更する必要があります。
• プロジェクトでは、新しいサービスアカウントを作成し、 Cloud Run Invokerの役割を提供します。その後、このサービスアカウントをスケジューラジョブに添付して、定期的にDataServiceの実行をトリガーします。
• Gcloud CLIをインストールしていることを確認してください。
• このプロジェクトで使用するためにgcloudを構成するには、 task gcloud-setupを使用できます。それ以外の場合は、必ず手動で設定してください。
• Google Cloudプロジェクトの構成に適合するように、 Taskfileにある変数PROJECT_ID 、 REGION 、およびLOCATIONのすべてのインスタンスを調整します。

DataServiceを展開し、スケジューラジョブを設定します

• DataServiceを構築および展開するにはtask deploy-dataserviceを実行します。最後に、新しく展開されたDataServiceのサービスURLが届きます。
• 次に、スケジューラジョブを作成するには、次のコマンドを実行します。環境変数としてセキュリティ重要な情報をどのように渡しているかに注意してください。

  DATASERVICE_URL=https://dataservice-ly6n5ozylq-od.a.run.app 
  SERVICE_ACCOUNT_EMAIL=[e-mail] 
  go-task create-dataservice-scheduler-job

• この時点で、クラウドスケジューラコンソールでDataService-Jobの実行を手動で強制する必要があります。これにより、Webサーバーを初めて開始する前に、オブジェクトストアにデータが入力されます。 WebServerを展開する前に、それを行ってから約5分後に待つ必要があります。これにより、DataServiceには新しいデータを取得して保存する時間があります。

Webサーバーの展開

task deploy-webserver実行します。それ以上の作業は必要ありません。

テスト

テストは、付属のタスクファイルを使用して実行できます。

• task test ：以下のすべてのテストタスクを実行します。
• task test-storage ： storageパッケージをテストし、 Docker実行する必要があります。

貢献

• プルリクエストを投稿する前に、 go fmtを使用してコードをフォーマットしてください。
• オープンソースへの初心者は大歓迎です。貢献したいが、何かがわからない場合は、問題を使用して尋ねることを歓迎します。
• 機能要求を機能ごとに1つの問題として投稿してください。
• より大きな貢献に取り組む前に、問題を開いて、実装したい機能が歓迎されるかどうかを尋ねてください。
• 透明なワークフローを維持するには、GitHubの問題でこのリポジトリの作業に関するすべての談話を維持してください。これについて議論するために他のチャネルを通して私にメッセージを送らないでください。