8장. ImageStream [image.openshift.io/v1]


설명

ImageStream은 이미지에 대한 태그 매핑, 스트림에 이미지가 태그될 때 적용되는 메타데이터 덮어쓰기 및 레지스트리의 컨테이너 이미지 리포지토리에 대한 선택적 참조를 저장합니다. 일반적으로 spec.tags 필드를 업데이트하여 가져오기 보안 유형이 있는 네임스페이스의 인증 정보를 사용하여 컨테이너 레지스트리에서 가져온 외부 이미지를 가리키거나 태그 지정 또는 가져오기에 즉시 액세스할 수 있는 기존 이미지 스트림 태그 및 이미지를 가리킵니다. 태그에 적용된 이미지 기록은 status.tags 필드에 표시되고 이미지 스트림을 볼 수 있는 모든 사용자는 해당 이미지를 자체 이미지 스트림에 태그할 수 있습니다. 통합 레지스트리에서 이미지 가져오기 액세스는 지정된 이미지 스트림에 대한 "get imagestreams/layers" 권한을 보유하여 부여됩니다. 사용자는 imagestreamtag 리소스를 삭제하여 태그를 제거할 수 있으므로 해당 태그의 사양과 상태가 모두 제거됩니다. 이미지 스트림 기록은 관리자가 정리 작업을 실행할 때까지 유지되며 더 이상 사용되지 않는 참조를 제거합니다. 기록 이미지를 보존하려면 다이제스트를 통해 해당 이미지를 가리키는 spec에 태그가 있는지 확인합니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형
object

8.1. 사양

속성유형설명

apiVersion

string

APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

string

kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

메타데이터

ObjectMeta_v2

메타데이터는 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

ImageStreamSpec은 ImageStreams의 옵션을 나타냅니다.

status

object

ImageStreamStatus에는 이 이미지 스트림의 상태에 대한 정보가 포함되어 있습니다.

8.1.1. .spec

설명
ImageStreamSpec은 ImageStreams의 옵션을 나타냅니다.
유형
object
속성유형설명

dockerImageRepository

string

dockerImageRepository는 선택 사항입니다. 이 스트림을 이 서버의 컨테이너 리포지토리에서 지원하는 경우 이 필드는 v3.7에서 더 이상 사용되지 않으며 향후 릴리스에서 제거됩니다. 대신 spec.tags.from 참조를 통해 각 태그에서 가져올 태그의 소스를 지정합니다.

lookupPolicy

object

ImageLookupPolicy는 이미지 스트림을 사용하여 네임스페이스의 Pod, 빌드 및 기타 리소스에서 사용하는 이미지 참조를 재정의하는 방법을 설명합니다.

tags

array

태그는 임의의 문자열 값을 특정 이미지에 매핑합니다.

tags[]

object

TagReference는 이 태그를 사용하는 이미지의 선택적 주석과 이 태그가 추적해야 하는 ImageStreamTag, ImageStreamImage 또는 DockerImage에 대한 선택적 참조를 지정합니다.

8.1.2. .spec.lookupPolicy

설명
ImageLookupPolicy는 이미지 스트림을 사용하여 네임스페이스의 Pod, 빌드 및 기타 리소스에서 사용하는 이미지 참조를 재정의하는 방법을 설명합니다.
유형
object
필수 항목
  • 로컬
속성유형설명

로컬

boolean

local은 이 네임스페이스의 오브젝트에서 docker 단축 이미지 참조("mysql" 또는 "php:latest")를 원격 레지스트리에 도달하는 대신 이 이미지 스트림과 일치시킬 때마다 이미지 ID로 변경합니다. 발견되면 해당 이름이 이미지 ID에 대해 정규화된 상태가 됩니다. 교체된 값에 대한 태그의 referencePolicy가 고려됩니다. 현재 네임스페이스 내에서만 작동합니다.

8.1.3. .spec.tags

설명
태그는 임의의 문자열 값을 특정 이미지에 매핑합니다.
유형
array

8.1.4. .spec.tags[]

