주석
주석 (Annotations)
주석(annotations)은 이미지에 대한 설명적 메타데이터를 제공해요. 임의의 정보를 기록해 이미지에 붙여, 소비자와 도구가 이미지의 출처, 내용, 사용 방법을 이해하는 것을 돕는 데 사용해요.
출처: 문서
본문
주석은 레이블(labels)과 유사하고 어떤 의미에서는 겹치기도 해요. 둘 다 자원에 메타데이터를 붙이는 역할을 해요. 일반 원칙으로 주석과 레이블의 차이는 다음과 같이 생각할 수 있어요:
- **주석(Annotations)**은 OCI 이미지 컴포넌트(manifest, index, descriptor)를 설명해요.
- **레이블(Labels)**은 Docker 자원(이미지, 컨테이너, 네트워크, 볼륨)을 설명해요.
OCI 이미지 스펙은 주석의 형식과 미리 정의된 주석 키 집합을 정의해요. 지정된 표준을 따르면 이미지에 대한 메타데이터가 Docker Scout 같은 도구에 의해 자동으로 일관되게 표시될 수 있어요.
주석은 자격 증명(attestations)과 혼동해서는 안 돼요:
- **자격 증명(Attestations)**은 이미지가 어떻게 빌드되었는지와 무엇을 포함하는지에 대한 정보를 포함해요. 자격 증명은 별도의 매니페스트로 이미지에 붙어요.
- **주석(Annotations)**은 이미지 자체에 대한 설명적 메타데이터예요.
주석과 관련 키 (Annotations and keys)
이미지에 주석을 추가하는 방법은 --output 익스포터의 annotation 파라미터를 쓰는 것이에요. 미리 정의된 주석 키에는 org.opencontainers.image.title, org.opencontainers.image.source, org.opencontainers.image.created 등이 있어요.