6장. 이미지 스트림 관리
컨테이너 이미지를 생성 및 업데이트하고 OpenShift Container Platform의 버전 변경 사항을 추적하려면 이미지 스트림 및 태그를 사용할 수 있습니다. 이미지 스트림 태그를 추가, 업데이트, 제거 및 가져와서 컨테이너 이미지를 관리합니다.
6.1. 이미지 스트림 사용 링크 복사링크가 클립보드에 복사되었습니다!
이미지 스트림은 OpenShift Container Platform 내에서 컨테이너 이미지를 참조하는 데 필요한 추상화를 제공합니다. 이미지 스트림을 사용하여 이미지 버전을 관리하고 클러스터의 빌드 및 배포를 자동화할 수 있습니다.
이미지 스트림에는 실제 이미지 데이터가 포함되어 있지 않지만 이미지 리포지터리와 유사하게 관련 이미지에 대한 단일 가상 뷰가 있습니다.
새 이미지가 추가되는 경우 이미지 스트림의 알림을 보고 빌드 또는 배포를 각각 수행하여 대응하도록 빌드 및 배포를 구성할 수 있습니다.
예를 들어 배포에서 특정 이미지를 사용하고 있는데 해당 이미지의 새 버전이 생성되는 경우 배포가 자동으로 수행되어 새 버전의 이미지를 가져올 수 있습니다.
하지만 배포 또는 빌드에서 사용하는 이미지 스트림 태그가 업데이트되지 않으면 컨테이너 이미지 레지스트리의 컨테이너 이미지가 업데이트되어도 빌드 또는 배포에서는 알려진 정상 이미지인 이전 이미지를 계속 사용합니다.
소스 이미지를 저장할 수 있는 위치는 다음과 같습니다.
- OpenShift Container Platform 통합 레지스트리
- 외부 레지스트리(예: registry.redhat.io 또는 quay.io)
- OpenShift Container Platform 클러스터의 다른 이미지 스트림
이미지 스트림 태그를 참조하는 오브젝트(예: 빌드 또는 배포 구성)를 정의할 때 리포지터리가 아닌 이미지 스트림 태그를 가리킵니다. 애플리케이션을 빌드하거나 배포할 때 OpenShift Container Platform은 이 이미지 스트림 태그로 리포지터리를 조회하여 관련된 이미지 ID를 찾은 후 바로 그 이미지를 사용합니다.
이미지 스트림 메타데이터는 다른 클러스터 정보와 함께 etcd 인스턴스에 저장됩니다.
이미지 스트림을 사용하면 다음과 같은 여러 중요한 이점이 있습니다.
- 명령줄을 사용하여 다시 푸시하지 않고도 태그하고, 태그를 롤백하고, 이미지를 빠르게 처리할 수 있습니다.
- 새 이미지가 레지스트리로 푸시되면 빌드 및 배포를 트리거할 수 있습니다. OpenShift Container Platform에는 Kubernetes 오브젝트 등 다른 리소스에 대한 일반 트리거도 있습니다.
- 정기적인 다시 가져오기를 위해 태그를 표시할 수 있습니다. 소스 이미지가 변경되면 해당 변경 사항이 이미지 스트림에 반영되고, 이후 빌드 또는 배포 구성에 따라 빌드 및/또는 배포 흐름이 트리거됩니다.
- 세분화된 액세스 제어를 사용하여 이미지를 공유하고 팀 전체에 이미지를 빠르게 배포할 수 있습니다.
- 소스 이미지가 변경되면 이미지 스트림 태그는 여전히 알려진 양호한 버전의 이미지를 가리키므로 애플리케이션이 예기치 않게 손상되지 않도록 합니다.
- 이미지 스트림 오브젝트에 대한 권한을 통해 이미지를 보고 사용할 수 있는 사람에 대한 보안을 구성할 수 있습니다.
- 클러스터 수준에서 이미지를 읽거나 나열할 수 있는 권한이 없는 사용자도 이미지 스트림을 사용하여 프로젝트의 태그된 이미지를 검색할 수 있습니다.
6.2. 이미지 스트림 구성 링크 복사링크가 클립보드에 복사되었습니다!
애플리케이션에 대한 이미지 검색 및 보안 정책을 사용자 지정하려면 OpenShift Container Platform 내에서 이미지 스트림을 구성합니다. 이 프로세스를 통해 이미지 가져오기 사양을 정의하고, 태그를 관리하고, 안정적인 애플리케이션 배포에 필요한 액세스 권한을 제어할 수 있습니다.
ImageStream 오브젝트 파일에는 다음 요소가 포함되어 있습니다.
이미지 스트림 오브젝트 정의
apiVersion: image.openshift.io/v1
kind: ImageStream
metadata:
annotations:
openshift.io/generated-by: OpenShiftNewApp
labels:
app: ruby-sample-build
template: application-template-stibuild
name: origin-ruby-sample
namespace: test
spec: {}
status:
dockerImageRepository: 172.30.56.218:5000/test/origin-ruby-sample
tags:
- items:
- created: 2017-09-02T10:15:09Z
dockerImageReference: 172.30.56.218:5000/test/origin-ruby-sample@sha256:47463d94eb5c049b2d23b03a9530bf944f8f967a0fe79147dd6b9135bf7dd13d
generation: 2
image: sha256:909de62d1f609a717ec433cc25ca5cf00941545c83a01fb31527771e1fab3fc5
- created: 2017-09-01T13:40:11Z
dockerImageReference: 172.30.56.218:5000/test/origin-ruby-sample@sha256:909de62d1f609a717ec433cc25ca5cf00941545c83a01fb31527771e1fab3fc5
generation: 1
image: sha256:47463d94eb5c049b2d23b03a9530bf944f8f967a0fe79147dd6b9135bf7dd13d
tag: latest
다음과 같습니다.
name- 이미지 스트림의 이름을 지정합니다.
ruby-sample- 이 이미지 스트림에서 이미지를 추가하거나 업데이트하기 위해 새 이미지를 푸시할 수 있는 Docker 리포지토리 경로를 지정합니다.
dockerImageReference- 이 이미지 스트림 태그가 현재 참조하는 SHA 식별자를 지정합니다. 이 이미지 스트림 태그를 참조하는 리소스는 이 식별자를 사용합니다.
image- 이 이미지 스트림 태그가 이전에 참조한 SHA 식별자를 지정합니다. 이를 사용하여 이전 이미지로 롤백할 수 있습니다.
tag- 이미지 스트림 태그 이름을 지정합니다.
6.3. 이미지 스트림 이미지 링크 복사링크가 클립보드에 복사되었습니다!
특정 태그와 관련된 실제 이미지 콘텐츠를 정확하게 식별하고 관리하려면 OpenShift Container Platform에서 이미지 스트림 이미지를 참조 및 사용합니다. 이를 통해 애플리케이션 배포가 변경 불가능한 이미지 정의를 안정적으로 대상으로 할 수 있습니다.
이미지 스트림 이미지는 이미지 스트림 내에서 특정 이미지 ID를 가리킵니다.
이미지 스트림 이미지를 사용하면 태그된 특정 이미지 스트림에서 이미지에 대한 메타데이터를 검색할 수 있습니다.
이미지 스트림 이미지 오브젝트는 이미지 스트림으로 이미지를 가져오거나 태그할 때마다 OpenShift Container Platform에서 자동으로 생성됩니다. 이미지 스트림을 생성하는 데 사용하는 이미지 스트림 정의에서는 이미지 스트림 태그 오브젝트를 명시적으로 정의할 필요가 없습니다.
이미지 스트림 이미지는 리포지터리의 이미지 스트림 이름과 이미지 ID로 구성됩니다. 이름 및 ID는 @ 기호로 구분됩니다.
<image-stream-name>@<image-id>
ImageStream 개체 예의 이미지를 참조하려면 이미지 스트림 이미지가 다음과 유사해야 합니다.
origin-ruby-sample@sha256:47463d94eb5c049b2d23b03a9530bf944f8f967a0fe79147dd6b9135bf7dd13d
6.4. 이미지 스트림 태그 링크 복사링크가 클립보드에 복사되었습니다!
변경 불가능한 이미지에 대한 사람이 읽을 수 있는 참조를 유지하려면 OpenShift Container Platform 내에서 이미지 스트림 태그를 사용하십시오. 이러한 태그는 빌드 및 배포가 특정 안정적인 이미지 콘텐츠를 정확하게 대상으로 지정할 수 있기 때문에 중요합니다.
이미지 스트림 태그는 이미지 스트림의 이미지에 대한 이름 지정된 포인터입니다. istag로 축약됩니다. 이미지 스트림 태그는 지정된 이미지 스트림 및 태그의 이미지를 참조하거나 검색하는 데 사용됩니다.
이미지 스트림 태그는 로컬 또는 외부 관리 이미지를 참조할 수 있습니다. 태그가 가리켰던 모든 이미지의 스택으로 표시되는 이미지 기록이 이미지 스트림 태그에 포함되어 있습니다. 새 이미지 또는 기존 이미지에 특정 이미지 스트림 태그 아래에 태그를 지정할 때마다 기록 스택의 첫 번째 위치에 배치됩니다. 이전에 맨 위 위치를 차지했던 이미지는 두 번째 위치에서 사용할 수 있습니다. 이렇게 하면 태그가 다시 과거 이미지를 가리키도록 손쉽게 롤백할 수 있습니다.
다음 이미지 스트림 태그는 ImageStream 오브젝트에서 가져온 것입니다.
기록에 두 개의 이미지가 있는 이미지 스트림 태그
kind: ImageStream
apiVersion: image.openshift.io/v1
metadata:
name: my-image-stream
# ...
tags:
- items:
- created: 2017-09-02T10:15:09Z
dockerImageReference: 172.30.56.218:5000/test/origin-ruby-sample@sha256:47463d94eb5c049b2d23b03a9530bf944f8f967a0fe79147dd6b9135bf7dd13d
generation: 2
image: sha256:909de62d1f609a717ec433cc25ca5cf00941545c83a01fb31527771e1fab3fc5
- created: 2017-09-01T13:40:11Z
dockerImageReference: 172.30.56.218:5000/test/origin-ruby-sample@sha256:909de62d1f609a717ec433cc25ca5cf00941545c83a01fb31527771e1fab3fc5
generation: 1
image: sha256:47463d94eb5c049b2d23b03a9530bf944f8f967a0fe79147dd6b9135bf7dd13d
tag: latest
# ...
이미지 스트림 태그는 영구 태그일 수도 있고 추적 태그일 수도 있습니다.
- 영구 태그는 Python 3.5 같은 특정 버전의 이미지를 가리키는 버전 특정 태그입니다.
추적 태그는 다른 이미지 스트림 태그를 따르는 참조 태그이며, symlink와 매우 비슷하게 나중에 이 태그를 업데이트하여 따를 이미지를 변경할 수 있습니다. 이러한 새 수준은 이전 버전과 호환되지 않을 수 있습니다.
예를 들어 OpenShift Container Platform과 함께 제공되는
latest이미지 스트림 태그는 추적 태그입니다. 즉,latest이미지 스트림 태그 사용자는 새로운 수준을 사용할 수 있게 되면 이미지에서 제공하는 프레임워크의 최신 수준으로 업데이트됩니다.v3.10에 대한latest이미지 스트림 태그는 언제든v3.11로 변경될 수 있습니다. 이러한latest이미지 스트림 태그는 Dockerlatest태그와 다르게 동작한다는 사실을 알고 있는 것이 중요합니다. Docker의 경우latest이미지 스트림 태그가 Docker 리포지터리의 최신 이미지를 가리키지 않습니다. 다른 이미지 스트림 태그를 가리키며, 이것은 이미지의 최신 버전이 아닐 수도 있습니다. 예를 들어latest이미지 스트림 태그가 이미지의v3.10을 가리키는 경우3.11버전이 릴리스되면latest태그가v3.11로 자동 업데이트되지 않고v3.11이미지 스트림 태그를 가리키도록 수동 업데이트될 때까지v3.10으로 남아 있습니다.참고추적 태그는 단일 이미지 스트림으로 제한되며 다른 이미지 스트림을 참조할 수 없습니다.
고유한 요구 사항에 맞게 자체 이미지 스트림 태그를 생성할 수 있습니다.
이미지 스트림 태그는 콜론으로 구분된 이미지 스트림 이름 및 태그로 구성됩니다.
<imagestream name>:<tag>
예를 들어 앞의 ImageStream 오브젝트 예에 있는 sha256:47463d94eb5c049b2d23b03a9530bf944f8f967a0fe79147dd6b9135bf7dd13d 이미지를 참조하려면 이미지 스트림 태그는 다음과 같습니다.
origin-ruby-sample:latest
6.5. 이미지 스트림 변경 트리거 링크 복사링크가 클립보드에 복사되었습니다!
애플리케이션 라이프사이클을 자동화하고 최신 코드를 사용하려면 OpenShift Container Platform에서 이미지 스트림 트리거를 구성합니다. 이미지 스트림 트리거를 사용하면 새 버전의 업스트림 이미지가 준비될 때 빌드 및 배포가 자동으로 호출됩니다.
예를 들어 이미지 스트림 태그가 수정되면 빌드 및 배포를 자동으로 시작할 수 있습니다. 이 과정은 해당하는 특정 이미지 스트림 태그를 모니터링하다가 변경이 탐지되면 빌드 또는 배포에 알리는 방식으로 이루어집니다.
6.6. 이미지 스트림 매핑 링크 복사링크가 클립보드에 복사되었습니다!
이미지 스트림 매핑을 이해하여 OpenShift Container Platform에서 새로 업로드된 이미지를 추적하는 방법을 관리합니다. 통합 레지스트리에서 새 이미지를 수신하면 이미지 스트림 매핑을 자동으로 생성 및 보내 이미지의 중요한 프로젝트, 이름, 태그 및 메타데이터를 제공합니다.
이미지 스트림 매핑 구성은 고급 기능입니다.
이러한 정보는 새 이미지를 생성하고(아직 없는 경우) 이미지를 이미지 스트림에 태그하는 데 사용됩니다. OpenShift Container Platform은 명령, 진입점, 환경 변수 등 각 이미지에 대한 완전한 메타데이터를 저장합니다. OpenShift Container Platform의 이미지는 변경 불가능하며 이름의 최대 길이는 63자입니다.
다음 이미지 스트림 매핑 예에서는 test/origin-ruby-sample:latest로 이미지가 태그됩니다.
이미지 스트림 매핑 오브젝트 정의
apiVersion: image.openshift.io/v1
kind: ImageStreamMapping
metadata:
creationTimestamp: null
name: origin-ruby-sample
namespace: test
tag: latest
image:
dockerImageLayers:
- name: sha256:5f70bf18a086007016e948b04aed3b82103a36bea41755b6cddfaf10ace3c6ef
size: 0
- name: sha256:ee1dd2cb6df21971f4af6de0f1d7782b81fb63156801cfde2bb47b4247c23c29
size: 196634330
- name: sha256:5f70bf18a086007016e948b04aed3b82103a36bea41755b6cddfaf10ace3c6ef
size: 0
- name: sha256:5f70bf18a086007016e948b04aed3b82103a36bea41755b6cddfaf10ace3c6ef
size: 0
- name: sha256:ca062656bff07f18bff46be00f40cfbb069687ec124ac0aa038fd676cfaea092
size: 177723024
- name: sha256:63d529c59c92843c395befd065de516ee9ed4995549f8218eac6ff088bfa6b6e
size: 55679776
- name: sha256:92114219a04977b5563d7dff71ec4caa3a37a15b266ce42ee8f43dba9798c966
size: 11939149
dockerImageMetadata:
Architecture: amd64
Config:
Cmd:
- /usr/libexec/s2i/run
Entrypoint:
- container-entrypoint
Env:
- RACK_ENV=production
- OPENSHIFT_BUILD_NAMESPACE=test
- OPENSHIFT_BUILD_SOURCE=https://github.com/openshift/ruby-hello-world.git
- EXAMPLE=sample-app
- OPENSHIFT_BUILD_NAME=ruby-sample-build-1
- PATH=/opt/app-root/src/bin:/opt/app-root/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
- STI_SCRIPTS_URL=image:///usr/libexec/s2i
- STI_SCRIPTS_PATH=/usr/libexec/s2i
- HOME=/opt/app-root/src
- BASH_ENV=/opt/app-root/etc/scl_enable
- ENV=/opt/app-root/etc/scl_enable
- PROMPT_COMMAND=. /opt/app-root/etc/scl_enable
- RUBY_VERSION=2.2
ExposedPorts:
8080/tcp: {}
Labels:
build-date: 2015-12-23
io.k8s.description: Platform for building and running Ruby 2.2 applications
io.k8s.display-name: 172.30.56.218:5000/test/origin-ruby-sample:latest
io.openshift.build.commit.author: Ben Parees <bparees@users.noreply.github.com>
io.openshift.build.commit.date: Wed Jan 20 10:14:27 2016 -0500
io.openshift.build.commit.id: 00cadc392d39d5ef9117cbc8a31db0889eedd442
io.openshift.build.commit.message: 'Merge pull request #51 from php-coder/fix_url_and_sti'
io.openshift.build.commit.ref: master
io.openshift.build.image: centos/ruby-22-centos7@sha256:3a335d7d8a452970c5b4054ad7118ff134b3a6b50a2bb6d0c07c746e8986b28e
io.openshift.build.source-location: https://github.com/openshift/ruby-hello-world.git
io.openshift.builder-base-version: 8d95148
io.openshift.builder-version: 8847438ba06307f86ac877465eadc835201241df
io.openshift.s2i.scripts-url: image:///usr/libexec/s2i
io.openshift.tags: builder,ruby,ruby22
io.s2i.scripts-url: image:///usr/libexec/s2i
license: GPLv2
name: CentOS Base Image
vendor: CentOS
User: "1001"
WorkingDir: /opt/app-root/src
Container: 86e9a4a3c760271671ab913616c51c9f3cea846ca524bf07c04a6f6c9e103a76
ContainerConfig:
AttachStdout: true
Cmd:
- /bin/sh
- -c
- tar -C /tmp -xf - && /usr/libexec/s2i/assemble
Entrypoint:
- container-entrypoint
Env:
- RACK_ENV=production
- OPENSHIFT_BUILD_NAME=ruby-sample-build-1
- OPENSHIFT_BUILD_NAMESPACE=test
- OPENSHIFT_BUILD_SOURCE=https://github.com/openshift/ruby-hello-world.git
- EXAMPLE=sample-app
- PATH=/opt/app-root/src/bin:/opt/app-root/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
- STI_SCRIPTS_URL=image:///usr/libexec/s2i
- STI_SCRIPTS_PATH=/usr/libexec/s2i
- HOME=/opt/app-root/src
- BASH_ENV=/opt/app-root/etc/scl_enable
- ENV=/opt/app-root/etc/scl_enable
- PROMPT_COMMAND=. /opt/app-root/etc/scl_enable
- RUBY_VERSION=2.2
ExposedPorts:
8080/tcp: {}
Hostname: ruby-sample-build-1-build
Image: centos/ruby-22-centos7@sha256:3a335d7d8a452970c5b4054ad7118ff134b3a6b50a2bb6d0c07c746e8986b28e
OpenStdin: true
StdinOnce: true
User: "1001"
WorkingDir: /opt/app-root/src
Created: 2016-01-29T13:40:00Z
DockerVersion: 1.8.2.fc21
Id: 9d7fd5e2d15495802028c569d544329f4286dcd1c9c085ff5699218dbaa69b43
Parent: 57b08d979c86f4500dc8cad639c9518744c8dd39447c055a3517dc9c18d6fccd
Size: 441976279
apiVersion: "1.0"
kind: DockerImage
dockerImageMetadataVersion: "1.0"
dockerImageReference: 172.30.56.218:5000/test/origin-ruby-sample@sha256:47463d94eb5c049b2d23b03a9530bf944f8f967a0fe79147dd6b9135bf7dd13d
6.7. 이미지 스트림으로 작업 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform에서 컨테이너 이미지를 구성하고 관리하려면 이미지 스트림 및 이미지 스트림 태그를 사용할 수 있습니다. 이미지 스트림을 사용하면 이미지 버전을 추적하고 배포를 단순화할 수 있습니다.
기본 프로젝트에서 워크로드를 실행하거나 기본 프로젝트에 대한 액세스를 공유하지 마세요. 기본 프로젝트는 핵심 클러스터 구성 요소를 실행하기 위해 예약되어 있습니다.
다음 기본 프로젝트는 높은 권한이 있는 것으로 간주됩니다. default, kube-public, kube-system, openshift, openshift-infra, openshift-node 및 openshift.io/run-level 레이블이 0 또는 1 로 설정된 기타 시스템 생성 프로젝트입니다. Pod 보안 승인, 보안 컨텍스트 제약 조건, 클러스터 리소스 할당량 및 이미지 참조 확인과 같은 승인 플러그인에 의존하는 기능은 높은 권한 있는 프로젝트에서 작동하지 않습니다.
6.7.1. 이미지 스트림에 대한 정보 가져오기 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform에서 이미지 스트림을 효율적으로 관리하고 모니터링하기 위해 이미지 스트림에 대한 일반 정보와 해당 이미지 스트림의 모든 태그에 대한 자세한 정보를 얻을 수 있으므로 배포된 애플리케이션이 올바른 이미지 버전에 의존하는지 확인할 수 있습니다.
절차
이미지 스트림에 대한 일반 정보와 해당 이미지 스트림이 가리키는 모든 태그에 대한 자세한 정보를 얻으려면 다음 명령을 입력합니다.
$ oc describe is/<image-name>예를 들면 다음과 같습니다.
$ oc describe is/python출력 예
Name: python Namespace: default Created: About a minute ago Labels: <none> Annotations: openshift.io/image.dockerRepositoryCheck=2017-10-02T17:05:11Z Docker Pull Spec: docker-registry.default.svc:5000/default/python Image Lookup: local=false Unique Images: 1 Tags: 1 3.5 tagged from centos/python-35-centos7 * centos/python-35-centos7@sha256:49c18358df82f4577386404991c51a9559f243e0b1bdc366df25 About a minute ago특정 이미지 스트림 태그에 대한 사용 가능한 모든 정보를 얻으려면 다음 명령을 입력합니다.
$ oc describe istag/<image-stream>:<tag-name>예를 들면 다음과 같습니다.
$ oc describe istag/python:latest출력 예
Image Name: sha256:49c18358df82f4577386404991c51a9559f243e0b1bdc366df25 Docker Image: centos/python-35-centos7@sha256:49c18358df82f4577386404991c51a9559f243e0b1bdc366df25 Name: sha256:49c18358df82f4577386404991c51a9559f243e0b1bdc366df25 Created: 2 minutes ago Image Size: 251.2 MB (first layer 2.898 MB, last binary layer 72.26 MB) Image Created: 2 weeks ago Author: <none> Arch: amd64 Entrypoint: container-entrypoint Command: /bin/sh -c $STI_SCRIPTS_PATH/usage Working Dir: /opt/app-root/src User: 1001 Exposes Ports: 8080/tcp Docker Labels: build-date=20170801참고표시된 것보다 더 많은 정보가 출력됩니다.
다음 명령을 입력하여 이미지 스트림 태그가 지원하는 아키텍처 또는 운영 체제를 확인합니다.
$ oc get istag <image-stream-tag> -ojsonpath="{range .image.dockerImageManifests[*]}{.os}/{.architecture}{'\n'}{end}"예를 들면 다음과 같습니다.
$ oc get istag busybox:latest -ojsonpath="{range .image.dockerImageManifests[*]}{.os}/{.architecture}{'\n'}{end}"출력 예
linux/amd64 linux/arm linux/arm64 linux/386 linux/mips64le linux/ppc64le linux/riscv64 linux/s390x
6.7.2. 이미지 스트림에 태그 추가 링크 복사링크가 클립보드에 복사되었습니다!
특정 버전의 컨테이너 이미지를 정확하게 관리하고 추적하려면 OpenShift Container Platform 내의 이미지 스트림에 태그를 추가하고 이를 통해 환경 전체에서 안정적인 참조 및 배포를 보장합니다.
절차
‘oc tag’ 명령을 사용하여 기존 태그 중 하나를 가리키는 태그를 추가합니다.
$ oc tag <image-name:tag1> <image-name:tag2>예를 들면 다음과 같습니다.
$ oc tag python:3.5 python:latest출력 예
Tag python:latest set to python@sha256:49c18358df82f4577386404991c51a9559f243e0b1bdc366df25.이미지 스트림에 두 개의 태그 즉, 외부 컨테이너 이미지를 가리키는 하나의 태그(
3.5)와 첫 번째 태그를 기반으로 생성되어 동일한 이미지를 가리키는 다른 태그(latest)가 있는지 확인합니다.$ oc describe is/python출력 예
Name: python Namespace: default Created: 5 minutes ago Labels: <none> Annotations: openshift.io/image.dockerRepositoryCheck=2017-10-02T17:05:11Z Docker Pull Spec: docker-registry.default.svc:5000/default/python Image Lookup: local=false Unique Images: 1 Tags: 2 latest tagged from python@sha256:49c18358df82f4577386404991c51a9559f243e0b1bdc366df25 * centos/python-35-centos7@sha256:49c18358df82f4577386404991c51a9559f243e0b1bdc366df25 About a minute ago 3.5 tagged from centos/python-35-centos7 * centos/python-35-centos7@sha256:49c18358df82f4577386404991c51a9559f243e0b1bdc366df25 5 minutes ago
6.7.3. 외부 이미지에 대한 태그 추가 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform 리소스에서 외부 레지스트리에서 소싱된 컨테이너 이미지를 추적하고 사용하려면 해당 이미지 스트림에 태그를 추가합니다. 이 작업은 외부 이미지 콘텐츠를 클러스터의 로컬 이미지 관리 시스템에 안전하게 통합합니다.
절차
모든 태그 관련 작업에
oc tag명령을 사용하여 내부 또는 외부 이미지를 가리키는 태그를 추가합니다.$ oc tag <repository/image> <image-name:tag>예를 들어 이 명령은
python이미지 스트림에서docker.io/python:3.6.0이미지를3.6태그에 매핑합니다.$ oc tag docker.io/python:3.6.0 python:3.6출력 예
Tag python:3.6 set to docker.io/python:3.6.0.외부 이미지에 보안이 설정되어 있으면 해당 레지스트리에 액세스하는 데 사용할 인증 정보가 포함된 시크릿을 생성해야 합니다.
6.7.4. 이미지 스트림 태그 업데이트 링크 복사링크가 클립보드에 복사되었습니다!
배포 정의에서 유연성과 일관성을 유지하려면 OpenShift Container Platform의 다른 태그를 반영하도록 이미지 스트림 태그를 업데이트합니다. 특히 이미지 버전의 다른 태그를 효과적으로 관리하는 데 필요한 태그를 업데이트하여 이미지 스트림의 다른 태그를 반영할 수 있습니다.
절차
태그를 업데이트합니다.
$ oc tag <image-name:tag> <image-name:latest>예를 들어 다음에서는 이미지 스트림의
3.6태그를 반영하도록latest태그를 업데이트합니다.$ oc tag python:3.6 python:latest출력 예
Tag python:latest set to python@sha256:438208801c4806548460b27bd1fbcb7bb188273d13871ab43f.
6.7.5. 이미지 스트림 태그 제거 링크 복사링크가 클립보드에 복사되었습니다!
이미지 기록을 제어하고 OpenShift Container Platform 내에서 관리를 단순화하기 위해 이미지 스트림에서 이전 태그를 제거할 수 있습니다. 이 작업을 수행하면 리소스가 현재 및 필요한 이미지 참조만 추적할 수 있습니다.
절차
이미지 스트림에서 이전 태그를 제거합니다.
$ oc tag -d <image-name:tag>예를 들면 다음과 같습니다.
$ oc tag -d python:3.6출력 예
Deleted tag default/python:3.6
6.7.6. 주기적으로 이미지 스트림 태그 가져오기 구성 링크 복사링크가 클립보드에 복사되었습니다!
외부 컨테이너 이미지 레지스트리에서 최신 이미지 정의를 유지하려면 주기적으로 이미지 스트림 태그 가져오기를 구성합니다. 이 프로세스를 사용하면 --scheduled 플래그를 사용하여 중요한 보안 업데이트에 대한 이미지를 신속하게 다시 가져올 수 있습니다.
절차
이미지 가져오기를 스케줄링합니다.
$ oc tag <repository/image> <image-name:tag> --scheduled예를 들면 다음과 같습니다.
$ oc tag docker.io/python:3.6.0 python:3.6 --scheduled출력 예
Tag python:3.6 set to import docker.io/python:3.6.0 periodically.이 명령은 OpenShift Container Platform이 특정 이미지 스트림 태그를 주기적으로 업데이트하도록 합니다. 이 기간은 기본적으로 15분으로 설정되는 클러스터 전체 설정입니다.
정기 점검을 없애고 위 명령을 다시 실행하되
--scheduled플래그를 생략합니다. 이렇게 하면 동작이 기본값으로 재설정됩니다.$ oc tag <repositiory/image> <image-name:tag>
6.8. 이미지 및 이미지 스트림 가져오기 및 작업 링크 복사링크가 클립보드에 복사되었습니다!
컨테이너 이미지를 OpenShift Container Platform 클러스터로 가져와서 해당 참조를 관리하려면 외부 레지스트리에서 이미지를 가져오고 이미지 스트림을 사용하여 이미지를 구성할 수 있습니다. 이 프로세스를 사용하면 애플리케이션의 컨테이너 이미지의 중앙 집중식 레지스트리를 유지 관리할 수 있습니다.
다음 섹션에서는 이미지 스트림을 가져오고 작업하는 방법을 설명합니다.
6.8.1. 개인 레지스트리에서 이미지 및 이미지 스트림 가져오기 링크 복사링크가 클립보드에 복사되었습니다!
외부 소스의 콘텐츠를 안전하게 관리하려면 인증이 필요한 개인 레지스트리에서 태그 및 이미지 메타데이터를 가져오도록 이미지 스트림을 구성합니다.
이 절차는 Cluster Samples Operator가 기본 registry.redhat.io 이외의 항목으로 콘텐츠를 가져오는 데 사용하는 레지스트리를 변경하는 경우 필요합니다.
안전하지 않거나 보안된 레지스트리에서 가져올 때 시크릿에 정의 된 레지스트리 URL에는 :80 포트 접미사가 포함되어야 합니다. 그렇지 않으면 레지스트리에서 가져 오려고 할 때 시크릿을 사용할 수 없습니다.
프로세스
다음 명령을 입력하여 인증 정보를 저장하는 데 사용되는
secret개체를 만들어야 합니다.$ oc create secret generic <secret_name> --from-file=.dockerconfigjson=<file_absolute_path> --type=kubernetes.io/dockerconfigjson시크릿을 구성한 후 새 이미지 스트림을 생성하거나
oc import-image명령을 입력합니다.$ oc import-image <imagestreamtag> --from=<image> --confirm가져 오기 프로세스 중에 OpenShift Container Platform은 시크릿을 선택하여 원격 당사자에게 제공합니다.
6.8.2. 매니페스트 목록으로 작업 링크 복사링크가 클립보드에 복사되었습니다!
매니페스트 목록에서 다중 아키텍처 이미지를 관리하려면 oc import-image 또는 oc tag 와 함께 --import-mode 플래그를 사용하십시오. 단일 하위 강제 또는 모든 매니페스트를 가져오면 이미지 스트림 콘텐츠를 세밀하게 제어할 수 있습니다.
경우에 따라 사용자가 하위 매니페스트를 직접 사용하려는 경우도 있습니다. oc adm prune images 가 실행되거나 CronJob pruner가 실행되는 경우 하위 영구 목록이 사용되는 시기를 감지할 수 없습니다. 결과적으로 oc adm prune images 또는 CronJob pruner를 사용하는 관리자는 하위 매니페스트 목록을 포함하여 전체 매니페스트 목록을 삭제할 수 있습니다.
이러한 제한을 방지하려면 매니페스트 목록을 태그 또는 다이제스트로 대신 사용할 수 있습니다.
절차
다중 아키텍처 이미지가 포함된 이미지 스트림을 생성하고 다음 명령을 입력하여 가져오기 모드를
PreserveOriginal로 설정합니다.$ oc import-image <multiarch-image-stream-tag> --from=<registry>/<project_name>/<image-name> \ --import-mode='PreserveOriginal' --reference-policy=local --confirm출력 예
--- Arch: <none> Manifests: linux/amd64 sha256:6e325b86566fafd3c4683a05a219c30c421fbccbf8d87ab9d20d4ec1131c3451 linux/arm64 sha256:d8fad562ffa75b96212c4a6dc81faf327d67714ed85475bf642729703a2b5bf6 linux/ppc64le sha256:7b7e25338e40d8bdeb1b28e37fef5e64f0afd412530b257f5b02b30851f416e1 ---또는 다음 명령을 입력하여
Legacy가져오기 모드로 이미지를 가져오십시오. 이 모드에서는 매니페스트 목록을 삭제하고 단일 하위 명령을 가져옵니다.$ oc import-image <multiarch-image-stream-tag> --from=<registry>/<project_name>/<image-name> \ --import-mode='Legacy' --confirm참고--import-mode=기본값은Legacy입니다. 이 값을 제외하거나Legacy또는PreserveOriginal를 지정하지 않으면 단일 하위 매니페스트를 가져옵니다. 유효하지 않은 가져오기 모드에서는 다음 오류를 반환합니다:error: valid ImportMode values are Legacy or PreserveOriginal.
6.8.2.1. 주기적으로 매니페스트 목록 가져오기 구성 링크 복사링크가 클립보드에 복사되었습니다!
복잡한 다중 아키텍처 이미지에 대한 최신 이미지 참조를 유지하려면 매니페스트 목록을 정기적으로 가져오기를 구성합니다. 매니페스트 목록을 정기적으로 다시 가져오려면 --scheduled 플래그를 사용하여 이미지 스트림이 외부 레지스트리의 최신 버전을 추적하도록 할 수 있습니다.
절차
다음 명령을 입력하여 매니페스트 목록을 주기적으로 업데이트하도록 이미지 스트림을 설정합니다.
$ oc import-image <multiarch-image-stream-tag> --from=<registry>/<project_name>/<image-name> \ --import-mode='PreserveOriginal' --scheduled=true
6.8.2.2. 매니페스트 목록을 가져올 때 SSL/TLS 구성 링크 복사링크가 클립보드에 복사되었습니다!
외부 리포지토리에서 소싱된 매니페스트 목록의 연결 보안 및 액세스 정책을 제어하려면 이미지를 가져오는 동안 SSL/TLS 설정을 구성합니다.
매니페스트 목록을 가져올 때 SSL/TLS를 구성하려면 --insecure 플래그를 사용하여 필요한 경우 표준 인증서 검증 요구 사항을 바이패스할 수 있습니다.
절차
매니페스트 목록을 가져오려면 SSL/TLS 확인을 건너뛰도록
--insecure=true를 설정합니다. 예를 들면 다음과 같습니다.$ oc import-image <multiarch-image-stream-tag> --from=<registry>/<project_name>/<image-name> \ --import-mode='PreserveOriginal' --insecure=true
6.8.3. --import-mode의 아키텍처 지정 링크 복사링크가 클립보드에 복사되었습니다!
가져온 이미지의 아키텍처를 제어하고 적절한 배포를 확인하려면 --import-mode= 플래그를 사용합니다. 필요에 따라 --import-mode= 플래그를 제외하거나 포함하여 멀티 아키텍처와 단일 아키텍처 간에 가져온 이미지 스트림을 스왑할 수 있습니다.
절차
다음 명령을 실행하여
--import-mode=플래그를 제외하여 다중 아키텍처에서 단일 아키텍처로 이미지 스트림을 업데이트합니다.$ oc import-image <multiarch-image-stream-tag> --from=<registry>/<project_name>/<image-name>다음 명령을 실행하여 단일 아키텍처에서 다중 아키텍처로 이미지 스트림을 업데이트합니다.
$ oc import-image <multiarch_image_stream_tag> --from=<registry>/<project_name>/<image_name> \ --import-mode='PreserveOriginal'
6.8.4. --import-mode의 구성 필드 링크 복사링크가 클립보드에 복사되었습니다!
--import-mode 플래그를 사용하여 다중 아키텍처 이미지 관리를 구현하려면 필요한 구성 필드를 참조하십시오. 이러한 필드는 OpenShift Container Platform 클러스터로 특정 매니페스트를 선택하고 가져오기 위한 정확한 매개변수를 정의합니다.
다음 표에서는 --import-mode= 플래그에 사용할 수 있는 옵션을 설명합니다.
| 매개변수 | 설명 |
|---|---|
| Legacy |
|
| PreserveOriginal | 지정하면 원래 매니페스트가 유지됩니다. 매니페스트 목록의 경우 매니페스트 목록과 모든 하위 매니페스트를 가져옵니다. |