데모 저장소 포크하기

데모 저장소는 포크하여 오픈텔레메트리(OpenTelemetry) 활용 사례를 보여주는 도구로 사용할 수 있도록 설계되었다.

포크나 데모를 설정할 때는 일반적으로 일부 환경 변수를 덮어쓰고, 필요하면 일부 컨테이너 이미지를 교체하기만 하면 된다.

실행 중인 데모를 데모 README에 추가할 수 있다.

포크 메인테이너를 위한 제안

• 데모가 내보내거나 수집하는 텔레메트리 데이터를 개선하려는 경우, 변경 사항을 이 저장소에도 반영하는 것을 강력히 권장한다. 벤더나 구현체에 특화된 변경은 내부 코드를 변경하기보다 설정을 통해 파이프라인에서 텔레메트리를 수정하는 방식이 바람직하다.
• 교체하기보다는 확장한다. 기존 API와 연동하는 새로운 서비스를 추가하는 것은 텔레메트리 수정만으로 구현할 수 없는 벤더나 도구에 특화된 기능을 추가하는 좋은 방법이다.
• 확장성을 지원하려면 큐, 데이터베이스, 캐시 등의 리소스를 감싸는 리포지터리 패턴이나 파사드(facade) 패턴을 사용한다. 이렇게 하면 플랫폼에 따라 이러한 서비스의 서로 다른 구현을 연결할 수 있다.
• 벤더나 도구에 특화된 개선 사항은 이 저장소에 반영하지 않는다.

질문이 있거나 포크 메인테이너의 작업을 더 쉽게 할 수 있는 방법을 제안하려면 이슈를 등록한다.