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

手順

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

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

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

3. RHEL にサブスクライブします。

   • RHEL に自動的にサブスクライブするには、以下を実行します。

     # subscription-manager attach --auto

   • プール ID で RHEL をサブスクライブするには、次のコマンドを実行します。

     # subscription-manager attach --pool <PoolID>

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

   # dnf install container-tools

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

   # dnf install podman-docker

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

手順

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

2. podman パッケージをインストールします。

   # dnf install podman -y

3. ユーザーアカウントを新規作成します。

   # useradd -c "Joe Jones" joe
   # passwd joe

   • ユーザーは、ルートレス Podman を使用できるように自動的に設定されます。
   • useradd コマンドは、/etc/subuid と /etc/subgid ファイルに、アクセス可能なユーザー ID とグループ ID の範囲を自動的に設定します。
   • etc/subuid や /etc/subgid を手動で変更した場合、新しい変更を適用させるために podman system migrate コマンドを実行する必要があります。

4. ユーザーに接続します。

   $ ssh joe@server.example.com

   注記

   これらのコマンドでは正しい環境変数が設定されないため、su または su - コマンドは使用しないでください。

5. registry.access.redhat.com/ubi9/ubi コンテナーイメージをプルします。

   $ podman pull registry.access.redhat.com/ubi9/ubi

6. myubi という名前のコンテナーを実行し、OS バージョンを表示します。

   $ podman run --rm --name=myubi registry.access.redhat.com/ubi9/ubi \
     cat /etc/os-release
   NAME="Red Hat Enterprise Linux"
   VERSION="9 (Plow)"

手順

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

   # podman login quay.io

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

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

     # podman search quay.io/postgresql-10
     INDEX       NAME                                           DESCRIPTION           STARS   OFFICIAL   AUTOMATED
     redhat.io   registry.redhat.io/rhel8/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 オプションをコマンドに渡します。

手順

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

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

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

   $ podman pull registry.redhat.io/ubi9/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/ubi9/ubi          latest  3269c37eae33  7 weeks ago  208 MB

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

   • イメージ名:

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

   • イメージ ID:

     $ podman tag 3269c37eae33 myubi

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

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

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

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

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

   • イメージ名:

     $ podman tag registry.redhat.io/ubi9/ubi myubi:9

   • イメージ ID:

     $ podman tag 3269c37eae33 myubi:9

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

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

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

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

手順

1. registry.redhat.io/rhel9/rsyslog イメージを tarball として保存します。

   • デフォルトの docker-dir 形式で以下を行います。

     $ podman save -o myrsyslog.tar registry.redhat.io/rhel9/rsyslog:latest

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

     $ podman save -o myrsyslog-oci.tar --format=oci-archive registry.redhat.io/rhel9/rsyslog

     myrsyslog.tar および myrsyslog-oci.tar アーカイブは現在のディレクトリーに保存されます。次の手順では、myrsyslog.tar tarball で実行されます。

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

   $ file myrsyslog.tar
   myrsyslog.tar: POSIX tar archive

3. myrsyslog.tar から registry.redhat.io/rhel9/rsyslog:latest イメージを読み込むには、以下を実行します。

   $ podman load -i myrsyslog.tar
   ...
   Loaded image(s): registry.redhat.io/rhel9/rsyslog:latest

手順

1. オプション: ubi イメージに名前を追加します。

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

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

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

手順

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

   $ podman images
   REPOSITORY                           TAG     IMAGE ID      CREATED      SIZE
   registry.redhat.io/rhel8/rsyslog     latest  4b32d14201de  7 weeks ago  228 MB
   registry.redhat.io/ubi8/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/rhel8/rsyslog:latest  /bin/rsyslog.sh  6 seconds ago  Up 5 seconds ago          mysyslog

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

3. mysyslog コンテナーを停止します。

   $ podman stop mysyslog
   7ccd6001166e9720c47fbeb077e0afd0bb635e74a1b0ede3fd34d09eaf5a52e9

4. registry.redhat.io/rhel8/rsyslog イメージを削除します。

   $ podman rmi registry.redhat.io/rhel8/rsyslog

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

     $ podman rmi registry.redhat.io/rhel8/rsyslog registry.redhat.io/ubi8/ubi

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

     $ podman rmi -a

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

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

手順

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

   $ podman run --rm registry.access.redhat.com/ubi9/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 9"
   ...

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

   $ podman ps
   CONTAINER ID  IMAGE   COMMAND  CREATED  STATUS  PORTS   NAMES

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

手順

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

   $ podman run --name=myubi -it registry.access.redhat.com/ubi9/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
   CONTAINER ID  IMAGE                               COMMAND    CREATED         STATUS                     PORTS   NAMES
   1984555a2c27  registry.redhat.io/ubi9/ubi:latest  /bin/bash  21 minutes ago  Exited (0) 21 minutes ago          myubi

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

手順

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

   $ podman run -d registry.redhat.io/rhel8/rsyslog

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

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

     $ podman ps
     CONTAINER ID IMAGE              COMMAND         CREATED       STATUS            PORTS NAMES
     74b1da000a11 rhel9/rsyslog /bin/rsyslog.sh 2 minutes ago Up About a minute       musing_brown

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

     $ podman ps -a
     CONTAINER ID IMAGE         COMMAND    CREATED    STATUS                PORTS NAMES     IS INFRA
     d65aecc325a4 ubi9/ubi      /bin/bash  3 secs ago Exited (0) 5 secs ago peaceful_hopper false
     74b1da000a11 rhel9/rsyslog rsyslog.sh 2 mins ago Up About a minute     musing_brown    false

