インストール - Podmanのソースを表示

== 概要 ==
コンテナとは、ソフトウェアプロセスやマイクロサービスをパッケージ化して、あらゆるコンピューティング環境で実行可能にするソフトウェアソリューションである。<br>
<br>
コンテナに含まれるファイルには、アプリケーションコード、環境変数、設定コード、バイナリプログラム、ソフトウェアの依存関係、ライブラリ等がある。<br>
これらのコンポーネントをバンドルするプロセスはコンテナ化と呼ばれ、最終的な製品はコンテナイメージとして知られている。<br>
<br>
このイメージは、クラウド、オンプレミスのデータシステム、ローカルシステム等、あらゆるプラットフォームにデプロイされる。<br>
<br>
Podman (Pod Manage) は、Open Container Initiatives （OCI） のコンテナイメージを開発、管理、本番環境で実行する時に使用するコンテナエンジンである。<br>
OCIは、コンテナフォーマットとランタイムに関するOSレベルの仮想化ソフトウェアコンテナのオープンなガバナンス構造を実装するために設計された。<br>
<br>
Podmanコンテナは、スーパユーザ / 非スーパーユーザのいずれでも実行可能である。<br>
<br><br>

== Podmanのソケットアクティベーション ==
ソケットアクティベーションは、systemdがソケット （TCP、UDP、Unixソケット等） を作成することで機能する。<br>
<br>
クライアントがソケットに接続する時、systemdはソケット用に設定されたsystemdサービスを起動する。<br>
新しく起動されたプログラムは、ソケットのファイルディスクリプタを継承して、着信した接続を受け付けることができる。 （システムコールの<code>accept()</code>を実行する）<br>
<br>
これにより、デフォルトのsystemdソケット設定である<code>Accept=no</code>に対応し、サービスがソケットを受け付けるようになる。<br>
<br>
Podmanは、2種類のソケットアクティベーションをサポートしている。<br>
* APIサービスのソケットアクティベーション
* コンテナのソケット起動
<br><br>

== Podmanのインストール ==
==== パッケージ管理システムからインストール ====
 # RHEL
 sudo yum install epel-release
 sudo dnf install podman
 
 # SUSE
 sudo zypper install podman
<br>

