제품 릴리스 매니페스트
모든 제품 릴리스(Product Release)는 manifest.yml을 포함해야 합니다. 매니페스트는 제품 식별과 불변 특성을 기록하며, 릴리스를 게시한 뒤 같은 릴리스의 값을 변경하지 않습니다.
필수 최상위 필드
| 필드 | 의미 |
|---|---|
product-type | 배포물을 해석하고 배포를 관리할 제품 유형입니다. |
product-group | Maven 좌표의 그룹 ID입니다. |
product-name | Maven 좌표의 아티팩트 ID입니다. |
product-version | Maven 좌표의 버전입니다. Apollo 비교 가능 버전을 사용해야 합니다. |
다음은 서비스 제품의 식별 구조를 보여 주는 예시입니다.
product-type: service.v1
product-group: com.palantir.apollo
product-name: apollo-catalog
product-version: 1.2.3
이 예시의 유형을 Helm 제품에 그대로 사용하지 않습니다. Helm 릴리스는 CLI 초기화가 만든 매니페스트의 제품 유형과 형식 정보를 유지하고 제품 좌표와 차트 위치를 확인합니다.
확장
extensions에는 제품의 불변 특성을 추가할 수 있습니다. 예를 들어 컨테이너 이미지의 artifacts, 의존 관계의 product-dependencies, 비호환 관계의 product-incompatibilities를 넣습니다. 이미 있는 확장을 덮어쓰지 말고 같은 extensions 아래에 필요한 항목을 추가합니다.
릴리스 채널 소속이나 회수 같은 변경 가능한 운영 메타데이터와 매니페스트의 불변 선언은 구분합니다.
메타데이터에 넣지 말아야 할 정보
product-group, product-name, 컨테이너 이미지 이름과 태그, 리소스 식별자 같은 워크로드 메타데이터는 모니터링과 문제 조사를 위한 로그 및 운영 텔레메트리에서 Palantir 직원이나 환경 관리자에게 보일 수 있습니다.
비밀번호, 인증 토큰, 민감한 업무 내용이나 개인 식별 정보는 메타데이터 이름에 넣지 않습니다. 민감한 값은 Apollo 비밀정보로 관리합니다.