手順

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

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

     $ podman start myubi

     または、podman start 1984555a2c27 を使用することもできます。

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

     $ podman start -a -i myubi

     または、podman start -a -i 1984555a2c27 を使用することができます。

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

   [root@6ccffd0f6421 /]# exit

手順

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

   # podman run --name="log_test" -v /dev/log:/dev/log --rm \
     registry.redhat.io/ubi9/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 -d --name=mysyslog registry.redhat.io/rhel9/rsyslog

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

   # podman ps -a
   CONTAINER ID  IMAGE                                    COMMAND          CREATED         STATUS                     PORTS   NAMES
   c56ef6a256f8  registry.redhat.io/rhel9/rsyslog:latest  /bin/rsyslog.sh  20 minutes ago  Up 20 minutes ago                  mysyslog

3. mysyslog コンテナーをマウントします。

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

4. 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

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

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

手順

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

   # podman run -d --ip=10.88.0.44 registry.access.redhat.com/rhel9/rsyslog
   efde5f0a8c723f70dd5cb5dc3d5039df3b962fae65575b08662e0d5b5f9fbe85

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

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

手順

1. myrsyslog コンテナー内で rpm -qa コマンドを実行し、インストールされているパッケージのリストを表示します。

   $ podman exec -it myrsyslog rpm -qa
   tzdata-2020d-1.el8.noarch
   python3-pip-wheel-9.0.3-18.el8.noarch
   redhat-release-8.3-1.0.el8.x86_64
   filesystem-3.8-3.el8.x86_64
   ...

2. myrsyslog コンテナーで /bin/bash コマンドを実行します。

   $ podman exec -it myrsyslog /bin/bash

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

   # dnf install procps-ng

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

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

     # ps -ef
     UID          PID    PPID  C STIME TTY          TIME CMD
     root           1       0  0 10:23 ?        00:00:01 /usr/sbin/rsyslogd -n
     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
     fuse-overlayfs   27G  7.1G   20G  27% /
     tmpfs            64M     0   64M   0% /dev
     tmpfs           269M  936K  268M   1% /etc/hosts
     shm              63M     0   63M   0% /dev/shm
     ...

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

     # uname -r
     4.18.0-240.10.1.el8_3.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/ubi9/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/ubi9/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

手順

1. registry.access.redhat.com/ubi9/ubi イメージに基づいて、myubi コンテナーを実行します。

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

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

   $ podman ps -a
   CONTAINER ID  IMAGE                                    COMMAND          CREATED     STATUS         PORTS   NAMES
   a6a6d4896142  registry.access.redhat.com/9: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 docker.io/library/myubi-imported cat testfile
    hello

手順

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

   $ podman ps -a
   CONTAINER ID IMAGE         COMMAND    CREATED    STATUS                PORTS NAMES     IS INFRA
   d65aecc325a4 ubi9/ubi      /bin/bash  3 secs ago Exited (0) 5 secs ago peaceful_hopper false
   74b1da000a11 rhel9/rsyslog rsyslog.sh 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. registry.access.redhat.com/ubi9/ubi コンテナーイメージをプルします。

   # podman pull registry.access.redhat.com/ubi9/ubi

2. registry.access.redhat.com/ubi9/ubi イメージを rhel.tar アーカイブにエクスポートします。

   # podman export $(podman create registry.access.redhat.com/ubi9/ubi) > rhel.tar

3. bundle/rootfs ディレクトリーを作成します。

   # mkdir -p bundle/rootfs

4. rhel.tar アーカイブを bundle/rootfs ディレクトリーにデプロイメントします。

   # tar -C bundle/rootfs -xf rhel.tar

5. バンドル用に config.json という名前の新規仕様ファイルを作成します。

   # <runtime> spec -b bundle

   • -b オプションは、バンドルのディレクトリーを指定します。デフォルト値は現在のディレクトリーです。

6. オプション: 設定を変更します。

   # vi bundle/config.json

7. バンドル用に myubi という名前のコンテナーのインスタンスを作成します。

   # <runtime> create -b bundle/ myubi

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

   # <runtime> start myubi

手順

1. registry.access.redhat.com/ubi9/ubi コンテナーイメージをプルします。

   $ podman pull registry.access.redhat.com/ubi9/ubi

2. --runtime オプションを使用してコンテナーランタイムを変更します。

   $ podman run --name=myubi -dt --runtime=<runtime> ubi9
   e4654eb4df12ac031f1d0f2657dc4ae6ff8eb0085bf114623b66cc664072e69b

3. オプション: すべてのイメージをリスト表示します。

   $ podman ps -a
   CONTAINER ID  IMAGE                                   COMMAND  CREATED        STATUS            PORTS   NAMES
   e4654eb4df12  registry.access.redhat.com/ubi9:latest  bash     4 seconds ago  Up 4 seconds ago          myubi

手順

1. /etc/containers/containers.conf ファイルでランタイムを変更します。

   # vim /etc/containers/containers.conf
   [engine]
   runtime = "<runtime>"

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

   # podman run --name=myubi -dt ubi9 bash
   Resolved "ubi9" as an alias (/etc/containers/registries.conf.d/001-rhel-shortnames.conf)
   Trying to pull registry.access.redhat.com/ubi9:latest…
   ...
   Storing signatures