==== スタティックビルド済みのPodmanの使用 ====
===== Podmanのダウンロード =====
<u>※注意</u><br>
<u>スタティックビルド済みのPodmanを使用する場合は、Podman Desktopが使用できないことに注意する。</u><br>
<br>
[https://github.com/containers/podman/ PodmanのGithub]にアクセスして、スタティックビルド済みのPodmanをダウンロードする。<br>
ダウンロードしたファイルを解凍する。<br>
 tar xf podman-remote-static-linux_<アーキテクチャ名>.tar.gz
 cd bin
 mv podman-remote-static-linux_<アーキテクチャ名> podman
<br>
必要ならば、Podmanを任意のインストールディレクトリに配置する。<br>
 mkdir -p <任意のインストールディレクトリ>
 mv podman <任意のインストールディレクトリ>
<br>
~/.profileファイル等に、環境変数<code>PATH</code>およびソケットの設定を記述する。<br>
 vi ~/.profile
<br>
 <syntaxhighlight lang="sh">
 # ~/.profileファイル
 
 export PATH="<Podmanのインストールディレクトリ>:$PATH"
 
 export DOCKER_HOST=unix:///run/user/$UID/podman/podman.sock
 </syntaxhighlight>
<br>
===== gvproxyのダウンロード =====
SUSEにおいて、パッケージ管理システムにgvproxyパッケージが存在しないため、手動でgvproxyをインストールする必要がある。<br>
<br>
まず、[https://github.com/containers/gvisor-tap-vsock/ gvproxyのGithub]にアクセスして、gvproxyをダウンロードする。<br>
ダウンロードしたgvproxyのファイル名を変更して、/usr/libexec/podmanディレクトリまたは/usr/local/libexec/podmanディレクトリにコピーする。<br>
 mv gvproxy-linux-<アーキテクチャ名> gvproxy
 sudo mkdir -p /usr/libexec/podman  または  sudo mkdir -p /usr/local/libexec/podman
 sudo mv gvproxy /usr/local/libexec/podman
<br>

==== ソースコードからインストール ====
===== Goのバージョンが1.16未満の場合 =====
もし、パッケージ管理システムのGoのバージョンが1.16未満の場合は、[https://golang.org/dl/ Goの公式Webサイト]にアクセスして、Goをダウンロードする。<br>
ダウンロードしたファイルを解凍する。</u><br>
 tar xf go<バージョン>.linux-<アーキテクチャ名>.tar.gz
 mv go<バージョン>.linux-<アーキテクチャ名> Go
<br>
必要ならば、Goを任意のインストールディクトリに配置する。<br>
 mv Go <任意のインストールディレクトリ>
<br>
~/.profileファイル等に、環境変数<code>PATH</code>を追記する。<br>
 <syntaxhighlight lang="sh">
 export GOPATH=<Goのインストールディレクトリ>
 export PATH=/<Goのインストールディレクトリ>/bin:$PATH
 </syntaxhighlight>
<br>

===== 最新のconmonが必要な場合 =====
最新バージョンのconmonがシステムにインストールされていることが期待される。<br>
conmonは、OCIランタイムをモニタリングするために使用される。<br>
<br>
conmonのビルドに必要なライブラリをインストールする。<br>
 # SUSE
 sudo zypper install meson ninja glib2-devel libseccomp-devel
<br>
[https://github.com/containers/conmon conmonのGithub]にアクセスして、ソースコードをダウンロードする。<br>
ダウンロードしたファイルを解凍する。<br>
 tar xf conmon-<バージョン>.tar.gz
 cd conmon-<バージョン>
<br>
または、<code>git clone</code>コマンドを実行して、ソースコードをダウンロードする。<br>
 git clone https://github.com/containers/conmon
 cd conmon
<br>
conmonをビルドおよびインストールする。<br>
 meson --prefix=<Podmanのインストールディレクトリ> ./build
 ninja -C ./build
 ninja -C ./build install
<br>
conmonファイルは/<Podmanのインストールディレクトリ>/liexec/podmanディレクトリにインストールされるため、binディレクトリへのシンボリックリンクを作成する。<br>
 ln -s /<Podmanのインストールディレクトリ>/liexec/podman/conmon /<Podmanのインストールディレクトリ>/bin/conmon
<br>

===== 最新のcrun /runcが必要な場合 =====
最新バージョンのcrun /runcがシステムにインストールされていることが期待される。<br>
crun /runcは、Podmanによりその1つがデフォルトのランタイムとしてピックアップされる。（crunはruncよりも優先される）<br>
<br>
[https://github.com/opencontainers/runc/ crun /runcのGithub]にアクセスして、ソースコードをダウンロードする。<br>
ダウンロードしたファイルを解凍する。<br>
 tar xf runc-<バージョン>.tar.gz
 cd runc-<バージョン>
<br>
または、<code>git clone</code>コマンドを実行して、ソースコードをダウンロードする。<br>
 git clone https://github.com/opencontainers/runc.git
 cd runc
<br>
crun /runcをビルドおよびインストールする。<br>
 # SELinux, SECcompを有効にする場合
 make BUILDTAGS="selinux seccomp" PREFIX=<Podmanのインストールディレクトリ> -j $(nproc) 
 
 # SELinux, SECcompを無効にする場合
 make BUILDTAGS="" PREFIX=<Podmanのインストールディレクトリ> -j $(nproc) 
 
 make PREFIX=<Podmanのインストールディレクトリ> install
<br>
===== CNIネットワークの設定 =====
<u>※注意</u><br>
<u>CNIバックエンドは非推奨であり、Podman 5.0以降ではNetavarkが優先されるため、CNIネットワークは削除される予定である。</u><br>
<br>
CNIネットワーキングの基本的な設定は、Podmanのビルド時で行われており、Podmanを使用するために他の設定は必要ない。<br>
<br>
追加の設定を行う場合は、CNIネットワークの設定ファイルをダウンロードして、/etc/containersディレクトリに配置する。<br>
 sudo mkdir -p /etc/containers
 
 sudo curl -L -o /etc/containers/registries.conf https://src.fedoraproject.org/rpms/containers-common/raw/main/f/registries.conf
 sudo curl -L -o /etc/containers/policy.json https://src.fedoraproject.org/rpms/containers-common/raw/main/f/default-policy.json
<br>
CNIネットワークの設定の詳細は、[https://github.com/containers/podman/blob/main/cni/README.md PodmanのGithub]に記載されている。<br>
<br>

===== ユーザネームスペースの有効化 =====
Linuxカーネルがユーザネームスペースをサポートしているかどうかを確認する。<br>
 zgrep CONFIG_USER_NS /proc/config.gz
 
 # 出力例: ユーザネームスペースをサポートしている場合
 CONFIG_USER_NS=y
<br>
もし、ユーザネームスペースが無効の場合は有効にする。<br>
 # ユーザネームスペースを一時的に有効にする
 sudo sysctl kernel.unprivileged_userns_clone=1
 
 # ユーザネームスペースを恒久的に有効にする
 echo 'kernel.unprivileged_userns_clone=1' > /etc/sysctl.d/userns.conf
<br>
===== Podmanのビルド =====
Podmanのビルドに必要なライブラリをインストールする。<br>
 # RHEL
 sudo dnf install 'dnf-command(builddep)'
 sudo dnf builddep rpm/podman.spec --enablerepo=codeready-builder-for-rhel-$(rpm --eval %{?rhel})-$(uname -m)-rpms
 
 sudo dnf install conmon containers-common crun iptables netavark nftables slirp4netns
 
 # SUSE
 sudo zypper install pkg-config libseccomp-devel libgpgme-devel libbtrfs-devel device-mapper-devel systemd-devel libapparmor-devel protobuf-devel
 
 # Raspberry Pi / Mobian
 sudo apt install btrfs-progs git uidmap pkg-config crun golang-go go-md2man iptables libassuan-dev libbtrfs-dev libc6-dev libdevmapper-dev libglib2.0-dev \
                  libgpgme-dev libgpg-error-dev libprotobuf-dev libprotobuf-c-dev libseccomp-dev libselinux1-dev libsystemd-dev libapparmor-dev \
                  netavark  # 古いバージョンのRaspbian OSの場合、netavarkパッケージが利用できない場合がある
                            # その場合、containernetworking-pluginsパッケージをインストールする
<br>
[https://github.com/containers/podman/ PodmanのGithub]にアクセスして、ソースコードをダウンロードする。<br>
ダウンロードしたファイルを解凍する。<br>
 tar xf podman-<バージョン>.tar.gz
 cd podman-<バージョン>
<br>
または、<code>git clone</code>コマンドを実行して、Podmanのソースコードをダウンロードすることもできる。<br>
 git clone git clone https://github.com/containers/podman/
 cd podman
<br>
Podmanをビルドおよびインストールする。<br>
 # SELinux, SECcomp (syscall filtering) を有効にする場合
 make BUILDTAGS="selinux seccomp" PREFIX=<Podmanのインストールディレクトリ> -j $(nproc)
 
 # AppArmor, SECcomp (syscall filtering) を有効にする場合
 make BUILDTAGS="apparmor seccomp" PREFIX=<Podmanのインストールディレクトリ> -j $(nproc)
 
 # SELinux, SECcomp (syscall filtering) を無効にする場合
 make BUILDTAGS="" PREFIX=<Podmanのインストールディレクトリ> -j $(nproc)
 
 make install PREFIX=<Podmanのインストールディレクトリ>
<br>
~/.profileファイル等に、環境変数<code>PATH</code>およびソケットの設定を記述する。<br>
 vi ~/.profile
<br>
 <syntaxhighlight lang="sh">
 # ~/.profileファイル
 
 export PATH="<Podmanのインストールディレクトリ>:$PATH"
 
 export DOCKER_HOST=unix:///run/user/$UID/podman/podman.sock
 </syntaxhighlight>
<br>
SUSEにおいて、パッケージ管理システムにgvproxyパッケージが存在しないため、手動でgvproxyをインストールする必要がある。<br>
<br>
まず、[https://github.com/containers/gvisor-tap-vsock/ gvproxyのGithub]にアクセスして、gvproxyをダウンロードする。<br>
ダウンロードしたgvproxyのファイル名を変更して、/usr/libexec/podmanディレクトリまたは/usr/local/libexec/podmanディレクトリにコピーする。<br>
 mv gvproxy-linux-<アーキテクチャ名> gvproxy
 chmod u+x gvproxy
 
 sudo mkdir -p /usr/libexec/podman  または  sudo mkdir -p /usr/local/libexec/podman
 sudo mv gvproxy /usr/libexec/podman  または  sudo mv gvproxy /usr/local/libexec/podman
<br><br>

== Podmanの設定 ==
==== Dockerから移行する場合 ====
DockerからPodman Desktopに透過的に移行するため、環境変数<code>DOCKER_HOST</code>を使用することができる。<br>
* 使い慣れたDockerコマンドを使い続けることが可能である。
* Podmanの利点を活用できる。
* GradleやTestcontainers等のツールは、再設定なしでPodmanと通信することができる。
<br>
Podmanソケットファイルの場所を確認する。<br>
 podman info --format <nowiki>'{{.Host.RemoteSocket.Path}}'</nowiki>
<br>
Podmanソケットの場所を設定するため、~/.profileファイル等に環境変数<code>DOCKER_HOST</code>に記述する。<br>
 vi ~/.profile
<br>
 <syntaxhighlight lang="sh">
 # ~/.profileファイル
 
 export DOCKER_HOST="unix://<Podmanソケットファイルのパス>"
 </syntaxhighlight>
<br>

==== Linux仮想マシンの初期化 ====
コンテナが実行される新しいLinux仮想マシンを初期化する。<br>
VMにアクセスするためのSSHキーが自動的に生成されて、VM内のスーパーユーザアカウントとユーザアカウントへのシステム接続が追加される。<br>
 podman machine init
<br>
デフォルトでは、VMのディストリビューションはカスタムFedoraイメージに基づくWSLを除き、Fedora CoreOSである。<br>
一般的なFedora CoreOSのアップグレードは14日ごとに行われるが、自動アップデートのZincataはPodmanマシンでは無効になっている。<br>
<br>
Linux仮想マシンを開始する。<br>
 podman machine start
<br>

==== Podmanマシンの接続の設定 ====
各Podmanマシンは2つのデフォルト接続を公開する。<br>
Podmanのデフォルト接続は1つのみ選択することができる。<br>
* ルートレス
* ルートフル
<br>
Podman DesktopやKind等の他のツールはデフォルト接続に接続する。<br>
もし、別のPodmanマシンの作成等により、デフォルトのPodmanマシン接続が変更された可能性があるイベントが発生した場合、デフォルト接続の確認と設定を検討すること。<br>
<br>
まず、Podmanマシンの接続を確認する。<br>
 podman system connection ls
<br>
次に、Podmanマシンのデフォルト接続を任意の接続に設定する。<br>
 podman system connection default podman-machine-default
 # または
 podman system connection default podman-machine-default-root
<br>
Podmanマシンのデフォルト接続が変更されているかどうかを確認する。<br>
 podman system connection ls
<br>
デフォルト接続を持つPodmanマシンを再起動する。<br>
 podman machine stop
 podman machine start
<br>
Podman DesktopとPodmanの接続を更新する。<br>
<br>
Podman Desktopのメイン画面右下にある[電球]アイコンを選択して[トラブルシューティング]ページを開き、[プロバイダーを再接続]ボタンを押下する。<br>
<br><br>

== Podmanの動作確認 ==
Podmanの動作を確認するため、テストイメージをダウンロードして実行する。<br>
  podman run hello-world
<br><br>

== Podmanコマンド ==
==== ログイン ====
 podman loguin -u <ユーザ名> -v <登録するURL>
 
 # 例: Docker Hubにログインする場合
 podman login -u <Docker Hubのユーザ名> -v https://docker.io
 podman login -u <Docker Hubのユーザ名> -v https://index.docker.io/v2/
<br>
認証情報は、/run/user/$UID/containers/auth.jsonファイルに保存される。<br>
<br>
Docker Hubにログインすることにより、Podmanコマンドで[https://hub.docker.com Docker Hub]からイメージを検索およびダウンロードすることができる。<br>
<br>
==== Podmanイメージの検索 ====
[https://quay.io/search Quay] (デフォルト) および他のWebサイト (登録している場合) からイメージを検索およびダウンロードする。<br>
 podman search <イメージ名>
<br>

==== Podmanイメージのダウンロード ====
 podman pull <イメージ名>
 
 # 例: Ubuntuの公式イメージをダウンロード
 podman pull ubuntu
 
 # 例: Docker HubからApache2のイメージをダウンロード
 podman pull docker.io/httpd:latest
<br>
==== ダウンロードしたPodmanイメージの一覧の表示 ====
 podman images
<br>
==== Podmanイメージの削除 ====
 podman image rm <イメージID>
<br>
Podmanイメージを全て削除する。<br>
 podman image rm -f $(podman images -q)
<br>
==== Podmanコンテナの削除 ====
 podman container rm <コンテナID>
<br>
Podmanコンテナを全て削除する。<br>
 podman container rm -f $(podman container ps -a -q)
<br>

==== コンテナの起動 ====
 podman run --name <コンテナ名> -d <イメージ名>
 
 # 例: イメージ名はubuntu、コンテナ名はubuntu01として起動
 podman run --name ubuntu01 -itd ubuntu /bin/bash
 
 # 例: イメージ名はhttpd、コンテナ名はwwwとして起動
 #     また、コンテナ内の80番ポートをホスト側の8080番にポートフォワーディングしている
 podman run --name www -p 8080:80 -d httpd
<br>
==== コンテナのプロセス確認 ====
 # 動作中のコンテナのみ表示
 podman ps
 
 # 全てのコンテナを表示
 podman ps -a  または podman ps --all
<br>
==== コンテナの停止 ====
コンテナが停止している時は、STATUSでExitedとなる。<br>
 podman stop <コンテナ名>  または  podman stop <コンテナID>
<br>
==== コマンドの実行 ====
起動中のコンテナにコマンドを実行する。<br>
 podman exec -it <コンテナ名> /bin/bash
<br>

==== コンテナとホスト間のファイルコピー ====
ホストからコンテナにファイルをコピーする。<br>
 podman cp <ホストのファイルパス> <コンテナ名:コンテナ内の保存先>
 # または
 podman cp <ホストのファイルパス> <コンテナID:コンテナ内の保存先>
 
 # 例:
 podman cp sample.txt my_suse:/tmp  # コンテナを実行
 podman exec -it my_suse /bin/bash  # cd /tmp && lsコマンドを実行してファイルを確認
<br>
コンテナからホストにファイルをコピーする。<br>
 podman cp <コンテナ名:コンテナ内のファイルパス> <ホストの保存先>
 # または
 podman cp <コンテナID:コンテナ内のファイルパス> <ホストの保存先>
 
 # 例:
 podman cp my_suse:/tmp/sample.txt ~/Downloads
<br>

==== ボリュームのマウント ====
コンテナにボリュームをマウントする。<br>
<br>
<code>-v</code>オプションの代わりに<code>--mount</code>オプションを付加することが推奨されている。<br>
<code>--mount</code>オプションは、キーバリュー形式で各要素が指定できる。<br>
 podman container run -it --mount type=<volume, bind, tmpfsのいずれかを指定>,src=<ボリューム名>,dst=<コンテナ内のパス> <コンテナ名/イメージ名:タグ名>
<br>
<code>--rm</code>オプションを付加することにより、匿名ボリュームの場合はコンテナ停止と同時にボリュームも破棄される。<br>
名前付きボリュームの場合は、<code>--rm</code>オプションを付加しても、ボリュームは破棄されない。<br>
<br>
<center>
{| class="wikitable" | style="background-color:#fefefe;"
|+ mountオプションについて
|-
! style="background-color:#66CCFF;" | mountオプションで指定できる種類
! style="background-color:#66CCFF;" | 説明
|-
| style="text-align: center;" | type || <code>volume</code>、<code>bind</code>、<code>tmpfs</code>を指定する。
|-
| style="text-align: center;" | src || <code>source</code>と記述することもできる。<br><br>匿名ボリュームの場合は、省略する。<br>名前付きボリュームの場合は、その名前を記述する。<br>バインドマウントの場合は、ホスト側のディレクトリを指定する。
|-
| style="text-align: center;" | dst || <code>destination</code>、<code>target</code>と記述することもできる。<br><br>コンテナ側のディレクトリを指定する。
|}
</center>
<br>
* 匿名ボリューム
*: ホスト側に/var/lib/podman/volumesディレクトリ内に領域が確保されて、指定したコンテナ内のディレクトリと共有される。
*: 識別のためにハッシュ値が振られており、同一のネットワークからそのハッシュ値でアクセスすることができる。
*: <code>podman container run --mount type=volume,dst=<コンテナ内のディレクトリパス  例: /tmp/sample> <コンテナ名/イメージ名:タグ名></code>
*: <br>
* 名前付きボリューム
*: 匿名ボリュームと同様、ホスト側には/var/lib/podman/volumesディレクトリ内に領域が確保されて、指定したコンテナ内のディレクトリと共有される。
*: ホスト名を指定するため、同一のネットワークからそのホスト名でアクセスすることができる。
*: <code>podman container run --mount type=volume,src=<ボリューム名>,dst=<ホスト名>:<コンテナ内のディレクトリパス  例: /tmp/sample> <コンテナ名/イメージ名:タグ名></code>
*: <br>
* バインドマウント
*: <u>ホスト側のカレントディレクトリ内</u>にある指定したディレクトリとコンテナ側の指定したディレクトリが共有される。
*: <code>podman container run --mount type=bind,src=<ホスト側のディレクトリパス  例: $PWD/host-sample>,dst=<コンテナ内のディレクトリパス  例: /tmp/container-sample> <コンテナ名/イメージ名:タグ名></code>
<br>

==== ボリュームのアンマウント ====
 podman volume umount <ボリューム名>
<br>
特定のコンテナにマウントされているボリュームをアンマウントする。<br>
 podman volume umount <コンテナID>
<br>

==== ボリュームの削除 ====
 podman volume rm <ボリューム名>
<br>
使用されていないボリュームを削除する。<br>
 podman volume prune
<br>
ボリュームを全て削除する。<br>
 podman volume rm $(podman volume ls -q)
<br>

==== コンテナのバックアップ ====
コンテナをイメージ化してバックアップする。<br>
<br>
# コンテナを新しいメージとして作成する。
#: <code>podman commit <コンテナID> <任意のイメージ名></code>
# 作成したイメージをファイルとして保存する。
#: <code>podman save <上記で入力した任意のイメージ名> > <バックアップするファイル名>.tar</code>
<br>

==== バックアップしたコンテナの復元 ====
 podman load -i <バックアップしたファイル名>.tar
<br>
正常に復元されているかどうかを確認する。<br>
 podman images
<br><br>

== Podmanのストレージ ==
コンテナ内で発生したデータは同じコンテナ内のどこかに書き込まれるが、コンテナを破棄すると同時に削除される。<br>
コンテナを破棄してもデータは保存する場合、または、他のコンテナで再利用する場合は、コンテナ外にデータ保存領域を作成する機能を提供している。<br>
<br>
* ボリューム
*: Podmanの管理下でストレージ領域を確保する。
*: ルートレスモードのデフォルトでは、~/.local/share/containersディレクトリである。
*: <br>
*: 名前付きボリュームと匿名ボリュームがあり、名前付きの場合はホスト内で名前解決できるため簡単にアクセスすることができる。
*: 匿名ボリュームは任意のハッシュ値が振られる。
*: <br>
*: 他のプロセスからはアクセスできないため安全に使用できる。
*: <br>
* バインドマウント
*: ホスト側のディレクトリをコンテナ内のディレクトリと共有する。
*: <br>
* tmpfs
*: メモリ上に一時的なストレージ領域を確保する。
*: 使用用途としては、機密性の高い情報を一時的にマウントする場合等がある。
<br>
<code>-v</code>オプション、<code>VOLUME</code>、<code>volumes</code>で指定する場合に関しても、基本的には上記のいずれかを扱っている。<br>
<br><br>

== Podman Compose ==
==== Podman Composeについて ====
<code>podman compose</code>コマンドは、docker-composeやpodman-composeのような外部のComposeプロバイダの薄いラッパーである。<br>
つまり、<code>podman compose</code>はConpose機能を実装する別のツールを実行するが、Composeプロバイダがローカルの Podmanソケットと透過的に通信できるように環境を設定する。<br>
<br>
指定したオプション、コマンド、引数は直接composeプロバイダに渡される。<br>
デフォルトのComposeプロバイダは、docker-composeとpodman-composeである。<br>
<br>
<u>両方ともインストールされている場合は、docker-composeが優先される。</u><br>
なぜなら、docker-composeはCompose仕様のオリジナルの実装であり、サポートされているプラットフォーム (Linux、MacOS、Windows) で広く使用されているからである。<br>
<br>
デフォルトの挙動を変更する場合や、選択したプロバイダのカスタムインストールパスが必要な場合は、containers.confファイルの<code>compose_provider</code>フィールドを変更する必要がある。<br>
また、環境変数<code>PODMAN_COMPOSE_PROVIDER</code>を設定して変更することもできる。<br>
<br>
==== Podman Composeのインストール ====
===== パッケージ管理システムからインストール =====
 # RHEL
 sudo dnf install podman-compose
 
 # SUSE
 sudo zypper install python3-podman-compose
<br>
===== PyPIからインストール =====
 # Python3のルートディレクトリにインストールする場合
 pip3 install podman-compose python-dotenv PyYAML
 
 # Python3のユーザディレクトリにインストールする場合
 pip3 install --user podman-compose python-dotenv PyYAML
 
 # GithubからPodman Composeを直接インストールする場合
 pip3 install https://github.com/containers/podman-compose/archive/devel.tar.gz
 pip3 install python-dotenv PyYAML
<br>
===== ソースコードからインストール =====
まず、PyYAMLおよびPython-DotEnvをインストールする。<br>
パッケージ管理システムからPyYAMLおよびPython-DotEnvをインストールする場合、依存関係が多すぎるため、PyPIからインストールすることを推奨する。<br>
 pip3 install --user python-dotenv PyYAML
<br>
Podman ComposeのGithubから、ソースコードをダウンロードする。<br>
 git clone https://github.com/containers/podman-compose.git -b stable
<br>
Podman Composeをビルドおよびインストールする。<br>
 export PYTHONPATH="/<Podmanのインストールディレクトリ>/lib/python<Pythonのバージョン>/site-packages:$PYTHONPATH"
 
 python3 ./setup.py build
 python3 ./setup.py install --prefix=<Podmanのインストールディレクトリ>
<br>
~/.profileファイル等に、環境変数<code>PYTHONPATH</code>を設定する。<br>
 <syntaxhighlight lang="sh">
 export PYTHONPATH="/<Podmanのインストールディレクトリ>/lib/python<Pythonのバージョン>/site-packages:$PYTHONPATH"
 </syntaxhighlight>
<br><br>

== Podman Desktop ==
==== Podman Desktopのインストール ====
[https://podman-desktop.io Podman Desktopの公式Webサイト]、または、[https://github.com/containers/podman-desktop/ Github]にアクセスして、Podman Desktopをダウンロードする。<br>
ダウンロードしたファイルを解凍する。<br>
 tar xf podman-desktop-<バージョン>.tar.gz
 mv podman-desktop-<バージョン> Podman-Desktop
<br>
必要ならば、任意のインストールディレクトリに配置する。<br>
 mv Podman-Desktop <任意のインストールディレクトリ>
<br>
Podman Desktopのデスクトップエントリファイルを作成する。<br>
 vi ~/.local/share/applications/Podman-Desktop.desktop
<br>
 <syntaxhighlight lang="ini">
 # ~/.local/share/applications/Podman-Desktop.desktopファイル
 
 [Desktop Entry]
 Type=Application
 Name=Podman Desktop
 Exec=/<Podman Desktopのインストールディレクトリ>/podman-desktop %F
 Icon=io.podman_desktop.PodmanDesktop
 Categories=Development;
 StartupWMClass=Podman Desktop
 Terminal=false
 </syntaxhighlight>
<br>
==== Docker Hubの使用 ====
Docker Hubにログインする。<br>
 podman login -u <Docker Hubのユーザ名> -v https://docker.io
 podman login -u <Docker Hubのユーザ名> -v https://index.docker.io/v2/
<br>
Podman Desktopを再起動する。<br>
<br>
認証情報は、/run/user/$UID/containers/auth.jsonファイルに保存される。<br>
<br><br>

== ルートレスモード ==
==== ルートレスモードとは ====
Podmanはsetuidパッケージが不要であり、一般ユーザとしてコンテナを実行することができる。<br>
ルートレスモードで実行する場合、Podmanコンテナはユーザネームスペースを使用して、コンテナ内のrootをPodmanを実行しているユーザに設定する。<br>
<br>
ルートレスモードのPodmanは、コンテナを実行しているユーザには無い特権は持たず、ロックダウンされたコンテナを実行する。<br>
<br>
これらの制限の一部は (例えば、<code>--privileged</code>オプションを付加して) 解除できるが、ルートレスコンテナが起動したユーザ以上の権限を持つことはない。<br>
一般ユーザとしてPodmanを実行する時、ホストから/etc/passwdにマウントした場合でも、一般ユーザには権限が無いため変更することはできない。<br>
<br>
==== PodmanとDockerの違い ====
DockerとPodmanの違いの1つは、コンテナの扱い方である。<br>
Dockerは、コンテナを実行するためにスーパーユーザ権限を必要とする。<br>
Podmanは、スーパーユーザ権限無しでコンテナを実行することができる。<br>
<br>
例えば、ルートレスモードのPodmanでは、ポート番号が1024番未満のポートでコンテナを起動することはできないため、1024番以上のポートを使用する必要がある。<br>
<br>
もし、1024番未満のポートでコンテナを作成する必要がある場合は、ルートレスモードを解除してスーパーユーザ権限で実行する。<br>
 podman machine set --rootful
<br>
ルートレスモードに戻す場合は、以下に示すコマンドを実行する。<br>
 podman machine set --rootful=false
<br>
しかし、Dockerには、コンテナを作成および管理するためDocker Composeが存在する。<br>
幸運なことに、PodmanはDocker CLIをエミュレートできるため、Docker Composeと連携することができる。<br>
<br><br>


__FORCETOC__
[[カテゴリ:RHEL]][[カテゴリ:SUSE]][[カテゴリ:Raspberry_Pi]][[カテゴリ:PinePhone]][[カテゴリ:Web]]