OCI 컨테이너 레지스트리 산업

판정 기준

ECR과 ACR의 공개 제품 문서에서 OCI 참조 검색 방식을 비교하고, ACR 고객 관리 키 구성에 서버 Referrers API가 적용되는지 확인한다.

대체 설명

서버 API가 없는 구성은 클라이언트가 참조 태그 인덱스를 사용하면 계속 동작할 수 있다. API 전용 클라이언트는 해당 구성에 맞지 않을 수 있다.

반증 조건

비교 대상 중 한 공급자가 범위 안의 특정 설정에서 서버 Referrers API를 제공하지 않고 클라이언트 참조 태그 대체 경로를 요구하면 이 가정을 기각한다.

결정을 막는 것

• 가설에 대한 반박 근거를 확인해야 합니다.
• 필요한 근거: 의존성, 영향
• 서로 다른 원천 그룹 두 곳 이상에서 필요한 역할을 뒷받침해야 합니다.
• 영향을 검증할 사전 동결 후 관측이 없습니다.

검토 기록

[Attach, push, and pull supply chain artifacts] Microsoft 문서에서 고객 관리 키(CMK)로 암호화된 레지스트리는 서버 Referrers API 지원의 예외이며, ORAS v1.2.3이 참조 태그 방식을 쓴다고 설명한다.

메커니즘과 의존성

1. 이미지에 연결된 아티팩트 검색과 호환 경로 artifact-discovery · 의존: standard-content-path
   관측 · OCI 명세는 Referrers API 조회가 404일 때 클라이언트가 태그 인덱스로 돌아가도록 규정한다.

   oci-referrers-fallback · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Listing Referrers / Backwards Compatibility] 지원 서버는 참조 검색 결과를 제공한다. 참조 조회가 404이면 클라이언트는 다이제스트에서 만든 태그의 인덱스를 사용하도록 규정한다.

   OCI Distribution Specification v1.1.1 · 공개 원문 · sources/oci-distribution.txt:L7

   관측 · AWS는 ECR이 OCI 1.1 이미지 참조 아티팩트를 저장·검색·가져올 수 있다고 발표했다.

   ecr-referrers · document

   작성자 요약 · 아래 발췌와 대조 필요

   [2024-06-27] ECR은 이미지에 연결된 서명이나 SBOM 등의 참조 아티팩트를 저장하고, 연결 관계로 검색하고, 가져올 수 있다고 발표했다.

   AWS 출시 공지: Amazon ECR의 OCI Image·Distribution 1.1 · 공개 원문 · sources/aws-oci-launch.txt:L5

   관측 · Microsoft는 ACR에서 이미지에 연결된 참조 아티팩트를 ORAS로 조회하는 사례를 제공한다.

   acr-referrers · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Discovering artifact references] Microsoft는 이미지에 연결된 아티팩트 목록을 ORAS로 조회하는 흐름을 예시로 제공한다.

   Microsoft Learn: Azure Container Registry의 OCI 아티팩트와 ORAS · 공개 원문 · sources/azure-oras.txt:L7

   관측 · Microsoft 문서에서는 CMK 암호화 구성에서 ORAS가 서버 Referrers API 대신 참조 태그를 사용한다.

   acr-cmk-exception · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Attach, push, and pull supply chain artifacts] Microsoft 문서에서 고객 관리 키(CMK)로 암호화된 레지스트리는 서버 Referrers API 지원의 예외이며, ORAS v1.2.3이 참조 태그 방식을 쓴다고 설명한다.

   Microsoft Learn: Azure Container Registry의 OCI 아티팩트와 ORAS · 공개 원문 · sources/azure-oras.txt:L6

   관측 · OCI는 참조 태그 인덱스를 여러 클라이언트가 갱신할 때 경합할 수 있다고 설명한다.

   oci-fallback-contention · document

   작성자 요약 · 아래 발췌와 대조 필요

   [2024-03-13, Referrers API] OCI는 기존 레지스트리를 위한 참조 태그 인덱스를 설명하고 여러 클라이언트가 태그를 동시에 갱신할 때 경합할 수 있다고 밝힌다.

   OCI 공식 발표: Image·Distribution 1.1 출시 · 공개 원문 · sources/oci-vone-release.txt:L6

2. OCI 매니페스트와 blob을 통한 공통 콘텐츠 배포 standard-content-path
   관측 · OCI v1.1.1 준수 레지스트리의 Pull 범주는 콘텐츠를 매니페스트와 blob으로 가져오는 공통 계약을 규정한다.

   oci-common-pull · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Conformance / Pull] 준수하는 레지스트리는 기본 Pull 범주를 구현한다. Pull은 매니페스트와 blob을 가져오며, 매니페스트는 태그나 다이제스트로 지정할 수 있다.

   OCI Distribution Specification v1.1.1 · 공개 원문 · sources/oci-distribution.txt:L5

   관측 · Pull, Push, 탐색, 관리는 별도 준수 범주다.

   oci-category-boundary · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Conformance] Push, Content Discovery, Content Management는 기본 Pull과 별도 범주다. 특정 범주 준수를 주장하면 해당 범주 전체가 필요하다.

   OCI Distribution Specification v1.1.1 · 공개 원문 · sources/oci-distribution.txt:L6

   관측 · AWS는 ECR이 OCI 1.1 이미지 참조 아티팩트를 저장·검색·가져올 수 있다고 발표했다.

   ecr-referrers · document

   작성자 요약 · 아래 발췌와 대조 필요

   [2024-06-27] ECR은 이미지에 연결된 서명이나 SBOM 등의 참조 아티팩트를 저장하고, 연결 관계로 검색하고, 가져올 수 있다고 발표했다.

   AWS 출시 공지: Amazon ECR의 OCI Image·Distribution 1.1 · 공개 원문 · sources/aws-oci-launch.txt:L5

   관측 · Microsoft는 ACR의 OCI 아티팩트 push·pull 경로를 문서화한다.

   acr-artifact-path · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Push and Pull OCI Artifacts] Microsoft는 Azure Container Registry에서 OCI 이미지와 아티팩트를 저장하고 ORAS로 OCI 아티팩트를 올리거나 받는 경로를 문서화한다.

   Microsoft Learn: Azure Container Registry의 OCI 아티팩트와 ORAS · 공개 원문 · sources/azure-oras.txt:L5