手順

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

   FROM registry.access.redhat.com/ubi9/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/ubi8/ubi-micro イメージをプルしてビルドします。

   # microcontainer=$(buildah from registry.access.redhat.com/ubi9/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/ubi9/ubi イメージをプルして実行します。

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

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

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

     # dnf install --disablerepo=* --enablerepo=ubi-8-appstream-rpms --enablerepo=ubi-8-baseos-rpms bzip2

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

     # dnf install zsh

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

     # dnf install --enablerepo=codeready-builder-for-rhel-8-x86_64-rpms python38-devel

検証

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

   # dnf repolist

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

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

   # rpm -qa

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

手順

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

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

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

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

     # microdnf install bzip2 --setopt install_weak_deps=false

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

     # microdnf install --enablerepo=codeready-builder-for-rhel-8-x86_64-rpms python38-devel --setopt install_weak_deps=false

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

検証

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

   # microdnf repolist

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

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

   # rpm -qa

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

検証

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

   • UBI 標準イメージまたは UBI init イメージに基づいて、コンテナー内で有効なリポジトリーをすべてリスト表示するには、次のコマンドを実行します。

     #  dnf repolist

   • UBI minimal コンテナーに基づいて、コンテナー内で有効なリポジトリーを一覧表示するには、以下を実行します。

     # microdnf repolist

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

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

   # rpm -qa

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

手順

1. Containerfile を作成します。

   FROM registry.access.redhat.com/ubi9/ubi
   USER root
   LABEL maintainer="John Doe"
   # Update image
   RUN dnf update --disablerepo=* --enablerepo=ubi-8-appstream-rpms --enablerepo=ubi-8-baseos-rpms -y && rm -rf /var/cache/yum
   RUN dnf install --disablerepo=* --enablerepo=ubi-8-appstream-rpms --enablerepo=ubi-8-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/ubi9/ubi:latest
   STEP 2: USER root
   STEP 3: LABEL maintainer="John Doe"
   STEP 4: RUN dnf update --disablerepo=* --enablerepo=ubi-8-appstream-rpms --enablerepo=ubi-8-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/ubi9: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

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

手順

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

   # gpg --full-gen-key

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

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

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

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

   <registry>、<namespace>、および <image> をコンテナーイメージ識別子に置き換えます。詳細については、コンテナーレジストリー を参照してください。

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

    $  podman push \
       --sign-by <username@domain.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

手順

1. <registry> の信頼範囲を更新します。

   $ podman image trust set -f <path>/key.gpg <registry>/<namespace>

2. オプション: /etc/containers/policy.json ファイルを表示して、信頼ポリシーの設定を確認します。

   $ cat /etc/containers/policy.json
   {
     ...
     "transports": {
       "docker": {
         "<registry>/<namespace>": [
           {
             "type": "signedBy",
             "keyType": "GPGKeys",
             "keyPath": "<path>/key.gpg"
           }
         ]
       }
     }
   }

   注記

   通常、/etc/containers.policy.json ファイルは、同じキーが使用される組織のレベルで設定されます。たとえば、公開レジストリーの場合は <registry>/<namespace>、単一企業専用レジストリーの場合は単に <registry> です。

3. イメージをプルします:

   # podman pull <registry>/<namespace>/<image>
   ...
   Storing signatures
   e7d92cdc71feacf90708cb59182d0df1b911f8ae022d29e8e95d75ca6a99776a

   podman pull コマンドは、設定どおりに署名の存在を強制します。追加のオプションは必要ありません。

手順

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

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

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

     注記

     skopeo generate-sigstore-key コマンドは、RHEL 9.2 から利用できます。それ以外の場合は、アップストリームの Cosign プロジェクトを使用して、公開鍵と秘密鍵のペアを生成する必要があります。

     • cosign ツールをインストールします。

       $ git clone -b v2.0.0 https://github.com/sigstore/cosign
       $ cd cosign
       $ make ./cosign

     • 公開鍵/秘密鍵のペアを生成します。

       $ ./cosign generate-key-pair
       ...
       Private key written to cosign.key
       Public key written to cosign.pub

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、レジストリー、または名前空間) は、/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 署名がリモートレジストリーにアップロードされます。

手順

1. 次の内容を /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、レジストリー、または名前空間) は、/etc/containers/registries.d ディレクトリー内の 1 つのファイルにのみ存在できます。

2. /etc/containers/policy.json ファイルを編集して、sigstore 署名の存在を強制します。

   ...
   "transports": {
               "docker": {
                   "<registry>/<namespace>": [
                       {
                           "type": "sigstoreSigned",
                           "keyPath": "/some/path/to/cosign.pub"
                       }
                   ]
               }
           }
   ...

   /etc/containers/policy.json 設定ファイルを変更することにより、信頼ポリシーの設定を変更します。Podman、Buildah、および Skopeo は、コンテナーイメージの署名の存在を強制します。

3. イメージをプルします:

   $ podman pull <registry>/<namespace>/<image>

手順

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、レジストリー、または名前空間) は、/etc/containers/registries.d ディレクトリー内の 1 つのファイルにのみ存在できます。/etc/containers/registries.d/default.yaml ファイルでシステム全体のレジストリー設定を編集することもできます。すべての YAML ファイルが読み取られ、ファイル名は任意であることに注意してください。

2. 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 コマンドを使用して、既存のイメージをコンテナーレジストリー間で移動しながら署名することもできます。

