プライベート自動化ハブでのコンテナーの管理
プライベート自動化ハブコンテナーレジストリー (単数または複数) を設定するための管理者ワークフローおよびプロセス
概要
多様性を受け入れるオープンソースの強化 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。まずは、マスター (master)、スレーブ (slave)、ブラックリスト (blacklist)、ホワイトリスト (whitelist) の 4 つの用語の置き換えから始めます。この取り組みは膨大な作業を要するため、今後の複数のリリースで段階的に用語の置き換えを実施して参ります。詳細は、Red Hat CTO である Chris Wright のメッセージ をご覧ください。
第1章 プライベート自動化ハブコンテナーレジストリーの管理 リンクのコピーリンクがクリップボードにコピーされました!
自動化ハブコンテナーレジストリーを使用して、{PlatfomNameShort} インフラストラクチャーでコンテナーイメージリポジトリーを管理します。ハブは、個々のコンテナーリポジトリーにアクセスできるユーザーや、イメージのタグの変更、アクティビティーおよびイメージ層の表示、および各コンテナーリポジトリーに関連した追加情報を提供することを行うための機能を提供します。
1.1. コンテナーレジストリー リンクのコピーリンクがクリップボードにコピーされました!
自動化ハブコンテナーレジストリーは、コンテナーイメージの保存と管理に使用されます。コンテナーイメージをビルド、または取得した後に、そのコンテナーイメージをプライベート自動化ハブのレジストリーの部分にプッシュしてコンテナーリポジトリーを作成できます。
第2章 プライベート自動化ハブでコンテナーリポジトリーのユーザーアクセスの設定 リンクのコピーリンクがクリップボードにコピーされました!
プライベート自動化ハブのコンテナーリポジトリーへのユーザーアクセスを設定し、Ansible Automation Platform でイメージにアクセスして管理できるパーミッションを提供します。
2.1. 前提条件 リンクのコピーリンクがクリップボードにコピーされました!
- グループを作成して、プライベート自動化ハブでパーミッションを割り当てることができるようになっている。
2.2. コンテナーレジストリーのグループパーミッション リンクのコピーリンクがクリップボードにコピーされました!
ユーザーアクセスにより、ユーザーがプライベート自動化ハブで管理されているコンテナーと対話する方法を細かく制御できます。以下のパーミッション一覧を使用して、コンテナーレジストリーの適切な権限を持つグループを作成します。
| パーミッション名 | 説明 |
|---|---|
| 新規コンテナーの作成 | ユーザーは新規コンテナーを作成できます。 |
| コンテナーの名前空間パーミッションの変更 | ユーザーは、コンテナーリポジトリーのパーミッションを変更できます。 |
| コンテナーの変更 | ユーザーはコンテナーの情報を変更できます。 |
| イメージタグの変更 | ユーザーはイメージタグを変更できます。 |
| プライベートコンテナーのプル | ユーザーはプライベートコンテナーからイメージをプルできます。 |
| 既存コンテナーへのプッシュ | 既存のコンテナーにイメージをプッシュすることができます。 |
| プライベートコンテナーの表示 | ユーザーは、プライベートとしてマークされているコンテナーを表示できます。 |
2.3. 新規グループの作成 リンクのコピーリンクがクリップボードにコピーされました!
ユーザーがシステム内の指定された機能にアクセスできるパーミッションを作成し、Automation Hub のグループに割り当てることができます。デフォルトでは、 があります。adminsすべての権限が割り当てられており、Automation Hub のインストール時に作成された認証情報を使用して初回ログイン時に使用できる Automation Hub の グループ。
前提条件
- を持っています。groups 権限で、Automation Hub のグループ設定とアクセスを作成および管理できます。
手順
- ローカルの Automation Hub にログインします。
- → に移動します。
- をクリックします。
- を提供します。Name で、 をクリックします。
新しいグループの編集ページで、パーミッションを割り当てたり、ユーザーを追加したりできるようになりました。
2.4. グループへのパーミッションの割り当て リンクのコピーリンクがクリップボードにコピーされました!
ユーザーがシステム内の特定の機能にアクセスできるパーミッションを Automation Hub のグループに割り当てることができます。デフォルトでは、新規グループにパーミッションが割り当てられません。最初のグループ作成時にパーミッションを追加するか、既存のグループを編集してパーミッションを追加または削除できます。
前提条件
- を持っています。Change group 権限で、Automation Hub のグループ権限を編集できます。
手順
- ローカルの Automation Hub にログインします。
- → に移動します。
- グループ名をクリックします。
- を選択します。Permissions タブで、 をクリックします。
- パーミッションタイプのフィールドをクリックし、一覧に表示されるパーミッションを選択します。
- パーミッションの割り当てが完了したら、 をクリックします。
このグループは、割り当てられたパーミッションに関連付けられている Automation Hub の機能にアクセスできるようになりました。
関連情報
- 特定のパーミッションについての詳細は、コンテナーレジストリーのグループパーミッション を参照してください。
2.5. グループへのユーザーの追加 リンクのコピーリンクがクリップボードにコピーされました!
グループの作成時にユーザーを追加したり、既存のグループにユーザーを手動で追加したりできます。本セクションでは、既存のグループにユーザーを追加する方法を説明します。
前提条件
- を持っています。groups 権限で、Automation Hub のグループ設定とアクセスを作成および管理できます。
手順
- Automation Hub にログインします。
- → に移動します。
- グループ名をクリックします。
- タブに移動し、 をクリックします。
- 一覧から追加するユーザーを選択し、 をクリックします。
これで、グループに選択したユーザーが追加されました。このユーザーは、グループに割り当てられた Automation Hub を使用するためのパーミッションを持つようになりました。
第3章 プライベート自動化ハブコンテナーレジストリーへの入力 リンクのコピーリンクがクリップボードにコピーされました!
デフォルトでは、プライベート自動化ハブにはコンテナーイメージが含まれません。コンテナーレジストリーを設定するには、コンテナーイメージレジストリーにコンテナーイメージをプッシュする必要があります。本セクションの手順では、Red Hat Ecosystem Catalog (registry.redhat.io) からイメージをプルし、それらをタグ付けして、プライベート自動化コンテナーレジストリーにプッシュする方法を説明します。
3.1. 前提条件 リンクのコピーリンクがクリップボードにコピーされました!
- 新しいコンテナーを作成して、プライベート自動化ハブにプッシュするパーミッションがある。
3.2. 自動化ハブで使用するイメージの取得 リンクのコピーリンクがクリップボードにコピーされました!
コンテナーイメージをプライベート自動化ハブにプッシュする前に、まず既存のレジストリーからプルし、使用できるようにタグを付ける必要があります。以下の例では、Red Hat Ecosystem Catalog (registry.redhat.io) からイメージをプルする方法を説明します。
前提条件
- registry.redhat.io からイメージをプルするパーミッションがある。
手順
registry.redhat.io 認証情報を使用して Podman にログインします。
podman login registry.redhat.io
$ podman login registry.redhat.ioCopy to Clipboard Copied! Toggle word wrap Toggle overflow - プロンプトにユーザー名およびパスワードを入力します。
コンテナーイメージをプルします。
podman pull registry.redhat.io/<container_image_name>:<tag>
$ podman pull registry.redhat.io/<container_image_name>:<tag>Copy to Clipboard Copied! Toggle word wrap Toggle overflow
検証
ローカルストレージ内のイメージを一覧表示します。
podman images
$ podman imagesCopy to Clipboard Copied! Toggle word wrap Toggle overflow - 最近プルしたイメージが一覧に含まれていることを確認します。
- タグが正しいことを確認します。
3.3. 自動化ハブで使用するイメージのタグ付け リンクのコピーリンクがクリップボードにコピーされました!
レジストリーからイメージをプルしたら、プライベート自動化ハブコンテナーレジストリーで使用するようにタグを付けます。
前提条件
- 外部レジストリーからコンテナーイメージをプルしている。
手順
自動化ハブコンテナーリポジトリーを使用してローカルイメージにタグを付けます。
podman tag registry.redhat.io/<container_image_name>:<tag> <automation_hub_URL>/<container_image_name>
$ podman tag registry.redhat.io/<container_image_name>:<tag> <automation_hub_URL>/<container_image_name>Copy to Clipboard Copied! Toggle word wrap Toggle overflow
検証
ローカルストレージ内のイメージを一覧表示します。
podman images
$ podman imagesCopy to Clipboard Copied! Toggle word wrap Toggle overflow - 自動化ハブの情報で最近タグ付けされたイメージが一覧に含まれていることを確認します。
3.4. プライベート自動化ハブへのコンテナーイメージのプッシュ リンクのコピーリンクがクリップボードにコピーされました!
タグ付けされたコンテナーイメージをプライベート自動化ハブにプッシュして新規コンテナーを作成し、コンテナーレジストリーにデータを入力できます。
前提条件
- 新規コンテナーを作成するパーミッションがある。
- 自動化ハブインスタンスの FQDN または IP アドレスがある。
手順
自動化ハブの場所および認証情報を使用して Podman にログインします。
podman login -u=<username> -p=<password> <automation_hub_url>
$ podman login -u=<username> -p=<password> <automation_hub_url>Copy to Clipboard Copied! Toggle word wrap Toggle overflow コンテナーイメージを自動化ハブのコンテナーレジストリーにプッシュします。
podman push <automation_hub_url>/<container_image_name> --remove-signatures
$ podman push <automation_hub_url>/<container_image_name> --remove-signaturesCopy to Clipboard Copied! Toggle word wrap Toggle overflow 注記registry.redhat.io からの署名付きイメージが自動化ハブコンテナーレジストリーにプッシュされる場合は、
--remove-signaturesフラグが必要です。push操作は、アップロード中にイメージレイヤーを再圧縮します。これは、再現性が保証されておらず、クライアントの実装に依存します。これにより、イメージレイヤーダイジェストが変更され、プッシュ操作が失敗し、Error: Copying this image requires changing layer representation, which is not possible (image is signed or the destination specifies a digest)エラーが発生します。
検証
- ローカルの自動化ハブにログインします。
- に移動します。
- コンテナーリポジトリー一覧でコンテナーを見つけます。
第4章 コンテナーリポジトリーの設定 リンクのコピーリンクがクリップボードにコピーされました!
コンテナーリポジトリーを設定して説明の追加、README の追加、リポジトリーにアクセスできるグループの追加、およびタグイメージの追加を行うことができます。
4.1. 前提条件 リンクのコピーリンクがクリップボードにコピーされました!
- リポジトリーを変更するパーミッションが必要です。
4.2. コンテナーリポジトリーへの README の追加 リンクのコピーリンクがクリップボードにコピーされました!
コンテナーリポジトリーに README を追加して、コンテナーを操作する方法をユーザーに提供します。自動化ハブコンテナーリポジトリーは、README を作成するためのマークダウンをサポートします。デフォルトでは、README は空になります。
前提条件
- コンテナーを変更するパーミッションがある。
手順
- に移動します。
- コンテナーリポジトリーを選択します。
- 上でDetail タブで、 をクリックします。
- でRaw Markdown テキストフィールドに、README テキストを Markdown で入力します。
- 終了したら をクリックします。
README を追加したら、 をクリックし、ステップ 4 および 5 を繰り返すことで、いつでも編集できます。
4.3. コンテナーリポジトリーへのアクセスの提供 リンクのコピーリンクがクリップボードにコピーされました!
イメージを使用する必要のあるユーザーにコンテナーリポジトリーへのアクセスを提供します。グループを追加すると、グループがコンテナーリポジトリーに対して持つことができるパーミッションを変更できます。このオプションを使用して、グループが割り当てられている内容に応じてパーミッションを拡張または制限できます。
前提条件
- を持っています。change container namespace 権限。
手順
- に移動します。
- コンテナーリポジトリーを選択します。
- ウィンドウの右上にある をクリックします。
の下でGroups with access で、アクセスを許可するグループを選択します。
- (必要に応じて) グループ名でドロップダウンを使用して、特定のグループのパーミッションを追加または削除します。
- をクリックします。
4.4. コンテナーイメージのタグ付け リンクのコピーリンクがクリップボードにコピーされました!
自動化ハブコンテナーリポジトリーに保存されているイメージにタグを付けて、名前を追加します。イメージにタグが追加されない場合、自動化ハブの名前はデフォルトで latest に設定されます。
前提条件
- を持っています。change image tags 権限。
手順
- に移動します。
- コンテナーリポジトリーを選択します。
- をクリックします。Images タブに移動します。
-
をクリックし、 をクリックします。
テキストフィールドに新しいタグを追加し、 をクリックします。
- オプション: を削除します。current tags そのイメージのタグのいずれかで をクリックします。
- をクリックします。
検証
- をクリックします。Activity タブで、最新の変更を確認します。
第5章 コンテナーリポジトリーからのイメージのプル リンクのコピーリンクがクリップボードにコピーされました!
自動化ハブコンテナーレジストリーからイメージを取得し、ローカルマシンにコピーを作成します。自動化ハブは、コンテナーリポジトリーの latest イメージごとに、podman pull コマンドを提供します。このコマンドを端末にコピーアンドペーストするか、podman pull を使用してイメージタグに基づいてイメージをコピーすることができます。
5.1. 前提条件 リンクのコピーリンクがクリップボードにコピーされました!
- プライベートコンテナーを表示し、プルすることができます。
5.2. イメージのプル リンクのコピーリンクがクリップボードにコピーされました!
自動化ハブコンテナーレジストリーからイメージをプルして、ローカルマシンにコピーできます。自動化ハブは、コンテナーリポジトリーの latest イメージごとに、podman pull コマンドを提供します。
前提条件
- プライベートコンテナーからイメージを表示し、プルすることができる。
手順
- に移動します。
- コンテナーリポジトリーを選択します。
- でPull this image エントリーで、 をクリックします。
- 端末でコマンドを貼り付けます。
検証
-
podman imagesを実行して、ローカルマシンにイメージを表示します。