イメージ

• Cluster Samples Operator が、クリーンインストール後の初回起動から 3 分後に registry.redhat.io に到達できない場合。
• Cluster Samples Operator がこれが IPv6 ネットワーク上にあることを検出する場合。

• Cluster Samples Operator がインストール時に削除される場合、Cluster Samples Operator を代替レジストリーと共に使用 し、コンテンツをインポートし、サンプルを取得するために Cluster Samples Operator を Managed に設定できるようにします。

検証

• OpenShift CLI のインストール後に、oc コマンドを使用して利用できます。

  $ oc <command>

  Copy to Clipboard Toggle word wrap

検証

• OpenShift CLI のインストール後に、oc コマンドを使用して利用できます。

  C:\> oc <command>

  Copy to Clipboard Toggle word wrap

検証

• oc コマンドを使用してインストールを確認します。

  $ oc <command>

  Copy to Clipboard Toggle word wrap

• Cluster Samples Operator が Removed に設定される場合、ミラーリングされたレジストリーを作成するか、使用する必要のある既存のミラーリングされたレジストリーを判別できます。
• 新しい config map をガイドとして使用し、ミラーリングされたレジストリーに必要なサンプルをミラーリングします。
• Cluster Samples Operator 設定オブジェクトの skippedImagestreams リストに、ミラーリングされていないイメージストリームを追加します。
• Cluster Samples Operator 設定オブジェクトの samplesRegistry をミラーリングされたレジストリーに設定します。
• 次に、Cluster Samples Operator を Managed に設定し、ミラーリングしたイメージストリームをインストールします。

• 公開されるポートは、イメージから作成されるコンテナーに関連付けられる podman ps の下に表示されます。
• 公開されるポートは、podman inspect によって返されるイメージのメタデータに表示されます。
• 公開されるポートは、1 つのコンテナーを別のコンテナーにリンクする際にリンクされます。

• ソース
• Source-to-Image (S2I) スクリプト
• ビルダーイメージ

• image:///path_to_scripts_dir: S2I スクリプトが配置されているディレクトリーへのイメージ内の絶対パス。
• file:///path_to_scripts_dir: S2I スクリプトが配置されているディレクトリーへのホスト上の相対パスまたは絶対パス。
• http(s)://path_to_scripts_dir: S2I スクリプトが配置されているディレクトリーの URL。

• Podman を使用する場合は、以下のコマンドを実行します。

  $ podman build -t <builder_image_name>

  Copy to Clipboard Toggle word wrap

• Docker を使用する場合は、以下のコマンドを実行します。

  $ docker build -t <builder_image_name>

  Copy to Clipboard Toggle word wrap

手順

• oc tag コマンドを使用して、タグをイメージストリームに追加できます。

  $ oc tag <source> <destination>

  Copy to Clipboard Toggle word wrap

  たとえば、ruby イメージストリームの static-2.0 タグを ruby イメージストリーム 2.0 タグの現行のイメージを常に参照するように設定するには、以下を実行します。

  $ oc tag ruby:2.0 ruby:static-2.0

  Copy to Clipboard Toggle word wrap

  これにより、ruby イメージストリームに static-2.0 という名前のイメージストリームタグが新たに作成されます。この新規タグは、oc tag の実行時に ruby:2.0 イメージストリームタグが参照したイメージ ID を直接参照し、これが参照するイメージが変更されることがありません。

• 宛先タグがソースタグの変更時に更新されるようにするには、--alias=true フラグを使用します。

  $ oc tag --alias=true <source> <destination>

  Copy to Clipboard Toggle word wrap

• また、--scheduled=true フラグを追加して、宛先タグが定期的に更新 (再インポート) されるようにもできます。期間はシステムレベルでグローバルに設定できます。

