手順

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 モジュールをインストールします。

   # yum module install -y container-tools

   container-tools モジュールには podman-docker パッケージが含まれています。

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

手順

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

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

   # yum 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/ubi8/ubi コンテナーイメージをプルします。

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

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

   $ podman run --rm --name=myubi registry.access.redhat.com/ubi8/ubi \ cat /etc/os-release
   NAME="Red Hat Enterprise Linux"
   VERSION="8 (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/ubi8/ubi コンテナーイメージをプルします。

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

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

   • イメージ名:

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

   • イメージ ID:

     $ podman tag 3269c37eae33 myubi

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

3. すべてのイメージを一覧表示します。

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

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

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

   • イメージ名:

     $ podman tag registry.redhat.io/ubi8/ubi myubi:8

   • イメージ ID:

     $ podman tag 3269c37eae33 myubi:8

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

5. すべてのイメージを一覧表示します。

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

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

手順

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

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

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

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

     $ podman save -o myrsyslog-oci.tar --format=oci-archive registry.redhat.io/rhel8/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/rhel8/rsyslog:latest イメージを読み込むには、以下を実行します。

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

手順

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

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

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

   # podman push registry.example.com:5000/ubi8/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/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. GPG キーを生成します。

   # gpg --full-gen-key

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

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

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

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

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

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

    $  podman push \
       --sign-by <username>@redhat.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. cosign ツールをインストールします。

   $ git clone https://github.com/sigstore/cosign
   $ cd cosign
   $ make ./cosign

2. 公開鍵と秘密鍵を生成:

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

手順

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. 現在のディレクトリーで Containerfile を使用してコンテナーイメージをビルドします。

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

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

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

   podman push コマンドは、<registry>/<namespace>/<image> ローカルイメージを <registry>/<namespace>/<image> としてリモートレジストリーにプッシュします。--sign-by-sigstore-private-key オプションは、cosign.key 秘密鍵を使用して 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. cat /etc/os-release コマンドを使用して、registry.access.redhat.com/ubi8/ubi コンテナーイメージをベースとするコンテナーのオペレーティングシステムの種類を表示します。

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

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

   $ podman ps
   CONTAINER ID  IMAGE   COMMAND  CREATED  STATUS  PORTS   NAMES

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

手順

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

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

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

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

   [root@6ccffd0f6421 /]# yum 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/ubi8/ubi:latest  /bin/bash  21 minutes ago  Exited (0) 21 minutes ago          myubi

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

手順

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

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

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

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

     $ podman ps
     CONTAINER ID IMAGE              COMMAND         CREATED       STATUS            PORTS NAMES
     74b1da000a11 rhel8/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 ubi8/ubi      /bin/bash  3 secs ago Exited (0) 5 secs ago peaceful_hopper false
     74b1da000a11 rhel8/rsyslog rsyslog.sh 2 mins ago Up About a minute     musing_brown    false

手順

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

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

     $ podman start myubi

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

   • 対話モードで、 -a (--attach) および -t (--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/ubi8/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/rhel8/rsyslog

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

   # podman ps -a
   CONTAINER ID  IMAGE                                    COMMAND          CREATED         STATUS                     PORTS   NAMES
   c56ef6a256f8  registry.redhat.io/rhel8/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="8 (Ootpa)"
   ID="rhel"
   ID_LIKE="fedora"
   ...

手順

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

   # podman run -d --ip=10.88.0.44 registry.access.redhat.com/rhel8/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 など)。

   # yum 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/ubi8/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/ubi8/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/ubi8/ubi イメージに基づいて、myubi コンテナーを実行します。

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

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

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

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

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

   # podman export $(podman create registry.access.redhat.com/ubi8/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. 新しいディレクトリーに以下の内容を含む Containerfile を作成します。

   FROM registry.access.redhat.com/ubi8/ubi-init
   RUN yum -y install httpd; yum 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/ubi8/ubi-micro)

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

   # micromount=$(buildah mount $microcontainer)

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

   # yum install \
       --installroot $micromount \
       --releasever 8 \
       --setopt install_weak_deps=false \
       --nodocs -y \
       httpd
   # yum 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/ubi8/ubi イメージをプルして実行します。

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

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

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

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

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

     # yum install zsh

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

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

検証手順

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

   # yum repolist

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

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

   # rpm -qa

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

手順

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

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

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

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

     # microdnf install bzip2

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

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

検証手順

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

   # microdnf repolist

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

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

   # rpm -qa

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

検証手順

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

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

     #  yum repolist

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

     # microdnf repolist

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

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

   # rpm -qa

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

手順

