コンテナーの構築、実行、および管理

手順

1. RHEL をインストールします。

2. RHEL の登録: ユーザー名とパスワードを入力します。ユーザー名とパスワードは、Red Hat カスタマーポータルのログイン認証情報と同じです。

   # subscription-manager register
   Registering to: subscription.rhsm.redhat.com:443/subscription
   Username: <username>
   Password: <password>

3. container-tools メタパッケージをインストールします。

   # dnf install container-tools

   必要に応じて、podman、buildah、skopeo を個別にインストールすることもできます。

4. オプション: podman-docker パッケージをインストールします。

   # dnf install podman-docker

   podman-docker パッケージは、Docker コマンドラインインターフェイスと docker-api を、同等の Podman コマンドに置き換えます。

手順

1. コマンドラインを開き、RHEL 拡張機能リポジトリーを有効にします。

   # subscription-manager repos --enable rhel-10-for-$(arch)-extensions-rpms

2. プロンプトが表示されたらパスワードを入力します。

3. Podman Desktop をインストールします。

   # dnf install podman-desktop

4. インストールされたサイズを確認するには、y と入力します。
5. GPG キーをインポートしてインストールを完了するには、y と入力します。

検証

1. ホーム画面の上部にある検索ボックスに Podman Desktop と入力し、Podman Desktop アプリケーションをクリックして開きます。
2. 指示に従って、アプリケーションの簡単なオンボーディングプロセスを完了します。

手順

1. レジストリーに対して認証します。

   # podman login quay.io

2. イメージを検索します。

   • 特定のレジストリーで特定のイメージを検索するには、以下を入力します。

     # podman search quay.io/postgresql-10
     INDEX       NAME                                           DESCRIPTION           STARS   OFFICIAL   AUTOMATED
     redhat.io   registry.redhat.io/rhel10/postgresql-10         This container image ...  0
     redhat.io   registry.redhat.io/rhscl/postgresql-10-rhel7   PostgreSQL is an  ...     0

   • または、特定のレジストリーで提供されるすべてのイメージを表示するには、以下を入力します。

     # podman search quay.io/*

   • すべてのレジストリー全体でイメージ名を検索するには、以下を入力します。

     # podman search postgresql-10

     完全な説明を表示するには、--no-trunc オプションをコマンドに渡します。詳細は、システム上の podman-search(1) man ページを参照してください。

手順

1. registry.redhat.io レジストリーにログインします。

   $ podman login registry.redhat.io
   Username: <username>
   Password: <password>
   Login Succeeded!

2. registry.redhat.io/ubi10/ubi コンテナーイメージをプルします。

   $ podman pull registry.redhat.io/ubi10/ubi

手順

1. /var/lib/images/nginx ディレクトリーを作成します。

   $ mkdir -p /var/lib/images/nginx

2. docker://docker.io/nginx:latest イメージのレイヤーを、新たに作成したディレクトリーにコピーします。

   $ skopeo copy docker://docker.io/nginx:latest dir:/var/lib/images/nginx

手順

1. すべてのイメージをリスト表示します。

   $ podman images
   REPOSITORY                           TAG     IMAGE ID      CREATED      SIZE
   registry.redhat.io/ubi10/ubi          latest  3269c37eae33  7 weeks ago  208 MB

2. 以下のいずれかのオプションを使用して、myubi 名を registry.redhat.io/ubi10/ubi イメージに割り当てます。

   • イメージ名:

     $ podman tag registry.redhat.io/ubi10/ubi myubi

   • イメージ ID:

     $ podman tag 3269c37eae33 myubi

     どちらのコマンドも、同じ結果になります。

3. すべてのイメージをリスト表示します。

   $ podman images
   REPOSITORY                           TAG     IMAGE ID      CREATED       SIZE
   registry.redhat.io/ubi10/ubi          latest  3269c37eae33  2 months ago  208 MB
   localhost/myubi                      latest  3269c37eae33  2 months ago  208 MB

   デフォルトのタグがいずれのイメージでも latest であることに注意してください。すべてのイメージ名が単一のイメージ ID 3269c37eae33 に割り当てられていることを確認できます。

4. 以下のいずれかを使用して、10 タグを registry.redhat.io/ubi10/ubi イメージに追加します。

   • イメージ名:

     $ podman tag registry.redhat.io/ubi10/ubi myubi:10

   • イメージ ID:

     $ podman tag 3269c37eae33 myubi:10

     どちらのコマンドも、同じ結果になります。

検証

1. すべてのイメージをリスト表示します。

   $ podman images
   REPOSITORY                           TAG     IMAGE ID      CREATED       SIZE
   registry.redhat.io/ubi10/ubi          latest  3269c37eae33  2 months ago  208 MB
   localhost/myubi                      latest  3269c37eae33  2 months ago  208 MB
   localhost/myubi                      10     3269c37eae33  2 months ago  208 MB

   デフォルトのタグがいずれのイメージでも latest であることに注意してください。すべてのイメージ名が単一のイメージ ID 3269c37eae33 に割り当てられていることを確認できます。

2. registry.redhat.io/ubi10/ubi イメージにタグ付けした後に、コンテナーを実行するオプションが 3 つあります。

   • ID (3269c37eae33)
   • 名前 (localhost/myubi:latest)

   • 名前 (localhost/myubi:10)

     詳細は、システム上の podman-tag(1) man ページを参照してください。

手順

1. サポートする必要がある各アーキテクチャーの Containerfiles を作成します。

2. 各アーキテクチャー用のイメージをビルドします。以下に例を示します。

   $ podman build --platform linux/arm64,linux/amd64 --manifest <registry>/<image> .

   • --platform linux/arm64,linux/amd64 オプションは、コンテナーイメージのビルド対象のターゲットプラットフォームを指定します。
   • --manifest <registry>/<image> オプションは、指定の名前 (<registry>/<image>) を含むマニフェストリストを作成し、新しくビルドされたイメージをそのリストに追加します。マニフェストリストは、それぞれ異なるアーキテクチャーをターゲットとするイメージマニフェストのコレクションです。

3. マニフェストリストをレジストリーにプッシュします。

   $ podman manifest push <registry>/<image>

   このマニフェストリストは、マルチアーキテクチャーコンテナーをプルする際の唯一のエントリーポイントとして機能します。

   これにより、単一のマニフェストリストに基づいて、プラットフォームに適したコンテナーイメージをプルできるようになります。

   また、podman manifest remove <manifest_list> <digest_ID> コマンドを使用すると、マニフェストリストから項目を削除できます。<digest_ID> は、コンテナーイメージの SHA-256 チェックサムです。例: podman manifest remove <registry>/<image> sha256:cb8a924afdf…​

手順

1. registry.redhat.io/rhel10/support-tools イメージを tarball として保存します。

   • デフォルトの docker-archive 形式の場合:

     $ podman save -o mysupport-tools.tar registry.redhat.io/rhel10/support-tools:latest

   • oci-archive 形式で、--format オプションを使用します。

     $ podman save -o mysupport-tools-oci.tar --format=oci-archive registry.redhat.io/rhel10/support-tools

     mysupport-tools.tar および mysupport-tools-oci.tar アーカイブはカレントディレクトリーに保存されます。次の手順は、mysupport-tools.tar tarball を使用して実行されます。

2. mysupport-tools.tar のファイルタイプを確認します。

   $ file mysupport-tools.tar
   mysupport-tools.tar: POSIX tar archive

3. mysupport-tools.tar から registry.redhat.io/rhel10/support-tools:latest イメージをロードするには、以下を実行します。

   $ podman load -i mysupport-tools.tar
   ...
   Loaded image(s): registry.redhat.io/rhel10/support-tools:latest

   詳細は、システム上の podman-save(1) および podman-load(1) man ページを参照してください。

手順

1. 必要に応じて、ubi イメージに別の名前を追加します。

   # podman tag registry.redhat.io/ubi10/ubi registry.example.com:5000/ubi10/ubi

2. registry.example.com:5000/ubi10/ubi イメージをローカルストレージからレジストリーにプッシュします。

   # podman push registry.example.com:5000/ubi10/ubi

   重要

   このイメージを使用する方法には制限がいくつかありますが、その方法を参照する方法にもいくつかの制限があります。たとえば、Red Hat Container Certification または Red Hat OpenShift Operator Certification の Red Hat Partner Connect Program で認定されていなければ、Red Hat の認定イメージまたは Red Hat のサポートイメージとはみなされません。

手順

1. ローカルシステムにある全イメージのリストを表示します。

   $ podman images
   REPOSITORY                           TAG     IMAGE ID      CREATED      SIZE
   registry.redhat.io/rhel10/support-tools     latest  4b32d14201de  7 weeks ago  228 MB
   registry.redhat.io/ubi10/ubi          latest  3269c37eae33  7 weeks ago  208 MB
   localhost/myubi                      X.Y     3269c37eae33  7 weeks ago  208 MB

2. すべてのコンテナーをリスト表示します。

   $ podman ps -a
   CONTAINER ID  IMAGE                                    COMMAND          CREATED        STATUS            PORTS   NAMES
   7ccd6001166e  registry.redhat.io/rhel10/support-tools:latest  usr/bin/bash  6 seconds ago  Up 5 seconds ago          my-support-tools

   registry.redhat.io/rhel10/support-tools イメージを削除するには、podman stop コマンドを使用して、このイメージから実行されているすべてのコンテナーを停止する必要があります。コンテナーを ID または名前を使用して停止できます。

3. my-support-tools コンテナーを停止します。

   $ podman stop my-support-tools
   7ccd6001166e9720c47fbeb077e0afd0bb635e74a1b0ede3fd34d09eaf5a52e9

4. registry.redhat.io/rhel10/support-tools イメージを削除します。

   $ podman rmi registry.redhat.io/rhel10/support-tools

   • 複数のイメージを削除するには、以下のコマンドを実行します。

     $ podman rmi registry.redhat.io/rhel10/support-tools registry.redhat.io/ubi10/ubi

   • システムからすべてのイメージを削除するには、以下のコマンドを実行します。

     $ podman rmi -a

   • 複数の名前 (タグ) が関連付けられているイメージを削除するには、-f オプションを追加して削除します。

     $ podman rmi -f 1de7d7b3f531
     1de7d7b3f531...

手順

1. cat /etc/os-release コマンドを使用して、registry.access.redhat.com/ubi10/ubi コンテナーイメージをベースとするコンテナーのオペレーティングシステムの種類を表示します。

   $ podman run --rm registry.access.redhat.com/ubi10/ubi cat /etc/os-release
   NAME="Red Hat Enterprise Linux"
   ...
   ID="rhel"
   ...
   HOME_URL="https://www.redhat.com/"
   BUG_REPORT_URL="https://bugzilla.redhat.com/"
   
   REDHAT_BUGZILLA_PRODUCT=" Red Hat Enterprise Linux 10"
   ...

2. オプション: すべてのコンテナーをリスト表示します。

   $ podman ps
   CONTAINER ID  IMAGE   COMMAND  CREATED  STATUS  PORTS   NAMES

   --rm オプションがあるのでコンテナーは表示されません。コンテナーが削除されました。

手順

1. registry.redhat.io/ubi10/ubi イメージに基づいて、myubi という名前のコンテナーを実行します。

   $ podman run --name=myubi -it registry.access.redhat.com/ubi10/ubi /bin/bash
   [root@6ccffd0f6421 /]#

   • -i オプションは対話式のセッションを作成します。-t オプションを指定しないと、シェルは開いたままにも拘らず、シェルには何も入力できません。
   • -t オプションは、端末セッションを開きます。-i オプションを指定しないと、シェルが開き、終了します。

2. システムユーティリティーのセットが含まれる procps-ng パッケージをインストールします (例: ps、top、uptime など)。

   [root@6ccffd0f6421 /]# dnf install procps-ng

3. ps -ef コマンドを使用して、現在のプロセスをリスト表示します。

   # ps -ef
   UID          PID    PPID  C STIME TTY          TIME CMD
   root           1       0  0 12:55 pts/0    00:00:00 /bin/bash
   root          31       1  0 13:07 pts/0    00:00:00 ps -ef

4. exit を実行してコンテナーを終了し、ホストに戻ります。

   # exit

5. 必要に応じて、すべてのコンテナーをリスト表示します。

   $ podman ps -a
   CONTAINER ID  IMAGE                               COMMAND    CREATED         STATUS                     PORTS   NAMES
   1984555a2c27  registry.redhat.io/ubi10/ubi:latest  /bin/bash  21 minutes ago  Exited (0) 21 minutes ago          myubi

   コンテナーが終了ステータスであることを確認できます。