원천 제외

근거를 한 원천씩 제외했을 때 판정이 바뀌는지 확인합니다.

• azure-oras 제외 → 근거 부족

판정 기준

동일한 이미지·차트·볼륨 콘텐츠에서 OCI 공급자 변경과 비 OCI 경로 전환에 필요한 설정·도구 변경·검증 인시를 비교한다.

대체 설명

OCI 호환 게이트웨이가 객체 저장소 위에 기존 인터페이스를 제공하면 팀이 보는 전환비용은 작을 수 있다. 호스트와 인증 변경은 OCI 공급자 내부의 이전에도 발생할 수 있다.

반증 조건

사전에 고른 독립 팀의 비교에서 비 OCI 경로 전환이 클라이언트 변경 없이 이뤄지고 검증 인시와 실패율도 OCI 공급자 변경과 차이가 없다면 해자 가설을 기각한다.

결정을 막는 것

• 필요한 근거: 전환 비용
• 서로 다른 원천 그룹 두 곳 이상에서 필요한 역할을 뒷받침해야 합니다.
• 전환 비용을 검증할 사전 동결 후 관측이 없습니다.

검토 기록

[Using an OCI-based registry] Helm은 OCI 레지스트리에 차트를 저장하는 절차를 설명하고 ECR, ACR, Google Artifact Registry를 포함한 여러 대상 공급자를 예시로 든다.
[The push subcommand] Helm은 이미 패키징한 차트를 배포하며, 이름과 의미 버전으로 저장 참조가 결정된다.

[Create a chart repository] Helm은 OCI 레지스트리 없이도 HTTP 서버, 객체 저장소 등을 이용해 인덱스와 패키징한 차트를 제공하는 방식을 설명한다.

[gcloud CLI credential helper] Google Artifact Registry의 Docker 자격증명은 리포지터리 호스트 목록을 기준으로 설정된다. 공급자 변경 시 OCI 콘텐츠와 별도로 호스트·인증 설정을 고려해야 한다.

메커니즘과 의존성

1. Helm·Kubernetes의 OCI 소비 경로와 공급자별 자격증명 complementary-tools · 의존: standard-content-path
   관측 · Helm의 OCI 차트 경로는 여러 호스팅 공급자를 열거하고 공통 패키지와 명명 규칙을 사용한다.

   helm-multiple-hosts · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Using an OCI-based registry] Helm은 OCI 레지스트리에 차트를 저장하는 절차를 설명하고 ECR, ACR, Google Artifact Registry를 포함한 여러 대상 공급자를 예시로 든다.
   [The push subcommand] Helm은 이미 패키징한 차트를 배포하며, 이름과 의미 버전으로 저장 참조가 결정된다.

   Helm v3 공식 문서: OCI 기반 레지스트리 · 공개 원문 · sources/helm-oci.txt:L5-L6

   관측 · Google의 Docker 인증은 레지스트리 호스트에 따라 별도로 구성된다.

   provider-credentials · document

   작성자 요약 · 아래 발췌와 대조 필요

   [gcloud CLI credential helper] Google Artifact Registry의 Docker 자격증명은 리포지터리 호스트 목록을 기준으로 설정된다. 공급자 변경 시 OCI 콘텐츠와 별도로 호스트·인증 설정을 고려해야 한다.

   Google Artifact Registry 공식 문서: Docker 인증 · 공개 원문 · sources/google-docker-auth.txt:L5

   관측 · Kubernetes가 OCI 레지스트리를 컨테이너 실행 이미지 이외의 볼륨 콘텐츠 공급원으로 사용하는 경로를 문서화한다.

   kube-artifact-consumer · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Use an Image Volume With a Pod] Kubernetes 문서는 OCI 레지스트리의 콘텐츠를 Pod 내부에 볼륨으로 마운트하는 기능을 v1.36부터 안정으로 표시한다.

   Kubernetes v1.36 공식 문서: 이미지 볼륨 사용 · 공개 원문 · sources/kube-image-volume.txt:L5

   관측 · OCI 이미지 볼륨을 쓰려면 런타임이 해당 기능을 지원해야 한다.

   kube-runtime-limit · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Before you begin; Run a Pod that uses an image volume] 볼륨의 콘텐츠는 이미지 참조로 지정한다. 컨테이너 런타임에도 이 기능 지원이 필요하다.

   Kubernetes v1.36 공식 문서: 이미지 볼륨 사용 · 공개 원문 · sources/kube-image-volume.txt:L6

   관측 · Helm의 같은 패키지 유형에는 객체 저장소나 HTTP 서버에서 차트 인덱스와 패키지를 배포하는 대체 경로가 있다.

   helm-http-alternative · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Create a chart repository] Helm은 OCI 레지스트리 없이도 HTTP 서버, 객체 저장소 등을 이용해 인덱스와 패키징한 차트를 제공하는 방식을 설명한다.

   Helm v3 공식 문서: HTTP 차트 저장소 · 공개 원문 · sources/helm-classic.txt:L5

   관측 · 아티팩트 발행자 Cilium은 OCI 레지스트리에서 Helm 차트를 배포하는 경로와 일반 Helm 저장소 경로를 함께 문서화한다.

   cilium-oci-publishing · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Helm Installation Methods] Cilium은 Quay의 OCI 레지스트리 경로를 실제 차트 배포 선택지로 게시하고 일반 HTTP Helm 저장소 경로도 안내한다.

   Cilium 공식 설치 문서: OCI 및 일반 Helm 배포 · 공개 원문 · sources/cilium-chart.txt:L5