• --reference フラグはインポートされないイメージストリームを作成します。このタグはソースの場所を参照しますが、これを永続的に参照します。

  タグ付けされたイメージを統合レジストリーから常に取得するように Red Hat OpenShift Service on AWS に指示する場合は、--reference-policy=local を使用します。レジストリーはプルスルー (pull-through) 機能を使用してイメージをクライアントに提供します。デフォルトで、イメージ Blob はレジストリーによってローカルにミラーリングされます。その結果、それらが次回必要となる場合により迅速にプルされます。また、このフラグは --insecure-registry をコンテナーランタイムに指定しなくても、イメージストリームに非セキュアなアノテーションがあるか、タグに非セキュアなインポートポリシーがある限り、非セキュアなレジストリーからのプルを許可します。

手順

• タグをイメージストリームから完全に削除するには、以下を実行します。

  $ oc delete istag/ruby:latest

  Copy to Clipboard Toggle word wrap

  または、以下を実行します。

  $ oc tag -d ruby:latest

  Copy to Clipboard Toggle word wrap

手順

• 所定のメージストリームおよびタグのイメージを参照するには、ImageStreamTag を使用します。

  <image_stream_name>:<tag>

  Copy to Clipboard Toggle word wrap

• 所定のイメージストリームおよびイメージの sha ID のイメージを参照するには、ImageStreamImage を使用します。

  <image_stream_name>@<id>

  Copy to Clipboard Toggle word wrap

  <id> は、ダイジェストとも呼ばれる特定イメージのイミュータブルな ID です。

• 所定の外部レジストリーのイメージを参照または取得するには、DockerImage を使用します。

  openshift/ruby-20-centos7:2.0

  Copy to Clipboard Toggle word wrap
  注記

  タグが指定されていない場合、latest タグが使用されることが想定されます。

  サードパーティーのレジストリーを参照することもできます。

  registry.redhat.io/rhel7:latest

  Copy to Clipboard Toggle word wrap

  またはダイジェストでイメージを参照できます。

  centos/ruby-22-centos7@sha256:3a335d7d8a452970c5b4054ad7118ff134b3a6b50a2bb6d0c07c746e8986b28e

  Copy to Clipboard Toggle word wrap

• Docker: Docker は、デフォルトで $HOME/.docker/config.json を使用します。
• Podman: Podman は、デフォルトで $HOME/.config/containers/auth.json を使用します。

手順

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

  $ oc describe is/<image-name>

  Copy to Clipboard Toggle word wrap

  以下に例を示します。

  $ oc describe is/python

  Copy to Clipboard Toggle word wrap

  出力例

  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

  Copy to Clipboard Toggle word wrap

• 特定のイメージストリームタグに関して利用可能なすべての情報を取得するには、次のコマンドを入力します。

  $ oc describe istag/<image-stream>:<tag-name>

  Copy to Clipboard Toggle word wrap

  以下に例を示します。

  $ oc describe istag/python:latest

  Copy to Clipboard Toggle word wrap

  出力例

  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

  Copy to Clipboard Toggle word wrap

  注記

  表示されている以上の情報が出力されます。

• 次のコマンドを入力して、イメージストリームタグがサポートするアーキテクチャーまたはオペレーティングシステムを検出します。

  $ oc get istag <image-stream-tag> -ojsonpath="{range .image.dockerImageManifests[*]}{.os}/{.architecture}{'\n'}{end}"

  Copy to Clipboard Toggle word wrap

  以下に例を示します。

  $ oc get istag busybox:latest -ojsonpath="{range .image.dockerImageManifests[*]}{.os}/{.architecture}{'\n'}{end}"

  Copy to Clipboard Toggle word wrap

  出力例

  linux/amd64
  linux/arm
  linux/arm64
  linux/386
  linux/mips64le
  linux/ppc64le
  linux/riscv64
  linux/s390x

  Copy to Clipboard Toggle word wrap

手順

• 既存タグのいずれかを参照するタグを追加するには、`oc tag` コマンドを使用できます。

  $ oc tag <image-name:tag1> <image-name:tag2>

  Copy to Clipboard Toggle word wrap

  以下に例を示します。

  $ oc tag python:3.5 python:latest

  Copy to Clipboard Toggle word wrap

  出力例

  Tag python:latest set to python@sha256:49c18358df82f4577386404991c51a9559f243e0b1bdc366df25.

  Copy to Clipboard Toggle word wrap