前提条件

1. container-tools メタパッケージがインストールされている。

手順

1. コンテナーツールのインストール: ご使用の RHEL システムに必要なコンテナーツールがインストールされていることを確認します。container-tools モジュールは、Buildah、Podman、Skopeo を提供します。

   $ sudo dnf install container-tools

2. Containerfile の作成: Containerfile は、コンテナーイメージをビルドするための手順を定義したものです。このファイルでは、ベースイメージ、インストールするソフトウェア、適用する設定、実行するアプリケーションを指定します。以下に例を示します。

   FROM registry.redhat.io/ubi10/ubi-minimal
   RUN microdnf -y update && microdnf -y install
   COPY index.html /var/www/html/
   EXPOSE 80
   CMD ["httpd", "-DFOREGROUND"]

3. Buildah を使用してコンテナーイメージをビルドします。コンテナーファイルを含むディレクトリーに移動した後、buildah bud (または podman build) を使用してイメージをビルドします。

   $ cd /<path_to_container_file>
   
   $ buildah bud -t your_image_name:tag .

   • your_image_name: イメージの名前。
   • tag: イメージに付けるタグ (例: latest、1.0)。
   • .: Containerfile がカレントディレクトリーにあることを示します。

4. コンテナーの実行: イメージをビルドした後、podman run コマンドを使用して、そのイメージからコンテナーを実行できます。

   $ podman run -d -p 8080:80 my-web-app

   • -d: コンテナーをデタッチモード (バックグラウンド) で実行します。
   • -p 8080:80: ホスト上のポート 8080 をコンテナー内のポート 80 にマッピングします。

   • my-web-app: 実行するイメージの名前。

     コンテナービルドにおける heredocs 構文

     BuildKit を有効にしておけば、Red Hat Enterprise Linux ベースイメージを使用した Containerfile 内で heredoc 構文を使用できます。コマンドに heredoc 構文が含まれている場合、Containerfile は、heredoc の区切り文字のみを含む行が現れるまでの後続の行を、同じコマンドの一部とみなします。

     heredocs を使用すると、Containerfile 内の RUN や COPY などの命令内に複数行の文字列を直接埋め込むことができます。これは RHEL ベースのイメージで役立ちます。単純なタスク用に個別のスクリプトファイルを作成する必要がなくなり、可読性と保守性が向上するためです。

     たとえば、一般的な使用例として、単一の RUN 命令内で複数のシェルコマンドを実行して単一のイメージレイヤーを作成し、&& \ 構文の使用を回避する例が挙げられます。

手順

1. registry.redhat.io/rhel10/support-tools イメージをベースとするコンテナーを実行します。

   $ podman run -dt registry.redhat.io/rhel10/support-tools

2. すべてのコンテナーをリスト表示します。

   • 実行中のコンテナーのリストを表示するには、以下のコマンドを実行します。

     $ podman ps
     CONTAINER ID IMAGE              COMMAND         CREATED       STATUS            PORTS NAMES
     74b1da000a11 rhel10/support-tools /usr/bin/bash 2 minutes ago Up About a minute       musing_brown

   • 実行中または停止中のすべてのコンテナーをリスト表示するには、以下を実行します。

     $ podman ps -a
     CONTAINER ID IMAGE         COMMAND    CREATED    STATUS                PORTS NAMES     IS INFRA
     d65aecc325a4 ubi10/ubi      /bin/bash  3 secs ago Exited (0) 5 secs ago peaceful_hopper false
     74b1da000a11 rhel10/support-tools /usr/bin/bash 2 mins ago Up About a minute     musing_brown    false

     --rm オプションを使用して削除しなかった場合、実行されていないコンテナーを再起動できます。

     詳細は、システム上の podman-images(1) man ページを参照してください。

手順

1. myubi コンテナーを起動します。

   • 非対話モードで以下を行います。

     $ podman start myubi

   • インタラクティブモードで -a (--attach) および -i (--interactive) オプションを使用して、コンテナーの bash シェルと連携します。

     $ podman start -a -i myubi

2. exit を実行してコンテナーを終了し、ホストに戻ります。

   [root@6ccffd0f6421 /]# exit

   詳細は、システム上の podman-start(1) man ページを参照してください。

手順

1. log_test という名前のコンテナーを実行し、コンテナーにホストの /dev/log デバイスをマウントします。

   # podman run --name="log_test" -v /dev/log:/dev/log --rm \
     registry.redhat.io/ubi10/ubi logger "Testing logging to the host"

2. journalctl ユーティリティーを使用してログを表示します。

   # journalctl -b | grep Testing
   Dec 09 16:55:00 localhost.localdomain root[14634]: Testing logging to the host

   --rm オプションは、終了時にコンテナーを削除します。

手順

1. mysyslog という名前のコンテナーを実行します。

   # podman run -dt --name=mysyslog registry.redhat.io/rhel10/support-tools

2. podman mount コマンドを実行して、ホストからアクセス可能な場所に、作業コンテナーの root ファイルシステムをマウントします。たとえば、mysyslog コンテナーをマウントします。

   # podman mount mysyslog
   /var/lib/containers/storage/overlay/990b5c6ddcdeed4bde7b245885ce4544c553d108310e2b797d7be46750894719/merged

3. ls コマンドを使用して、マウントポイントのコンテンツを表示します。

   # ls /var/lib/containers/storage/overlay/990b5c6ddcdeed4bde7b245885ce4544c553d108310e2b797d7be46750894719/merged
   bin  boot  dev  etc  home  lib  lib64  lost+found  media  mnt  opt  proc  root  run  sbin  srv  sys  tmp  usr  var

4. OS バージョンを表示します。

   # cat /var/lib/containers/storage/overlay/990b5c6ddcdeed4bde7b245885ce4544c553d108310e2b797d7be46750894719/merged/etc/os-release
   NAME="Red Hat Enterprise Linux"
   VERSION="10 (Ootpa)"
   ID="rhel"
   ID_LIKE="fedora"
   ...

   詳細は、システム上の podman-mount(1) man ページを参照してください。

手順

1. コンテナーのネットワークインターフェイスを IP アドレス 10.88.0.44 に設定します。

   # podman run -d --ip=10.88.0.44 registry.redhat.io/rhel10/support-tools
   efde5f0a8c723f70dd5cb5dc3d5039df3b962fae65575b08662e0d5b5f9fbe85

2. IP アドレスが正しく設定されていることを確認します。

   # podman inspect efde5f0a8c723 | grep 10.88.0.44
   "IPAddress": "10.88.0.44",

   詳細は、システム上の podman-inspect(1) および podman-run(1) man ページを参照してください。

手順

1. my-support-tools コンテナー内で rpm -qa コマンドを入力して、インストールされているすべてのパッケージをリストします。

   $ podman exec -it my-support-tools rpm -qa
   gpg-pubkey-fd431d51-4ae0493b
   gpg-pubkey-5a6340b3-6229229e
   libgcc-11.5.0-2.el9.x86_64
   setup-2.13.7-10.el9.noarch
   ...

2. my-support-tools コンテナーで /bin/bash コマンドを入力します。

   $ podman exec -it my-support-tools /bin/bash

3. システムユーティリティーのセットが含まれる procps-ng パッケージをインストールします (例: ps、top、uptime など)。

   # dnf install procps-ng

4. コンテナーを検査します。

   • システムにある全プロセスをリスト表示するには、以下のコマンドを実行します。

     # ps -ef
     UID          PID    PPID  C STIME TTY          TIME CMD
     root           8       0  0 11:07 pts/0    00:00:00 /bin/bash
     root          47       8  0 11:13 pts/0    00:00:00 ps -ef

   • ファイルシステムのディスク領域の使用量を表示するには、次のコマンドを実行します。

     # df -h
     Filesystem      Size  Used Avail Use% Mounted on
     tmpfs           6.3G  448K  6.3G   1% /etc/hosts
     shm              63M     0   63M   0% /dev/shm
     overlay         953G   76G  877G   8% /
     tmpfs            64M     0   64M   0% /dev
     devtmpfs        4.0M     0  4.0M   0% /dev/tty
     ...

   • システム情報を表示するには、以下のコマンドを実行します。

     # uname -r
     6.12.0-124.15.1.el10_1.x86_64

   • MB 単位でメモリーの空き容量を表示するには、次のコマンドを実行します。

     # free --mega
     total        used        free      shared  buff/cache   available
     Mem:       2818         615        1183          12         1020        1957
     Swap:      3124           0        3124

手順

1. ボリュームを作成します。

   $ podman volume create hostvolume

2. ボリュームに関する情報を表示します。

   $ podman volume inspect hostvolume
   [
       {
           "name": "hostvolume",
           "labels": {},
           "mountpoint": "/home/username/.local/share/containers/storage/volumes/hostvolume/_data",
           "driver": "local",
           "options": {},
           "scope": "local"
       }
   ]

   volumes ディレクトリーにボリュームが作成されることに注意してください。$ mntPoint=$(podman volume inspect hostvolume --format {{.Mountpoint}}) で、変数へのマウントポイントパスを保存して操作を簡素化できます。

   sudo podman volume create hostvolume を実行すると、マウントポイントが /var/lib/containers/storage/volumes/hostvolume/_data に変わります。

3. mntPoint 変数に保管されたパスを使用して、ディレクトリー内にテキストファイルを作成します。

   $ echo "Hello from host" >> $mntPoint/host.txt

4. mntPoint 変数で定義されたディレクトリー内の全ファイルをリスト表示します。

   $ ls $mntPoint/
   host.txt

5. myubi1 という名前のコンテナーを実行し、ホストのボリューム名 hostvolume で定義したディレクトリーをコンテナーの /containervolume1 ディレクトリーにマッピングします。

   $ podman run -it --name myubi1 -v hostvolume:/containervolume1 registry.access.redhat.com/ubi10/ubi /bin/bash

   mntPoint 変数 (-v $mntPoint:/containervolume1) で定義したボリュームパスを使用する場合には、podman volume prune コマンドを実行すると未使用のボリュームが削除され、データが失われる場合がある点に注意してください。常に -v hostvolume_name:/containervolume_name を使用します。

6. コンテナー上にある共有ボリューム内のファイルをリスト表示します。

   # ls /containervolume1
   host.txt

   ホスト上で作成した host.txt ファイルが表示されます。

7. /containervolume1 ディレクトリーにテキストファイルを作成します。

   # echo "Hello from container 1" >> /containervolume1/container1.txt

8. CTRL+p および CTRL+q を使用してコンテナーからデタッチします。

9. ホスト上にある共有ボリューム内のファイルをリスト表示します。以下の 2 つのファイルが表示されるはずです。

   $ ls $mntPoint
   container1.rxt  host.txt

   この時点で、コンテナーとホスト間でファイルを共有しています。2 つのコンテナー間でファイルを共有するには、myubi2 という名前の別のコンテナーを実行します。

10. myubi2 という名前のコンテナーを実行し、ホストのボリューム名 hostvolume で定義したディレクトリーをコンテナーの /containervolume2 ディレクトリーにマッピングします。

    $ podman run -it --name myubi2 -v hostvolume:/containervolume2 registry.access.redhat.com/ubi10/ubi /bin/bash

11. コンテナー上にある共有ボリューム内のファイルをリスト表示します。

    # ls /containervolume2
    container1.txt host.txt

    ホストで作成した host.txt ファイルと、myubi1 コンテナー内に作成した container1.txt ファイルが表示されます。

12. /containervolume2 ディレクトリーにテキストファイルを作成します。

    # echo "Hello from container 2" >> /containervolume2/container2.txt

13. CTRL+p および CTRL+q を使用してコンテナーからデタッチします。

14. ホスト上にある共有ボリューム内のファイルをリスト表示します。以下の 3 つのファイルが表示されるはずです。

    $ ls $mntPoint
    container1.rxt  container2.txt host.txt

    詳細は、システム上の podman-volume(1) man ページを参照してください。

手順

1. registry.access.redhat.com/ubi10/ubi イメージをベースとする myubi コンテナーを実行します。

   $ podman run -dt --name=myubi registry.access.redhat.com/10/ubi

2. 必要に応じて、すべてのコンテナーをリスト表示します。

   $ podman ps -a
   CONTAINER ID  IMAGE                                    COMMAND          CREATED     STATUS         PORTS   NAMES
   a6a6d4896142  registry.access.redhat.com/10:latest   /bin/bash        7 seconds ago  Up 7 seconds ago          myubi