1. Containerfile を作成します。

   FROM registry.access.redhat.com/ubi8/ubi
   USER root
   LABEL maintainer="John Doe"
   # Update image
   RUN yum update --disablerepo=* --enablerepo=ubi-8-appstream-rpms --enablerepo=ubi-8-baseos-rpms -y && rm -rf /var/cache/yum
   RUN yum 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/ubi8/ubi:latest
   STEP 2: USER root
   STEP 3: LABEL maintainer="John Doe"
   STEP 4: RUN yum 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/ubi8: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. 空の 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/ubi8/pause            Less than a second ago  Created         223df6b390b4-infra  223df6b390b4

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

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

   $ podman run -dt --name myubi --pod mypod registry.access.redhat.com/ubi8/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/ubi8/ubi:latest  /bin/bash  Less than a second ago  Up Less than a second ago         myubi               223df6b390b4
   3afdcd93de3e  registry.access.redhat.com/ubi8/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/ubi8/ubi:latest  /bin/bash  About a minute ago  Exited (0) 7 seconds ago          myubi               223df6b390b4  mypod
   
   3afdcd93de3e  registry.access.redhat.com/8/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. すべてのネットワークをリストアップします。

   # 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. コンテナーの 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 ubi8/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 ubi8/httpd-24

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

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

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

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

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

   # podman ps
   
   CONTAINER ID  IMAGE                                            COMMAND               CREATED         STATUS             PORTS                                             NAMES
   f12fa79b8b39  registry.access.redhat.com/ubi8/httpd-24:latest  /usr/bin/run-http...  23 seconds ago  Up 24 seconds ago                                                    web1
   9024d9e815e2  registry.access.redhat.com/ubi8/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/ubi8/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/8/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 ubi8 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/ubi8/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/container.conf ファイルが存在しない場合は、/usr/share/containers/containers.conf ファイルを /etc/containers/ ディレクトリーにコピーします。

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

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

   network_backend="netavark"

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

   # podman system reset

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

   # reboot

手順

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

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

2. etc/containers/container.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/ubi8/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/ubi8/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/ubi8/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. コンテナー (例: myubi) を作成します。

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

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

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

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

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

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

   # podman ps -a
   CONTAINER ID  IMAGE                                            COMMAND               CREATED        STATUS      PORTS                   NAMES
   cdb9f981cf14  registry.access.redhat.com/ubi8/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/ubi8/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 マネージャーの設定を再読み込みするには、次のコマンドを実行します。

   # 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 ubi8-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. たとえば、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/ubi8 top
   $ podman create --pod systemd-pod --name container1 registry.access.redhat.com/ubi8 top

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

   $ podman ps -a --pod
   CONTAINER ID  IMAGE                                   COMMAND  CREATED        STATUS         PORTS   NAMES               POD ID        PODNAME
   24666f47d9b2  registry.access.redhat.com/ubi8: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/ubi8: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

   systemd ユニットファイルは、3 つ作成される点に注意してください。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/ubi8/ubi-init イメージをもとに、myubi コンテナーを起動します。

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

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

   # podman ps -a
   CONTAINER ID  IMAGE                                            COMMAND  CREATED         STATUS             PORTS   NAMES
   76465a5e2933  registry.access.redhat.com/8/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. registry.redhat.io レジストリーにログインします。

   $ podman login registry.redhat.io
   Username: myuser@mycompany.com
   Password: <password>
   Login Succeeded!

2. registry.redhat.io/rhel8/skopeo コンテナーイメージを取得します。

   $ podman pull registry.redhat.io/rhel8/skopeo

3. Skopeo を使用して、リモートコンテナーイメージ registry.access.redhat.com/ubi8/ubi を検査します。

   $ podman run --rm registry.redhat.io/rhel8/skopeo \ skopeo inspect docker://registry.access.redhat.com/ubi8/ubi
   {
       "Name": "registry.access.redhat.com/ubi8/ubi",
       ...
       "Labels": {
           "architecture": "x86_64",
           ...
           "name": "ubi8",
           ...
           "summary": "Provides the latest release of Red Hat Universal Base Image 8.",
           "url": "https://access.redhat.com/containers/#/registry.access.redhat.com/ubi8/images/8.2-347",
           ...
       },
       "Architecture": "amd64",
       "Os": "linux",
       "Layers": [
       ...
       ],
       "Env": [
           "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
           "container=oci"
       ]
   }

   --rm オプションは、コンテナーの終了後に registry.redhat.io/rhel8/skopeo イメージを削除します。

手順

