6.6. イメージストリームの使用

手順

• イメージストリームに関する一般情報と、それが指しているすべてのタグに関する詳細情報を取得するには、次のコマンドを入力します。

  $ 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

手順

• 既存タグのいずれかを参照するタグを追加するには、`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) の 2 つのタグが含まれることを確認します。

  $ 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

手順

• タグ関連のすべての操作に oc tag コマンドを使用して、内部または外部イメージをポイントするタグを追加します。

  $ oc tag <repository/image> <image-name:tag>

  たとえば、このコマンドは docker.io/python:3.6.0 イメージを python イメージストリームの 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.

  外部イメージのセキュリティーが保護されている場合、そのレジストリーにアクセスするために認証情報を使用してシークレットを作成する必要があります

手順

• タグを更新します。

  $ oc tag <image-name:tag> <image-name:latest>

  たとえば、以下は latest タグを更新し、3.6 タグをイメージタグに反映させます。

  $ oc tag python:3.6 python:latest

  出力例

  Tag python:latest set to python@sha256:438208801c4806548460b27bd1fbcb7bb188273d13871ab43f.

手順

• 古いタグをイメージストリームから削除します。

  $ oc tag -d <image-name:tag>

  以下に例を示します。

  $ oc tag -d python:3.6

  出力例

  Deleted tag default/python:3.6