2. OCI 매니페스트와 blob을 통한 공통 콘텐츠 배포 standard-content-path
   관측 · OCI v1.1.1 준수 레지스트리의 Pull 범주는 콘텐츠를 매니페스트와 blob으로 가져오는 공통 계약을 규정한다.

   oci-common-pull · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Conformance / Pull] 준수하는 레지스트리는 기본 Pull 범주를 구현한다. Pull은 매니페스트와 blob을 가져오며, 매니페스트는 태그나 다이제스트로 지정할 수 있다.

   OCI Distribution Specification v1.1.1 · 공개 원문 · sources/oci-distribution.txt:L5

   관측 · Pull, Push, 탐색, 관리는 별도 준수 범주다.

   oci-category-boundary · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Conformance] Push, Content Discovery, Content Management는 기본 Pull과 별도 범주다. 특정 범주 준수를 주장하면 해당 범주 전체가 필요하다.

   OCI Distribution Specification v1.1.1 · 공개 원문 · sources/oci-distribution.txt:L6

   관측 · AWS는 ECR이 OCI 1.1 이미지 참조 아티팩트를 저장·검색·가져올 수 있다고 발표했다.

   ecr-referrers · document

   작성자 요약 · 아래 발췌와 대조 필요

   [2024-06-27] ECR은 이미지에 연결된 서명이나 SBOM 등의 참조 아티팩트를 저장하고, 연결 관계로 검색하고, 가져올 수 있다고 발표했다.

   AWS 출시 공지: Amazon ECR의 OCI Image·Distribution 1.1 · 공개 원문 · sources/aws-oci-launch.txt:L5

   관측 · Microsoft는 ACR의 OCI 아티팩트 push·pull 경로를 문서화한다.

   acr-artifact-path · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Push and Pull OCI Artifacts] Microsoft는 Azure Container Registry에서 OCI 이미지와 아티팩트를 저장하고 ORAS로 OCI 아티팩트를 올리거나 받는 경로를 문서화한다.

   Microsoft Learn: Azure Container Registry의 OCI 아티팩트와 ORAS · 공개 원문 · sources/azure-oras.txt:L5

원천 제외

근거를 한 원천씩 제외했을 때 판정이 바뀌는지 확인합니다.

• helm-classic 제외 → 근거 부족

판정 기준

역할과 최종 결정 주체를 확인하고, 서로 독립된 두 결정의 선택 이유와 후속 결과를 당시 기록 및 별도의 구현자 기록과 연결한다.

대체 설명

한 워킹그룹의 공개 제안과 병합 기록은 공개 개발 절차를 보여주지만 전체 레지스트리 공급자들의 조직 문화는 설명하지 않는다.

반증 조건

사전에 선정한 다른 결정에서 대안 논의가 공개되지 않았거나 결정과 실행 연결을 독립 기록에서 확인할 수 없으면 반복 문화 가설을 보류하거나 기각한다.

결정을 막는 것

• 후속 결과을 검증할 사전 동결 후 관측이 없습니다.
• 독립 원천에서 기간이 겹치지 않는 두 결정과 후속 결과를 확인해야 합니다. 뒤 사건의 결과는 홀드아웃이어야 합니다.

검토 기록