1. registry.access.redhat.com/ubi8/ubi イメージをローカルストレージにコピーします。

   $ podman run --privileged --rm -v $HOME/.local/share/containers/storage:/var/lib/containers/storage \ registry.redhat.io/rhel8/skopeo skopeo copy \ docker://registry.access.redhat.com/ubi8/ubi containers-storage:registry.access.redhat.com/ubi8/ubi

   • --privileged オプションは、すべてのセキュリティーメカニズムを無効にします。Red Hat では、このオプションは信頼できる環境でのみ使用することを推奨します。

   • セキュリティーメカニズムを無効にするには、イメージを tarball またはその他のパスベースのイメージトランスポートにエクスポートして Skopeo コンテナーにマウントします。

     • $ podman save --format oci-archive -o oci.tar $IMAGE
     • $ podman run --rm -v oci.tar:/oci.tar registry.redhat.io/rhel8/skopeo copy oci-archive:/oci.tar $DESTINATION

2. 必要に応じて ローカルストレージ内のイメージを一覧表示します。

   $ podman images
   REPOSITORY                               TAG     IMAGE ID      CREATED       SIZE
   registry.access.redhat.com/ubi8/ubi      latest  ecbc6f53bba0  8 weeks ago   211 MB

手順

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

   $ podman login registry.redhat.io
   Username: myuser@mycompany.com
   Password: <password>
   Login Succeeded!

2. registry.redhat.io/rhel8/buildah イメージをプルして実行します。

   # podman run --rm --device /dev/fuse --cap-add sys_chroot -it \ registry.redhat.io/rhel8/buildah /bin/bash

   • --rm オプションは、コンテナーの終了後に registry.redhat.io/rhel8/buildah イメージを削除します。
   • --device オプションは、ホストデバイスをコンテナーに追加します。
   • sys_chroot - 別のルートディレクトリーに変更する機能。コンテナーのデフォルト機能には含まれていません。

3. registry.access.redhat.com/ubi8 イメージを使用して、新しいコンテナーを作成します。

   # buildah from registry.access.redhat.com/ubi8
   ...
   ubi8-working-container

4. ubi8-working-container コンテナー内で ls / コマンドを実行します。

   # buildah run --isolation=chroot ubi8-working-container ls /
   bin  boot  dev  etc  home  lib  lib64  lost+found  media  mnt  opt  proc  root  run  sbin  srv

5. 必要に応じて、ローカルストレージ内の全イメージを一覧表示します。

   # buildah images
   REPOSITORY                        TAG      IMAGE ID       CREATED       SIZE
   registry.access.redhat.com/ubi8   latest   ecbc6f53bba0   5 weeks ago   211 MB

6. 必要に応じて、作業用コンテナーとそのベースイメージを一覧表示します。

   # buildah containers
   CONTAINER ID  BUILDER  IMAGE ID     IMAGE NAME                       CONTAINER NAME
   0aaba7192762     *     ecbc6f53bba0 registry.access.redhat.com/ub... ubi8-working-container

7. 必要に応じて、registry.access.redhat.com/ubi8 イメージを registry.example.com にあるローカルレジストリーにプッシュします。

   # buildah push ecbc6f53bba0 registry.example.com:5000/ubi8/ubi

手順

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

   # podman run --privileged --name podman_container -it \ registry.redhat.io/rhel8/podman /bin/bash

   • registry.access.redhat.com/rhel8/podman イメージに基づいて、privileged_podman という名前の外部コンテナーを実行します。
   • --it オプションは、コンテナー内で対話式 bash シェルを実行します。
   • --privileged オプションは、コンテナーをホストから分離するセキュリティー機能を無効にします。

2. podman_container コンテナー内に Containerfile を作成します。

   # vi Containerfile
   FROM registry.access.redhat.com/ubi8/ubi
   RUN yum install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
   RUN yum -y install moon-buggy && yum clean all
   CMD ["/usr/bin/moon-buggy"]

   Containerfile のコマンドで以下の build コマンドが実行されます。

   • registry.access.redhat.com/ubi8/ubi イメージからコンテナーをビルドします。
   • epel-release-latest-8.noarch.rpm パッケージをインストールします。
   • moon-buggy パッケージをインストールします。
   • コンテナーコマンドを設定します。

3. Containerfile を使用して moon-buggy という名前の新しいコンテナーイメージをビルドします。

   # podman build -t moon-buggy .

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

   # podman images
   REPOSITORY                  TAG      IMAGE ID      CREATED        SIZE
   localhost/moon-buggy  latest  c97c58abb564  13 seconds ago  1.67 GB
   registry.access.redhat.com/ubi8/ubi latest 4199acc83c6a  132seconds ago 213 MB

5. moon-buggy コンテナーに基づいて新しいコンテナーを実行します。

   # podman run -it --name moon moon-buggy

6. 必要に応じて、moon-buggy イメージをタグ付けします。

   # podman tag moon-buggy registry.example.com/moon-buggy

7. 必要に応じて、moon-buggy イメージをレジストリーにプッシュします。

   # podman push registry.example.com/moon-buggy

検証