手順

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、レジストリー、または名前空間) は、/etc/containers/registries.d ディレクトリー内の 1 つのファイルにのみ存在できます。/etc/containers/registries.d/default.yaml ファイルでシステム全体のレジストリー設定を編集することもできます。すべての YAML ファイルが読み取られ、ファイル名は任意であることに注意してください。

2. /etc/containers/policy.json ファイルに fulcio セクションと rekorPublicKeyPath フィールドまたは rekorPublicKeyData フィールドを追加します。

   {
       ...
       "transports": {
   	"docker": {
           "<registry>/<namespace>": [
               {
               "type": "sigstoreSigned",
               "fulcio": {
                   "caPath": "/path/to/local/CA/file",
                   "oidcIssuer": "https://expected.OIDC.issuer/",
                   "subjectEmail", "expected-signing-user@example.com",
               },
               "rekorPublicKeyPath": "/path/to/local/public/key/file",
               }
           ]
       ...
   	}
     }
     ...
   }

   • fulcio セクションでは、署名が Fulcio 発行の証明書に基づいていることが規定されています。
   • Fulcio インスタンスの CA 証明書を含む caPath フィールドと caData フィールドのいずれかを指定する必要があります。
   • oidcIssuer と subjectEmail は両方とも必須であり、予期される ID プロバイダー、および Fulcio 証明書を取得するユーザーの ID を正確に指定します。
   • rekorPublicKeyPath フィールドと rekorPublicKeyData フィールドのいずれかを指定する必要があります。

3. イメージをプルします:

   $ podman pull <registry>/<namespace>/<image>

手順

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

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

   • 公開鍵と秘密鍵 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、レジストリー、または名前空間) は、/etc/containers/registries.d ディレクトリー内の 1 つのファイルにのみ存在できます。/etc/containers/registries.d/default.yaml ファイルでシステム全体のレジストリー設定を編集することもできます。すべての YAML ファイルが読み取られ、ファイル名は任意であることに注意してください。

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

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

4. file.yml ファイルを作成します。

   privateKeyFile: "/home/user/sigstore/myKey.private"
   privateKeyPassphraseFile: "/mnt/user/sigstore-myKey-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. すべてのネットワークをリストアップします。

   # 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

手順

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/ubi9/pause            Less than a second ago  Created         223df6b390b4-infra  223df6b390b4

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

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

   $ podman run -dt --name myubi --pod mypod registry.access.redhat.com/ubi9/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/ubi9/ubi:latest  /bin/bash  Less than a second ago  Up Less than a second ago         myubi               223df6b390b4
   3afdcd93de3e  registry.access.redhat.com/ubi9/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/ubi9/ubi:latest  /bin/bash  About a minute ago  Exited (0) 7 seconds ago          myubi               223df6b390b4  mypod
   
   3afdcd93de3e  registry.access.redhat.com/9/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 中の全コンテナーが自動的に削除されることに注意してください。

2. オプション: すべてのコンテナーおよび Pod が削除されたことを確認します。

   $ podman ps
   $ podman pod ps

手順

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 ubi9/ubi curl 10.88.0.2:80
   
   <html><body><h1>It works!</h1></body></html>

手順

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

   # podman network inspect podman | grep bridge
   
       "bridge": "cni-podman0",
       "type": "bridge"

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

   # ip addr show cni-podman0
   
   6: cni-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 cni-podman0
          valid_lft forever preferred_lft forever
       inet6 fe80::60af:a1ff:fe0a:ca2e/64 scope link
          valid_lft forever preferred_lft forever

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

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

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

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

   $ curl 10.88.0.2:80
   
   <html><body><h1>It works!</h1></body></html>

手順

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

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

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

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

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

   # podman run -dt --name=web3 -p 9090:80 ubi9/httpd-24

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

   # podman ps
   
   CONTAINER ID  IMAGE                                            COMMAND               CREATED         STATUS             PORTS                                             NAMES
   f12fa79b8b39  registry.access.redhat.com/ubi9/httpd-24:latest  /usr/bin/run-http...  23 seconds ago  Up 24 seconds ago                                                    web1
   9024d9e815e2  registry.access.redhat.com/ubi9/httpd-24:latest  /usr/bin/run-http...  13 seconds ago  Up 13 seconds ago  0.0.0.0:43595->8080/tcp, 0.0.0.0:42423->8443/tcp  web2
   03bc2a019f1b  registry.access.redhat.com/ubi9/httpd-24:latest  /usr/bin/run-http...  2 seconds ago   Up 2 seconds ago   0.0.0.0:9090->80/tcp                              web3

   以下が確認できます。

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

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

     注記

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

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

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

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

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

   # curl 10.88.0.14: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.14:9090
   ...
   <title>Test Page for the HTTP Server on Red Hat Enterprise Linux</title>
   ...

手順

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

   # podman run -d --net mynet --name receiver ubi9 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 で終了します。

手順

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
   
   <html><body><h1>It works!</h1></body></html>

   コンテナーが 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  publish-pod  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
   
   <html><body><h1>It works!</h1></body></html>

手順

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 webt-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/ubi9/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. dhcp プラグインを手動で実行します。

   # /usr/libexec/cni/dhcp daemon &
   [1] 4966

2. dhcp プラグインが動作していることを確認します。

   # ps -a | grep dhcp
   4966 pts/1    00:00:00 dhcp