[PR #999, 2023-04-13 병합] 제안자는 기존 버전과의 호환성을 근거로 별도 아티팩트 매니페스트 삭제를 제안했다. Image Specification 유지관리자들이 공개 토론 뒤 변경을 승인하고 병합했다.
[유지관리자 설명, 2023-04-26] 워킹그룹은 규격의 최종 결정권자가 아니며, Image Specification의 의사결정은 해당 규격 유지관리 절차에 따른다.

[Release date; No Artifact Manifest] Image·Distribution v1.1.0은 2024-02-15에 출시됐다. 최종 규격은 출시 후보의 별도 아티팩트 매니페스트 대신 기존 이미지 매니페스트를 사용한다.

메커니즘과 의존성

1. OCI 워킹그룹의 공개 제안과 규격 유지관리자의 호환성 판단 spec-governance · 의존: artifact-discovery
   관측 · OCI 워킹그룹은 여러 제안의 상태를 공개하고 최종 제안의 상위 규격 반영 및 보관 상태 전환을 기록했다.

   wg-open-options · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Completed / Proposals] 워킹그룹은 여러 제안의 상태를 공개했고 Proposal E를 선택해 Distribution·Image 규격에 반영했다고 기록한다.
   [Status] 워킹그룹은 정의한 과업을 마친 뒤 저장소를 보관 상태로 전환했다고 밝힌다.

   OCI Reference Types 워킹그룹 기록 · 공개 원문 · sources/oci-reference-wg.txt:L5-L6

   관측 · 2022-08-25 워킹그룹의 Reference Types 제안이 Distribution Specification main에 병합됐다.

   wg-proposal-merged · outcome

   작성자 요약 · 아래 발췌와 대조 필요

   [2022-08-25] Reference Types 워킹그룹 제안이 OCI Distribution Specification의 main 브랜치에 병합됐다. 이 날짜는 최종 버전 출시일과 다르다.

   OCI Distribution 변경 기록: Reference Types 워킹그룹 제안 #335 · 공개 원문 · sources/oci-wg-merge.txt:L5

   관측 · 2023-04-13 OCI Image Specification 유지관리자들이 기존 레지스트리와의 호환성을 고려해 출시 후보의 별도 매니페스트를 제거하는 변경을 병합했다.

   oci-compatibility-decision · decision

   작성자 요약 · 아래 발췌와 대조 필요

   [PR #999, 2023-04-13 병합] 제안자는 기존 버전과의 호환성을 근거로 별도 아티팩트 매니페스트 삭제를 제안했다. Image Specification 유지관리자들이 공개 토론 뒤 변경을 승인하고 병합했다.
   [유지관리자 설명, 2023-04-26] 워킹그룹은 규격의 최종 결정권자가 아니며, Image Specification의 의사결정은 해당 규격 유지관리 절차에 따른다.

   OCI Image Specification 변경 기록: 별도 아티팩트 매니페스트 제거 #999 · 공개 원문 · sources/oci-manifest-change.txt:L5-L6

   관측 · 2024-02-15에 출시된 OCI v1.1.0은 별도 아티팩트 매니페스트 없이 기존 이미지 매니페스트에 아티팩트 지원을 포함했다.

   oci-manifest-release-outcome · outcome

   작성자 요약 · 아래 발췌와 대조 필요

   [Release date; No Artifact Manifest] Image·Distribution v1.1.0은 2024-02-15에 출시됐다. 최종 규격은 출시 후보의 별도 아티팩트 매니페스트 대신 기존 이미지 매니페스트를 사용한다.

   OCI 공식 발표: Image·Distribution 1.1 출시 · 공개 원문 · sources/oci-vone-release.txt:L7

   관측 · 2024-06-27 AWS는 ECR에 OCI 1.1 참조 아티팩트 기능을 적용했다고 발표했다.

   ecr-reference-rollout · outcome

   작성자 요약 · 아래 발췌와 대조 필요

   [2024-06-27] ECR은 이미지에 연결된 서명이나 SBOM 등의 참조 아티팩트를 저장하고, 연결 관계로 검색하고, 가져올 수 있다고 발표했다.

   AWS 출시 공지: Amazon ECR의 OCI Image·Distribution 1.1 · 공개 원문 · sources/aws-oci-launch.txt:L5

2. 이미지에 연결된 아티팩트 검색과 호환 경로 artifact-discovery · 의존: standard-content-path
   관측 · OCI 명세는 Referrers API 조회가 404일 때 클라이언트가 태그 인덱스로 돌아가도록 규정한다.

   oci-referrers-fallback · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Listing Referrers / Backwards Compatibility] 지원 서버는 참조 검색 결과를 제공한다. 참조 조회가 404이면 클라이언트는 다이제스트에서 만든 태그의 인덱스를 사용하도록 규정한다.

   OCI Distribution Specification v1.1.1 · 공개 원문 · sources/oci-distribution.txt:L7

   관측 · AWS는 ECR이 OCI 1.1 이미지 참조 아티팩트를 저장·검색·가져올 수 있다고 발표했다.

   ecr-referrers · document

   작성자 요약 · 아래 발췌와 대조 필요

   [2024-06-27] ECR은 이미지에 연결된 서명이나 SBOM 등의 참조 아티팩트를 저장하고, 연결 관계로 검색하고, 가져올 수 있다고 발표했다.

   AWS 출시 공지: Amazon ECR의 OCI Image·Distribution 1.1 · 공개 원문 · sources/aws-oci-launch.txt:L5

   관측 · Microsoft는 ACR에서 이미지에 연결된 참조 아티팩트를 ORAS로 조회하는 사례를 제공한다.

   acr-referrers · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Discovering artifact references] Microsoft는 이미지에 연결된 아티팩트 목록을 ORAS로 조회하는 흐름을 예시로 제공한다.

   Microsoft Learn: Azure Container Registry의 OCI 아티팩트와 ORAS · 공개 원문 · sources/azure-oras.txt:L7

   관측 · Microsoft 문서에서는 CMK 암호화 구성에서 ORAS가 서버 Referrers API 대신 참조 태그를 사용한다.

   acr-cmk-exception · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Attach, push, and pull supply chain artifacts] Microsoft 문서에서 고객 관리 키(CMK)로 암호화된 레지스트리는 서버 Referrers API 지원의 예외이며, ORAS v1.2.3이 참조 태그 방식을 쓴다고 설명한다.

   Microsoft Learn: Azure Container Registry의 OCI 아티팩트와 ORAS · 공개 원문 · sources/azure-oras.txt:L6

   관측 · OCI는 참조 태그 인덱스를 여러 클라이언트가 갱신할 때 경합할 수 있다고 설명한다.

   oci-fallback-contention · document

   작성자 요약 · 아래 발췌와 대조 필요

   [2024-03-13, Referrers API] OCI는 기존 레지스트리를 위한 참조 태그 인덱스를 설명하고 여러 클라이언트가 태그를 동시에 갱신할 때 경합할 수 있다고 밝힌다.

   OCI 공식 발표: Image·Distribution 1.1 출시 · 공개 원문 · sources/oci-vone-release.txt:L6