3. myubi コンテナーに割り当てます。

   $ podman attach myubi

4. testfile という名前のファイルを作成します。

   [root@a6a6d4896142 /]# echo "hello" > testfile

5. CTRL+p および CTRL+q を使用してコンテナーからデタッチします。

6. ローカルマシンで、myubi のファイルシステムを myubi-container.tar としてエクスポートします。

   $ podman export -o myubi.tar a6a6d4896142

7. 必要に応じて、現在のディレクトリーの内容をリスト表示します。

   $ ls -l
   -rw-r--r--. 1 user user 210885120 Apr  6 10:50 myubi-container.tar
   ...

8. 必要に応じて、myubi-container ディレクトリーを作成し、myubi-container.tar アーカイブからすべてのファイルを抽出します。ツリー形式で myubi-directory の内容をリスト表示します。

   $ mkdir myubi-container
   $ tar -xf myubi-container.tar -C myubi-container
   $ tree -L 1 myubi-container
   ├── bin -> usr/bin
   ├── boot
   ├── dev
   ├── etc
   ├── home
   ├── lib -> usr/lib
   ├── lib64 -> usr/lib64
   ├── lost+found
   ├── media
   ├── mnt
   ├── opt
   ├── proc
   ├── root
   ├── run
   ├── sbin -> usr/sbin
   ├── srv
   ├── sys
   ├── testfile
   ├── tmp
   ├── usr
   └── var
   
   20 directories, 1 file

   myubi-container.tar にコンテナーのファイルシステムが含まれていることを確認できます。

9. myubi.tar をインポートして、ファイルシステムイメージとして保存します。

   $ podman import myubi.tar myubi-imported
   Getting image source signatures
   Copying blob 277cab30fe96 done
   Copying config c296689a17 done
   Writing manifest to image destination
   Storing signatures
   c296689a17da2f33bf9d16071911636d7ce4d63f329741db679c3f41537e7cbf

10. すべてのイメージをリスト表示します。

    $ podman images
    REPOSITORY                              TAG     IMAGE ID      CREATED         SIZE
    docker.io/library/myubi-imported       latest  c296689a17da  51 seconds ago  211 MB

11. testfile ファイルの内容を表示します。

    $ podman run -it --name=myubi-imported myubi-imported cat testfile
    hello

    podman export コマンドを使用して、実行中のコンテナーのファイルシステムをローカルマシンの tar ファイルにエクスポートできます。たとえば、使用頻度の低い大きなコンテナーや、後で復元するためにスナップショットを保存しておきたいコンテナーがある場合などです。

    podman import コマンドを使用して tar ファイルをインポートし、ファイルシステムイメージとして保存できます。これにより、このファイルシステムイメージを実行するか、他のイメージのレイヤーとして使用できます。

    詳細は、システム上の podman-export (1) および podman-import(1) の man ページを参照してください。

手順

1. (実行中または停止中の) すべてのコンテナーを一覧表示するには、以下を実行します。

   $ podman ps -a
   CONTAINER ID IMAGE         COMMAND    CREATED    STATUS                PORTS NAMES     IS INFRA
   d65aecc325a4 ubi10/ubi      /bin/bash  3 secs ago Exited (0) 5 secs ago peaceful_hopper false
   74b1da000a11 rhel10/support-tools usr/bin/bash 2 mins ago Up About a minute     musing_brown    false

2. コンテナーを削除します。

   • peaceful_hopper を削除するには以下を実行します。

     $ podman rm peaceful_hopper

     peaceful_hopper コンテナーが終了ステータスであったことに注意してください。コンテナーが停止されているので、即座に削除できます。

   • musing_brown コンテナーを削除するには、まずコンテナーを停止してから削除します。

     $ podman stop musing_brown
     $ podman rm musing_brown

   • 複数のコンテナーを削除するには、以下を実行します。

     $ podman rm clever_yonath furious_shockley

   • ローカルシステムからすべてのコンテナーを削除するには、以下のコマンドを実行します。

     $ podman rm -a

手順

1. 新しいディレクトリーに以下の内容を含む Containerfile を作成します。

   FROM registry.access.redhat.com/ubi10/ubi-init
   RUN dnf -y install httpd; dnf clean all; systemctl enable httpd;
   RUN echo "Successful Web Server Test" > /var/www/html/index.html
   RUN mkdir /etc/systemd/system/httpd.service.d/; echo -e '[Service]\nRestart=always' > /etc/systemd/system/httpd.service.d/httpd.conf
   EXPOSE 80
   CMD [ "/sbin/init" ]

   Containerfile は、httpd パッケージをインストールし、ブート時に httpd サービスが開始できるようにし、テストファイル (index.html) を作成し、Web サーバーをホスト (ポート 80) に公開し、コンテナーの起動時、systemd init サービス (/sbin/init) を開始します。

2. コンテナーをビルドします。

   # podman build --format=docker -t mysysd .

3. オプション: お使いのシステムで systemd を使用してコンテナーを実行し、SELinux を有効にする場合は、container_manage_cgroup ブール値変数を設定する必要があります。

   # setsebool -P container_manage_cgroup 1

4. mysysd_run という名前のコンテナーを実行します。

   # podman run -d --name=mysysd_run -p 80:80 mysysd

   mysysd イメージが mysysd_run コンテナーをデーモンプロセスとして実行し、コンテナーのポート 80 がホストシステムのポート 80 に公開されます。

   注記

   ルートレスモードでは、1024 以上のホストのポート番号を選択する必要があります。以下に例を示します。

   $ podman run -d --name=mysysd -p 8081:80 mysysd

   1024 未満のポート番号を使用するには、net.ipv4.ip_unprivileged_port_start 変数を変更する必要があります。

   # sysctl net.ipv4.ip_unprivileged_port_start=80

5. コンテナーが実行されていることを確認します。

   # podman ps
   a282b0c2ad3d  localhost/mysysd:latest  /sbin/init  15 seconds ago  Up 14 seconds ago  0.0.0.0:80->80/tcp  mysysd_run

6. Web サーバーをテストします。

   # curl localhost/index.html
   Successful Web Server Test

手順

1. registry.access.redhat.com/ubi10/ubi-micro イメージをプルしてビルドします。

   # microcontainer=$(buildah from registry.access.redhat.com/ubi10/ubi-micro)

2. 作業中のコンテナーの root ファイルシステムをマウントします。

   # micromount=$(buildah mount $microcontainer)

3. httpd サービスを micromount ディレクトリーにインストールします。

   # dnf install \
       --installroot $micromount \
       --releasever=/ \
       --setopt install_weak_deps=false \
       --setopt=reposdir=/etc/yum.repos.d/ \
       --nodocs -y \
       httpd
   # dnf clean all \
       --installroot $micromount

4. 作業コンテナーで root ファイルシステムをアンマウントします。

   # buildah umount $microcontainer

5. 作業コンテナーから ubi-micro-httpd イメージを作成します。

   # buildah commit $microcontainer ubi-micro-httpd

検証

1. ubi-micro-httpd イメージの詳細を表示します。

   # podman images ubi-micro-httpd
   localhost/ubi-micro-httpd latest 7c557e7fbe9f  22 minutes ago  151 MB

手順

1. registry.access.redhat.com/ubi10/ubi イメージをプルして実行します。

   $ podman run -it --name myubi registry.access.redhat.com/ubi10/ubi

2. myubi コンテナーにパッケージを追加します。

   • UBI リポジトリーにあるパッケージを追加するには、UBI リポジトリー以外の dnf リポジトリーをすべて無効にします。たとえば、bzip2 パッケージを追加するには、次のコマンドを実行します。

     # dnf install --disablerepo==* --enablerepo=ubi-10-for-x86_64-appstream-rpms --enablerepo=ubi-10-for-x86_64-baseos-rpms bzip2

   • UBI リポジトリーにないパッケージを追加するには、リポジトリーを無効にしないでください。たとえば、zsh パッケージを追加するには、次のコマンドを実行します。

     # dnf install zsh

   • 別のホストリポジトリーにあるパッケージを追加するには、必要なリポジトリーを明示的に有効にします。たとえば、codeready-builder-for-ubi-10-x86_64-rpms リポジトリーから python3-devel パッケージをインストールするには、以下のコマンドを実行します。

     # dnf install --enablerepo=codeready-builder-for-ubi-10-x86_64-rpms python3-devel

検証

1. コンテナー内で有効なリポジトリーのリストを表示します。

   # dnf repolist

2. 必要なリポジトリーがリスト表示されていることを確認します。

3. インストール済みパッケージのリストを表示します。

   # rpm -qa

4. 必要なパッケージがリスト表示されていることを確認します。

手順

1. registry.access.redhat.com/ubi10/ubi-minimal イメージをプルして実行します。

   $ podman run -it --name myubimin registry.access.redhat.com/ubi10/ubi-minimal

2. myubimin コンテナーにパッケージを追加します。

   • UBI リポジトリーにあるパッケージを追加するには、リポジトリーを無効にしないでください。たとえば、bzip2 パッケージを追加するには、次のコマンドを実行します。

     # microdnf install bzip2 --setopt install_weak_deps=0

   • 別のホストリポジトリーにあるパッケージを追加するには、必要なリポジトリーを明示的に有効にします。たとえば、codeready-builder-for-rhel-10-x86_64-rpms リポジトリーから python3-devel パッケージをインストールするには、以下のコマンドを実行します。

     # microdnf install --enablerepo=codeready-builder-for-rhel-10-x86_64-rpms python3-devel --setopt install_weak_deps=0

     --setopt install_weak_deps=false オプションは、weak 依存関係のインストールを無効にします。Weak 依存関係には、厳密には必要ではないが、デフォルトでインストールされることが多い推奨パッケージや提案パッケージが含まれます。

検証

1. コンテナー内で有効なリポジトリーのリストを表示します。

   # microdnf repolist

2. 必要なリポジトリーがリスト表示されていることを確認します。

3. インストール済みパッケージのリストを表示します。

   # rpm -qa

4. 必要なパッケージがリスト表示されていることを確認します。

検証

1. 有効なリポジトリーをリスト表示します。

   • UBI standard イメージまたは UBI init イメージをベースとするコンテナー内で、有効なリポジトリーをすべてリスト表示する場合は、以下を実行します。

     #  dnf repolist

   • UBI minimal コンテナーをベースとするコンテナー内で、有効なリポジトリーをすべてリスト表示する場合は、以下を実行します。

     # microdnf repolist

2. 必要なリポジトリーがリスト表示されていることを確認します。

3. インストール済みパッケージのリストを表示します。

   # rpm -qa

4. 必要なパッケージがリスト表示されていることを確認します。

手順

1. Containerfile を作成します。

   FROM registry.access.redhat.com/ubi10/ubi
   USER root
   LABEL maintainer="John Doe"
   # Update image
   RUN dnf update --disablerepo=* --enablerepo=ubi-10-appstream-rpms --enablerepo=ubi-10-baseos-rpms -y && rm -rf /var/cache/yum
   RUN dnf install --disablerepo=* --enablerepo=ubi-10-appstream-rpms --enablerepo=ubi-10-baseos-rpms httpd -y && rm -rf /var/cache/yum
   # Add default Web page and expose port
   RUN echo "The Web Server is Running" > /var/www/html/index.html
   EXPOSE 80
   # Start the service
   CMD ["-D", "FOREGROUND"]
   ENTRYPOINT ["/usr/sbin/httpd"]

2. コンテナーイメージをビルドします。

   # buildah bud -t johndoe/webserver .
   STEP 1: FROM registry.access.redhat.com/ubi10/ubi:latest
   STEP 2: USER root
   STEP 3: LABEL maintainer="John Doe"
   STEP 4: RUN dnf update --disablerepo=* --enablerepo=ubi-10-appstream-rpms --enablerepo=ubi-10-baseos-rpms -y
   ...
   Writing manifest to image destination
   Storing signatures
   --> f9874f27050
   f9874f270500c255b950e751e53d37c6f8f6dba13425d42f30c2a8ef26b769f2

検証

1. Web サーバーを実行します。

   # podman run -d --name=myweb -p 80:80 johndoe/webserver
   bbe98c71d18720d966e4567949888dc4fb86eec7d304e785d5177168a5965f64

2. Web サーバーをテストします。

   # curl http://localhost/index.html
   The Web Server is Running