3. alpine コンテナーを実行します。

   # podman run -it --rm --network=example alpine ip addr show enp1s0
   Resolved "alpine" as an alias (/etc/containers/registries.conf.d/000-shortnames.conf)
   Trying to pull docker.io/library/alpine:latest...
   ...
   Storing signatures
   
   2: eth0@eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc noqueue state UP
       link/ether f6:dd:1b:a7:9b:92 brd ff:ff:ff:ff:ff:ff
       inet 192.168.1.22/24 brd 192.168.1.255 scope global eth0
       ...

   この例では、以下が適用されます。

   • network=example オプションは、接続するネットワークを example という名前で指定します。
   • alpine コンテナーで ip addr show enp1s0 コマンドを実行すると、ネットワークインターフェイス enp1s0 の IP アドレスを確認します。
   • ホストネットワークは 192.168.1.0/24 です。
   • eth0 インターフェイスは、alpine コンテナー用に 192.168.1.122 の IP アドレスをリースしています。

手順

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

   # cat /usr/lib/systemd/system/io.podman.dhcp.socket
   [Unit]
   Description=DHCP Client for CNI
   
   [Socket]
   ListenStream=%t/cni/dhcp.sock
   SocketMode=0600
   
   [Install]
   WantedBy=sockets.target

2. サービスユニットファイルを作成します。

   # cat /usr/lib/systemd/system/io.podman.dhcp.service
   [Unit]
   Description=DHCP Client CNI Service
   Requires=io.podman.dhcp.socket
   After=io.podman.dhcp.socket
   
   [Service]
   Type=simple
   ExecStart=/usr/libexec/cni/dhcp daemon
   TimeoutStopSec=30
   KillMode=process
   
   
   [Install]
   WantedBy=multi-user.target
   Also=io.podman.dhcp.socket

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

   # systemctl --now enable io.podman.dhcp.socket

手順

1. /etc/containers/containers.conf ファイルが存在しない場合は、/usr/share/containers/containers.conf ファイルを /etc/containers/ ディレクトリーにコピーします。

   # cp /usr/share/containers/containers.conf /etc/containers/

2. /etc/containers/containers.conf ファイルを編集し、[network] セクションに以下の内容を追加します。

   network_backend="netavark"

3. コンテナーや Pod がある場合は、ストレージをリセットして初期状態に戻します。

   # podman system reset

4. システムを再起動します。

   # reboot

手順

1. /etc/containers/containers.conf ファイルが存在しない場合は、/usr/share/containers/containers.conf ファイルを /etc/containers/ ディレクトリーにコピーします。

   # cp /usr/share/containers/containers.conf /etc/containers/

2. /etc/containers/containers.conf ファイルを編集し、[network] セクションに以下の内容を追加します。

   network_backend="cni"

3. コンテナーや Pod がある場合は、ストレージをリセットして初期状態に戻します。

   # podman system reset

4. システムを再起動します。

   # reboot

手順

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

   $ podman ps -a --pod
   CONTAINER ID  IMAGE                                       COMMAND    CREATED                 STATUS                     PORTS  NAMES               POD
   5df5c48fea87  registry.access.redhat.com/ubi9/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/ubi9/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/ubi9/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 が一致します。

手順

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. 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 を作成します。

2. すべてのコンテナーと 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. mysleep.container ユニットファイルを作成します。

   $ cat $HOME/.config/containers/systemd/mysleep.container
   [Unit]
   Description=The sleep container
   After=local-fs.target
   
   [Container]
   Image=registry.access.redhat.com/ubi9-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

検証

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/ubi9-minimal:latest               sleep 1000  30 seconds ago   Up 10 seconds ago systemd-mysleep

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

   • systemd- 接頭辞

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

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

手順

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 ubi9-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 コマンドを使用して、サービスが有効であるかどうかを確認できます。

手順

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

   $ podman create --name myubi registry.access.redhat.com/ubi9: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/ubi9/httpd-24

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

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

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

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

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

   # podman ps -a
   CONTAINER ID  IMAGE                                            COMMAND               CREATED        STATUS      PORTS                   NAMES
   cdb9f981cf14  registry.access.redhat.com/ubi9/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/ubi9/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

手順

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/ubi9 top
   $ podman create --pod systemd-pod --name container1 registry.access.redhat.com/ubi9 top

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

   $ podman ps -a --pod
   CONTAINER ID  IMAGE                                   COMMAND  CREATED        STATUS         PORTS   NAMES               POD ID        PODNAME
   24666f47d9b2  registry.access.redhat.com/ubi9: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/ubi9: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/ubi9/ubi-init イメージをもとに、myubi コンテナーを起動します。

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

2. オプション: 実行中または終了したコンテナーをリスト表示します。

   # podman ps -a
   CONTAINER ID  IMAGE                                            COMMAND  CREATED         STATUS             PORTS   NAMES
   76465a5e2933  registry.access.redhat.com/9/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

手順

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. 次の内容を含む 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: 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/linux-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 と run_as_group

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

   kube_file_content

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

   • 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: 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: ubi8-httpd
             spec:
               containers:
                 - name: ubi8-httpd
                   image: registry.access.redhat.com/ubi8/httpd-24
                   ports:
                     - containerPort: 8080
                       hostPort: 8080
                   volumeMounts:
                     - mountPath: /var/www/html:Z
                       name: ubi8-html
               volumes:
                 - name: ubi8-html
                   persistentVolumeClaim:
                     claimName: ubi8-html-volume

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

   kube_file_content

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

   • ubi8-httpd コンテナーは、registry.access.redhat.com/ubi8/httpd-24 コンテナーイメージに基づいています。
   • ubi8-html-volume は、ホスト上の /var/www/html ディレクトリーをコンテナーにマップします。Z フラグはコンテンツにプライベート非共有ラベルを付けるため、ubi8-httpd コンテナーのみがコンテンツにアクセスできます。
   • Pod は、マウントパス /var/www/html を使用して、ubi8-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