3. OCI 매니페스트와 blob을 통한 공통 콘텐츠 배포 standard-content-path
   관측 · OCI v1.1.1 준수 레지스트리의 Pull 범주는 콘텐츠를 매니페스트와 blob으로 가져오는 공통 계약을 규정한다.

   oci-common-pull · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Conformance / Pull] 준수하는 레지스트리는 기본 Pull 범주를 구현한다. Pull은 매니페스트와 blob을 가져오며, 매니페스트는 태그나 다이제스트로 지정할 수 있다.

   OCI Distribution Specification v1.1.1 · 공개 원문 · sources/oci-distribution.txt:L5

   관측 · Pull, Push, 탐색, 관리는 별도 준수 범주다.

   oci-category-boundary · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Conformance] Push, Content Discovery, Content Management는 기본 Pull과 별도 범주다. 특정 범주 준수를 주장하면 해당 범주 전체가 필요하다.

   OCI Distribution Specification v1.1.1 · 공개 원문 · sources/oci-distribution.txt:L6

   관측 · AWS는 ECR이 OCI 1.1 이미지 참조 아티팩트를 저장·검색·가져올 수 있다고 발표했다.

   ecr-referrers · document

   작성자 요약 · 아래 발췌와 대조 필요

   [2024-06-27] ECR은 이미지에 연결된 서명이나 SBOM 등의 참조 아티팩트를 저장하고, 연결 관계로 검색하고, 가져올 수 있다고 발표했다.

   AWS 출시 공지: Amazon ECR의 OCI Image·Distribution 1.1 · 공개 원문 · sources/aws-oci-launch.txt:L5

   관측 · Microsoft는 ACR의 OCI 아티팩트 push·pull 경로를 문서화한다.

   acr-artifact-path · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Push and Pull OCI Artifacts] Microsoft는 Azure Container Registry에서 OCI 이미지와 아티팩트를 저장하고 ORAS로 OCI 아티팩트를 올리거나 받는 경로를 문서화한다.

   Microsoft Learn: Azure Container Registry의 OCI 아티팩트와 ORAS · 공개 원문 · sources/azure-oras.txt:L5

원천 제외

근거를 한 원천씩 제외했을 때 판정이 바뀌는지 확인합니다.

• oci-distribution 제외 → 근거 부족

판정 기준

기존 OCI 이미지 고객의 운영 기록에서 새로운 아티팩트의 실제 소비 횟수와 재사용을 확인하고, 런타임 지원 범위와 일반 파일 배포 대비 운영 비용을 대조한다.

대체 설명

소비 기능은 출시됐어도 기존 차트 저장소나 파일 배포가 고객에게 더 편해 실제 전환이 일어나지 않을 수 있다.

반증 조건

합의된 관찰 기간에 호환 런타임을 보유한 독립 조직들에서 추가 콘텐츠 사용이 지속되지 않거나 운영 비용이 비교 경로를 일관되게 넘으면 확대 가설을 기각한다.

결정을 막는 것

• 필요한 근거: 수요
• 서로 다른 원천 그룹 두 곳 이상에서 필요한 역할을 뒷받침해야 합니다.
• 수요을 검증할 사전 동결 후 관측이 없습니다.

검토 기록

[Helm Installation Methods] Cilium은 Quay의 OCI 레지스트리 경로를 실제 차트 배포 선택지로 게시하고 일반 HTTP Helm 저장소 경로도 안내한다.

[Use an Image Volume With a Pod] Kubernetes 문서는 OCI 레지스트리의 콘텐츠를 Pod 내부에 볼륨으로 마운트하는 기능을 v1.36부터 안정으로 표시한다.

[Before you begin; Run a Pod that uses an image volume] 볼륨의 콘텐츠는 이미지 참조로 지정한다. 컨테이너 런타임에도 이 기능 지원이 필요하다.

[Create a chart repository] Helm은 OCI 레지스트리 없이도 HTTP 서버, 객체 저장소 등을 이용해 인덱스와 패키징한 차트를 제공하는 방식을 설명한다.

메커니즘과 의존성

1. Helm·Kubernetes의 OCI 소비 경로와 공급자별 자격증명 complementary-tools · 의존: standard-content-path
   관측 · Helm의 OCI 차트 경로는 여러 호스팅 공급자를 열거하고 공통 패키지와 명명 규칙을 사용한다.

   helm-multiple-hosts · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Using an OCI-based registry] Helm은 OCI 레지스트리에 차트를 저장하는 절차를 설명하고 ECR, ACR, Google Artifact Registry를 포함한 여러 대상 공급자를 예시로 든다.
   [The push subcommand] Helm은 이미 패키징한 차트를 배포하며, 이름과 의미 버전으로 저장 참조가 결정된다.

   Helm v3 공식 문서: OCI 기반 레지스트리 · 공개 원문 · sources/helm-oci.txt:L5-L6

   관측 · Google의 Docker 인증은 레지스트리 호스트에 따라 별도로 구성된다.

   provider-credentials · document

   작성자 요약 · 아래 발췌와 대조 필요

   [gcloud CLI credential helper] Google Artifact Registry의 Docker 자격증명은 리포지터리 호스트 목록을 기준으로 설정된다. 공급자 변경 시 OCI 콘텐츠와 별도로 호스트·인증 설정을 고려해야 한다.

   Google Artifact Registry 공식 문서: Docker 인증 · 공개 원문 · sources/google-docker-auth.txt:L5

   관측 · Kubernetes가 OCI 레지스트리를 컨테이너 실행 이미지 이외의 볼륨 콘텐츠 공급원으로 사용하는 경로를 문서화한다.

   kube-artifact-consumer · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Use an Image Volume With a Pod] Kubernetes 문서는 OCI 레지스트리의 콘텐츠를 Pod 내부에 볼륨으로 마운트하는 기능을 v1.36부터 안정으로 표시한다.

   Kubernetes v1.36 공식 문서: 이미지 볼륨 사용 · 공개 원문 · sources/kube-image-volume.txt:L5

   관측 · OCI 이미지 볼륨을 쓰려면 런타임이 해당 기능을 지원해야 한다.

   kube-runtime-limit · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Before you begin; Run a Pod that uses an image volume] 볼륨의 콘텐츠는 이미지 참조로 지정한다. 컨테이너 런타임에도 이 기능 지원이 필요하다.

   Kubernetes v1.36 공식 문서: 이미지 볼륨 사용 · 공개 원문 · sources/kube-image-volume.txt:L6

   관측 · Helm의 같은 패키지 유형에는 객체 저장소나 HTTP 서버에서 차트 인덱스와 패키지를 배포하는 대체 경로가 있다.

   helm-http-alternative · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Create a chart repository] Helm은 OCI 레지스트리 없이도 HTTP 서버, 객체 저장소 등을 이용해 인덱스와 패키징한 차트를 제공하는 방식을 설명한다.

   Helm v3 공식 문서: HTTP 차트 저장소 · 공개 원문 · sources/helm-classic.txt:L5

   관측 · 아티팩트 발행자 Cilium은 OCI 레지스트리에서 Helm 차트를 배포하는 경로와 일반 Helm 저장소 경로를 함께 문서화한다.

   cilium-oci-publishing · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Helm Installation Methods] Cilium은 Quay의 OCI 레지스트리 경로를 실제 차트 배포 선택지로 게시하고 일반 HTTP Helm 저장소 경로도 안내한다.

   Cilium 공식 설치 문서: OCI 및 일반 Helm 배포 · 공개 원문 · sources/cilium-chart.txt:L5