手順

1. skopeo copy コマンドを使用して、ソースコンテナーイメージをローカルディレクトリーにコピーします。

   $ skopeo copy \
   docker://registry.access.redhat.com/ubi10:8.1-397-source \
   dir:$HOME/TEST
   ...
   Copying blob 477bc8106765 done
   Copying blob c438818481d3 done
   ...
   Writing manifest to image destination
   Storing signatures

2. skopeo inspect コマンドを使用して、ソースコンテナーイメージを検査します。

   $ skopeo inspect dir:$HOME/TEST
   {
       "Digest": "sha256:7ab721ef3305271bbb629a6db065c59bbeb87bc53e7cbf88e2953a1217ba7322",
       "RepoTags": [],
       "Created": "2020-02-11T12:14:18.612461174Z",
       "DockerVersion": "",
       "Labels": null,
       "Architecture": "amd64",
       "Os": "linux",
       "Layers": [
           "sha256:1ae73d938ab9f11718d0f6a4148eb07d38ac1c0a70b1d03e751de8bf3c2c87fa",
           "sha256:9fe966885cb8712c47efe5ecc2eaa0797a0d5ffb8b119c4bd4b400cc9e255421",
           "sha256:61b2527a4b836a4efbb82dfd449c0556c0f769570a6c02e112f88f8bbcd90166",
           ...
           "sha256:cc56c782b513e2bdd2cc2af77b69e13df4ab624ddb856c4d086206b46b9b9e5f",
           "sha256:dcf9396fdada4e6c1ce667b306b7f08a83c9e6b39d0955c481b8ea5b2a465b32",
           "sha256:feb6d2ae252402ea6a6fca8a158a7d32c7e4572db0e6e5a5eab15d4e0777951e"
       ],
       "Env": null
   }

3. すべてのコンテンツを展開します。

   $ cd $HOME/TEST
   $ for f in $(ls); do tar xvf $f; done

4. 結果を確認します。

   $ find blobs/ rpm_dir/
   blobs/
   blobs/sha256
   blobs/sha256/10914f1fff060ce31388f5ab963871870535aaaa551629f5ad182384d60fdf82
   rpm_dir/
   rpm_dir/gzip-1.9-4.el8.src.rpm

   結果が正しい場合は、イメージを使用できる状態になります。

   注記

   コンテナーイメージがリリースされてから、関連するソースコンテナーが利用可能になるまでに数時間かかる場合があります。

   詳細は、システム上の skopeo-copy (1) および skopeo-inspect(1) の man ページを参照してください。

手順

1. sigstore の公開鍵または秘密鍵のペアを生成します。

   $ skopeo generate-sigstore-key --output-prefix myKey.private

2. 次の内容を /etc/containers/registries.d/default.yaml ファイルに追加します。

   docker:
       <registry>:
           use-sigstore-attachments: true

   use-sigstore-attachments オプションを設定することで、Podman と Skopeo はコンテナーの sigstore 署名をイメージと共に読み書きし、署名されたイメージと同じリポジトリーに保存できます。

   /etc/containers/registries.d/default.yaml ファイルで、システム全体のレジストリー設定を編集できます。/etc/containers/registries.d ディレクトリーにある任意の YAML ファイルのレジストリーまたはリポジトリー設定セクションを編集することもできます。

   すべての YAML ファイルが読み取られ、ファイル名は任意です。単一のスコープ (default-docker、registry、または namespace) は、/etc/containers/registries.d/ ディレクトリー内の 1 つのファイルにのみ存在できます。

3. カレントディレクトリーの Containerfile を使用して、コンテナーイメージをビルドします。

   $ podman build -t <registry>/<namespace>/<image>

4. イメージに署名し、レジストリーにプッシュします。

   $ podman push --sign-by-sigstore-private-key ./myKey.private <registry>/<namespace>/<image>

   podman push コマンドは、<registry>/<namespace>/<image> ローカルイメージを <registry>/<namespace>/<image> としてリモートレジストリーにプッシュします。--sign-by-sigstore-private-key オプションは、myKey.private 秘密鍵を使用して sigstore 署名を <registry>/<namespace>/<image> イメージに追加します。イメージと sigstore 署名がリモートレジストリーにアップロードされます。

   注記

   既存のイメージをコンテナーレジストリー間で移動するときに署名する必要がある場合は、skopeo copy コマンドを使用できます。

   詳細は、お使いのシステムの podman-push(1) および podman-build(1) の man ページを参照してください。

手順

1. 次の内容を /etc/containers/registries.conf.d/default.yaml ファイルに追加します。

   docker:
       <registry>:
           use-sigstore-attachments: true

   use-sigstore-attachments オプションを設定することで、Podman と Skopeo はコンテナーの sigstore 署名をイメージと共に読み書きし、署名されたイメージと同じリポジトリーに保存できます。

   /etc/containers/registries.d/ ディレクトリー内の任意の YAML ファイルのレジストリーまたはリポジトリー設定セクションを編集できます。単一のスコープ (default-docker、registry、または namespace) は、/etc/containers/registries.d/ ディレクトリー内の 1 つのファイルにのみ存在できます。

   /etc/containers/registries.d/default.yaml ファイルでシステム全体のレジストリー設定を編集することもできます。すべての YAML ファイルが読み取られ、ファイル名は任意であることに注意してください。

2. /etc/containers/registries.d/file.yml ファイルを作成します。

   fulcio:
     fulcioURL: "https://<your-fulcio-server>"
     oidcMode: "interactive"
     oidcIssuerURL: "https://<your-OIDC-provider>"
     oidcClientID: "sigstore"
   rekorURL: "https://<your-rekor-server>"

   file.yml は、sigstore 署名の作成に必要なオプションを保存するために使用される sigstore 署名パラメーター YAML ファイルです。

3. イメージに署名し、レジストリーにプッシュします。

   $ podman push --sign-by-sigstore=file.yml <registry>/<namespace>/<image>

   あるいは、同様の --sign-by-sigstore オプションを指定して skopeo copy コマンドを使用して、既存のイメージをコンテナーレジストリー間で移動しながら署名することもできます。

   警告

   パブリックサーバーへの送信には、公開鍵、証明書、および署名メタデータが含まれる点に注意してください。

   詳細は、システム上の containers-sigstore-signing-params.yaml、podman-push(1)、および container-registries.d の man ページを参照してください。

手順

1. sigstore の公開鍵または秘密鍵のペアを生成します。

   $ skopeo generate-sigstore-key --output-prefix myKey.private

   公開鍵と秘密鍵 myKey.pub と myKey.private が生成されます。

2. 以下を /etc/containers/registries.conf.d/default.yaml ファイルに追加します。

   docker:
       <registry>:
           use-sigstore-attachments: true

   use-sigstore-attachments オプションを設定することで、Podman と Skopeo はコンテナーの sigstore 署名をイメージと共に読み書きし、署名されたイメージと同じリポジトリーに保存できます。

   注記

   /etc/containers/registries.d/ ディレクトリー内の任意の YAML ファイルのレジストリーまたはリポジトリー設定セクションを編集できます。単一のスコープ (default-docker、registry、または namespace) は、/etc/containers/registries.d/ ディレクトリー内の 1 つのファイルにのみ存在できます。/etc/containers/registries.d/default.yaml ファイルでシステム全体のレジストリー設定を編集することもできます。すべての YAML ファイルが読み取られ、ファイル名は任意であることに注意してください。

3. カレントディレクトリーの Containerfile を使用して、コンテナーイメージをビルドします。

   $ podman build -t <registry>/<namespace>/<image>

4. /etc/containers/registries.d/file.yml ファイルを作成します。

   privateKeyFile: "/home/user/sigstore/myKey.private"
   privateKeyPassphraseFile: "/mnt/user/sigstore-myKey.private-passphrase"
   rekorURL: "https://<your-rekor-server>"

   file.yml は、sigstore 署名の作成に必要なオプションを保存するために使用される sigstore 署名パラメーター YAML ファイルです。

5. イメージに署名し、レジストリーにプッシュします。

   $ podman push --sign-by-sigstore=file.yml <registry>/<namespace>/<image>

   あるいは、同様の --sign-by-sigstore オプションを指定して skopeo copy コマンドを使用して、既存のイメージをコンテナーレジストリー間で移動しながら署名することもできます。

   警告

   パブリックサーバーへの送信には、公開鍵に関するデータと署名に関するメタデータが含まれる点に注意してください。

手順

1. GPG キーを生成します。

   # gpg --full-gen-key

2. 公開鍵をエクスポートします。

   # gpg --output <path>/key.gpg --armor --export <username@example.com>

3. カレントディレクトリーの Containerfile を使用して、コンテナーイメージをビルドします。

   $ podman build -t <registry>/<namespace>/<image>

   <registry>、<namespace>、および <image> をコンテナーイメージ識別子に置き換えます。

4. イメージに署名し、レジストリーにプッシュします。

    $  podman push \
       --sign-by <username@example.com> \
       <registry>/<namespace>/<image>

   注記

   既存のイメージをコンテナーレジストリー間で移動するときに署名する必要がある場合は、skopeo copy コマンドを使用できます。

5. オプション: 新しいイメージ署名を表示します。

   # (cd /var/lib/containers/sigstore/; find . -type f)
   ./<image>@sha256=<digest>/signature-1

6. ローカル署名をルックアサイド Web サーバーにコピーします。

   # rsync -a /var/lib/containers/sigstore <user@registry-lookaside.example.com>:/registry-lookaside/webroot/sigstore

   署名は、lookaside-staging オプションによって決定される場所 (この場合は /var/lib/containers/sigstore ディレクトリー) に保存されます。

手順

1. 現在のディレクトリーで Containerfile を使用してコンテナーイメージをビルドします。

   $ podman build -t <registry>/<namespace>/<image>

2. キーを生成します。

   # sq key generate --own-key --email <test@example.com> --name <namspace>

3. 証明書をエクスポートします。

   # sq cert export --cert=<fingerprint_or_key_ID> --output mycerts/sequoia-key.pub

4. policy.json ファイルを有効なキーを指すように設定します。

5. キーを使用してイメージに署名してプッシュします。

   $ podman push --sign-by-sq-fingerprint <fingerprint> /<registry>/<namespace>/<image>

手順

1. 空の Pod を作成します。

   $ podman pod create --name mypod
   223df6b390b4ea87a090a4b5207f7b9b003187a6960bd37631ae9bc12c433aff
   The pod is in the initial state Created.

   Pod の初期状態は Created です。

2. 必要に応じて、すべての Pod をリスト表示します。

   $ podman pod ps
   POD ID         NAME    STATUS    CREATED                  # OF CONTAINERS   INFRA ID
   223df6b390b4   mypod   Created   Less than a second ago   1                 3afdcd93de3e

   Pod にはコンテナーが 1 つあることに注意してください。

3. 必要に応じて、関連付けられている全 Pod およびコンテナーをリスト表示します。

   $ podman ps -a --pod
   CONTAINER ID  IMAGE                 COMMAND  CREATED                 STATUS   PORTS  NAMES               POD
   3afdcd93de3e  registry.access.redhat.com/ubi10/pause            Less than a second ago  Created         223df6b390b4-infra  223df6b390b4

   podman ps コマンドからの Pod ID と podman pod ps コマンドの Pod ID が一致することが確認できます。デフォルトの infra コンテナーは registry.access.redhat.com/ubi10/pause イメージをベースとしています。

4. mypod という名前の既存 Pod 内で、名前が myubi のコンテナーを実行します。

   $ podman run -dt --name myubi --pod mypod registry.access.redhat.com/ubi10/ubi /bin/bash
   5df5c48fea87860cf75822ceab8370548b04c78be9fc156570949013863ccf71

5. 必要に応じて、すべての Pod をリスト表示します。

   $ podman pod ps
   POD ID         NAME    STATUS    CREATED                  # OF CONTAINERS   INFRA ID
   223df6b390b4   mypod   Running   Less than a second ago   2                 3afdcd93de3e

   Pod にはコンテナーが 2 つあることが分かります。

6. 必要に応じて、関連付けられている全 Pod およびコンテナーをリスト表示します。

   $ podman ps -a --pod
   CONTAINER ID  IMAGE                                       COMMAND    CREATED                 STATUS                     PORTS  NAMES               POD
   5df5c48fea87  registry.access.redhat.com/ubi10/ubi:latest  /bin/bash  Less than a second ago  Up Less than a second ago         myubi               223df6b390b4
   3afdcd93de3e  registry.access.redhat.com/ubi10/pause                                   Less than a second ago  Up Less than a second ago         223df6b390b4-infra  223df6b390b4

