itchgrep

itchgrep.com

Temukan aset yang sempurna untuk game Anda

? Cari melalui aset gatal.io menggunakan kueri teks; Temukan apa yang Anda butuhkan tanpa hanya mengandalkan tag.

Kunjungi itchgrep.com untuk mulai menjelajah.

? Bergabunglah dengan komunitas kami

Kami memiliki? Perselisihan! Ini adalah tempat untuk berbagi, belajar, dan berbicara tentang pengembangan game dan proyek yang kami sukai. Jangan ragu untuk bergabung dengan kami!

? Dukung Itchgrep

Dukungan Anda memicu hasrat kami dan membantu menjaga server tetap berjalan! Jika Anda menghargai apa yang kami lakukan dan ingin berkontribusi dalam perjalanan kami, pertimbangkan:

• ? Membelikan saya kopi! Kemurahan hati Anda sangat dihargai, dan setiap cangkir memungkinkan saya untuk terus mengerjakan hal -hal keren.

? TechStack

• Pergi
• Templ
• BLEVE
• Htmx
• Google Cloud
• Buruh pelabuhan

Alat dan teknologi ini dipilih dengan hati -hati untuk memberikan pengalaman yang mulus dan efisien bagi pengembang dan pengguna itchgrep.

? Arsitektur

Berjalan secara lokal

Jika Anda ingin berkontribusi, atau hanya menjalankan proyek secara lokal untuk Anda gunakan sendiri, ikuti instruksi di bawah ini.

Proyek ini dibangun dan dipelihara di Linux. Meskipun saya tidak berpikir itu umumnya tidak mungkin dijalankan di Windows, tetapi TaskFile ditulis menggunakan perintah Linux.

Ketergantungan alat

• Golang
• Tugas
• Buruh pelabuhan
• GCloud

Berlari

Proyek ini dibagi menjadi dua layanan:

• dataservice , bertanggung jawab untuk mengambil daftar aset dari gatal.io
• webserver , menyajikan data yang disimpan dengan alat pencarian.

Gunakan TaskFile yang disertakan untuk menjalankan layanan ini.

• task local-dataservice akan meluncurkan dataservice dengan instance GCS lokal. Kirim Permintaan GET ke Titik Akhir Pemicu: curl -X GET "localhost:8080/trigger-fetch" . Ini akan menyebabkan layanan mengikis data dari gatal.io, mengindeks dan menyimpan data dan indeks pada GC lokal.

• !! Cara menjalankan yang dijelaskan di atas saat ini tidak berfungsi dengan baik, saya mencari bantuan untuk ini. Silakan lihat masalah #1. Sementara itu, gunakan task local-dataservice-temp-fix . Ini menjalankan dataservice tanpa Docker.
• task local-webserver akan membangun dan menjalankan server web dalam wadah Docker bersama dengan GC lokal dalam wadah terpisah. Templ template tidak disalin selama build, tetapi dihasilkan di dalam wadah.
• task templ akan menghasilkan file .go dari file .templ apa pun. Ini tidak diperlukan untuk membangun/menjalankan, tetapi untuk memberikan penyelesaian kode dan menghentikan server bahasa dari mengeluh.

Menyebarkan di awan

Proyek ini dibuat dengan maksud hosting dataservice dan webserver di Google Cloud Run. Data aset dimaksudkan untuk disimpan di Google Cloud Store.

Google Cloud Run dapat diganti dengan platform tanpa server, dan Google Cloud Store dapat diganti dengan toko objek apa pun, tetapi beberapa pekerjaan akan diperlukan jika ini adalah tujuan Anda, dan instruksi berikut akan mengasumsikan Google Cloud Services.

Untuk menggunakan proyek di Google Cloud, ikuti langkah -langkah di bawah ini.

Menyiapkan gcloud

Beberapa langkah persiapan:

• Pastikan, Anda telah menyiapkan proyek di google cloud console Anda.
• Dalam proyek Anda, buat toko objek dengan nama itchgrep-data . (Anda juga dapat menggunakan nama lain di sini, tetapi Anda kemudian harus mengubah const dalam file internal/storage/storage.go .
• Dalam proyek Anda, buat akun layanan baru, dan berikan peran Cloud Run Invoker . Kemudian, kami akan melampirkan akun layanan ini ke pekerjaan penjadwal, untuk secara teratur memicu menjalankan layanan data.
• Pastikan Anda telah menginstal GCLOUD CLI.
• Anda dapat menggunakan task gcloud-setup untuk mengkonfigurasi gcloud untuk digunakan dengan proyek ini. Jika tidak, pastikan untuk mengonfigurasi dengan benar secara manual.
• Sesuaikan semua contoh variabel PROJECT_ID , REGION dan LOCATION yang ditemukan di Taskfile agar sesuai dengan konfigurasi proyek Google Cloud Anda.

Menyebarkan layanan data dan menyiapkan pekerjaan penjadwal

• Jalankan task deploy-dataservice untuk membangun dan menggunakan DataService. Pada akhirnya Anda akan menerima URL layanan untuk layanan data yang baru digunakan.
• Sekarang, untuk membuat pekerjaan penjadwal, jalankan perintah berikut. Perhatikan bagaimana kami memberikan informasi kritis keamanan sebagai variabel lingkungan:

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

• Pada titik ini, Anda harus secara manual memaksa menjalankan pekerjaan DataService di konsol penjadwal cloud. Ini akan memastikan bahwa toko objek dihuni dengan data, sebelum kami memulai server web untuk pertama kalinya. Anda harus menunggu sekitar 5 menit setelah melakukan itu, sebelum menggunakan server web, sehingga layanan data punya waktu untuk mengambil dan menyimpan data baru.

Menyebarkan server web

Jalankan task deploy-webserver . Tidak ada pekerjaan lebih lanjut yang diperlukan.

Pengujian

Tes dapat dijalankan dengan menggunakan TaskFile yang disertakan.

• task test : Menjalankan semua tugas tes di bawah ini.
• task test-storage : Menguji paket storage , mengharuskan Docker untuk berjalan.

Berkontribusi

• Sebelum memposting permintaan tarik, silakan gunakan go fmt untuk memformat kode Anda.
• Pemula untuk open source dipersilakan. Jika Anda ingin berkontribusi, tetapi tidak memahami sesuatu, Anda dipersilakan untuk bertanya menggunakan masalah.
• Silakan posting permintaan fitur sebagai satu masalah per fitur.
• Sebelum mengerjakan kontribusi yang lebih besar, buka masalah untuk menanyakan apakah fitur yang ingin Anda terapkan akan diterima.
• Untuk mempertahankan alur kerja yang transparan, harap simpan semua wacana tentang pekerjaan di repositori ini dalam masalah GitHub, jangan pesan saya melalui saluran lain untuk membahas hal ini.