หน้าแรก>การเขียนโปรแกรมที่เกี่ยวข้อง>ซอร์สโค้ดอื่น ๆ
ดาวน์โหลด

itchgrep.com

ค้นพบสินทรัพย์ที่สมบูรณ์แบบสำหรับเกมของคุณ

- ค้นหาผ่านสินทรัพย์ itch.io โดยใช้ข้อความค้นหา ค้นหาสิ่งที่คุณต้องการโดยไม่ต้องพึ่งพาแท็กเท่านั้น

เยี่ยมชม itchgrep.com เพื่อเริ่มสำรวจ

- เข้าร่วมชุมชนของเรา

เรามี? เซิร์ฟเวอร์ Discord! เป็นสถานที่สำหรับการแบ่งปันการเรียนรู้และการพูดคุยเกี่ยวกับการพัฒนาเกมและโครงการที่เราหลงใหล อย่าลังเลที่จะเข้าร่วมกับเรา!

- สนับสนุน itchgrep

การสนับสนุนของคุณเป็นเชื้อเพลิงความหลงใหลของเราและช่วยให้เซิร์ฟเวอร์ทำงานได้! หากคุณชื่นชมสิ่งที่เราทำและต้องการมีส่วนร่วมในการเดินทางของเราให้พิจารณา:

  • - ซื้อกาแฟให้ฉัน! ความเอื้ออาทรของคุณได้รับการชื่นชมอย่างมากและทุกถ้วยทำให้ฉันสามารถทำงานกับสิ่งดีๆได้

- TechStack

  • ไป
  • คนขี้เหนียว
  • เบลฟ
  • HTMX
  • Google Cloud
  • นักเทียบท่า

เครื่องมือและเทคโนโลยีเหล่านี้ได้รับการคัดเลือกด้วยความระมัดระวังเพื่อมอบประสบการณ์ที่ราบรื่นและมีประสิทธิภาพสำหรับทั้งนักพัฒนาและผู้ใช้ ITCHGrep

- สถาปัตยกรรม

แผนภาพสถาปัตยกรรมของ itchgrep.com

ทำงานในพื้นที่

หากคุณต้องการมีส่วนร่วมหรือเพียงแค่เรียกใช้โครงการในพื้นที่สำหรับการใช้งานของคุณเองให้ทำตามคำแนะนำด้านล่าง

โครงการนี้สร้างและบำรุงรักษาบน Linux ในขณะที่ฉันไม่คิดว่าโดยทั่วไปจะเป็นไปไม่ได้ที่จะทำงานบน Windows แต่ TaskFile เขียนขึ้นโดยใช้คำสั่ง Linux

การพึ่งพาเครื่องมือ

  • กอลัน
  • งาน
  • นักเทียบท่า
  • gcloud

วิ่ง

โครงการแบ่งออกเป็นสองบริการ:

  • dataservice รับผิดชอบในการดึงรายการสินทรัพย์จาก itch.io
  • webserver นำเสนอข้อมูลที่เก็บไว้ด้วยเครื่องมือค้นหา

ใช้ TaskFile ที่รวมอยู่เพื่อเรียกใช้บริการเหล่านี้

  • task local-dataservice จะเปิด dataservice ด้วยอินสแตนซ์ท้องถิ่นของ GCS ส่ง GET ขอรับไปยังจุดสิ้นสุดทริกเกอร์: curl -X GET "localhost:8080/trigger-fetch" สิ่งนี้จะทำให้บริการขูดข้อมูลจาก itch.io ดัชนีและจัดเก็บทั้งข้อมูลและดัชนีใน GCs ท้องถิ่น
  • - วิธีการทำงานที่อธิบายไว้ข้างต้นไม่ทำงานอย่างถูกต้องฉันกำลังมองหาความช่วยเหลือในเรื่องนี้ โปรดดูปัญหา #1 ในขณะเดียวกันให้ใช้ task local-dataservice-temp-fix สิ่งนี้เรียกใช้ dataservice โดยไม่มี Docker
  • task local-webserver จะสร้างและเรียกใช้เว็บเซิร์ฟเวอร์ในคอนเทนเนอร์ Docker พร้อมกับ GCs ในท้องถิ่นในคอนเทนเนอร์แยกต่างหาก เทมเพลต Templ ไม่ได้คัดลอกระหว่างการสร้าง แต่สร้างขึ้นภายในคอนเทนเนอร์
  • task templ จะสร้างไฟล์ .go จากไฟล์ .templ ใด ๆ สิ่งนี้ไม่จำเป็นสำหรับการสร้าง/รัน แต่เพื่อให้รหัสเสร็จสมบูรณ์และหยุดเซิร์ฟเวอร์ภาษาจากการบ่น

การปรับใช้ในคลาวด์

โครงการถูกสร้างขึ้นด้วยความตั้งใจที่จะโฮสต์ทั้ง dataservice และ webserver บน Google Cloud Run ข้อมูลสินทรัพย์มีวัตถุประสงค์เพื่อเก็บไว้ใน Google Cloud Store

