# 데모 저장소 포크하기

Site [llms.txt](/ko/llms.txt)

---

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

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

실행 중인 데모를 데모
[README](https://github.com/open-telemetry/opentelemetry-demo/blob/main/README.md?plain=1)에
추가할 수 있다.

## 포크 메인테이너를 위한 제안 {#suggestions-for-fork-maintainers}

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

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

[demo repository]: <https://github.com/open-telemetry/opentelemetry-demo>