itchgrep

itchgrep.com

게임의 완벽한 자산을 발견하십시오

? 텍스트 쿼리를 사용하여 iTch.io 자산을 검색합니다. 태그에만 의존하지 않고 필요한 것을 찾으십시오.

탐색을 시작하려면 itchgrep.com을 방문하십시오.

? 우리 커뮤니티에 가입하십시오

우리는? Discord Server! 게임 개발과 우리가 열정적 인 프로젝트에 대해 공유, 학습 및 이야기하는 곳입니다. 우리와 함께하십시오!

? Itchgrep 지원

귀하의 지원은 우리의 열정에 연료를 공급하고 서버를 계속 실행하는 데 도움이됩니다! 우리가하는 일에 감사하고 여행에 기여하고 싶다면 다음과 같이 생각하십시오.

• ? 나에게 커피를 사! 당신의 관대함은 엄청나게 높이 평가되며, 모든 컵을 사용하면 멋진 물건을 계속 사용할 수 있습니다.

? Techstack

• 가다
• 템플
• 블리브
• HTMX
• 구글 클라우드
• 도커

이러한 도구와 기술은 가려운 개발자와 Itchgrep 사용자 모두에게 원활하고 효율적인 경험을 제공하기 위해 조심스럽게 선택되었습니다.

? 건축학

현지에서 실행

자신의 용도로 기여하거나 로컬로 프로젝트를 실행하려면 아래 지침을 따르십시오.

이 프로젝트는 Linux에서 구축되고 유지됩니다. Windows에서 실행하는 것은 일반적으로 불가능하다고 생각하지만 작업 파일은 Linux 명령을 사용하여 작성됩니다.

툴링 종속성

• 골랑
• 일
• 도커
• Gcloud

달리기

프로젝트는 두 가지 서비스로 나뉩니다.

• Itch.io에서 자산 목록을 가져 오는 책임있는 dataservice
• 저장된 데이터를 검색 도구로 제시하는 webserver .

포함 된 작업 파일을 사용하여 이러한 서비스를 실행하십시오.

• task local-dataservice 로컬 인스턴스의 GCS를 사용하여 dataservice 시작합니다. 트리거 엔드 포인트로 GET 요청을 보내십시오. curl -X GET "localhost:8080/trigger-fetch" . 이로 인해 서비스가 Itch.io에서 데이터를 긁어 내고 인덱싱하고 로컬 GCS에 데이터와 색인을 모두 저장하게됩니다.

• !! 위에서 설명한 실행 방식은 현재 제대로 작동하지 않으며 이에 대한 지원을 찾고 있습니다. 문제 #1을 참조하십시오. 그 동안 task local-dataservice-temp-fix 사용하십시오. 이것은 docker없이 dataservice 실행합니다.
• task local-webserver 작업은 별도의 컨테이너로 로컬 GC와 함께 Docker 컨테이너에 웹 서버를 빌드 및 실행합니다. Templ 템플릿은 빌드 중에 복사되지 않지만 컨테이너 내부에서 생성됩니다.
• task templ .templ 파일에서 .go 파일을 생성합니다. 이는 구축/실행에 필요하지 않지만 코드 완료를 제공하고 언어 서버가 불만을 제기하는 것을 중지해야합니다.

클라우드에 배포

이 프로젝트는 Google Cloud Run에서 dataservice 및 webserver 모두 호스팅하려는 의도로 작성되었습니다. 자산 데이터는 Google Cloud Store에 저장되어 있습니다.

Google Cloud Run은 모든 서버리스 플랫폼으로 교체 할 수 있으며 Google Cloud Store는 모든 객체 저장소로 교체 할 수 있지만 이것이 목표 인 경우 일부 작업이 필요하며 다음 지침은 Google Cloud 서비스를 가정합니다.

Google Cloud에 프로젝트를 배포하려면 아래 단계를 따르십시오.

gcloud 설정

몇 가지 준비 단계 :

• Google 클라우드 콘솔에서 프로젝트를 설정했는지 확인하십시오.
• 프로젝트에서 itchgrep-data 라는 이름의 객체 저장소를 만듭니다. (여기서는 다른 이름을 사용할 수 있지만 internal/storage/storage.go 파일의 const 변경해야합니다.
• 프로젝트에서 새 서비스 계정을 만들고 Cloud Run Invoker 의 역할을 제공하십시오. 나중에이 서비스 계정을 스케줄러 작업에 첨부하여 정기적으로 데이터 서비스를 실행할 것입니다.
• Gcloud CLI를 설치했는지 확인하십시오.
• task gcloud-setup 사용 하여이 프로젝트와 함께 사용할 gcloud 구성 할 수 있습니다. 그렇지 않으면 수동으로 올바르게 구성해야합니다.
• Google 클라우드 프로젝트 구성에 맞게 Taskfile 에있는 변수 PROJECT_ID , REGION 및 LOCATION 의 모든 인스턴스를 조정하십시오.

데이터 서비스를 배포하고 스케줄러 작업을 설정합니다

• 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의 실행을 수동으로 강제해야합니다. 이렇게하면 웹 서버를 처음 시작하기 전에 객체 저장소에 데이터가 채워질 수 있습니다. Webserver를 배포하기 전에 그 후 약 5 분 정도 기다려야합니다. 따라서 DataService는 새 데이터를 가져오고 저장할 시간이 있습니다.

웹 서버 배포

task deploy-webserver 실행하십시오. 더 이상의 작업이 필요하지 않습니다.

테스트

포함 된 작업 파일을 사용하여 테스트를 실행할 수 있습니다.

• task test : 아래의 모든 테스트 작업을 실행합니다.
• task test-storage : storage 패키지를 테스트하고 Docker 실행해야합니다.

기여

• 풀 요청을 게시하기 전에 go fmt 사용하여 코드를 포맷하십시오.
• 오픈 소스 초보자를 환영합니다. 기여하고 싶지만 이해하지 못하면 문제를 사용하여 물어볼 수 있습니다.
• 기능 요청을 기능 당 하나의 문제로 게시하십시오.
• 더 큰 기여를하기 전에 문제를 열어 구현하려는 기능이 환영 할 것인지 묻습니다.
• 투명한 워크 플로를 유지하려면 GitHub 문제 에서이 저장소에 대한 작업과 관련된 모든 담론을 유지하십시오. 다른 채널을 통해이를 논의하기 위해 저에게 메시지를 보내지 마십시오.