手順

1. 証明書と秘密鍵ファイルの内容を表示します。

   $ cat ~/certificate.pem
   -----BEGIN CERTIFICATE-----
   ...
   -----END CERTIFICATE-----
   
   $ cat ~/key.pem
   -----BEGIN PRIVATE KEY-----
   ...
   -----END PRIVATE KEY-----

   この情報は後の手順で必要になります。

2. 機密性の高い変数を暗号化されたファイルに保存します。

   1. vault を作成します。

      $ ansible-vault create vault.yml
      New Vault password: <vault_password>
      Confirm New Vault password: <vault_password>

   2. ansible-vault create コマンドでエディターが開いたら、機密データを <key>: <value> 形式で入力します。

      root_password: <root_password>
      certificate: |-
        -----BEGIN CERTIFICATE-----
        ...
        -----END CERTIFICATE-----
      key: |-
        -----BEGIN PRIVATE KEY-----
        ...
        -----END PRIVATE KEY-----

      certificate 変数および key 変数のすべての行が 2 つのスペースで始まるようにします。

   3. 変更を保存して、エディターを閉じます。Ansible は vault 内のデータを暗号化します。

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

   - name: Deploy a wordpress CMS with MySQL database
     hosts: managed-node-01.example.com
     vars_files:
       - vault.yml
     tasks:
     - name: Create and run the container
       ansible.builtin.include_role:
         name: rhel-system-roles.podman
       vars:
         podman_create_host_directories: true
         podman_activate_systemd_unit: false
         podman_quadlet_specs:
           - name: quadlet-demo
             type: network
             file_content: |
               [Network]
               Subnet=192.168.30.0/24
               Gateway=192.168.30.1
               Label=app=wordpress
           - file_src: quadlet-demo-mysql.volume
           - template_src: quadlet-demo-mysql.container.j2
           - file_src: envoy-proxy-configmap.yml
           - file_src: quadlet-demo.yml
           - file_src: quadlet-demo.kube
             activate_systemd_unit: true
         podman_firewall:
           - port: 8000/tcp
             state: enabled
           - port: 9000/tcp
             state: enabled
         podman_secrets:
           - name: mysql-root-password-container
             state: present
             skip_existing: true
             data: "{{ root_password }}"
           - name: mysql-root-password-kube
             state: present
             skip_existing: true
             data: |
               apiVersion: v1
               data:
                 password: "{{ root_password | b64encode }}"
               kind: Secret
               metadata:
                 name: mysql-root-password-kube
           - name: envoy-certificates
             state: present
             skip_existing: true
             data: |
               apiVersion: v1
               data:
                 certificate.key: {{ key | b64encode }}
                 certificate.pem: {{ certificate | b64encode }}
               kind: Secret
               metadata:
                 name: envoy-certificates

   この手順では、MySQL データベースと組み合わせた WordPress コンテンツ管理システムを作成します。podman_quadlet_specs ロール変数では、Quadlet の一連の設定を定義します。この設定は、特定の方法で連携するコンテナーまたはサービスのグループを参照します。これには次の仕様を含めます。

   • Wordpress ネットワークを、quadlet-demo ネットワークユニットで定義します。
   • MySQL コンテナーのボリューム設定を、file_src: quadlet-demo-mysql.volume フィールドで定義します。
   • template_src: quadlet-demo-mysql.container.j2 フィールドを使用して、MySQL コンテナーの設定を生成します。
   • その後に、2 つの YAML ファイル file_src: envoy-proxy-configmap.yml および file_src:quadlet-demo.yml を指定します。.yml は有効な Quadlet ユニットタイプではないため、これらのファイルはコピーされるだけで、Quadlet 仕様としては処理されないことに注意してください。
   • Wordpress および envoy プロキシーコンテナーと設定を、file_src: quadlet-demo.kube フィールドで定義します。kube ユニットは、[Kube] セクション内の上記の YAML ファイルを、Yaml=quadlet-demo.yml および ConfigMap=envoy-proxy-configmap.yml として参照します。

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

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

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

5. Playbook を実行します。

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

手順

1. RHEL 9 Web コンソールにログインします。

   詳細は、Web コンソールへのログイン を参照してください。

2. メインメニューで Podman containers をクリックします。
3. Images テーブルで、右上隅にあるオーバーフローメニューをクリックし、Download new image を選択します。
4. Search for an image ダイアログボックスが表示されます。
5. Search for フィールドに、イメージの名前を入力するか、その説明を指定します。
6. in ドロップダウンリストで、イメージを取得するレジストリーを選択します。
7. オプション: Tag フィールドに、イメージのタグを入力します。
8. Download をクリックします。

手順

1. RHEL 9 Web コンソールにログインします。

   詳細は、Web コンソールへのログイン を参照してください。

2. メインメニューで Podman containers をクリックします。
3. Images テーブルで、右上隅のオーバーフローメニューをクリックし、Prune unused images を選択します。
4. イメージのリストを含むポップアップウィンドウが表示されます。Prune をクリックして選択を確定します。