手順

1. Pod mypod を停止します。

   $ podman pod stop mypod

2. 必要に応じて、関連付けられている全 Pod およびコンテナーをリスト表示します。

   $ podman ps -a --pod
   CONTAINER ID  IMAGE                               COMMAND    CREATED             STATUS                    PORTS   NAMES               POD ID        PODNAME
   5df5c48fea87  registry.redhat.io/ubi10/ubi:latest  /bin/bash  About a minute ago  Exited (0) 7 seconds ago          myubi               223df6b390b4  mypod
   
   3afdcd93de3e  registry.access.redhat.com/10/pause                           About a minute ago  Exited (0) 7 seconds ago          8a4e6527ac9d-infra  223df6b390b4  mypod

   Pod mypod およびコンテナー myubi のステータスが "Exited" であることが分かります。

手順

1. 以下を入力して、Pod mypod を削除します。

   $ podman pod rm mypod
   223df6b390b4ea87a090a4b5207f7b9b003187a6960bd37631ae9bc12c433aff

   Pod を削除すると、その Pod 中の全コンテナーが自動的に削除されることに注意してください。

手順

1. すべてのネットワークをリストアップします。

   # podman network ls
   NETWORK ID    NAME        VERSION     PLUGINS
   2f259bab93aa  podman      0.4.0       bridge,portmap,firewall,tuning
   11c844f95e28  mynet       0.4.0       bridge,portmap,firewall,tuning,dnsname

2. mynet ネットワークを削除します。

   # podman network rm mynet
   mynet

   注記

   削除されたネットワークにコンテナーが関連付けられている場合は、podman network rm -f コマンドを使用してコンテナーと Pod を削除する必要があります。

手順

1. オプション: pasta ネットワークモードを使用する場合は、passt パッケージをインストールします。

   $ {PackageManager} install passt

2. registry.access.redhat.com/ubi10/ubi イメージをベースとするコンテナーを実行します。

   $ podman run --network=<network_mode> -d --name=myubi registry.access.redhat.com/ubi10/ubi

   <network_mode> は、必要なネットワークモードです。あるいは、containers.conf ファイルの default_rootless_network_cmd オプションを使用して、デフォルトのネットワークモードを切り替えることもできます。

   注記

   ルートレスコンテナーのデフォルトのネットワークモードは pasta です。

手順

1. コンテナーの IP アドレスを表示します。

   # podman inspect --format='{{.NetworkSettings.IPAddress}}' <containerName>

2. コンテナーが接続されている全ネットワークを表示します。

   # podman inspect --format='{{.NetworkSettings.Networks}}' <containerName>

3. ポートマッピングを表示します。

   # podman inspect --format='{{.NetworkSettings.Ports}}' <containerName>

手順

1. web-container という名前のコンテナーを起動します。

   # podman run -dt --name=web-container docker.io/library/httpd

2. すべてのコンテナーをリスト表示します。

   # podman ps -a
   
   CONTAINER ID  IMAGE                           COMMAND           CREATED        STATUS            PORTS       NAMES
   b8c057333513  docker.io/library/httpd:latest  httpd-foreground  4 seconds ago  Up 5 seconds ago              web-container

3. コンテナーを点検し、IP アドレスを表示します。

   # podman inspect --format='{{.NetworkSettings.IPAddress}}' web-container
   
   10.88.0.2

4. myubi コンテナーを実行し、Web サーバーが動作していることを確認します。

   # podman run -it --name=myubi ubi10/ubi curl 10.88.0.2:80

手順

1. ブリッジが設定されていることを確認します。

   # podman network inspect podman | grep bridge
   
       "type": "bridge"

2. ホストネットワークの設定を表示します。

   # ip addr show cni-podman0
   
   6: podman0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc noqueue state UP group default qlen 1000
       link/ether 62:af:a1:0a:ca:2e brd ff:ff:ff:ff:ff:ff
       inet 10.88.0.1/16 brd 10.88.255.255 scope global podman0
          valid_lft forever preferred_lft forever
       inet6 fe80::60af:a1ff:fe0a:ca2e/64 scope link
          valid_lft forever preferred_lft forever

   web-container に podman0 サブネットの IP が指定されており、ネットワークがホストにブリッジされていることがわかります。

3. web-container をチェックし、その IP アドレスを表示します。

   # podman inspect --format='{{.NetworkSettings.IPAddress}}' web-container
   
   10.88.0.2

4. ホストから直接 web-container にアクセスします。

   $ curl 10.88.0.2:80

手順

1. 未公開のコンテナーを実行します。

   # podman run -dt --name=web1 ubi10/httpd-24

2. 自動的に公開されたコンテナーを実行します。

   # podman run -dt --name=web2 -P ubi10/httpd-24

3. 手動で公開したコンテナーを実行し、コンテナーポート 8080 を公開します。

   # podman run -dt --name=web3 -p 8888:8080 ubi10/httpd-24

4. すべてのコンテナーをリスト表示します。

   # podman ps
   
   CONTAINER ID  IMAGE                                            COMMAND               CREATED         STATUS         PORTS                                             NAMES
   db23e8dabc74  registry.access.redhat.com/ubi10/httpd-24:latest  /usr/bin/run-http...  23 seconds ago  Up 23 seconds  8080/tcp, 8443/tcp                                web1
   1824b8f0a64b  registry.access.redhat.com/ubi10/httpd-24:latest  /usr/bin/run-http...  18 seconds ago  Up 18 seconds  0.0.0.0:33127->8080/tcp, 0.0.0.0:37679->8443/tcp  web2
   39de784d917a  registry.access.redhat.com/ubi10/httpd-24:latest  /usr/bin/run-http...  5 seconds ago  Up 5 seconds  0.0.0.0:8888->8080/tcp, 8443/tcp                  web3

   以下が確認できます。

   • コンテナー web1 には公開ポートがなく、コンテナーネットワークまたはブリッジにでのみアクセスできます。

   • コンテナー web2 は、ポート 33127 と 37679 を自動的にマッピングして、それぞれアプリケーションポート 8080 と 8443 を公開します。

     registry.access.redhat.com/ubi10/httpd-24:latest イメージの Containerfile に EXPOSE 8080 と EXPOSE 8443 コマンドがあるため、自動ポートマッピングが可能です。

   • コンテナー web3 は手動でポートを公開しています。ホストポート 8888 はコンテナーポート 8080 にマッピングされています。

5. web1、web3 コンテナーの IP アドレスを表示します。

   # podman inspect --format='{{.NetworkSettings.IPAddress}}' web1
   # podman inspect --format='{{.NetworkSettings.IPAddress}}' web3

6. <IP>:<port> 表記を使用して web1 コンテナーに到達します。

   # curl 10.88.0.2:8080
   ...
   <title>Test Page for the HTTP Server on Red Hat Enterprise Linux</title>
   ...

7. localhost:<port> 表記を使用して web2 コンテナーに到達します。

   # curl localhost:43595
   ...
   <title>Test Page for the HTTP Server on Red Hat Enterprise Linux</title>
   ...

8. <IP>:<port> 表記を使用して web3 コンテナーに到達します:

   # curl 10.88.0.4:8080
   ...
   <title>Test Page for the HTTP Server on Red Hat Enterprise Linux</title>
   ...

手順

1. mynet ネットワークに接続された receiver コンテナーを実行します。

   # podman run -d --net mynet --name receiver ubi10 sleep 3000

2. sender コンテナーを実行し、その名前で receiver コンテナーにアクセスします。

   # podman run -it --rm --net mynet --name sender alpine ping receiver
   
   PING rcv01 (10.89.0.2): 56 data bytes
   64 bytes from 10.89.0.2: seq=0 ttl=42 time=0.041 ms
   64 bytes from 10.89.0.2: seq=1 ttl=42 time=0.125 ms
   64 bytes from 10.89.0.2: seq=2 ttl=42 time=0.109 ms

   CTRL+C で終了します。

   sender コンテナーは、receiver コンテナーの名前を使用して ping を送信できることがわかります。

手順

1. web-pod という名前の Pod を作成します。

   $ podman pod create --name=web-pod

2. web-container という名前の Web コンテナーを Pod で実行します。

   $ podman container run -d --pod web-pod --name=web-container docker.io/library/httpd

3. 関連付けられている全 Pod およびコンテナーをリスト表示します。

   $ podman ps --pod
   
   CONTAINER ID  IMAGE                           COMMAND           CREATED        STATUS            PORTS       NAMES               POD ID        PODNAME
   58653cf0cf09  k8s.gcr.io/pause:3.5                              4 minutes ago  Up 3 minutes ago              4e61a300c194-infra  4e61a300c194  web-pod
   b3f4255afdb3  docker.io/library/httpd:latest  httpd-foreground  3 minutes ago  Up 3 minutes ago              web-container  4e61a300c194  web-pod

4. docker.io/library/fedora イメージを元に、web-pod でコンテナーを実行します。

   $ podman container run -it --rm --pod web-pod docker.io/library/fedora curl localhost

   コンテナーが web-container に到達できることがわかります。

手順

1. web-pod という名前の Pod を作成します。

   # podman pod create --name=web-pod-publish -p 80:80

2. すべての Pod をリスト表示します。

   # podman pod ls
   
   POD ID        NAME         STATUS   CREATED        INFRA ID      # OF CONTAINERS
   26fe5de43ab3  web-pod-publish Created  5 seconds ago  7de09076d2b3  1

3. web-pod で web-container という名前の Web コンテナーを実行します。

   # podman container run -d --pod web-pod-publish --name=web-container docker.io/library/httpd

4. コンテナーの一覧を表示します。

   # podman ps
   
   CONTAINER ID  IMAGE                    COMMAND           CREATED             STATUS             PORTS               NAMES
   7de09076d2b3  k8s.gcr.io/pause:3.5                       About a minute ago  Up 23 seconds ago  0.0.0.0:80->80/tcp  26fe5de43ab3-infra
   088befb90e59  docker.io/library/httpd  httpd-foreground  23 seconds ago      Up 23 seconds ago  0.0.0.0:80->80/tcp  web-container

5. web-container に到達できることを確認します。

   $ curl localhost:80

手順

1. pod-net という名前のネットワークを作成します。

   # podman network create pod-net
   
   /etc/cni/net.d/pod-net.conflist

2. Pod web-pod を作成します。

   # podman pod create --net pod-net --name web-pod

3. web-pod で web-container という名前のコンテナーを実行します。

   # podman run -d --pod web-pod --name=web-container docker.io/library/httpd

4. オプション: コンテナーが関連付けられている Pod を表示します。

   # podman ps -p
   
   CONTAINER ID  IMAGE                           COMMAND           CREATED        STATUS            PORTS       NAMES               POD ID        PODNAME
   b7d6871d018c   registry.access.redhat.com/ubi10/pause:latest                             9 minutes ago  Up 6 minutes ago              a8e7360326ba-infra  a8e7360326ba  web-pod
   645835585e24  docker.io/library/httpd:latest  httpd-foreground  6 minutes ago  Up 6 minutes ago              web-container    a8e7360326ba  web-pod

手順

1. systemd ソケットを使用して DHCP プロキシーを有効にします。

   systemctl enable --now netavark-dhcp-proxy.socket
   Created symlink /etc/systemd/system/sockets.target.wants/netavark-dhcp-proxy.socket → /usr/lib/systemd/system/netavark-dhcp-proxy.socket.

2. オプション: ソケットユニットファイルを表示します。

   # cat /usr/lib/systemd/system/netavark-dhcp-proxy.socket
   [Unit]
   Description=Netavark DHCP proxy socket
   
   [Socket]
   ListenStream=%t/podman/nv-proxy.sock
   SocketMode=0660
   
   [Install]
   WantedBy=sockets.target

3. macvlan ネットワークを作成し、それを使用してホストインターフェイスを指定します。通常、これは外部インターフェイスです。

   # podman network create -d macvlan --interface-name <LAN_INTERFACE> mv1
   mv1

4. 新しく作成したネットワークを使用してコンテナーを実行します。

   # podman run --rm --network mv1 -d --name test alpine top
   894ae3b6b1081aca2a5d90a9855568eaa533c08a174874be59569d4656f9bc45

検証