2. OCI 매니페스트와 blob을 통한 공통 콘텐츠 배포 standard-content-path
   관측 · OCI v1.1.1 준수 레지스트리의 Pull 범주는 콘텐츠를 매니페스트와 blob으로 가져오는 공통 계약을 규정한다.

   oci-common-pull · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Conformance / Pull] 준수하는 레지스트리는 기본 Pull 범주를 구현한다. Pull은 매니페스트와 blob을 가져오며, 매니페스트는 태그나 다이제스트로 지정할 수 있다.

   OCI Distribution Specification v1.1.1 · 공개 원문 · sources/oci-distribution.txt:L5

   관측 · Pull, Push, 탐색, 관리는 별도 준수 범주다.

   oci-category-boundary · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Conformance] Push, Content Discovery, Content Management는 기본 Pull과 별도 범주다. 특정 범주 준수를 주장하면 해당 범주 전체가 필요하다.

   OCI Distribution Specification v1.1.1 · 공개 원문 · sources/oci-distribution.txt:L6

   관측 · AWS는 ECR이 OCI 1.1 이미지 참조 아티팩트를 저장·검색·가져올 수 있다고 발표했다.

   ecr-referrers · document

   작성자 요약 · 아래 발췌와 대조 필요

   [2024-06-27] ECR은 이미지에 연결된 서명이나 SBOM 등의 참조 아티팩트를 저장하고, 연결 관계로 검색하고, 가져올 수 있다고 발표했다.

   AWS 출시 공지: Amazon ECR의 OCI Image·Distribution 1.1 · 공개 원문 · sources/aws-oci-launch.txt:L5

   관측 · Microsoft는 ACR의 OCI 아티팩트 push·pull 경로를 문서화한다.

   acr-artifact-path · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Push and Pull OCI Artifacts] Microsoft는 Azure Container Registry에서 OCI 이미지와 아티팩트를 저장하고 ORAS로 OCI 아티팩트를 올리거나 받는 경로를 문서화한다.

   Microsoft Learn: Azure Container Registry의 OCI 아티팩트와 ORAS · 공개 원문 · sources/azure-oras.txt:L5

원천 제외

근거를 한 원천씩 제외했을 때 판정이 바뀌는지 확인합니다.

확인한 원천을 하나씩 제외해도 이 판정은 유지됩니다.

판정 기준

고정 버전 표준의 Pull 계약과 서로 독립된 두 공급자의 공개 이미지·아티팩트 경로를 대조한다.

대체 설명

실행 환경별 선택 기능과 미디어 유형에서 차이가 날 수 있다. 공개 문서는 동일 버전의 전체 기능 동작을 검증하는 시험 결과가 아니다.

반증 조건

공급자 중 하나가 해당 OCI 아티팩트 경로를 제공하지 않는다고 공식 문서가 수정되거나 버전이 고정된 독립 호환 시험에서 문서화된 기본 경로가 실패하면 그 구현의 판단을 바꾼다.

결정을 막는 것

• 메커니즘을 검증할 사전 동결 후 관측이 없습니다.

검토 기록

[Conformance / Pull] 준수하는 레지스트리는 기본 Pull 범주를 구현한다. Pull은 매니페스트와 blob을 가져오며, 매니페스트는 태그나 다이제스트로 지정할 수 있다.

[2024-06-27] ECR은 이미지에 연결된 서명이나 SBOM 등의 참조 아티팩트를 저장하고, 연결 관계로 검색하고, 가져올 수 있다고 발표했다.

[Push and Pull OCI Artifacts] Microsoft는 Azure Container Registry에서 OCI 이미지와 아티팩트를 저장하고 ORAS로 OCI 아티팩트를 올리거나 받는 경로를 문서화한다.

메커니즘과 의존성

1. OCI 매니페스트와 blob을 통한 공통 콘텐츠 배포 standard-content-path
   관측 · OCI v1.1.1 준수 레지스트리의 Pull 범주는 콘텐츠를 매니페스트와 blob으로 가져오는 공통 계약을 규정한다.

   oci-common-pull · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Conformance / Pull] 준수하는 레지스트리는 기본 Pull 범주를 구현한다. Pull은 매니페스트와 blob을 가져오며, 매니페스트는 태그나 다이제스트로 지정할 수 있다.

   OCI Distribution Specification v1.1.1 · 공개 원문 · sources/oci-distribution.txt:L5

   관측 · Pull, Push, 탐색, 관리는 별도 준수 범주다.

   oci-category-boundary · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Conformance] Push, Content Discovery, Content Management는 기본 Pull과 별도 범주다. 특정 범주 준수를 주장하면 해당 범주 전체가 필요하다.

   OCI Distribution Specification v1.1.1 · 공개 원문 · sources/oci-distribution.txt:L6

   관측 · AWS는 ECR이 OCI 1.1 이미지 참조 아티팩트를 저장·검색·가져올 수 있다고 발표했다.

   ecr-referrers · document

   작성자 요약 · 아래 발췌와 대조 필요

   [2024-06-27] ECR은 이미지에 연결된 서명이나 SBOM 등의 참조 아티팩트를 저장하고, 연결 관계로 검색하고, 가져올 수 있다고 발표했다.

   AWS 출시 공지: Amazon ECR의 OCI Image·Distribution 1.1 · 공개 원문 · sources/aws-oci-launch.txt:L5

   관측 · Microsoft는 ACR의 OCI 아티팩트 push·pull 경로를 문서화한다.

   acr-artifact-path · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Push and Pull OCI Artifacts] Microsoft는 Azure Container Registry에서 OCI 이미지와 아티팩트를 저장하고 ORAS로 OCI 아티팩트를 올리거나 받는 경로를 문서화한다.

   Microsoft Learn: Azure Container Registry의 OCI 아티팩트와 ORAS · 공개 원문 · sources/azure-oras.txt:L5