설명
TagReference는 이 태그를 사용하는 이미지의 선택적 주석과 이 태그가 추적해야 하는 ImageStreamTag, ImageStreamImage 또는 DockerImage에 대한 선택적 참조를 지정합니다.
유형
object
필수 항목
  • name
속성유형설명

annotations

오브젝트(문자열)

선택 사항. 지정된 경우 ImageStreamTags를 통해 검색된 이미지에 적용되는 주석입니다.

from

ObjectReference

선택 사항. 지정된 경우 이 태그가 가리켜야 하는 다른 이미지에 대한 참조입니다. 유효한 값은 ImageStreamTag, ImageStreamImage, DockerImage입니다. imagestreamtag 참조는 이 동일한 ImageStream 내의 태그만 참조할 수 있습니다.

생성

integer

generation은 spec 태그(사용자 의도)로 변경되는 것을 추적하는 카운터입니다. 태그 참조가 변경되면 생성이 현재 스트림 생성(spec이 변경될 때마다 증가됨)과 일치하도록 설정됩니다. 이미지 가져오기와 같은 시스템의 다른 프로세스는 spec 태그 생성이 상태에 기록된 생성보다 최신임을 확인하고 이를 트리거로 사용하여 최신 원격 태그를 가져옵니다. 새 가져오기를 트리거하기 위해 클라이언트는 이 값을 0으로 설정하여 생성을 최신 스트림 생성으로 재설정할 수 있습니다. 레거시 클라이언트는 이 값을 현재 태그 생성과 병합할 nil로 보냅니다.

importPolicy

object

TagImportPolicy는 이 태그와 관련된 이미지를 가져오는 방법을 제어합니다.

name

string

태그 이름

reference

boolean

태그를 가져올 경우 참조 상태입니다. 기본값은 false입니다. 즉, 태그를 가져옵니다.

referencePolicy

object

TagReferencePolicy는 배포 구성 또는 빌드에서 이미지 변경 트리거가 해결될 때 이 이미지 스트림 태그의 이미지 가져오기를 생성하는 방법을 설명합니다. 이를 통해 이미지 스트림 작성자는 이미지에 액세스하는 방법을 제어할 수 있습니다.

8.1.5. .spec.tags[].importPolicy

설명
TagImportPolicy는 이 태그와 관련된 이미지를 가져오는 방법을 제어합니다.
유형
object
속성유형설명

importMode

string

importMode는 이미지 매니페스트를 가져오는 방법을 설명합니다.

insecure

boolean

서버가 인증서 확인을 바이패스하거나 이미지 가져오기 중에 HTTP를 통해 직접 연결할 수 있는 경우 insecure는 True입니다.

Scheduled

boolean

Scheduled는 이 태그가 최신 상태인지 확인하고 가져오는 데 주기적으로 확인해야 함을 서버에 나타냅니다.

8.1.6. .spec.tags[].referencePolicy

설명
TagReferencePolicy는 배포 구성 또는 빌드에서 이미지 변경 트리거가 해결될 때 이 이미지 스트림 태그의 이미지 가져오기를 생성하는 방법을 설명합니다. 이를 통해 이미지 스트림 작성자는 이미지에 액세스하는 방법을 제어할 수 있습니다.
유형
object
필수 항목
  • type
속성유형설명

type

string

type은 이미지 스트림 태그가 배포 구성 트리거 또는 새 빌드에 사용될 때 이미지 가져오기 사양을 변환하는 방법을 결정합니다. 기본값은 Source 이며 이미지의 원래 위치를 사용해야 함을 나타냅니다(가져 있는 경우). 또한 사용자는 Local 을 지정하여 가져오기 사양이 통합된 컨테이너 이미지 레지스트리를 가리키며 레지스트리의 가져오기를 업스트림 레지스트리로 프록시하는 기능을 활용할 수도 있습니다. 로컬 에서는 이 이미지를 가져오는 데 사용되는 인증 정보를 이미지 스트림의 네임스페이스에서 관리할 수 있으므로 플랫폼의 다른 사용자는 원격 이미지에 액세스할 수 있지만 원격 시크릿에 액세스할 수 없습니다. 또한 이미지 계층을 업스트림 레지스트리를 사용할 수 없는 경우에도 이미지를 가져올 수 있는 로컬 레지스트리에 미러링할 수 있습니다.