1. コンテナーにローカルサブネット上の IP があることを確認します。

   # podman exec test ip addr
   1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN qlen 1000
       link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
       inet 127.0.0.1/8 scope host lo
          valid_lft forever preferred_lft forever
       inet6 ::1/128 scope host
          valid_lft forever preferred_lft forever
   2: eth0@eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc noqueue state UP qlen 1000
       link/ether 5a:30:72:bf:13:76 brd ff:ff:ff:ff:ff:ff
       inet 192.168.188.36/24 brd 192.168.188.255 scope global eth0
          valid_lft forever preferred_lft forever
       inet6 fe80::5830:72ff:febf:1376/64 scope link
          valid_lft forever preferred_lft forever

2. コンテナーを検査して、正しい IP アドレスが使用されていることを確認します。

   # podman container inspect test --format {{.NetworkSettings.Networks.mv1.IPAddress}}
   192.168.188.36

   注記

   この IP アドレスへの接続を試みるときは、必ず別のホストから接続してください。macvlan ネットワークを使用する場合、同じホストから接続することはできません。

手順

1. mysleep.container ユニットファイルを作成します。

   $ cat $HOME/.config/containers/systemd/mysleep.container
   [Unit]
   Description=The sleep container
   After=local-fs.target
   
   [Container]
   Image=registry.access.redhat.com/ubi10-minimal:latest
   Exec=sleep 1000
   
   [Install]
   # Start by default on boot
   WantedBy=multi-user.target default.target

   [Container] セクションでは、以下を指定する必要があります。

   • Image - 実行するコンテナーイメージ

   • Exec - コンテナー内で実行するコマンド

     systemd ユニットファイルで指定されているその他のフィールドはすべて使用できます。

2. mysleep.container ファイルに基づいて mysleep.service を作成します。

   $ systemctl --user daemon-reload

3. オプション: mysleep.service のステータスを確認します。

   $ systemctl --user status mysleep.service
   ○ mysleep.service - The sleep container
   	 Loaded: loaded (/home/username/.config/containers/systemd/mysleep.container; generated)
   	 Active: inactive (dead)

4. mysleep.service を起動します。

   $ systemctl --user start mysleep.service

   注記

   Quadlet は Podman v4.6 以降で利用可能です。

検証

1. mysleep.service のステータスを確認します。

   $ systemctl --user status mysleep.service
   ● mysleep.service - The sleep container
   	 Loaded: loaded (/home/username/.config/containers/systemd/mysleep.container; generated)
   	 Active: active (running) since Thu 2023-02-09 18:07:23 EST; 2s ago
      Main PID: 265651 (conmon)
         Tasks: 3 (limit: 76815)
   	 Memory: 1.6M
      	 CPU: 94ms
   	 CGroup: ...

2. すべてのコンテナーをリスト表示します。

   $ podman ps -a
   CONTAINER ID  IMAGE                            COMMAND               CREATED            STATUS                          PORTS   NAMES
   421c8293fc1b  registry.access.redhat.com/ubi10-minimal:latest               sleep 1000  30 seconds ago   Up 10 seconds ago systemd-mysleep

   作成されたコンテナーの名前は次の要素で構成されています。

   • systemd- 接頭辞

   • systemd ユニットの名前、つまり systemd-mysleep

     この名前は、一般的なコンテナーと systemd ユニットで実行されているコンテナーを区別するのに役立ちます。また、コンテナーがどのユニットで実行されるかを判断するのにも役立ちます。コンテナーの名前を変更する場合は、[Container] セクションの ContainerName フィールドを使用します。

     詳細は、システム上の podman-systemd.unit(5) man ページを参照してください。

手順

1. systemd マネージャーの設定を再読み込みするには、次のコマンドを実行します。

   # systemctl --user daemon-reload

2. サービス container.service を有効にし、起動時に開始します。

   # systemctl --user enable container.service

3. サービスをすぐに起動します。

   # systemctl --user start container.service

4. サービスのステータスを確認します。

   $ systemctl --user status container.service
   ● container.service - Podman container.service
      Loaded: loaded (/home/user/.config/systemd/user/container.service; enabled; vendor preset: enabled)
      Active: active (running) since Wed 2020-09-16 11:56:57 CEST; 8s ago
        Docs: man:podman-generate-systemd(1)
     Process: 80602 ExecStart=/usr/bin/podman run --conmon-pidfile //run/user/1000/container.service-pid --cidfile //run/user/1000/container.service-cid -d ubi10-minimal:>
     Process: 80601 ExecStartPre=/usr/bin/rm -f //run/user/1000/container.service-pid //run/user/1000/container.service-cid (code=exited, status=0/SUCCESS)
    Main PID: 80617 (conmon)
      CGroup: /user.slice/user-1000.slice/user@1000.service/container.service
              ├─ 2870 /usr/bin/podman
              ├─80612 /usr/bin/slirp4netns --disable-host-loopback --mtu 65520 --enable-sandbox --enable-seccomp -c -e 3 -r 4 --netns-type=path /run/user/1000/netns/cni->
              ├─80614 /usr/bin/fuse-overlayfs -o lowerdir=/home/user/.local/share/containers/storage/overlay/l/YJSPGXM2OCDZPLMLXJOW3NRF6Q:/home/user/.local/share/contain>
              ├─80617 /usr/bin/conmon --api-version 1 -c cbc75d6031508dfd3d78a74a03e4ace1732b51223e72a2ce4aa3bfe10a78e4fa -u cbc75d6031508dfd3d78a74a03e4ace1732b51223e72>
              └─cbc75d6031508dfd3d78a74a03e4ace1732b51223e72a2ce4aa3bfe10a78e4fa
                └─80626 /usr/bin/coreutils --coreutils-prog-shebang=sleep /usr/bin/sleep 1d

   systemctl is-enabled container.service コマンドを使用して、サービスが有効化されているか確認できます。

5. オプション: container.service を停止するには、以下を入力します。

   # systemctl --user stop container.service

手順

1. コンテナー (例: myubi) を作成します。

   $ podman create --name myubi registry.access.redhat.com/ubi10:latest sleep infinity
   0280afe98bb75a5c5e713b28de4b7c5cb49f156f1cce4a208f13fee2f75cb453

2. コンテナー名または ID を使用して systemd ユニットファイルを生成し、それを ~/.config/systemd/user/container-myubi.service ファイルに送ります。

   $ podman generate systemd --name myubi > ~/.config/systemd/user/container-myubi.service

手順

1. システムで使用するイメージをプルします。たとえば、httpd-24 イメージをプルするには、以下を実行します。

   # podman pull registry.access.redhat.com/ubi10/httpd-24

2. オプション: システムで使用可能なすべてのイメージをリストします。

   # podman images
   REPOSITORY                                TAG                  IMAGE ID      CREATED        SIZE
   registry.access.redhat.com/ubi10/httpd-24  latest               8594be0a0b57  2 weeks ago    462 MB

3. httpd コンテナーを作成します。

   # podman create --name httpd -p 8080:8080 registry.access.redhat.com/ubi10/httpd-24
   cdb9f981cf143021b1679599d860026b13a77187f75e46cc0eac85293710a4b1

4. オプション: コンテナーが作成されたことを確認します。

   # podman ps -a
   CONTAINER ID  IMAGE                                            COMMAND               CREATED        STATUS      PORTS                   NAMES
   cdb9f981cf14  registry.access.redhat.com/ubi10/httpd-24:latest  /usr/bin/run-http...  5 minutes ago  Created     0.0.0.0:8080->8080/tcp  httpd

5. httpd コンテナーの systemd ユニットファイルを生成します。

   # podman generate systemd --new --files --name httpd
   /root/container-httpd.service

6. 生成された container-httpd.service systemd ユニットファイルの内容を表示します。

   # cat /root/container-httpd.service
   # container-httpd.service
   # autogenerated by Podman 3.3.1
   # Wed Sep  8 20:41:44 CEST 2021
   
   [Unit]
   Description=Podman container-httpd.service
   Documentation=man:podman-generate-systemd(1)
   Wants=network-online.target
   After=network-online.target
   RequiresMountsFor=%t/containers
   
   [Service]
   Environment=PODMAN_SYSTEMD_UNIT=%n
   Restart=on-failure
   TimeoutStopSec=70
   ExecStartPre=/bin/rm -f %t/%n.ctr-id
   ExecStart=/usr/bin/podman run --cidfile=%t/%n.ctr-id --sdnotify=conmon --cgroups=no-conmon --rm -d --replace --name httpd -p 8080:8080 registry.access.redhat.com/ubi10/httpd-24
   ExecStop=/usr/bin/podman stop --ignore --cidfile=%t/%n.ctr-id
   ExecStopPost=/usr/bin/podman rm -f --ignore --cidfile=%t/%n.ctr-id
   Type=notify
   NotifyAccess=all
   
   [Install]
   WantedBy=multi-user.target default.target

   注記

   --new オプションを使用して生成されたユニットファイルでは、コンテナーと Pod が存在することを想定していません。したがって、サービスの起動時に (ExecStart の行を参照)、podman start コマンドではなく、podman run コマンドを実行します。たとえば、Generating a systemd unit file using Podman のセクションを参照してください。

   • podman run コマンドは、以下のコマンドラインオプションを使用します。

     • --conmon-pidfile オプションは、ホストで実行している conmon プロセスのプロセス ID を格納するパスを指します。conmon プロセスはコンテナーと同じ終了ステータスで終了します。これにより、systemd は正しいサービスステータスを報告し、必要に応じてコンテナーを再起動できます。
     • --cidfile オプションは、コンテナー ID を格納するパスを指します。
     • %t は、ランタイムディレクトリーのルートへのパスです (例: /run/user/$UserID)。
     • %n は、サービスの完全な名前です。

7. /etc/systemd/system にユニットファイルをコピーして root ユーザーとしてインストールします。

   # cp -Z container-httpd.service /etc/systemd/system

8. container-httpd.service を有効にして起動します。

   # systemctl daemon-reload
   # systemctl enable --now container-httpd.service
   Created symlink /etc/systemd/system/multi-user.target.wants/container-httpd.service → /etc/systemd/system/container-httpd.service.
   Created symlink /etc/systemd/system/default.target.wants/container-httpd.service → /etc/systemd/system/container-httpd.service.

手順

1. たとえば、systemd-pod などの空の Pod を作成します。

   $ podman pod create --name systemd-pod
   11d4646ba41b1fffa51c108cbdf97cfab3213f7bd9b3e1ca52fe81b90fed5577

2. 必要に応じて、すべての Pod をリスト表示します。

   $ podman pod ps
   POD ID        NAME         STATUS   CREATED         # OF CONTAINERS  INFRA ID
   11d4646ba41b  systemd-pod  Created  40 seconds ago  1                8a428b257111
   11d4646ba41b1fffa51c108cbdf97cfab3213f7bd9b3e1ca52fe81b90fed5577

3. 空の Pod に 2 つのコンテナーを作成します。たとえば、container0 と container1 を systemd-pod に作成するには、以下を実行します。

   $ *podman create --pod systemd-pod --name container0 registry.access.redhat.com/ubi*10 top
   $ *podman create --pod systemd-pod --name container1 registry.access.redhat.com/ubi*10 top

4. 必要に応じて、関連付けられている全 Pod およびコンテナーをリスト表示します。

   $ podman ps -a --pod
   CONTAINER ID  IMAGE                                   COMMAND  CREATED        STATUS         PORTS   NAMES               POD ID        PODNAME
   24666f47d9b2  registry.access.redhat.com/ubi10:latest  top      3 minutes ago  Created                container0          3130f724e229  systemd-pod
   56eb1bf0cdfe  k8s.gcr.io/pause:3.2                             4 minutes ago  Created                3130f724e229-infra  3130f724e229  systemd-pod
   62118d170e43  registry.access.redhat.com/ubi10:latest  top      3 seconds ago  Created                container1          3130f724e229  systemd-pod

5. 新しい Pod の systemd ユニットファイルを生成します。

   $ podman generate systemd --files --name systemd-pod
   /home/user1/pod-systemd-pod.service
   /home/user1/container-container0.service
   /home/user1/container-container1.service

   3 つの systemd ユニットファイルが生成されることに注意してください。1 つは systemd-pod Pod 用、2 つはコンテナー container0 および container1 用です。