1. ローカルストレージ内のイメージを一覧表示します。

   # buildah images
   REPOSITORY                                  TAG      IMAGE ID       CREATED       SIZE
   registry.access.redhat.com/ubi8/ubi         latest   272209ff0ae5   2 weeks ago   234 MB

2. 作業用のコンテナーおよびそれらのベースイメージを一覧表示します。

   # buildah containers
   CONTAINER ID  BUILDER  IMAGE ID     IMAGE NAME                       CONTAINER NAME
   01eab9588ae1     *     272209ff0ae5 registry.access.redhat.com/ub... ubi-working-container

手順

1. Containerfile を作成します。

   # cat Containerfile
   FROM registry.access.redhat.com/ubi8/ubi
   ADD myecho /usr/local/bin
   ENTRYPOINT "/usr/local/bin/myecho"

2. myecho スクリプトを作成します。

   # cat myecho
   echo "This container works!"

3. myecho スクリプトのアクセスパーミッションを変更します。

   # chmod 755 myecho

4. 現在のディレクトリーの Containerfile を使用して myecho イメージをビルドします。

   # buildah bud -t myecho .
   STEP 1: FROM registry.access.redhat.com/ubi8/ubi
   STEP 2: ADD myecho /usr/local/bin
   STEP 3: ENTRYPOINT "/usr/local/bin/myecho"
   STEP 4: COMMIT myecho
   ...
   Storing signatures

検証

1. すべてのイメージを一覧表示します。

   # buildah images
   REPOSITORY                                  TAG      IMAGE ID       CREATED              SIZE
   localhost/myecho                            latest   b28cd00741b3   About a minute ago   234 MB

2. localhost/myecho イメージに基づいて myecho コンテナーを実行します。

   # podman run --name=myecho localhost/myecho
   This container works!

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

   # podman ps -a
   0d97517428d  localhost/myecho                                     12 seconds ago  Exited (0) 13 seconds ago          myecho

手順

1. registry.access.redhat.com/ubi8/ubi イメージをもとに作業コンテナーを作成し、コンテナーの名前を mycontainer 変数に保存します。

   # mycontainer=$(buildah from localhost/myecho)
   
   # echo $mycontainer
   myecho-working-container

2. myecho-working-container コンテナーをマウントし、マウントポイントパスを mymount 変数に保存します。

   # mymount=$(buildah mount $mycontainer)
   
   # echo $mymount
   /var/lib/containers/storage/overlay/c1709df40031dda7c49e93575d9c8eebcaa5d8129033a58e5b6a95019684cc25/merged

3. myecho スクリプトを変更し、実行可能にします。

   # echo 'echo "We modified this container."' >> $mymount/usr/local/bin/myecho
   # chmod +x $mymount/usr/local/bin/myecho

4. myecho-working-container コンテナーから myecho2 イメージを作成します。

   # buildah commit $mycontainer containers-storage:myecho2

検証

1. ローカルストレージ内のイメージを一覧表示します。

   # buildah images
   REPOSITORY                                  TAG      IMAGE ID       CREATED          SIZE
   docker.io/library/myecho2                   latest   4547d2c3e436   4 minutes ago    234 MB
   localhost/myecho                            latest   b28cd00741b3   56 minutes ago   234 MB

2. docker.io/library/myecho2 イメージに基づいて myecho2 コンテナーを実行します。

   # podman run --name=myecho2 docker.io/library/myecho2
   This container works!
   We even modified it.

手順

1. newecho という名前のスクリプトを作成し、実行可能にします。

   # cat newecho
   echo "I changed this container"
   # chmod 755 newecho

2. 新しい作業コンテナーを作成します。

   # buildah from myecho:latest
   myecho-working-container-2

3. newecho スクリプトを、コンテナー内の /usr/local/bin ディレクトリーにコピーします。

   # buildah copy myecho-working-container-2 newecho /usr/local/bin

4. newecho スクリプトを、新しいエントリーポイントとして使用するように設定を変更します。

   # buildah config --entrypoint "/bin/sh -c /usr/local/bin/newecho" myecho-working-container-2

5. オプション:実行する newecho スクリプトのトリガーとなる myecho-working-container-2 コンテナーを実行します。

   # buildah run myecho-working-container-2 -- sh -c '/usr/local/bin/newecho'
   I changed this container

6. myecho-working-container-2 コンテナーを、mynewecho という新しいイメージにコミットします。

   # buildah commit myecho-working-container-2 containers-storage:mynewecho

1. 空のコンテナーを作成します。

   # buildah from scratch
   working-container

2. working-container コンテナーをマウントし、マウントポイントパスを scratchmnt 変数に保存します。

   # scratchmnt=$(buildah mount working-container)
   
   
   # echo $scratchmnt
   /var/lib/containers/storage/overlay/be2eaecf9f74b6acfe4d0017dd5534fde06b2fa8de9ed875691f6ccc791c1836/merged