Google Cloud Run สามารถถูกแทนที่ด้วยแพลตฟอร์ม Serverless ใด ๆ และ Google Cloud Store สามารถถูกแทนที่ด้วย Object Store ใด ๆ แต่จะต้องมีงานบางอย่างหากนี่คือเป้าหมายของคุณและคำแนะนำต่อไปนี้จะถือว่า Google Cloud Services

ในการปรับใช้โครงการบน Google Cloud ให้ทำตามขั้นตอนด้านล่าง

การตั้งค่า gcloud

ขั้นตอนการเตรียมการสองสามขั้นตอน:

  • ตรวจสอบให้แน่ใจว่าคุณได้ตั้งค่าโครงการใน Google Cloud Console ของคุณแล้ว
  • ในโครงการของคุณสร้างร้านค้าวัตถุที่มีชื่อ itchgrep-data (คุณสามารถใช้ชื่ออื่นได้ที่นี่ แต่คุณต้องเปลี่ยน const ในไฟล์ internal/storage/storage.go ตามนั้น)
  • ในโครงการของคุณสร้างบัญชีบริการใหม่และให้บทบาทของ Cloud Run Invoker ในภายหลังเราจะแนบบัญชีบริการนี้กับงานกำหนดตารางเวลาเพื่อเรียกใช้การทำงานของ DataService เป็นประจำ
  • ตรวจสอบให้แน่ใจว่าคุณได้ติดตั้ง Gcloud CLI แล้ว
  • คุณสามารถใช้ task gcloud-setup เพื่อกำหนดค่า gcloud เพื่อใช้กับโครงการนี้ มิฉะนั้นตรวจสอบให้แน่ใจว่าได้กำหนดค่าด้วยตนเองอย่างถูกต้อง
  • ปรับอินสแตนซ์ทั้งหมดของตัวแปร PROJECT_ID REGION และ LOCATION ที่พบใน Taskfile เพื่อให้พอดีกับการกำหนดค่าโครงการ Google Cloud ของคุณ

การปรับใช้ DataService และการตั้งค่างานกำหนดตารางเวลา

  • เรียกใช้ task deploy-dataservice เพื่อสร้างและปรับใช้ DataService ในตอนท้ายคุณจะได้รับ URL บริการสำหรับ DataService ที่ปรับใช้ใหม่
  • ตอนนี้เพื่อสร้างงานกำหนดตารางเวลาให้เรียกใช้คำสั่งต่อไปนี้ สังเกตว่าเราผ่านข้อมูลที่สำคัญด้านความปลอดภัยเป็นตัวแปรสภาพแวดล้อมได้อย่างไร: 
    DATASERVICE_URL=https://dataservice-ly6n5ozylq-od.a.run.app 
SERVICE_ACCOUNT_EMAIL=cloud-run-invoker@itchgrep.iam.gserviceaccount.com 
go-task create-dataservice-scheduler-job
  • ณ จุดนี้คุณควรบังคับให้ใช้งาน DataService-Job ในคอนโซลคลาวด์ สิ่งนี้จะช่วยให้มั่นใจได้ว่า Object Store นั้นมีข้อมูลก่อนที่เราจะเริ่มเว็บเซิร์ฟเวอร์เป็นครั้งแรก คุณควรรอประมาณ 5 นาทีหลังจากทำเช่นนั้นก่อนที่จะปรับใช้เว็บเซิร์ฟเวอร์ดังนั้น DataService จึงมีเวลาดึงข้อมูลและจัดเก็บข้อมูลใหม่

การปรับใช้เว็บเซิร์ฟเวอร์

เรียกใช้ task deploy-webserver ไม่จำเป็นต้องทำงานเพิ่มเติม

การทดสอบ

การทดสอบสามารถเรียกใช้โดยใช้ TaskFile ที่รวมอยู่

  • task test : รันงานทดสอบทั้งหมดด้านล่าง
  • task test-storage : ทดสอบแพ็คเกจ storage ต้องใช้ Docker เพื่อเรียกใช้

การบริจาค

  • ก่อนโพสต์คำขอดึงโปรดใช้ go fmt เพื่อจัดรูปแบบรหัสของคุณ
  • ยินดีต้อนรับผู้เริ่มต้นโอเพ่นซอร์ส หากคุณต้องการมีส่วนร่วม แต่ไม่เข้าใจอะไรคุณยินดีที่จะถามโดยใช้ปัญหา
  • กรุณาโพสต์คำขอคุณสมบัติเป็นหนึ่งปัญหาต่อคุณสมบัติ
  • ก่อนที่จะทำงานเกี่ยวกับการบริจาคที่ใหญ่ขึ้นโปรดเปิดปัญหาเพื่อถามว่าคุณสมบัติที่คุณต้องการนำไปใช้จะได้รับการต้อนรับหรือไม่
  • เพื่อรักษาเวิร์กโฟลว์โปร่งใสโปรดเก็บวาทกรรมทั้งหมดเกี่ยวกับการทำงานในที่เก็บนี้ในปัญหา GitHub อย่าส่งข้อความถึงฉันผ่านช่องทางอื่นเพื่อหารือเกี่ยวกับเรื่องนี้
ขยาย
ข้อมูลเพิ่มเติม
แอปที่เกี่ยวข้อง
แนะนำสำหรับคุณ
ข้อมูลที่เกี่ยวข้อง ทั้งหมด