6. pod-systemd-pod.service ユニットファイルを表示します。

   $ cat pod-systemd-pod.service
   # pod-systemd-pod.service
   # autogenerated by Podman 3.3.1
   # Wed Sep  8 20:49:17 CEST 2021
   
   [Unit]
   Description=Podman pod-systemd-pod.service
   Documentation=man:podman-generate-systemd(1)
   Wants=network-online.target
   After=network-online.target
   RequiresMountsFor=
   Requires=container-container0.service container-container1.service
   Before=container-container0.service container-container1.service
   
   [Service]
   Environment=PODMAN_SYSTEMD_UNIT=%n
   Restart=on-failure
   TimeoutStopSec=70
   ExecStart=/usr/bin/podman start bcb128965b8e-infra
   ExecStop=/usr/bin/podman stop -t 10 bcb128965b8e-infra
   ExecStopPost=/usr/bin/podman stop -t 10 bcb128965b8e-infra
   PIDFile=/run/user/1000/containers/overlay-containers/1dfdcf20e35043939ea3f80f002c65c00d560e47223685dbc3230e26fe001b29/userdata/conmon.pid
   Type=forking
   
   [Install]
   WantedBy=multi-user.target default.target

   • [Unit] セクションの Requires 行は、container-container0.service と container-container1.service ユニットファイルの依存関係を定義します。両方のユニットファイルがアクティベートされます。
   • [Service] セクションの ExecStart 行および ExecStop 行はそれぞれ infra-container を開始して停止します。

7. container-container0.service ユニットファイルを表示します。

   $ cat container-container0.service
   # container-container0.service
   # autogenerated by Podman 3.3.1
   # Wed Sep  8 20:49:17 CEST 2021
   
   [Unit]
   Description=Podman container-container0.service
   Documentation=man:podman-generate-systemd(1)
   Wants=network-online.target
   After=network-online.target
   RequiresMountsFor=/run/user/1000/containers
   BindsTo=pod-systemd-pod.service
   After=pod-systemd-pod.service
   
   [Service]
   Environment=PODMAN_SYSTEMD_UNIT=%n
   Restart=on-failure
   TimeoutStopSec=70
   ExecStart=/usr/bin/podman start container0
   ExecStop=/usr/bin/podman stop -t 10 container0
   ExecStopPost=/usr/bin/podman stop -t 10 container0
   PIDFile=/run/user/1000/containers/overlay-containers/4bccd7c8616ae5909b05317df4066fa90a64a067375af5996fdef9152f6d51f5/userdata/conmon.pid
   Type=forking
   
   [Install]
   WantedBy=multi-user.target default.target

   • [Unit] セクションの BindsTo l 行は、pod-systemd-pod.service ユニットファイルの依存関係を定義します。
   • [Service] セクションの ExecStart 行および ExecStop 行では、それぞれ container0 を起動および停止します。

8. container-container1.service ユニットファイルを表示します。

   $ cat container-container1.service

9. 生成されたファイルをすべて $HOME/.config/systemd/user にコピーして、root 以外のユーザーとしてインストールします。

   $ cp pod-systemd-pod.service container-container0.service container-container1.service $HOME/.config/systemd/user

10. ユーザーのログイン時に、サービスを有効にして開始します。

    $ systemctl enable --user pod-systemd-pod.service
    Created symlink /home/user1/.config/systemd/user/multi-user.target.wants/pod-systemd-pod.service → /home/user1/.config/systemd/user/pod-systemd-pod.service.
    Created symlink /home/user1/.config/systemd/user/default.target.wants/pod-systemd-pod.service → /home/user1/.config/systemd/user/pod-systemd-pod.service.

    サービスは、ユーザーのログアウト時に停止される点に注意してください。

手順

1. registry.access.redhat.com/ubi10/ubi-init イメージをもとに、myubi コンテナーを起動します。

   # podman run --label "io.containers.autoupdate=image" \
   --name myubi -dt registry.access.redhat.com/ubi10/ubi-init top
   bc219740a210455fa27deacc96d50a9e20516492f1417507c13ce1533dbdcd9d

2. 必要に応じて、実行中または終了したコンテナーをリスト表示します。

   # podman ps -a
   CONTAINER ID  IMAGE                                            COMMAND  CREATED         STATUS             PORTS   NAMES
   76465a5e2933  registry.access.redhat.com/10/ubi-init:latest  top      24 seconds ago  Up 23 seconds ago          myubi

3. myubi コンテナーの systemd ユニットファイルを生成します。

   # podman generate systemd --new --files --name myubi
   /root/container-myubi.service

4. /usr/lib/systemd/system にユニットファイルをコピーして root ユーザーとしてインストールします。

   # cp -Z ~/container-myubi.service /usr/lib/systemd/system

5. systemd マネージャー設定をリロードします。

   # systemctl daemon-reload

6. コンテナーを起動して、ステータスを確認します。

   # systemctl start container-myubi.service
   # systemctl status container-myubi.service

7. コンテナーを自動更新します。

   # podman auto-update

   詳細は、システム上の podman-generate-systemd(1) および systemctl(1) man ページを参照してください。

手順

1. podman-auto-update.service ユニットファイルを表示します。

   # cat /usr/lib/systemd/system/podman-auto-update.service
   
   [Unit]
   Description=Podman auto-update service
   Documentation=man:podman-auto-update(1)
   Wants=network.target
   After=network-online.target
   
   [Service]
   Type=oneshot
   ExecStart=/usr/bin/podman auto-update
   
   [Install]
   WantedBy=multi-user.target default.target

2. podman-auto-update.timer ユニットファイルを表示します。

   # cat /usr/lib/systemd/system/podman-auto-update.timer
   
   [Unit]
   Description=Podman auto-update timer
   
   [Timer]
   OnCalendar=daily
   Persistent=true
   
   [Install]
   WantedBy=timers.target

   この例では、podman auto-update コマンドは、毎日、深夜に起動します。

3. システム起動時に podman-auto-update.timer サービスを有効にします。

   # systemctl enable podman-auto-update.timer

4. systemd サービスを開始します。

   # systemctl start podman-auto-update.timer

5. 必要に応じて、すべてのタイマーをリスト表示します。

   # systemctl list-timers --all
   NEXT                         LEFT      LAST                         PASSED       UNIT                         ACTIVATES
   Wed 2020-12-09 00:00:00 CET  9h left   n/a                          n/a          podman-auto-update.timer     podman-auto-update.service

   podman-auto-update.timer が podman-auto-update.service を有効化したことが確認できます。

手順

1. 関連付けられている全 Pod およびコンテナーをリスト表示します。

   $ podman ps -a --pod
   CONTAINER ID  IMAGE                                       COMMAND    CREATED                 STATUS                     PORTS  NAMES               POD
   5df5c48fea87  registry.access.redhat.com/ubi10/ubi:latest  /bin/bash  Less than a second ago  Up Less than a second ago         myubi               223df6b390b4
   3afdcd93de3e  k8s.gcr.io/pause:3.1                                   Less than a second ago  Up Less than a second ago         223df6b390b4-infra  223df6b390b4

2. Pod 名または ID を使用して Kubernetes YAML ファイルを生成します。

   $ podman generate kube mypod > mypod.yaml

   podman generate コマンドは、コンテナーに接続されている論理ボリュームマネージャー (LVM) の論理ボリュームまたは物理ボリュームを反映しません。

3. mypod.yaml ファイルを表示します。

   $ cat mypod.yaml
   # Generation of Kubernetes YAML is still under development!
   #
   # Save the output of this file and use kubectl create -f to import
   # it into Kubernetes.
   #
   # Created with podman-1.6.4
   apiVersion: v1
   kind: Pod
   metadata:
     creationTimestamp: "2020-06-09T10:31:56Z"
     labels:
   app: mypod
     name: mypod
   spec:
     containers:
     - command:
           - /bin/bash
           env:
           - name: PATH
                 value: /usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
           - name: TERM
                 value: xterm
           - name: HOSTNAME
           - name: container
                 value: oci
           image: registry.access.redhat.com/ubi10/ubi:latest
           name: myubi
           resources: {}
           securityContext:
                 allowPrivilegeEscalation: true
                 capabilities: {}
                 privileged: false
                 readOnlyRootFilesystem: false
           tty: true
           workingDir: /
   status: {}

手順

1. mypod.yaml ファイルから Pod およびコンテナーを作成します。

   $ podman play kube mypod.yaml
   Pod:
   b8c5b99ba846ccff76c3ef257e5761c2d8a5ca4d7ffa3880531aec79c0dacb22
   Container:
   848179395ebd33dd91d14ffbde7ae273158d9695a081468f487af4e356888ece

2. すべての Pod をリスト表示します。

   $ podman pod ps
   POD ID         NAME    STATUS    CREATED          # OF CONTAINERS   INFRA ID
   b8c5b99ba846   mypod   Running   19 seconds ago   2                 aa4220eaf4bb

3. 関連付けられている全 Pod およびコンテナーをリスト表示します。

   $ podman ps -a --pod
   CONTAINER ID  IMAGE                                       COMMAND    CREATED             STATUS                 PORTS  NAMES               POD
   848179395ebd  registry.access.redhat.com/ubi10/ubi:latest  /bin/bash  About a minute ago  Up About a minute ago         myubi               b8c5b99ba846
   aa4220eaf4bb  k8s.gcr.io/pause:3.1                                   About a minute ago  Up About a minute ago         b8c5b99ba846-infra  b8c5b99ba846

   podman ps コマンドからの Pod ID と、podman pod ps コマンドからの Pod ID が一致します。

   詳細は、システム上の podman-play-kube(1) man ページを参照してください。

手順

1. mariadb-conf/Containerfile ファイルを表示します。

   $ cat mariadb-conf/Containerfile
   FROM docker.io/library/mariadb
   COPY my.cnf /etc/mysql/my.cnf

2. mariadb-conf/my.cnf ファイルを表示します。

   [client-server]
   # Port or socket location where to connect
   port = 3306
   socket = /run/mysqld/mysqld.sock
   
   # Import all .cnf files from the configuration directory
   [mariadbd]
   skip-host-cache
   skip-name-resolve
   bind-address = 127.0.0.1
   
   !includedir /etc/mysql/mariadb.conf.d/
   !includedir /etc/mysql/conf.d/

3. mariadb-conf/Containerfile を使用して docker.io/library/mariadb イメージをビルドします。

   $ cd mariadb-conf
   $ podman build -t mariadb-conf .
   $ cd ..
   STEP 1: FROM docker.io/library/mariadb
   Trying to pull docker.io/library/mariadb:latest...
   Getting image source signatures
   Copying blob 7b1a6ab2e44d done
   ...
   Storing signatures
   STEP 2: COPY my.cnf /etc/mysql/my.cnf
   STEP 3: COMMIT mariadb-conf
   --> ffae584aa6e
   Successfully tagged localhost/mariadb-conf:latest
   ffae584aa6e733ee1cdf89c053337502e1089d1620ff05680b6818a96eec3c17

4. 必要に応じて、すべてのイメージをリスト表示します。

   $ podman images
   LIST IMAGES
   REPOSITORY                                                       TAG         IMAGE ID      CREATED             SIZE
   localhost/mariadb-conf                                           latest      b66fa0fa0ef2  57 seconds ago      416 MB

5. wordpresspod という名前の pod を作成し、コンテナーとホストシステム間のポートマッピングを設定します。

   $ podman pod create --name wordpresspod -p 8080:80

6. wordpresspod pod の中に mydb コンテナーを作成します。

   $ podman run --detach --pod wordpresspod \
       -e MYSQL_ROOT_PASSWORD=1234 \
       -e MYSQL_DATABASE=mywpdb \
       -e MYSQL_USER=mywpuser \
       -e MYSQL_PASSWORD=1234 \
       --name mydb localhost/mariadb-conf

7. wordpresspod pod の中に myweb コンテナーを作成します。

   $ podman run --detach --pod wordpresspod \
       -e WORDPRESS_DB_HOST=127.0.0.1 \
       -e WORDPRESS_DB_NAME=mywpdb \
       -e WORDPRESS_DB_USER=mywpuser \
       -e WORDPRESS_DB_PASSWORD=1234 \
       --name myweb docker.io/wordpress

8. 必要に応じて、関連付けられている全 Pod およびコンテナーをリスト表示します。

   $ podman ps --pod -a
   CONTAINER ID  IMAGE                               COMMAND               CREATED                 STATUS                     PORTS                 NAMES               POD ID        PODNAME
   9ea56f771915  k8s.gcr.io/pause:3.5                                      Less than a second ago  Up Less than a second ago  0.0.0.0:8080->80/tcp  4b7f054a6f01-infra  4b7f054a6f01  wordpresspod
   60e8dbbabac5  localhost/mariadb-conf:latest       mariadbd              Less than a second ago  Up Less than a second ago  0.0.0.0:8080->80/tcp  mydb                4b7f054a6f01  wordpresspod
   045d3d506e50  docker.io/library/wordpress:latest  apache2-foregroun...  Less than a second ago  Up Less than a second ago  0.0.0.0:8080->80/tcp  myweb               4b7f054a6f01  wordpresspod