8.1.7. .status

설명
ImageStreamStatus에는 이 이미지 스트림의 상태에 대한 정보가 포함되어 있습니다.
유형
object
필수 항목
  • dockerImageRepository
속성유형설명

dockerImageRepository

string

DockerImageRepository는 이 스트림에 액세스할 수 있는 효과적인 위치를 나타냅니다. 서버가 리포지토리가 있는 위치를 결정할 때까지 비어 있을 수 있습니다.

publicDockerImageRepository

string

publicDockerImageRepository는 클러스터 외부에서 이미지를 가져올 수 있는 공용 위치를 나타냅니다. 관리자가 통합 레지스트리를 외부에 노출하지 않은 경우 이 필드가 비어 있을 수 있습니다.

tags

array

태그는 각 태그와 연결된 이미지의 기록 레코드입니다. TagEvent 배열의 첫 번째 항목은 현재 태그가 지정된 이미지입니다.

tags[]

object

NamedTagEventList는 태그와 해당 이미지 기록과 관련이 있습니다.

8.1.8. .status.tags

설명
태그는 각 태그와 연결된 이미지의 기록 레코드입니다. TagEvent 배열의 첫 번째 항목은 현재 태그가 지정된 이미지입니다.
유형
array

8.1.9. .status.tags[]

설명
NamedTagEventList는 태그와 해당 이미지 기록과 관련이 있습니다.
유형
object
필수 항목
  • tag
  • items
속성유형설명

conditions

array

conditions는 태그 이벤트 목록에 적용되는 조건의 배열입니다.

conditions[]

object

TagEventCondition에는 태그 이벤트에 대한 조건 정보가 포함되어 있습니다.

items

array

표준 오브젝트의 메타데이터입니다.

items[]

object

TagEvent는 ImageStreamStatus에서 태그와 연결된 이미지의 기록 레코드를 유지하는 데 사용됩니다.

tag

string

tag는 기록이 기록된 태그입니다.

8.1.10. .status.tags[].conditions

설명
conditions는 태그 이벤트 목록에 적용되는 조건의 배열입니다.
유형
array

8.1.11. .status.tags[].conditions[]

설명
TagEventCondition에는 태그 이벤트에 대한 조건 정보가 포함되어 있습니다.
유형
object
필수 항목
  • type
  • status
  • 생성
속성유형설명

생성

integer

generation은 이 상태가 해당하는 사양 태그 생성입니다.

lastTransitionTime

시간

LastTransitionTIme는 조건이 한 상태에서 다른 상태로 전환된 시간입니다.

message

string

message는 마지막 전환에 대한 세부 정보에 대해 사람이 읽을 수 있는 설명으로, 이유를 보완합니다.

reason

string

이유는 조건의 마지막 전환에 대한 간단한 머신에서 읽을 수 있는 설명입니다.

status

string

조건의 상태, True, False, 알 수 없음.

type

string

태그 이벤트 조건 유형, 현재 ImportSuccess만 사용

8.1.12. .status.tags[].items

설명
표준 오브젝트의 메타데이터입니다.
유형
array

8.1.13. .status.tags[].items[]

설명
TagEvent는 ImageStreamStatus에서 태그와 연결된 이미지의 기록 레코드를 유지하는 데 사용됩니다.
유형
object
필수 항목
  • created
  • dockerImageReference
  • image
  • 생성
속성유형설명

created

시간

created는 TagEvent가 생성된 시간을 보유합니다.

dockerImageReference

string

DockerImageReference는 이 이미지를 가져오는 데 사용할 수 있는 문자열입니다.

생성

integer

generation은 이 태그가 업데이트되는 사양 태그 생성입니다.

image

string

이미지는 이미지입니다.

Red Hat logoGithubRedditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

© 2024 Red Hat, Inc.