Skip to content

nerdctl.tomlによるnerdctlの構成

⚡ 必要条件 nerdctl >= 0.16

このドキュメントでは、nerdctlの設定ファイル(nerdctl.toml)について説明します。 このファイルは、containerdの設定ファイル(config.toml)とは無関係です。

ファイルパス

  • ルートフルモード: /etc/nerdctl/nerdctl.toml
  • ルートレスモード: ~/.config/nerdctl/nerdctl.toml

パスは $NERDCTL_TOML で上書きできます。

例

# This is an example of /etc/nerdctl/nerdctl.toml .
# Unrelated to the daemon's /etc/containerd/config.toml .

debug          = false
debug_full     = false
address        = "unix:///run/k3s/containerd/containerd.sock"
namespace      = "k8s.io"
snapshotter    = "stargz"
cgroup_manager = "cgroupfs"
hosts_dir      = ["/etc/containerd/certs.d", "/etc/docker/certs.d"]
experimental   = true

プロパティ

TOMLプロパティ CLIフラグ 環境変数 説明 Availability *1
debug --debug デバッグモード 0.16.0から
debug_full --debug-full デバッグモード(フル出力) 0.16.0から
address --address,--host,-a,-H $CONTAINERD_ADDRESS containerd アドレス 0.16.0から
namespace --namespace,-n $CONTAINERD_NAMESPACE containerd 名前空間 0.16.0から
snapshotter --snapshotter,--storage-driver $CONTAINERD_SNAPSHOTTER containerdスナップショット生成器 0.16.0から
cni_path --cni-path $CNI_PATH CNI バイナリ ディレクトリ 0.16.0から
cni_netconfpath --cni-netconfpath $NETCONFPATH CNI 設定 ディレクトリ 0.16.0から
data_root --data-root 永続的な状態ディレクトリ 0.16.0から
cgroup_manager --cgroup-manager cgroup管理 0.16.0から
insecure_registry --insecure-registry 安全でないレジストリを許可する 0.16.0から
hosts_dir --hosts-dir certs.d directory 0.16.0から
experimental --experimental NERDCTL_EXPERIMENTAL 試験的な機能を有効にする 0.22.3から
host_gateway_ip --host-gateway-ip NERDCTL_HOST_GATEWAY_IP --add-host の特別な 'host-gateway' 文字列が解決される IP アドレス。デフォルトは、ホストの IP アドレスです。--add-host を設定しないと効果がありません 1.3.0から

プロパティは、次の優先順位で解析されます。 1. CLIフラグ 2. 環境変数 3. TOMLプロパティ 4. 組み込みの既定値 (既定値を表示するには nerdctl --help を実行します)

*1: TOMLプロパティの有無

関連項目