원천 제외

근거를 한 원천씩 제외했을 때 판정이 바뀌는지 확인합니다.

확인한 원천을 하나씩 제외해도 이 판정은 유지됩니다.

판정 기준

서로 겹치지 않는 두 규격 개선 사건에서 날짜가 있는 기존 구현의 실제 차질, 그 뒤의 설계 변경 결정, 독립 구현자의 후속 결과를 연결한다. 나중 사건의 결과는 가설 확정 뒤 관찰한다.

대체 설명

Reference Types는 특별한 조정 사례일 수 있다. AWS가 표준 논의에 참여했으므로 AWS의 채택 공지만으로 별도 매니페스트 제거의 인과 효과를 확인할 수 없다.

반증 조건

사전에 정한 후속 사건에서 이미 보고된 제약을 해결하지 못하거나, 독립 구현자가 변경된 계약을 채택하지 않으면 반복 개선 가설을 재평가한다.

결정을 막는 것

• 필요한 근거: 실패 또는 차질
• 후속 결과을 검증할 사전 동결 후 관측이 없습니다.
• 기간이 겹치지 않는 두 사건의 실패, 의사결정, 후속 결과를 확인해야 합니다. 뒤 사건의 결과는 독립 홀드아웃이어야 합니다.

검토 기록

[PR #999, 2023-04-13 병합] 제안자는 기존 버전과의 호환성을 근거로 별도 아티팩트 매니페스트 삭제를 제안했다. Image Specification 유지관리자들이 공개 토론 뒤 변경을 승인하고 병합했다.
[유지관리자 설명, 2023-04-26] 워킹그룹은 규격의 최종 결정권자가 아니며, Image Specification의 의사결정은 해당 규격 유지관리 절차에 따른다.

[2024-06-27] ECR은 이미지에 연결된 서명이나 SBOM 등의 참조 아티팩트를 저장하고, 연결 관계로 검색하고, 가져올 수 있다고 발표했다.

메커니즘과 의존성

1. OCI 워킹그룹의 공개 제안과 규격 유지관리자의 호환성 판단 spec-governance · 의존: artifact-discovery
   관측 · OCI 워킹그룹은 여러 제안의 상태를 공개하고 최종 제안의 상위 규격 반영 및 보관 상태 전환을 기록했다.

   wg-open-options · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Completed / Proposals] 워킹그룹은 여러 제안의 상태를 공개했고 Proposal E를 선택해 Distribution·Image 규격에 반영했다고 기록한다.
   [Status] 워킹그룹은 정의한 과업을 마친 뒤 저장소를 보관 상태로 전환했다고 밝힌다.

   OCI Reference Types 워킹그룹 기록 · 공개 원문 · sources/oci-reference-wg.txt:L5-L6

   관측 · 2022-08-25 워킹그룹의 Reference Types 제안이 Distribution Specification main에 병합됐다.

   wg-proposal-merged · outcome

   작성자 요약 · 아래 발췌와 대조 필요

   [2022-08-25] Reference Types 워킹그룹 제안이 OCI Distribution Specification의 main 브랜치에 병합됐다. 이 날짜는 최종 버전 출시일과 다르다.

   OCI Distribution 변경 기록: Reference Types 워킹그룹 제안 #335 · 공개 원문 · sources/oci-wg-merge.txt:L5

   관측 · 2023-04-13 OCI Image Specification 유지관리자들이 기존 레지스트리와의 호환성을 고려해 출시 후보의 별도 매니페스트를 제거하는 변경을 병합했다.

   oci-compatibility-decision · decision

   작성자 요약 · 아래 발췌와 대조 필요

   [PR #999, 2023-04-13 병합] 제안자는 기존 버전과의 호환성을 근거로 별도 아티팩트 매니페스트 삭제를 제안했다. Image Specification 유지관리자들이 공개 토론 뒤 변경을 승인하고 병합했다.
   [유지관리자 설명, 2023-04-26] 워킹그룹은 규격의 최종 결정권자가 아니며, Image Specification의 의사결정은 해당 규격 유지관리 절차에 따른다.

   OCI Image Specification 변경 기록: 별도 아티팩트 매니페스트 제거 #999 · 공개 원문 · sources/oci-manifest-change.txt:L5-L6

   관측 · 2024-02-15에 출시된 OCI v1.1.0은 별도 아티팩트 매니페스트 없이 기존 이미지 매니페스트에 아티팩트 지원을 포함했다.

   oci-manifest-release-outcome · outcome

   작성자 요약 · 아래 발췌와 대조 필요

   [Release date; No Artifact Manifest] Image·Distribution v1.1.0은 2024-02-15에 출시됐다. 최종 규격은 출시 후보의 별도 아티팩트 매니페스트 대신 기존 이미지 매니페스트를 사용한다.

   OCI 공식 발표: Image·Distribution 1.1 출시 · 공개 원문 · sources/oci-vone-release.txt:L7

   관측 · 2024-06-27 AWS는 ECR에 OCI 1.1 참조 아티팩트 기능을 적용했다고 발표했다.

   ecr-reference-rollout · outcome

   작성자 요약 · 아래 발췌와 대조 필요

   [2024-06-27] ECR은 이미지에 연결된 서명이나 SBOM 등의 참조 아티팩트를 저장하고, 연결 관계로 검색하고, 가져올 수 있다고 발표했다.

   AWS 출시 공지: Amazon ECR의 OCI Image·Distribution 1.1 · 공개 원문 · sources/aws-oci-launch.txt:L5

2. 이미지에 연결된 아티팩트 검색과 호환 경로 artifact-discovery · 의존: standard-content-path
   관측 · OCI 명세는 Referrers API 조회가 404일 때 클라이언트가 태그 인덱스로 돌아가도록 규정한다.

   oci-referrers-fallback · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Listing Referrers / Backwards Compatibility] 지원 서버는 참조 검색 결과를 제공한다. 참조 조회가 404이면 클라이언트는 다이제스트에서 만든 태그의 인덱스를 사용하도록 규정한다.

   OCI Distribution Specification v1.1.1 · 공개 원문 · sources/oci-distribution.txt:L7

   관측 · AWS는 ECR이 OCI 1.1 이미지 참조 아티팩트를 저장·검색·가져올 수 있다고 발표했다.

   ecr-referrers · document

   작성자 요약 · 아래 발췌와 대조 필요

   [2024-06-27] ECR은 이미지에 연결된 서명이나 SBOM 등의 참조 아티팩트를 저장하고, 연결 관계로 검색하고, 가져올 수 있다고 발표했다.

   AWS 출시 공지: Amazon ECR의 OCI Image·Distribution 1.1 · 공개 원문 · sources/aws-oci-launch.txt:L5

   관측 · Microsoft는 ACR에서 이미지에 연결된 참조 아티팩트를 ORAS로 조회하는 사례를 제공한다.

   acr-referrers · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Discovering artifact references] Microsoft는 이미지에 연결된 아티팩트 목록을 ORAS로 조회하는 흐름을 예시로 제공한다.

   Microsoft Learn: Azure Container Registry의 OCI 아티팩트와 ORAS · 공개 원문 · sources/azure-oras.txt:L7

   관측 · Microsoft 문서에서는 CMK 암호화 구성에서 ORAS가 서버 Referrers API 대신 참조 태그를 사용한다.

   acr-cmk-exception · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Attach, push, and pull supply chain artifacts] Microsoft 문서에서 고객 관리 키(CMK)로 암호화된 레지스트리는 서버 Referrers API 지원의 예외이며, ORAS v1.2.3이 참조 태그 방식을 쓴다고 설명한다.

   Microsoft Learn: Azure Container Registry의 OCI 아티팩트와 ORAS · 공개 원문 · sources/azure-oras.txt:L6

   관측 · OCI는 참조 태그 인덱스를 여러 클라이언트가 갱신할 때 경합할 수 있다고 설명한다.

   oci-fallback-contention · document

   작성자 요약 · 아래 발췌와 대조 필요

   [2024-03-13, Referrers API] OCI는 기존 레지스트리를 위한 참조 태그 인덱스를 설명하고 여러 클라이언트가 태그를 동시에 갱신할 때 경합할 수 있다고 밝힌다.

   OCI 공식 발표: Image·Distribution 1.1 출시 · 공개 원문 · sources/oci-vone-release.txt:L6

