Distr는 자체 호스팅 소프트웨어를 배포하기 위한 오픈 소스 플랫폼입니다. 간단하게 시작하고 필요에 따라 확장할 수 있습니다. Distr에 가입하여 몇 분 안에 Docker Compose POC를 설정하고, 필요한 경우 Helm 및 에어갭(air-gapped) 환경을 구축할 수 있습니다. 자체 호스팅 기능을 제공하는 데 필요한 모든 도구를 갖추고 있습니다.
Distr deployment overview: status dashboard with logs across customer environments
배포 에이전트 (Deployment agents): 사전 구축된 Docker Compose, Docker Swarm, 및 Helm 에이전트를 사용하여 고객 환경에 애플리케이션을 설치하고 업데이트하며 상태, 로그 및 메트릭을 보고합니다.OCI 레지스트리 (OCI registry): Docker 이미지, Helm 차트, Zarf 패키지 및 모든 OCI 아티팩트를 배포할 수 있으며, 고객별 태그 접근 제어, 풀스루 캐싱(pull-through caching), 다운로드 분석 기능을 제공합니다.라이선싱 (Licensing): 고객별 애플리케이션 및 아티팩트 권한 부여와 함께, 애플리케이션이 Distr로 콜백할 필요 없이 오프라인에서 검증하는 서명된 JWT 라이선스 키를 제공합니다.원격 진단 (Remote diagnostics): 고객의 인프라에 접근하지 않고도 컨테이너 로그, 실시간 메트릭, 배포 상태, 알림 및 고객 주도 지원 번들을 제공합니다.고객 포털 (Customer portal): 화이트 라벨(White-labeled) 설치 지침, 아티팩트 다운로드, 자격 증명 및 고객 조직별 버전 관리를 제공합니다.에어갭 (Air-gapped): CI에서 Zarf 패키지를 빌드하고 Distr에 게시한 다음, 격리된 환경을 통해 전송하여 오프라인으로 배포할 수 있습니다.자체 호스팅 가능 (Self-hostable): Apache-2.0 라이선스 하에 Postgres 18+, 오브젝트 스토리지 및 Loki와 함께 단일 Go 바이너리를 사용합니다. 유료 플랜도 자체 호스팅이 가능합니다.- REST API 및 SDK를 통해 모든 것을 자동화할 수 있습니다.
Community Edition은 무료이며 Apache-2.0 라이선스입니다. 유료 플랜은 Distr Cloud에서 월 $80부터 시작하거나, 라이선스 키와 함께 완전한 자체 호스팅이 가능합니다. 자세한 내용은 https://distr.sh/pricing/를 참조하세요.
호스팅된 버전은 https://distr.sh/get-started/에서 확인해 보세요.
고객이 통제하는 환경으로 배포하는 것은 Helm 차트나 Compose 파일로 시작됩니다. 그리고 라이선스 키, 고객별 아티팩트 권한 부여, 모든 설치에 걸친 버전 추적, 업데이트 오케스트레이션, 그리고 SSH로 접근할 수 없는 배포를 디버깅하는 방법으로 끝납니다. Distr는 바로 그 계층이며, 현재 GovCloud 및 국방, 규제 금융, 헬스 테크, 제조, 엔터프라이즈 AI, 개발자 도구 분야에서 운영되고 있습니다.
주요 사용 사례:
- 온프레미스(On-premises), VPC 및 자체 호스팅 소프트웨어 배포
- Bring Your Own Cloud (BYOC) 자동화
- 엣지(Edge) 및 플릿(Fleet) 관리
Distr과 핵심 개념에 대한 자세한 내용은 https://distr.sh/docs/core-concepts/에서 확인하세요.
architecture-beta
group ctrl(cloud)[Distr Cloud or Your Cloud]
service distr(server)[Distr] in ctrl
...
막히거나 질문이 있거나 도움이 필요하면 언제든지 저희에게 알려주세요. 커뮤니티 포럼에 참여해 주시면 기꺼이 지원해 드리겠습니다.
Distr은 ghcr.io를 통해 Docker 이미지로 배포됩니다.
Docker Compose를 사용한 예시 배포는 deploy/docker/quickstart에서 확인하세요.
빠르게 시작하려면 다음 단계를 따르세요:
mkdir distr && cd distr && curl -fsSL https://github.com/distr-sh/distr/releases/latest/download/deploy-quickstart.tar | tar -x
# .env 파일에 필요한 변경 사항을 적용하세요
docker compose up -d
Distr은 또한 ghcr.io를 통해 배포되는 Helm 차트(Helm chart)로도 사용할 수 있습니다.
Helm Chart 소스 코드는 deploy/charts/distr에서 확인하세요.
Kubernetes에 Distr을 설치하려면 다음 명령어를 실행하기만 하면 됩니다:
helm upgrade --install --wait --namespace distr --create-namespace \
distr oci://ghcr.io/distr-sh/charts/distr \
--set postgresql.enabled=true --set rustfs.enabled=true
빠른 테스트 설정을 위해서는 값을 수정할 필요가 없습니다. 하지만 프로덕션 환경에서 Distr을 사용할 계획이라면, 사용 가능한 모든 구성 값들을 다시 검토하고 그에 맞게 조정해 주십시오. 이 값들은 reference values.yaml 파일에서 찾을 수 있습니다.
http://localhost:8080/register에서 첫 계정을 등록하세요.
전체 자체 호스팅(self-hosting) 문서는 https://distr.sh/docs/self-hosting/에 있습니다.
macOS에서 Distr 에이전트를 사용하시나요? 시작하려면 macOS 가이드를 따르세요. WSL2를 사용하는 Windows에서 Distr 에이전트를 사용하나요? 시작하려면 Windows WSL2 가이드를 따르세요.
소스 코드로부터 Distr을 빌드하려면 mise를 사용하여 필요한 모든 종속성을 설치하는 것을 권장하지만, 필수는 아닙니다.
모든 종속성 버전과 빌드 작업은 mise.toml 파일에서 찾을 수 있습니다. 예를 들면:
# Build Distr
mise run build:distr:community
# Build all docker images
...
Distr는 기존의 도구 및 워크플로우와 통합할 수 있는 여러 가지 방법을 제공합니다.
Distr는 배포(deployments), 아티팩트(artifacts), 에이전트(agents), 라이선스(licenses) 등을 프로그래밍 방식으로 관리할 수 있게 해주는 포괄적인 REST API를 제공합니다. 전체 API 레퍼런스는 https://app.distr.sh/docs에서 확인할 수 있습니다.
인증 및 사용에 대한 자세한 내용은 https://distr.sh/docs/integrations/api/를 참조하십시오.
당사의 퍼스트파티 SDK를 사용하여 애플리케이션 코드에서 Distr와 직접 상호작용할 수 있습니다. 현재 Distr SDK는 JavaScript 전용으로 제공되지만, 더 많은 언어 및 프레임워크가 로드맵에 포함되어 있습니다. 어떤 기능을 보고 싶은지 알려주세요!
JavaScript용 Distr SDK는 npmjs.org에서 설치할 수 있습니다:
npm install --save @distr-sh/distr-sdk
전체 SDK 문서는 https://distr.sh/docs/integrations/sdk/에 있습니다.
공식 Distr GitHub Action을 사용하여 CI/CD 파이프라인에서 아티팩트 버전 생성을 자동화할 수 있습니다. 이는 https://github.com/distr-sh/distr-create-version-action에서 이용 가능합니다.
설정 및 사용 지침은 https://distr.sh/docs/integrations/gh-action/을 참조하십시오.
Distr에 기여하거나 자체적인 필요에 맞게 수정하고 싶다면, 저희의 기여 가이드라인(contributing guidelines)을 확인해 보세요.
Distr는 Apache License 2.0 하에 라이선스가 부여됩니다. 호스팅 버전 및 Enterprise 플랜은 https://distr.sh/pricing/에서 확인하십시오.
