yokai

요괴

백엔드 애플리케이션을 위한 간단하고 관찰 가능한 모듈식 Go 프레임워크입니다.

• 목표
• 선적 서류 비치
• 개요
  • 건축학
  • 기초
  • 확장
• 시작하기
• 쇼룸
• 기여

목표

Go로 백엔드 애플리케이션을 구축하는 것은 놀라운 일입니다.

그러나 production-grade 애플리케이션을 구축하려면 많은 노력과 상용구 코드를 배치해야 하며 애플리케이션의 논리(예: 종속성 연결, 구성 관리, 관찰 가능성 계측 등)와 관련되지 않은 복잡성을 도입해야 합니다.

이를 해결하기 위해 Yokai는 다음과 같은 목표를 염두에 두고 만들어졌습니다.

• Simple : 사용, 구성 및 테스트가 쉬우므로 빠르게 반복하고 신속하게 유지 관리 가능한 애플리케이션을 제공할 수 있습니다.
• Modular : 사용 가능한 Yokai 모듈을 사용하거나 자체 모듈을 사용하여 확장하여 진화 가능한 애플리케이션을 구축할 수 있습니다.
• Observable : 안정적인 애플리케이션을 구축하기 위해 로깅, 추적 및 측정 도구가 내장되어 있습니다.

즉, Yokai를 사용하면 애플리케이션 로직에 집중하고 나머지는 처리할 수 있습니다.

선적 서류 비치

Yokai의 documentation https://ankorstore.github.io/yokai에서 확인할 수 있습니다.

개요

건축학

• Yokai core modules 로깅, 추적, 메트릭 및 상태 확인 계측을 미리 로드하고 인프라 및 디버깅 요구 사항에 맞게 개인 HTTP 서버를 노출합니다.
• Yokai extensions modules 추가하여 공개 HTTP/gRPC 서버, 워커, ORM 등과 같은 애플리케이션 기능을 강화할 수 있습니다. 또한 contrib 모듈이나 자체 모듈을 추가할 수도 있습니다.
• 이는 Yokai dependency injection system 에서 사용할 수 있으며 이를 기반으로 애플리케이션 논리를 구축할 수 있습니다.

기초

Yokai는 다음과 같이 robust 하고 well known Go 라이브러리를 사용하여 구축되었습니다.

• HTTP 서버용 에코
• gRPC 서버용 gRPC-go
• 구성 관리를 위한 Viper
• 관측성 계측을 위한 OTEL
• 의존성 주입 시스템을 위한 Fx
• 그리고 더.

확장

Yokai의 extension system 사용하면 다음을 통해 애플리케이션 기능을 enrich 할 수 있습니다.

• Yokai built-in 모듈
• Yokai 기여 모듈
• 나만의 모듈

시작하기

Yokai는 프로젝트를 시작하기 위해 바로 사용할 수 있는 application templates 제공합니다.

• gRPC 애플리케이션용
• HTTP 애플리케이션용
• 작업자 애플리케이션의 경우

쇼룸

Yokai는 실행 준비가 완료된 demo applications 이 포함된 쇼룸 저장소를 제공하여 실제로 작동하는 모습을 볼 수 있습니다.

• gRPC 데모 애플리케이션
• HTTP 데모 애플리케이션
• 작업자 데모 애플리케이션

기여

이 저장소는 release-please를 사용하여 Yokai의 모듈 릴리스 프로세스를 자동화합니다.

중요한

릴리스 프로세스에서는 원자성 커밋과 일반 커밋을 사용하여 릴리스할 버전을 결정하고 릴리스 노트를 생성하므로 이를 제공해야 합니다.