3. scratch イメージで RPM データベースを初期化し、redhat-release パッケージを追加します。

   # yum install -y --releasever=8 --installroot=$scratchmnt redhat-release

4. httphttpd サービスを scratch ディレクトリーにインストールします。

   # yum install -y --setopt=reposdir=/etc/yum.repos.d \ --installroot=$scratchmnt \ --setopt=cachedir=/var/cache/dnf httpd

5. $scratchmnt/var/www/html/index.html ファイルを作成します。

   # mkdir -p $scratchmnt/var/www/html
   # echo "Your httpd container from scratch works!" > $scratchmnt/var/www/html/index.html

6. コンテナーから直接 httpd デーモンを実行するように working-container を設定します。

   # buildah config --cmd "/usr/sbin/httpd -DFOREGROUND" working-container
   # buildah config --port 80/tcp working-container
   # buildah commit working-container localhost/myhttpd:latest

検証

1. ローカルストレージ内のイメージを一覧表示します。

   # podman images
   REPOSITORY                                 TAG     IMAGE ID      CREATED         SIZE
   localhost/myhttpd                          latest  08da72792f60  2 minutes ago   121 MB

2. localhost/myhttpd イメージを実行し、コンテナーとホストシステム間のポートマッピングを設定します。

   # podman run -p 8080:80 -d --name myhttpd 08da72792f60

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

   # curl localhost:8080
   Your httpd container from scratch works!

手順

1. マシンにローカルレジストリーを作成します。

   # podman run -d -p 5000:5000 registry:2

2. myecho:latest イメージを localhost レジストリーにプッシュします。

   #  buildah push --tls-verify=false myecho:latest localhost:5000/myecho:latest
   Getting image source signatures
   Copying blob sha256:e4efd0...
   ...
   Writing manifest to image destination
   Storing signatures

検証