手順

1. 関連付けられている全 Pod およびコンテナーをリスト表示します。

   $ podman ps --pod -a
   CONTAINER ID  IMAGE                               COMMAND               CREATED                 STATUS                     PORTS                 NAMES               POD ID        PODNAME
   9ea56f771915  k8s.gcr.io/pause:3.5                                      Less than a second ago  Up Less than a second ago  0.0.0.0:8080->80/tcp  4b7f054a6f01-infra  4b7f054a6f01  wordpresspod
   60e8dbbabac5  localhost/mariadb-conf:latest       mariadbd              Less than a second ago  Up Less than a second ago  0.0.0.0:8080->80/tcp  mydb                4b7f054a6f01  wordpresspod
   045d3d506e50  docker.io/library/wordpress:latest  apache2-foregroun...  Less than a second ago  Up Less than a second ago  0.0.0.0:8080->80/tcp  myweb               4b7f054a6f01  wordpresspod

2. Pod 名または ID を使用して Kubernetes YAML ファイルを生成します。

   $ podman generate kube wordpresspod >> wordpresspod.yaml

1. YAML ファイルで使用されているイメージと同じ名前のディレクトリーが存在する
2. そのディレクトリーには Containerfile が含まれている

手順

1. 最初からやり直す場合は、ローカルに保存されているイメージを削除してください。

   $ podman rmi localhost/mariadb-conf
   $ podman rmi docker.io/library/wordpress
   $ podman rmi docker.io/library/mysql

2. wordpress.yaml ファイルを使用して、wordpress Pod を作成します。

   $ podman play kube wordpress.yaml
   STEP 1/2: FROM docker.io/library/mariadb
   STEP 2/2: COPY my.cnf /etc/mysql/my.cnf
   COMMIT localhost/mariadb-conf:latest
   --> 428832c45d0
   Successfully tagged localhost/mariadb-conf:latest
   428832c45d07d78bb9cb34e0296a7dc205026c2fe4d636c54912c3d6bab7f399
   Trying to pull docker.io/library/wordpress:latest...
   Getting image source signatures
   Copying blob 99c3c1c4d556 done
   ...
   Storing signatures
   Pod:
   3e391d091d190756e655219a34de55583eed3ef59470aadd214c1fc48cae92ac
   Containers:
   6c59ebe968467d7fdb961c74a175c88cb5257fed7fb3d375c002899ea855ae1f
   29717878452ff56299531f79832723d3a620a403f4a996090ea987233df0bc3d

   podman play kube コマンド:

   • docker.io/library/mariadb イメージを元に localhost/mariadb-conf:latest イメージを自動構築します。
   • docker.io/library/wordpress:latest のイメージをプルします。
   • wordpresspod-mydb と wordpresspod-myweb の 2 つのコンテナーが含まれる、wordpresspod という名前の Pod を作成します。

3. すべてのコンテナーと Pod を表示します。

   $ podman ps --pod -a
   CONTAINER ID  IMAGE                               COMMAND               CREATED        STATUS                    PORTS                 NAMES               POD ID        PODNAME
   a1dbf7b5606c  k8s.gcr.io/pause:3.5                                      3 minutes ago  Up 2 minutes ago          0.0.0.0:8080->80/tcp  3e391d091d19-infra  3e391d091d19  wordpresspod
   6c59ebe96846  localhost/mariadb-conf:latest       mariadbd              2 minutes ago  Exited (1) 2 minutes ago  0.0.0.0:8080->80/tcp  wordpresspod-mydb   3e391d091d19  wordpresspod
   29717878452f  docker.io/library/wordpress:latest  apache2-foregroun...  2 minutes ago  Up 2 minutes ago          0.0.0.0:8080->80/tcp  wordpresspod-myweb  3e391d091d19  wordpresspod

手順

1. 次の内容を含む Playbook ファイル (例: ~/playbook.yml) を作成します。

   ---
   - name: Configure Podman registries with RHEL system roles
     hosts: managed-node-01.example.com
     vars:
       podman_registries_conf:
         unqualified-search-registries:
           - "registry.access.redhat.com"
           - "docker.io"
           - "my-company-registry.com"
         registry:
           - location: "my-company-registry.com"
           - location: "my-local-registry:5000"
             insecure: true
     tasks:
       - name: Include the podman system role
         ansible.builtin.include_role:
           name: redhat.rhel_system_roles.podman

   サンプル Playbook で指定されている設定は次のとおりです。

   • unqualified-search-registries: 短いイメージ名 (例: podman pull <my-image>) を使用する場合に、Podman が検索対象とするレジストリーのリストを追加します。Podman は、デフォルトのレジストリーの後に my-company-registry.com でイメージを検索します。
   • [registry]: 特定のレジストリー用に特定のプロパティーを定義します。たとえば、my-local-registry:5000 で実行されているローカルレジストリーに insecure=true を設定することで、セキュアでない接続を有効にできます。

   podman_use_new_toml_formatter 変数は、Podman と互換性のある TOML 準拠の設定ファイルを生成します。この変数は、以前使用されていた Jinja テンプレートの代わりに、本格的な TOML フォーマッターを使用し、テーブルやインラインテーブルを含むすべての TOML 機能をサポートすることで、Podman ロールを強化します。

   以前のフォーマッターの動作との互換性を維持するために、新しいフォーマッターはデフォルトで無効になっています。新しいフォーマッターを有効にするには、設定で podman_use_new_toml_formatter: true を指定します。

   podman_use_new_toml_formatter: true
   podman_containers_conf:
     containers:
       annotations:
         - environment=production
         - status=tier2

2. Playbook の構文を検証します。

   $ ansible-playbook --syntax-check ~/playbook.yml

   このコマンドは構文を検証するだけであり、有効だが不適切な設定から保護するものではないことに注意してください。

3. Playbook を実行します。

   $ ansible-playbook ~/playbook.yml

検証

1. ホスト上で podman info コマンドを実行します。

   $ ansible managed-node-01.example.com -m command -a 'podman info'

2. registeries セクションを確認します。

   registries:
     my-company-registry.com:
       Blocked: false
       Insecure: false
       Location: my-company-registry.com
       MirrorByDigestOnly: false
       Mirrors: null
       Prefix: my-company-registry.com
       PullFromMirror: ""
     my-local-registry:5000:
       Blocked: false
       Insecure: true
       Location: my-local-registry:5000
       MirrorByDigestOnly: false
       Mirrors: null
       Prefix: my-local-registry:5000
       PullFromMirror: ""
     search:
     - registry.access.redhat.com
     - docker.io
     - my-company-registry.com

手順

1. 次の内容を含む Playbook ファイル (例: ~/playbook.yml) を作成します。

   - name: Configure Podman
     hosts: managed-node-01.example.com
     tasks:
       - name: Create a web application and a database
         ansible.builtin.include_role:
           name: redhat.rhel_system_roles.podman
         vars:
           podman_create_host_directories: true
           podman_firewall:
             - port: 8080-8081/tcp
               state: enabled
             - port: 12340/tcp
               state: enabled
           podman_selinux_ports:
             - ports: 8080-8081
               setype: http_port_t
           podman_kube_specs:
             - state: started
               run_as_user: dbuser
               run_as_group: dbgroup
               kube_file_content:
                 apiVersion: v1
                 kind: Pod
                 metadata:
                   name: db
                 spec:
                   containers:
                     - name: db
                       image:  quay.io/rhel-system-roles/mysql:5.6
                       ports:
                         - containerPort: 1234
                           hostPort: 12340
                       volumeMounts:
                         - mountPath: /var/lib/db:Z
                           name: db
                   volumes:
                     - name: db
                       hostPath:
                         path: /var/lib/db
             - state: started
               run_as_user: webapp
               run_as_group: webapp
               kube_file_src: /path/to/webapp.yml

   サンプル Playbook で指定されている設定は次のとおりです。

   • run_as_user and run_as_group:: コンテナーがルートレスであることを指定します。

   • kube_file_content:: db という名前の最初のコンテナーを定義する Kubernetes YAML ファイルが含まれています。Kubernetes YAML ファイルは、podman kube generate コマンドを使用して生成できます。

     • db コンテナーは、quay.io/db/db:stable コンテナーイメージに基づいています。

     • db バインドマウントは、ホスト上の /var/lib/db ディレクトリーをコンテナー内の /var/lib/db ディレクトリーにマップします。Z フラグにより、コンテンツにプライベート非共有ラベルが付与されます。そのため、そのコンテンツにアクセスできるのは db コンテナーだけです。

       kube_file_src: <path>

       2 つ目のコンテナーを定義します。コントローラーノードの /path/to/webapp.yml ファイルの内容は、マネージドノードの kube_file フィールドにコピーされます。

       volumes: <list>

       1 つ以上のコンテナーで提供するデータのソースを定義する YAML リスト。たとえば、ホスト上のローカルディスク (hostPath) またはその他のディスクデバイスなどです。

       volumeMounts: <list>

       個々のコンテナーが特定のボリュームをマウントする場所を定義する YAML リスト。

       podman_create_host_directories: true

       ホスト上にディレクトリーを作成します。これにより、hostPath ボリュームの kube 仕様を確認し、ホスト上にそれらのディレクトリーを作成するようにロールに指示します。所有権と権限をさらに細かく制御する必要がある場合は、podman_host_directories を使用します。

       Playbook で使用されるすべての変数の詳細は、コントロールノードの /usr/share/ansible/roles/rhel-system-roles.podman/README.md ファイルを参照してください。

2. Playbook の構文を検証します。

   $ ansible-playbook --syntax-check --ask-vault-pass ~/playbook.yml

   このコマンドは構文を検証するだけであり、有効だが不適切な設定から保護するものではないことに注意してください。

3. Playbook を実行します。

   $ ansible-playbook --ask-vault-pass ~/playbook.yml

手順

1. 次の内容を含む Playbook ファイル (例: ~/playbook.yml) を作成します。

   - name: Configure Podman
     hosts: managed-node-01.example.com
     tasks:
       - name: Start Apache server on port 8080
         ansible.builtin.include_role:
           name: redhat.rhel_system_roles.podman
     vars:
       podman_firewall:
         - port: 8080/tcp
           state: enabled
       podman_kube_specs:
         - state: started
           kube_file_content:
             apiVersion: v1
             kind: Pod
             metadata:
               name: ubi10-httpd
             spec:
               containers:
                 - name: ubi10-httpd
                   image: registry.access.redhat.com/ubi10/httpd-24
                   ports:
                     - containerPort: 8080
                       hostPort: 8080
                   volumeMounts:
                     - mountPath: /var/www/html:Z
                       name: ubi10-html
               volumes:
                 - name: ubi10-html
                   persistentVolumeClaim:
                     claimName: ubi10-html-volume

   サンプル Playbook で指定されている設定は次のとおりです。

   kube_file_content

   ubi10-httpd という名前の 1 つ目コンテナーを定義する Kubernetes YAML ファイルが含まれています。Kubernetes YAML ファイルは、podman kube generate コマンドを使用して生成できます。

   • ubi10-httpd コンテナーは、registry.access.redhat.com/ubi10/httpd-24 コンテナーイメージに基づいています。
   • ubi10-html-volume は、ホスト上の /var/www/html ディレクトリーをコンテナーにマッピングします。Z フラグにより、コンテンツにプライベート非共有ラベルが付与されます。そのため、そのコンテンツにアクセスできるのは ubi10-httpd コンテナーだけです。

   • Pod は、マウントパス /var/www/html を使用して、ubi10-html-volume という名前の既存の永続ボリュームをマウントします。

     Playbook で使用されるすべての変数の詳細は、コントロールノードの /usr/share/ansible/roles/rhel-system-roles.podman/README.md ファイルを参照してください。

2. Playbook の構文を検証します。

   $ ansible-playbook --syntax-check ~/playbook.yml

   このコマンドは構文のみを検証するものであり、誤っているが有効な設定に対する保護機能はありません。

3. Playbook を実行します。

   $ ansible-playbook ~/playbook.yml