3. OCI 매니페스트와 blob을 통한 공통 콘텐츠 배포 standard-content-path
   관측 · OCI v1.1.1 준수 레지스트리의 Pull 범주는 콘텐츠를 매니페스트와 blob으로 가져오는 공통 계약을 규정한다.

   oci-common-pull · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Conformance / Pull] 준수하는 레지스트리는 기본 Pull 범주를 구현한다. Pull은 매니페스트와 blob을 가져오며, 매니페스트는 태그나 다이제스트로 지정할 수 있다.

   OCI Distribution Specification v1.1.1 · 공개 원문 · sources/oci-distribution.txt:L5

   관측 · Pull, Push, 탐색, 관리는 별도 준수 범주다.

   oci-category-boundary · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Conformance] Push, Content Discovery, Content Management는 기본 Pull과 별도 범주다. 특정 범주 준수를 주장하면 해당 범주 전체가 필요하다.

   OCI Distribution Specification v1.1.1 · 공개 원문 · sources/oci-distribution.txt:L6

   관측 · AWS는 ECR이 OCI 1.1 이미지 참조 아티팩트를 저장·검색·가져올 수 있다고 발표했다.

   ecr-referrers · document

   작성자 요약 · 아래 발췌와 대조 필요

   [2024-06-27] ECR은 이미지에 연결된 서명이나 SBOM 등의 참조 아티팩트를 저장하고, 연결 관계로 검색하고, 가져올 수 있다고 발표했다.

   AWS 출시 공지: Amazon ECR의 OCI Image·Distribution 1.1 · 공개 원문 · sources/aws-oci-launch.txt:L5

   관측 · Microsoft는 ACR의 OCI 아티팩트 push·pull 경로를 문서화한다.

   acr-artifact-path · document

   작성자 요약 · 아래 발췌와 대조 필요

   [Push and Pull OCI Artifacts] Microsoft는 Azure Container Registry에서 OCI 이미지와 아티팩트를 저장하고 ORAS로 OCI 아티팩트를 올리거나 받는 경로를 문서화한다.

   Microsoft Learn: Azure Container Registry의 OCI 아티팩트와 ORAS · 공개 원문 · sources/azure-oras.txt:L5

원천 제외

근거를 한 원천씩 제외했을 때 판정이 바뀌는지 확인합니다.

확인한 원천을 하나씩 제외해도 이 판정은 유지됩니다.