10장. ImageTag [image.openshift.io/v1]
- 설명
ImageTag는 이미지 스트림 내의 단일 태그를 나타내며 제공된 태그의 사양, 상태 기록 및 현재 참조된 이미지(있는 경우)를 포함합니다. 이 유형은 태그의 전체 보기를 제공하여 ImageStreamTag를 대체합니다. 이미지 스트림에 있는 모든 spec 또는 status 태그에 대해 ImageTags가 반환됩니다. 두 양식 중 하나에 태그가 없으면 API에서 찾을 수 없는 오류가 반환됩니다. spec 태그가 이미 정의되어 있고 spec 필드가 설정된 경우 생성 작업이 성공적으로 수행됩니다. delete는 이미지 스트림에서 spec 및 status 요소를 모두 제거합니다.
호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
- 필수 항목
-
spec
-
status
-
image
-
10.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| 이미지는 특정 시점에 컨테이너 이미지와 메타데이터를 변경할 수 없는 표현입니다. 이미지는 콘텐츠(metadata 및 콘텐츠)의 해시를 가져와서 이름이 지정되며 형식, 콘텐츠 또는 메타데이터의 변경으로 인해 새 이름이 생성됩니다. 이미지 리소스는 주로 클러스터 관리자 및 클러스터 이미지 레지스트리와 같은 통합을 위해 사용됩니다. 최종 사용자는 imagestreamtag 또는 imagestreamimages 리소스를 통해 이미지에 액세스합니다. 이미지 메타데이터는 API에 저장되는 반면 컨테이너 이미지 레지스트리 API를 구현하는 통합에서는 원시 매니페스트 데이터, 이미지 구성 및 계층 콘텐츠에 대한 자체 스토리지를 제공해야 합니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다. |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 메타데이터는 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| TagReference는 이 태그를 사용하는 이미지의 선택적 주석과 이 태그가 추적해야 하는 ImageStreamTag, ImageStreamImage 또는 DockerImage에 대한 선택적 참조를 지정합니다. |
|
| NamedTagEventList는 태그와 해당 이미지 기록과 관련이 있습니다. |
10.1.1. .image
- 설명
이미지는 특정 시점에 컨테이너 이미지와 메타데이터를 변경할 수 없는 표현입니다. 이미지는 콘텐츠(metadata 및 콘텐츠)의 해시를 가져와서 이름이 지정되며 형식, 콘텐츠 또는 메타데이터의 변경으로 인해 새 이름이 생성됩니다. 이미지 리소스는 주로 클러스터 관리자 및 클러스터 이미지 레지스트리와 같은 통합을 위해 사용됩니다. 최종 사용자는 imagestreamtag 또는 imagestreamimages 리소스를 통해 이미지에 액세스합니다. 이미지 메타데이터는 API에 저장되는 반면 컨테이너 이미지 레지스트리 API를 구현하는 통합에서는 원시 매니페스트 데이터, 이미지 구성 및 계층 콘텐츠에 대한 자체 스토리지를 제공해야 합니다.
호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| DockerImageConfig는 런타임에서 컨테이너를 설정하는 데 사용하는 JSON Blob입니다. 매니페스트 스키마 v2의 일부입니다. 이미지가 매니페스트 목록을 나타내는 경우 설정하지 않습니다. |
|
| DockerImageLayers는 이미지의 계층을 나타냅니다. 이미지가 해당 데이터를 정의하지 않거나 이미지가 매니페스트 목록을 나타내는 경우 설정하지 않을 수 있습니다. |
|
| ImageLayer는 이미지의 단일 계층을 나타냅니다. 일부 이미지에는 여러 계층이 있을 수 있습니다. 일부는 없을 수도 있습니다. |
|
| DockerImageManifest는 매니페스트의 원시 JSON입니다. |
|
| DockerImageManifestMediaType은 매니페스트의 mediaType을 지정합니다. 매니페스트 스키마 v2의 일부입니다. |
|
| DockerImageManifests 이미지에 매니페스트 목록을 표시할 때 하위 매니페스트에 대한 정보가 들어 있습니다. 이 필드가 있으면 DockerImageLayers를 지정하지 않아야 합니다. |
|
| ImageManifest는 매니페스트 목록의 하위 매니페스트를 나타냅니다. Digest 필드는 일반 Image 오브젝트를 가리킵니다. |
| DockerImageMetadata에는 이 이미지에 대한 메타데이터가 포함되어 있습니다. | |
|
| DockerImageMetadataVersion은 오브젝트 버전을 전달합니다. 빈 기본값은 "1.0"입니다. |
|
| DockerImageReference는 이 이미지를 가져오는 데 사용할 수 있는 문자열입니다. |
|
| DockerImageSignatures는 서명을 불투명 Blob으로 제공합니다. 매니페스트 스키마 v1의 일부입니다. |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 메타데이터는 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| 서명에는 이미지의 모든 서명이 있습니다. |
|
| ImageSignature에는 이미지의 서명이 있습니다. 서명을 신뢰할 수 있는 한 이미지 ID 및 기타 클레임을 확인할 수 있습니다. 이 정보를 기반으로 실행 가능한 이미지를 클러스터 전체 정책과 일치하는 이미지로 제한할 수 있습니다. 필수 필드는 이미지 확인을 수행하는 클라이언트가 구문 분석해야 합니다. 다른 하나는 서버에 의해 서명의 콘텐츠에서 구문 분석됩니다. 이는 유익한 목적으로만 사용됩니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다. |
10.1.2. .image.dockerImageLayers
- 설명
- DockerImageLayers는 이미지의 계층을 나타냅니다. 이미지가 해당 데이터를 정의하지 않거나 이미지가 매니페스트 목록을 나타내는 경우 설정하지 않을 수 있습니다.
- 유형
-
array
10.1.3. .image.dockerImageLayers[]
- 설명
- ImageLayer는 이미지의 단일 계층을 나타냅니다. 일부 이미지에는 여러 계층이 있을 수 있습니다. 일부는 없을 수도 있습니다.
- 유형
-
object
- 필수 항목
-
name
-
size
-
mediaType
-
속성 | 유형 | 설명 |
---|---|---|
|
| 참조된 오브젝트의 mediatype입니다. |
|
| 기본 저장소에서 정의한 계층의 이름입니다. |
|
| 기본 저장소에서 정의한 대로 계층의 크기(바이트)입니다. |
10.1.4. .image.dockerImageManifests
- 설명
- DockerImageManifests 이미지에 매니페스트 목록을 표시할 때 하위 매니페스트에 대한 정보가 들어 있습니다. 이 필드가 있으면 DockerImageLayers를 지정하지 않아야 합니다.
- 유형
-
array
10.1.5. .image.dockerImageManifests[]
- 설명
- ImageManifest는 매니페스트 목록의 하위 매니페스트를 나타냅니다. Digest 필드는 일반 Image 오브젝트를 가리킵니다.
- 유형
-
object
- 필수 항목
-
다이제스트
-
mediaType
-
manifestSize
-
아키텍처
-
OS
-
속성 | 유형 | 설명 |
---|---|---|
|
|
아키텍처는 지원되는 CPU 아키텍처를 지정합니다(예: |
|
| 다이제스트는 매니페스트의 고유 식별자입니다. Image 오브젝트를 나타냅니다. |
|
| ManifestSize는 원시 오브젝트 콘텐츠의 크기(바이트)를 나타냅니다. |
|
| mediatype은 매니페스트 유형을 정의합니다. 가능한 값은 application/vnd.oci.image.manifest.v1+json, application/vnd.docker.distribution.manifest.v2+json 또는 application/vnd.docker.distribution.manifest.manifest.v1+json입니다. |
|
|
OS는 운영 체제를 지정합니다(예: |
|
| 변형은 CPU의 변형을 다시 사용하는 선택적 필드입니다(예: ARM CPU의 특정 CPU 변형을 지정하기 위한 v6). |
10.1.6. .image.signatures
- 설명
- 서명에는 이미지의 모든 서명이 있습니다.
- 유형
-
array
10.1.7. .image.signatures[]
- 설명
ImageSignature에는 이미지의 서명이 있습니다. 서명을 신뢰할 수 있는 한 이미지 ID 및 기타 클레임을 확인할 수 있습니다. 이 정보를 기반으로 실행 가능한 이미지를 클러스터 전체 정책과 일치하는 이미지로 제한할 수 있습니다. 필수 필드는 이미지 확인을 수행하는 클라이언트가 구문 분석해야 합니다. 다른 하나는 서버에 의해 서명의 콘텐츠에서 구문 분석됩니다. 이는 유익한 목적으로만 사용됩니다.
호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
- 필수 항목
-
type
-
콘텐츠
-
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| 조건은 서명의 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다. |
|
| SignatureCondition은 특정 프로브 시간에 특정 종류의 이미지 서명 조건을 설명합니다. |
|
| 필수: 이미지의 서명인 불투명 바이너리 문자열입니다. |
| 지정된 경우 서명 생성 시간입니다. | |
|
| 이미지의 ID를 나타내는 사람이 읽을 수 있는 문자열입니다. 제품 이름 및 버전 또는 이미지 가져오기 사양(예: "registry.access.redhat.com/rhel7/rhel:7.2")일 수 있습니다. |
|
| SignatureIssuer는 서명 인증서 또는 키 발행자에 대한 정보를 보관합니다. |
|
| SignatureSubject는 서명을 만든 사람 또는 엔티티에 대한 정보를 보유합니다. |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 메타데이터는 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| 서명의 클레임을 포함합니다. |
|
| 필수: 저장된 Blob 유형을 설명합니다. |
10.1.8. .image.signatures[].conditions
- 설명
- 조건은 서명의 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다.
- 유형
-
array
10.1.9. .image.signatures[].conditions[]
- 설명
- SignatureCondition은 특정 프로브 시간에 특정 종류의 이미지 서명 조건을 설명합니다.
- 유형
-
object
- 필수 항목
-
type
-
status
-
속성 | 유형 | 설명 |
---|---|---|
| 조건을 마지막으로 확인한 시간입니다. | |
| 상태가 다른 상태에서 다른 상태로 전환되는 마지막 시간입니다. | |
|
| 마지막 전환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다. |
|
| 조건의 마지막 전환 이유 |
|
| 조건의 상태, True, False, 알 수 없음. |
|
| 서명 조건 유형, 완료 또는 실패. |
10.1.10. .image.signatures[].issuedBy
- 설명
- SignatureIssuer는 서명 인증서 또는 키 발행자에 대한 정보를 보관합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 일반 이름(예: openshift-signing-service) |
|
| 조직 이름. |
10.1.11. .image.signatures[].issuedTo
- 설명
- SignatureSubject는 서명을 만든 사람 또는 엔티티에 대한 정보를 보유합니다.
- 유형
-
object
- 필수 항목
-
publicKeyID
-
속성 | 유형 | 설명 |
---|---|---|
|
| 일반 이름(예: openshift-signing-service) |
|
| 조직 이름. |
|
| 존재하는 경우 이미지 서명을 확인하는 데 사용되는 주체에 속하는 공개 키의 사람이 읽을 수 있는 키 ID입니다. 공개 키 지문(예: 0x685ebe62bf278440)의 최소 64비트를 포함해야 합니다. |
10.1.12. .spec
- 설명
- TagReference는 이 태그를 사용하는 이미지의 선택적 주석과 이 태그가 추적해야 하는 ImageStreamTag, ImageStreamImage 또는 DockerImage에 대한 선택적 참조를 지정합니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택 사항. 지정된 경우 ImageStreamTags를 통해 검색된 이미지에 적용되는 주석입니다. |
| 선택 사항. 지정된 경우 이 태그가 가리켜야 하는 다른 이미지에 대한 참조입니다. 유효한 값은 ImageStreamTag, ImageStreamImage, DockerImage입니다. imagestreamtag 참조는 이 동일한 ImageStream 내의 태그만 참조할 수 있습니다. | |
|
| generation은 spec 태그(사용자 의도)로 변경되는 것을 추적하는 카운터입니다. 태그 참조가 변경되면 생성이 현재 스트림 생성(spec이 변경될 때마다 증가됨)과 일치하도록 설정됩니다. 이미지 가져오기와 같은 시스템의 다른 프로세스는 spec 태그 생성이 상태에 기록된 생성보다 최신임을 확인하고 이를 트리거로 사용하여 최신 원격 태그를 가져옵니다. 새 가져오기를 트리거하기 위해 클라이언트는 이 값을 0으로 설정하여 생성을 최신 스트림 생성으로 재설정할 수 있습니다. 레거시 클라이언트는 이 값을 현재 태그 생성과 병합할 nil로 보냅니다. |
|
| TagImportPolicy는 이 태그와 관련된 이미지를 가져오는 방법을 제어합니다. |
|
| 태그 이름 |
|
| 태그를 가져올 경우 참조 상태입니다. 기본값은 false입니다. 즉, 태그를 가져옵니다. |
|
| TagReferencePolicy는 배포 구성 또는 빌드에서 이미지 변경 트리거가 해결될 때 이 이미지 스트림 태그의 이미지 가져오기를 생성하는 방법을 설명합니다. 이를 통해 이미지 스트림 작성자는 이미지에 액세스하는 방법을 제어할 수 있습니다. |
10.1.13. .spec.importPolicy
- 설명
- TagImportPolicy는 이 태그와 관련된 이미지를 가져오는 방법을 제어합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| importMode는 이미지 매니페스트를 가져오는 방법을 설명합니다. |
|
| 서버가 인증서 확인을 바이패스하거나 이미지 가져오기 중에 HTTP를 통해 직접 연결할 수 있는 경우 insecure는 True입니다. |
|
| Scheduled는 이 태그가 최신 상태인지 확인하고 가져오는 데 주기적으로 확인해야 함을 서버에 나타냅니다. |
10.1.14. .spec.referencePolicy
- 설명
- TagReferencePolicy는 배포 구성 또는 빌드에서 이미지 변경 트리거가 해결될 때 이 이미지 스트림 태그의 이미지 가져오기를 생성하는 방법을 설명합니다. 이를 통해 이미지 스트림 작성자는 이미지에 액세스하는 방법을 제어할 수 있습니다.
- 유형
-
object
- 필수 항목
-
type
-
속성 | 유형 | 설명 |
---|---|---|
|
|
type은 이미지 스트림 태그가 배포 구성 트리거 또는 새 빌드에 사용될 때 이미지 가져오기 사양을 변환하는 방법을 결정합니다. 기본값은 |
10.1.15. .status
- 설명
- NamedTagEventList는 태그와 해당 이미지 기록과 관련이 있습니다.
- 유형
-
object
- 필수 항목
-
tag
-
items
-
속성 | 유형 | 설명 |
---|---|---|
|
| conditions는 태그 이벤트 목록에 적용되는 조건의 배열입니다. |
|
| TagEventCondition에는 태그 이벤트에 대한 조건 정보가 포함되어 있습니다. |
|
| 표준 오브젝트의 메타데이터입니다. |
|
| TagEvent는 ImageStreamStatus에서 태그와 연결된 이미지의 기록 레코드를 유지하는 데 사용됩니다. |
|
| tag는 기록이 기록된 태그입니다. |
10.1.16. .status.conditions
- 설명
- conditions는 태그 이벤트 목록에 적용되는 조건의 배열입니다.
- 유형
-
array
10.1.17. .status.conditions[]
- 설명
- TagEventCondition에는 태그 이벤트에 대한 조건 정보가 포함되어 있습니다.
- 유형
-
object
- 필수 항목
-
type
-
status
-
생성
-
속성 | 유형 | 설명 |
---|---|---|
|
| generation은 이 상태가 해당하는 사양 태그 생성입니다. |
| LastTransitionTIme는 조건이 한 상태에서 다른 상태로 전환된 시간입니다. | |
|
| message는 마지막 전환에 대한 세부 정보에 대해 사람이 읽을 수 있는 설명으로, 이유를 보완합니다. |
|
| 이유는 조건의 마지막 전환에 대한 간단한 머신에서 읽을 수 있는 설명입니다. |
|
| 조건의 상태, True, False, 알 수 없음. |
|
| 태그 이벤트 조건 유형, 현재 ImportSuccess만 사용 |
10.1.18. .status.items
- 설명
- 표준 오브젝트의 메타데이터입니다.
- 유형
-
array
10.1.19. .status.items[]
- 설명
- TagEvent는 ImageStreamStatus에서 태그와 연결된 이미지의 기록 레코드를 유지하는 데 사용됩니다.
- 유형
-
object
- 필수 항목
-
created
-
dockerImageReference
-
image
-
생성
-
속성 | 유형 | 설명 |
---|---|---|
| created는 TagEvent가 생성된 시간을 보유합니다. | |
|
| DockerImageReference는 이 이미지를 가져오는 데 사용할 수 있는 문자열입니다. |
|
| generation은 이 태그가 업데이트되는 사양 태그 생성입니다. |
|
| 이미지는 이미지입니다. |