手順

1. RHEL 9 Web コンソールにログインします。

   詳細は、Web コンソールへのログイン を参照してください。

2. メインメニューで Podman containers をクリックします。
3. Images テーブルで、削除するイメージを選択し、オーバーフローメニューをクリックして Delete を選択します。
4. ウィンドウが表示されます。Delete tagged images をクリックして選択を確認します。

手順

1. RHEL 9 Web コンソールにログインします。

   詳細は、Web コンソールへのログイン を参照してください。

2. メインメニューで Podman containers をクリックします。
3. Create container をクリックします。
4. Name フィールドに、コンテナーの名前を入力します。

5. Details タブに必要な情報を入力します。

   • 管理者アクセス権がある場合のみ利用可能:コンテナーの所有者を選択します。システムまたはユーザー。

   • Image ドロップダウンリストで、選択したレジストリー内のコンテナーイメージを選択または検索します。

     • オプション: 最新のコンテナーイメージをプルするには、Pull latest image チェックボックスをオンにします。

   • Command フィールドはコマンドを指定します。必要に応じて、デフォルトのコマンドを変更できます。

     • オプション: ターミナルを使用してコンテナーを実行するには、With terminal チェックボックスをオンにします。
   • Memory limit フィールドでは、コンテナーのメモリー制限を指定します。デフォルトのメモリー制限を変更するには、チェックボックスをオンにして制限を指定します。
   • システムコンテナーでのみ利用可能:CPU shares フィールド に、相対的な CPU 時間量を指定します。デフォルト値は 1024 です。デフォルト値を変更するには、チェックボックスをオンにします。

   • システムコンテナーでのみ利用可能:Restart policy ドロップダウンメニューで、次のオプションのいずれかを選択します。

     • No (デフォルト値): 何もしません。
     • On Failure: 失敗時にコンテナーを再起動します。
     • Always: コンテナーの終了時、またはシステムの再起動後にコンテナーを再起動します。

6. Integration タブに必要な情報を入力します。

   • Add port mapping をクリックして、コンテナーとホストシステムの間にポートマッピングを追加します。

     • IP アドレス、ホストポート、コンテナーポート、および プロトコル を入力します。

   • Add volume をクリックしてボリュームを追加します。

     • ホストパス、コンテナーパス を入力します。Writable オプションのチェックボックスをオンにして、書き込み可能なボリュームを作成できます。SELinux ドロップダウンリストで、No Label、Shared、または Private のいずれかのオプションをを選択します。

   • Add variable をクリックして環境変数を追加します。

     • Key と Value を入力します。

7. Health check タブに必要な情報を入力します。

   • Command フィールドに、'healthcheck' コマンドを入力します。

   • ヘルスチェックオプションを指定します。

     • Interval (デフォルトは 30 秒)
     • Timeout (デフォルトは 30 秒)
     • Start period
     • Retries (デフォルトは 3)

     • When unhealthy: 以下のオプションのいずれかを選択します。

       • No action (デフォルト): 何もしません。
       • Restart: コンテナーを再起動します。
       • Stop: コンテナーを停止します。
       • Force stop: コンテナーを強制的に停止します。コンテナーが終了するのを待ちません。
8. Create and run をクリックして、コンテナーを作成して実行します。

手順

1. RHEL 9 Web コンソールにログインします。

   詳細は、Web コンソールへのログイン を参照してください。

2. メインメニューで Podman containers をクリックします。

3. Containers テーブルで、変更するコンテナーを選択し、オーバーフローメニューをクリックして、実行するアクションを選択します。

   • Start
   • Stop
   • Force stop
   • Restart
   • Force restart
   • Pause
   • Rename

手順

1. RHEL 9 Web コンソールにログインします。

   詳細は、Web コンソールへのログイン を参照してください。

2. メインメニューで Podman containers をクリックします。
3. Containers テーブルで、変更するコンテナーを選択し、オーバーフローメニューをクリックして Commit を選択します。

4. Commit container フォームに、次の詳細を追加します。

   • New image name フィールドにイメージ名を入力します。
   • オプション: Tag フィールドにタグを入力します。
   • オプション: Author フィールドに名前を入力します。
   • オプション: 必要に応じて、Command フィールドでコマンドを変更します。

   • オプション: 必要な オプション を確認してください。

     • イメージの作成時にコンテナーを一時停止します。イメージがコミットされている間、コンテナーとそのプロセスは一時停止されます。
     • 従来の Docker 形式を使用する: Docker イメージ形式を使用しない場合は、OCI 形式が使用されます。
5. Commit をクリックします。

手順

1. RHEL 9 Web コンソールにログインします。

   詳細は、Web コンソールへのログイン を参照してください。

2. メインメニューで Podman containers をクリックします。
3. Containers テーブルで、変更するコンテナーを選択し、オーバーフローアイコンメニューをクリックして Containers を選択します。

4. オプション: Checkpoint container フォームで、必要なオプションをチェックします。

   • すべての一時チェックポイントファイルを保持する: チェックポイント作成中に CRIU によって作成されたすべての一時ログおよび統計ファイルを保持します。さらなるデバッグのためのチェックポイント設定が失敗した場合でも、これらのファイルは削除されません。
   • チェックポイントをディスクに書き込んだ後も実行したままにする: チェックポイントを作成した後もコンテナーを停止するのではなく、実行したままにします。
   • 確立された TCP 接続の維持のサポート