• イメージストリームに、外部コンテナーイメージを参照するタグ (3.5) と、この最初のタグに基づいて作成されているために同じイメージを参照する別のタグ (latest) の 2 つのタグが含まれることを確認します。

  $ oc describe is/python

  Copy to Clipboard Toggle word wrap

  出力例

  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

  Copy to Clipboard Toggle word wrap

手順

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

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

  Copy to Clipboard Toggle word wrap

  たとえば、このコマンドは docker.io/python:3.6.0 イメージを python イメージストリームの 3.6 タグにマップします。

  $ oc tag docker.io/python:3.6.0 python:3.6

  Copy to Clipboard Toggle word wrap

  出力例

  Tag python:3.6 set to docker.io/python:3.6.0.

  Copy to Clipboard Toggle word wrap

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

手順

• タグを更新します。

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

  Copy to Clipboard Toggle word wrap

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

  $ oc tag python:3.6 python:latest

  Copy to Clipboard Toggle word wrap

  出力例

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

  Copy to Clipboard Toggle word wrap

手順

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

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

  Copy to Clipboard Toggle word wrap

  以下に例を示します。

  $ oc tag -d python:3.6

  Copy to Clipboard Toggle word wrap

  出力例

  Deleted tag default/python:3.6

  Copy to Clipboard Toggle word wrap

手順

• 次のコマンドを入力して、マルチアーキテクチャーイメージを含むイメージストリームを作成し、インポートモードを PreserveOriginal に設定します。

  $ oc import-image <multiarch-image-stream-tag>  --from=<registry>/<project_name>/<image-name> \
  --import-mode='PreserveOriginal' --reference-policy=local --confirm

  Copy to Clipboard Toggle word wrap

  出力例

  ---
  Arch:           <none>
  Manifests:      linux/amd64     sha256:6e325b86566fafd3c4683a05a219c30c421fbccbf8d87ab9d20d4ec1131c3451
                  linux/arm64     sha256:d8fad562ffa75b96212c4a6dc81faf327d67714ed85475bf642729703a2b5bf6
                  linux/ppc64le   sha256:7b7e25338e40d8bdeb1b28e37fef5e64f0afd412530b257f5b02b30851f416e1
  ---

  Copy to Clipboard Toggle word wrap

• または、次のコマンドを入力して、マニフェストリストを破棄し、単一のサブマニフェストをインポートする Legacy インポートモードでイメージをインポートします。

  $ oc import-image <multiarch-image-stream-tag>  --from=<registry>/<project_name>/<image-name> \
  --import-mode='Legacy' --confirm

  Copy to Clipboard Toggle word wrap
  注記

  --import-mode= のデフォルト値は Legacy です。この値を除外するか、Legacy または PreserveOriginal のいずれかを指定しないと、単一のサブマニフェストがインポートされます。無効なインポートモードは次のエラーを返します: error: valid ImportMode values are Legacy or PreserveOriginal。

• 場合によっては、ユーザーがサブマニフェストを直接使用したい場合があります。oc adm prune images が実行されている場合、または CronJob プルーナーが実行されている場合、サブマニフェストリストが使用されていることを検出できません。その結果、oc adm prune images または CronJob プルーナーを使用する管理者は、サブマニフェストを含むマニフェストリスト全体を削除する可能性があります。

  この制限を回避するには、代わりにタグ別またはダイジェスト別のマニフェストリストを使用できます。

手順

• 次のコマンドを実行して、--import-mode= フラグを除外して、イメージストリームをマルチアーキテクチャーからシングルアーキテクチャーに更新します。

  $ oc import-image <multiarch-image-stream-tag> --from=<registry>/<project_name>/<image-name>

  Copy to Clipboard Toggle word wrap

• 次のコマンドを実行して、イメージストリームをシングルアーキテクチャーからマルチアーキテクチャーに更新します。

  $ oc import-image <multiarch_image_stream_tag>  --from=<registry>/<project_name>/<image_name> \
  --import-mode='PreserveOriginal'

  Copy to Clipboard Toggle word wrap