1. localhost リポジトリー内のイメージを一覧表示します。

   # curl http://localhost:5000/v2/_catalog
   {"repositories":["myecho2]}
   
   
   # curl http://localhost:5000/v2/myecho2/tags/list
   {"name":"myecho","tags":["latest"]}

2. docker://localhost:5000/myecho:latest イメージを調査します。

   # skopeo inspect --tls-verify=false docker://localhost:5000/myecho:latest | less
   {
       "Name": "localhost:5000/myecho",
       "Digest": "sha256:8999ff6050...",
       "RepoTags": [
           "latest"
       ],
       "Created": "2021-06-28T14:44:05.919583964Z",
       "DockerVersion": "",
       "Labels": {
           "architecture": "x86_64",
           "authoritative-source-url": "registry.redhat.io",
       ...
   }

3. localhost:5000/myecho イメージをプルします。

   # podman pull --tls-verify=false localhost:5000/myecho2
   # podman run localhost:5000/myecho2
   This container works!

手順

1. docker.io/library/myecho:latest を Docker Hub にプッシュします。username および password を、Docker Hub 認証情報に置き換えます。

   # buildah push --creds username:password \ docker.io/library/myecho:latest docker://testaccountXX/myecho:latest

手順

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

   # buildah images
   REPOSITORY                                  TAG      IMAGE ID       CREATED          SIZE
   localhost/johndoe/webserver                 latest   dc5fcc610313   46 minutes ago   263 MB
   docker.io/library/mynewecho                 latest   fa2091a7d8b6   17 hours ago     234 MB
   docker.io/library/myecho2                   latest   4547d2c3e436   6 days ago       234 MB
   localhost/myecho                            latest   b28cd00741b3   6 days ago       234 MB
   localhost/ubi-micro-httpd                   latest   c6a7678c4139   12 days ago      152 MB
   registry.access.redhat.com/ubi8/ubi         latest   272209ff0ae5   3 weeks ago      234 MB

2. localhost/myecho イメージを削除します。

   # buildah rmi localhost/myecho

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

     # buildah rmi docker.io/library/mynewecho docker.io/library/myecho2

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

     # buildah rmi -a

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

     # buildah rmi -f localhost/ubi-micro-httpd

手順

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

   # buildah containers
   CONTAINER ID  BUILDER  IMAGE ID     IMAGE NAME                       CONTAINER NAME
   05387e29ab93     *     c37e14066ac7 docker.io/library/myecho:latest  myecho-working-container

2. myecho-working-container コンテナーを削除します。

   # buildah rm myecho-working-container
   05387e29ab93151cf52e9c85c573f3e8ab64af1592b1ff9315db8a10a77d7c22

手順

1. ヘルスチェックを定義します。

   $ podman run -dt --name=hc-container -p 8080:8080 --health-cmd='curl http://localhost:8080 || exit 1' --health-interval=0 registry.access.redhat.com/ubi8/httpd-24

   • --health-cmd オプションは、コンテナーの healthcheck コマンドを設定します。
   • healthcheck を手動で実行するには、--health-interval=0 オプション で 0 の値を指定します。

2. hc-container コンテナーのヘルスステータスを確認します。

   • podman inspect コマンドの使用:

     $ podman inspect --format='{{json .State.Health.Status}}' hc-container
     healthy

   • podman ps コマンドの使用:

     $ podman ps
     CONTAINER ID  IMAGE                 COMMAND               CREATED      STATUS          PORTS       NAMES
     a680c6919fe  localhost/hc-container:latest  /usr/bin/run-http...  2 minutes ago  Up 2 minutes (healthy) hc-container

   • podman healthcheck run コマンドを使用します。

     $ podman healthcheck run hc-container
     healthy

手順

1. Containerfile を作成します。

   $ cat Containerfile
   FROM registry.access.redhat.com/ubi8/httpd-24
   EXPOSE 8080
   HEALTHCHECK CMD curl http://localhost:8080 || exit 1

   注記

   HEALTHCHECK 命令は、docker イメージ形式でのみサポートされています。oci イメージ形式の場合、命令は無視されます。

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

   $ podman build --format=docker -t hc-container .
   STEP 1/3: FROM registry.access.redhat.com/ubi8/httpd-24
   STEP 2/3: EXPOSE 8080
   --> 5aea97430fd
   STEP 3/3: HEALTHCHECK CMD curl http://localhost:8080 || exit 1
   COMMIT health-check
   Successfully tagged localhost/health-check:latest
   a680c6919fe6bf1a79219a1b3d6216550d5a8f83570c36d0dadfee1bb74b924e

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

   $ podman run -dt --name=hc-container localhost/hc-container

4. hc-container コンテナーのヘルスステータスを確認します。

   • podman inspect コマンドの使用:

     $ podman inspect --format='{{json .State.Health.Status}}' hc-container
     healthy

   • podman ps コマンドの使用:

     $ podman ps
     CONTAINER ID  IMAGE                 COMMAND               CREATED      STATUS          PORTS       NAMES
     a680c6919fe  localhost/hc-container:latest  /usr/bin/run-http...  2 minutes ago  Up 2 minutes (healthy) hc-container

   • podman healthcheck run コマンドを使用します。

     $ podman healthcheck run hc-container
     healthy

手順

1. Python ベースのサーバーを作成します。

   # cat counter.py
   #!/usr/bin/python3
   
   import http.server
   
   counter = 0
   
   class handler(http.server.BaseHTTPRequestHandler):
       def do_GET(s):
           global counter
              s.send_response(200)
              s.send_header('Content-type', 'text/html')
              s.end_headers()
              s.wfile.write(b'%d\n' % counter)
              counter += 1
   
   
   server = http.server.HTTPServer(('', 8088), handler)
   server.serve_forever()

2. 以下の定義でコンテナーを作成します。

   # cat Containerfile
   FROM registry.access.redhat.com/ubi8/ubi
   
   COPY counter.py /home/counter.py
   
   RUN useradd -ms /bin/bash counter
   
   RUN yum -y install python3 && chmod 755 /home/counter.py
   
   USER counter
   ENTRYPOINT /home/counter.py

   コンテナーは Universal Base Image (UBI 8) をベースとしており、Python ベースのサーバーを使用します。

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

   # podman build . --tag counter

   counter.py ファイルおよび Containerfile ファイルは、コンテナービルドプロセス (podman build) の入力情報です。ビルドされたイメージはローカルに保存され、counter でタグ付けされます。

4. root でコンテナーを起動します。

   # podman run --name criu-test --detach counter

5. 実行中のコンテナーの一覧を表示するには、次のコマンドを実行します。

   # podman ps
   CONTAINER ID  IMAGE  COMMAND  CREATED   STATUS  PORTS NAMES
   e4f82fd84d48  localhost/counter:latest  5 seconds ago  Up 4 seconds ago  criu-test

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

   # podman inspect criu-test --format "{{.NetworkSettings.IPAddress}}"
   10.88.0.247

7. 要求をコンテナーに送信します。

   # curl 10.88.0.247:8080
   0
   # curl 10.88.0.247:8080
   1

8. コンテナーのチェックポイントを作成します。

   # podman container checkpoint criu-test

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

10. コンテナーを復元します。

    # podman container restore --keep criu-test

11. 要求をコンテナーに送信します。

    # curl 10.88.0.247:8080
    2
    # curl 10.88.0.247:8080
    3
    # curl 10.88.0.247:8080
    4

    結果は 0 で開始あれるのではなく、以前の値で継続されます。

手順

1. コンテナーのチェックポイントを作成し、チェックポイントイメージを tar.gz ファイルにエクスポートします。

   # podman container checkpoint criu-test --export /tmp/chkpt.tar.gz

2. tar.gz ファイルからコンテナーを復元します。

   # podman container restore --import /tmp/chkpt.tar.gz --name counter1
   # podman container restore --import /tmp/chkpt.tar.gz --name counter2
   # podman container restore --import /tmp/chkpt.tar.gz --name counter3

   --name (-n) オプションは、エクスポートしたチェックポイントを基に復元したコンテナーに新しい名前を指定します。

3. 各コンテナーの ID と名前を表示します。

   # podman ps -a --format "{{.ID}} {{.Names}}"
   a8b2e50d463c counter3
   faabc5c27362 counter2
   2ce648af11e5 counter1

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

   #️ podman inspect counter1 --format "{{.NetworkSettings.IPAddress}}"
   10.88.0.248
   
   #️ podman inspect counter2 --format "{{.NetworkSettings.IPAddress}}"
   10.88.0.249
   
   #️ podman inspect counter3 --format "{{.NetworkSettings.IPAddress}}"
   10.88.0.250

5. 各コンテナーに要求を送信します。

   #️ curl 10.88.0.248:8080
   4
   #️ curl 10.88.0.249:8080
   4
   #️ curl 10.88.0.250:8080
   4

   同じチェックポイントから異なるコンテナーを使用して復元しているので、結果は、どの場合も 4 になる点に注意してください。

手順

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

   # podman run --name criu-test --detach counter

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

   # podman inspect criu-test --format "{{.NetworkSettings.IPAddress}}"
   10.88.0.247

3. 要求をコンテナーに送信します。

   # curl 10.88.0.247:8080
   0
   # curl 10.88.0.247:8080
   1

4. コンテナーのチェックポイントを作成し、チェックポイントイメージを tar.gz ファイルにエクスポートします。

   # podman container checkpoint criu-test --export /tmp/chkpt.tar.gz

5. チェックポイントアーカイブを移行先ホストにコピーします。

   # scp /tmp/chkpt.tar.gz other_host:/tmp/

6. 移行先ホスト (other_host) のチェックポイントを復元します。

   # podman container restore --import /tmp/chkpt.tar.gz

7. 宛先ホスト (other_host) のコンテナーに要求を送信します。

   # *curl 10.88.0.247:8080*
   2

手順

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

   # yum install openmpi

2. 環境モジュールをアクティベートするには、以下を入力します。

   $ . /etc/profile.d/modules.sh

3. mpi/openmpi-x86_64 モジュールを読み込みます。

   $ module load mpi/openmpi-x86_64

   必要に応じて、mpi/openmpi-x86_64 モジュールを自動的に読み込むには、以下の行を .bashrc ファイルに追加します。

   $ echo "module load mpi/openmpi-x86_64" >> .bashrc

4. mpirun と podman を統合するには、以下の定義でコンテナーを作成します。

   $ cat Containerfile
   FROM registry.access.redhat.com/ubi8/ubi
   
   RUN yum -y install openmpi-devel wget && \
       yum clean all
   
   RUN wget https://raw.githubusercontent.com/open-mpi/ompi/master/test/simple/ring.c && \
       /usr/lib64/openmpi/bin/mpicc ring.c -o /home/ring && \
       rm -f ring.c

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

   $ podman build --tag=mpi-ring .

6. コンテナーを起動します。このコマンドは、CPU が 4 つあるシステムではコンテナーを 4 つ起動します。

   $ mpirun \ --mca orte_tmpdir_base /tmp/podman-mpirun \ podman run --env-host \ -v /tmp/podman-mpirun:/tmp/podman-mpirun \ --userns=keep-id \ --net=host --pid=host --ipc=host \ mpi-ring /home/ring
   Rank 2 has cleared MPI_Init
   Rank 2 has completed ring
   Rank 2 has completed MPI_Barrier
   Rank 3 has cleared MPI_Init
   Rank 3 has completed ring
   Rank 3 has completed MPI_Barrier
   Rank 1 has cleared MPI_Init
   Rank 1 has completed ring
   Rank 1 has completed MPI_Barrier
   Rank 0 has cleared MPI_Init
   Rank 0 has completed ring
   Rank 0 has completed MPI_Barrier

   これにより、mpirun は 4 つの Podman コンテナーを開始し、コンテナーごとに ring バイナリーのインスタンスを 1 台実行します。4 つプロセスはすべて、MPI 経由で相互に通信しています。

手順

1. rsyslog イメージをプルします。

   # podman pull registry.redhat.io/rhel8/rsyslog

2. rsyslog の install runlabel を表示します。

   # podman container runlabel install --display rhel8/rsyslog
   command: podman run --rm --privileged -v /:/host -e HOST=/host -e IMAGE=registry.redhat.io/rhel8/rsyslog:latest -e NAME=rsyslog registry.redhat.io/rhel8/rsyslog:latest /bin/install.sh

   これは、コマンドがホストに特権を開き、コンテナー内の /host にホストの root ファイルシステムをマウントし、install.sh スクリプトを実行します。

3. rsyslog の install runlabel を実行します。

   # podman container runlabel install rhel8/rsyslog
   command: podman run --rm --privileged -v /:/host -e HOST=/host -e IMAGE=registry.redhat.io/rhel8/rsyslog:latest -e NAME=rsyslog registry.redhat.io/rhel8/rsyslog:latest /bin/install.sh
   Creating directory at /host//etc/pki/rsyslog
   Creating directory at /host//etc/rsyslog.d
   Installing file at /host//etc/rsyslog.conf
   Installing file at /host//etc/sysconfig/rsyslog
   Installing file at /host//etc/logrotate.d/syslog

   これにより、rsyslog イメージが後で使用するホストシステムにファイルが作成されます。

4. rsyslog の run runlabel を表示します。

   # podman container runlabel run --display rhel8/rsyslog
   command: podman run -d --privileged --name rsyslog --net=host --pid=host -v /etc/pki/rsyslog:/etc/pki/rsyslog -v /etc/rsyslog.conf:/etc/rsyslog.conf -v /etc/sysconfig/rsyslog:/etc/sysconfig/rsyslog -v /etc/rsyslog.d:/etc/rsyslog.d -v /var/log:/var/log -v /var/lib/rsyslog:/var/lib/rsyslog -v /run:/run -v /etc/machine-id:/etc/machine-id -v /etc/localtime:/etc/localtime -e IMAGE=registry.redhat.io/rhel8/rsyslog:latest -e NAME=rsyslog --restart=always registry.redhat.io/rhel8/rsyslog:latest /bin/rsyslog.sh

   これは、コマンドがホストへの特権を開き、rsyslog コンテナーを起動して rsyslogd デーモンを実行するときに、コンテナー内のホストから多数のファイルとディレクトリーをマウントすることを示しています。

5. rsyslog の run runlabel を実行します。

   # podman container runlabel run rhel8/rsyslog
   command: podman run -d --privileged --name rsyslog --net=host --pid=host -v /etc/pki/rsyslog:/etc/pki/rsyslog -v /etc/rsyslog.conf:/etc/rsyslog.conf -v /etc/sysconfig/rsyslog:/etc/sysconfig/rsyslog -v /etc/rsyslog.d:/etc/rsyslog.d -v /var/log:/var/log -v /var/lib/rsyslog:/var/lib/rsyslog -v /run:/run -v /etc/machine-id:/etc/machine-id -v /etc/localtime:/etc/localtime -e IMAGE=registry.redhat.io/rhel8/rsyslog:latest -e NAME=rsyslog --restart=always registry.redhat.io/rhel8/rsyslog:latest /bin/rsyslog.sh
   28a0d719ff179adcea81eb63cc90fcd09f1755d5edb121399068a4ea59bd0f53

   rsyslog コンテナーは権限を開き、ホストから必要なものをマウントし、バックグラウンドで rsyslogd デーモンを実行します (-d)。rsyslogd デーモンは、ログメッセージを収集し、メッセージを /var/log ディレクトリー内のファイルに送信します。

6. rsyslog の uninstall runlabel を表示します。

   # podman container runlabel uninstall --display rhel8/rsyslog
   command: podman run --rm --privileged -v /:/host -e HOST=/host -e IMAGE=registry.redhat.io/rhel8/rsyslog:latest -e NAME=rsyslog registry.redhat.io/rhel8/rsyslog:latest /bin/uninstall.sh

7. rsyslog の uninstall runlabel を実行します。

   # podman container runlabel uninstall rhel8/rsyslog
   command: podman run --rm --privileged -v /:/host -e HOST=/host -e IMAGE=registry.redhat.io/rhel8/rsyslog:latest -e NAME=rsyslog registry.redhat.io/rhel8/rsyslog:latest /bin/uninstall.sh

1. systemd を使用して Podman API ソケットをアクティベートします。
2. Podman クライアントを使用して基本的なコマンドを実行します。

手順

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

   # systemctl enable --now podman.socket

2. docker-podman パッケージを使用して var/lib/docker.sock へのリンクを有効にするには以下を実行します。

   # yum install podman-docker

検証手順

1. Podman のシステム情報を表示します。

   # podman-remote info

2. リンクを確認します。

   # ls -al /var/run/docker.sock
   lrwxrwxrwx. 1 root root 23 Nov  4 10:19 /var/run/docker.sock -> /run/podman/podman.sock