5. Checkpoint をクリックします。

手順

1. RHEL 9 Web コンソールにログインします。

   詳細は、Web コンソールへのログイン を参照してください。

2. メインメニューで Podman containers をクリックします。
3. Containers テーブルで、変更するコンテナーを選択し、オーバーフローメニューをクリックして Restore を選択します。

4. オプション: Restore container フォームで、必要なオプションを確認します。

   • Keep all temporary checkpoint files: チェックポイント設定中に CRIU によって作成されたすべての一時ログおよび統計ファイルを保持します。さらなるデバッグのためのチェックポイント設定が失敗した場合でも、これらのファイルは削除されません。
   • Restore with established TCP connections
   • Ignore IP address if set statically: コンテナーが IP アドレスを使用して開始された場合、復元されたコンテナーもその IP アドレスを使用しようとし、その IP アドレスがすでに使用されている場合は復元は失敗します。このオプションは、コンテナーの作成時に Integration タブでポートマッピングを追加した場合に適用されます。
   • Ignore MAC address if set statically: コンテナーが MAC アドレスで開始された場合、復元されたコンテナーもその MAC アドレスを使用しようとし、その MAC アドレスがすでに使用されている場合は復元は失敗します。
5. Restore をクリックします。

手順

1. RHEL 9 Web コンソールにログインします。

   詳細は、Web コンソールへのログイン を参照してください。

2. メインメニューで Podman containers をクリックします。
3. Containers テーブルで、削除するコンテナーを選択し、オーバーフローメニューをクリックして Delete を選択します。
4. ポップアップウィンドウが表示されます。Delete をクリックして選択を確定します。

手順

1. RHEL 9 Web コンソールにログインします。

   詳細は、Web コンソールへのログイン を参照してください。

2. メインメニューで Podman containers をクリックします。
3. Create pod をクリックします。

4. Create pod フォームに必要な情報を入力します。

   • 管理者アクセス権がある場合のみ利用可能:コンテナーの所有者を選択します。システムまたはユーザー。
   • Name フィールドに、コンテナーの名前を入力します。

   • Add port mapping をクリックして、コンテナーとホストシステムの間にポートマッピングを追加します。

     • IP アドレス、ホストポート、コンテナーポート、プロトコルを入力します。

   • Add volume をクリックしてボリュームを追加します。

     • ホストパス、コンテナーパスを入力します。書き込み可能チェックボックスをオンにして、書き込み可能なボリュームを作成できます。SELinux ドロップダウンリストで、No Label、Shared、または Private。
5. Create をクリックします。

手順

1. RHEL 9 Web コンソールにログインします。

   詳細は、Web コンソールへのログイン を参照してください。

2. メインメニューで Podman containers をクリックします。
3. Create container in pod をクリックします。
4. Name フィールドに、コンテナーの名前を入力します。

5. Details タブに必要な情報を入力します。

   • 管理者アクセス権がある場合のみ利用可能:コンテナーの所有者を選択します。システムまたはユーザー。

   • Image ドロップダウンリストで、選択したレジストリー内のコンテナーイメージを選択または検索します。

     • オプション: 最新のコンテナーイメージをプルするには、Pull latest image チェックボックスをオンにします。

   • Command フィールドはコマンドを指定します。必要に応じて、デフォルトのコマンドを変更できます。

     • オプション: ターミナルを使用してコンテナーを実行するには、With terminal チェックボックスをオンにします。
   • Memory limit フィールドでは、コンテナーのメモリー制限を指定します。デフォルトのメモリー制限を変更するには、チェックボックスをオンにして制限を指定します。
   • システムコンテナーでのみ利用可能:CPU shares フィールド に、相対的な CPU 時間量を指定します。デフォルト値は 1024 です。デフォルト値を変更するには、チェックボックスをオンにします。

   • システムコンテナーでのみ利用可能:Restart policy ドロップダウンメニューで、次のオプションのいずれかを選択します。

     • No (デフォルト値): 何もしません。
     • On Failure: 失敗時にコンテナーを再起動します。
     • Always: コンテナーの終了時またはシステム起動後にコンテナーを再起動します。

6. Integration タブに必要な情報を入力します。

   • Add port mapping をクリックして、コンテナーとホストシステムの間にポートマッピングを追加します。

     • IP アドレス、ホストポート、コンテナーポート、および プロトコル を入力します。

   • Add volume をクリックしてボリュームを追加します。

     • ホストパス、コンテナーパス を入力します。Writable オプションのチェックボックスをオンにして、書き込み可能なボリュームを作成できます。SELinux ドロップダウンリストで、No Label、Shared、または Private のいずれかのオプションをを選択します。

   • Add variable をクリックして環境変数を追加します。

     • Key と Value を入力します。

7. Health check タブに必要な情報を入力します。

   • Command フィールドに、ヘルスチェックコマンドを入力します。

   • ヘルスチェックオプションを指定します。

     • Interval (デフォルトは 30 秒)
     • Timeout (デフォルトは 30 秒)
     • Start period
     • Retries (デフォルトは 3)

     • When unhealthy: 以下のオプションのいずれかを選択します。

       • No action (デフォルト): 何もしません。
       • Restart: コンテナーを再起動します。
       • Stop: コンテナーを停止します。
       • Force stop: コンテナーを強制的に停止します。コンテナーが終了するのを待ちません。