環境変数

クイックスタートガイドで述べたように、https://get.k3s.io で利用可能なインストールスクリプトを使用して、systemdおよびopenrcベースのシステムにK3sをサービスとしてインストールできます。

このコマンドの最も簡単な形式は次のとおりです:

curl -sfL https://get.k3s.io | sh -

この方法を使用してK3sをインストールする場合、次の環境変数を使用してインストールを構成できます:

環境変数 説明

INSTALL_K3S_SKIP_DOWNLOAD

trueに設定すると、K3sのハッシュまたはバイナリをダウンロードしません。

INSTALL_K3S_SYMLINK

デフォルトでは、パスにコマンドが存在しない場合、kubectl、crictl、およびctrバイナリのシンボリックリンクを作成します。'skip’に設定するとシンボリックリンクを作成せず、'force’に設定すると上書きします。

INSTALL_K3S_SKIP_ENABLE

trueに設定すると、K3sサービスを有効化または開始しません。

INSTALL_K3S_SKIP_START

trueに設定すると、K3sサービスを開始しません。

INSTALL_K3S_VERSION

GithubからダウンロードするK3sのバージョン。指定しない場合は安定版チャネルからダウンロードを試みます。

INSTALL_K3S_BIN_DIR

K3sバイナリ、リンク、およびアンインストールスクリプトをインストールするディレクトリ。デフォルトは/usr/local/binです。

INSTALL_K3S_BIN_DIR_READ_ONLY

trueに設定すると、INSTALL_K3S_BIN_DIRにファイルを書き込みません。INSTALL_K3S_SKIP_DOWNLOAD=trueを強制設定します。

INSTALL_K3S_SYSTEMD_DIR

systemdサービスおよび環境ファイルをインストールするディレクトリ。デフォルトは/etc/systemd/systemです。

INSTALL_K3S_EXEC

サービスでK3sを起動するためのフラグ付きコマンド。コマンドが指定されておらず、K3S_URLが設定されている場合、デフォルトは「agent」です。K3S_URLが設定されていない場合、デフォルトは「server」です。詳細はこの例を参照してください。

INSTALL_K3S_NAME

作成するsystemdサービスの名前。k3sをサーバーとして実行する場合はデフォルトで「k3s」、エージェントとして実行する場合は「k3s-agent」になります。指定された場合、名前の前に「k3s-」が付加されます。

INSTALL_K3S_TYPE

作成するsystemdサービスのタイプ。指定されていない場合、K3sの実行コマンドからデフォルトが設定されます。

INSTALL_K3S_SELINUX_WARN

trueに設定すると、k3s-selinuxポリシーが見つからない場合でも続行します。

INSTALL_K3S_SKIP_SELINUX_RPM

trueに設定すると、k3s RPMの自動インストールをスキップします。

INSTALL_K3S_CHANNEL_URL

K3sダウンロードURLを取得するためのチャネルURL。デフォルトはlink:https://update.k3s.io/v1-release/channelsです。

INSTALL_K3S_CHANNEL

K3sダウンロードURLを取得するためのチャネル。デフォルトは「stable」です。オプションにはstablelatesttestingがあります。

次の例は、前述の環境変数をオプションとして(パイプの後に)配置する方法を示しています:

curl -sfL https://get.k3s.io | INSTALL_K3S_CHANNEL=latest sh -

K3S_で始まる環境変数は、systemdおよびopenrcサービスで使用するために保持されます。

K3S_URLを設定し、明示的に実行コマンドを設定しない場合、コマンドはデフォルトで「agent」になります。

エージェントを実行する場合、K3S_TOKENも設定する必要があります。

Version Gate

Available as of October 2024 releases: v1.28.15+k3s1, v1.29.10+k3s1, v1.30.6+k3s1, v1.31.2+k3s1.

K3s will now use PATH to find alternative container runtimes, in addition to checking the default paths used by the container runtime packages. In order to use this feature, you must modify the K3s service’s PATH environment variable to add the directories containing the container runtime binaries.

It’s recommended that you modify one of this two environment files:

  • /etc/default/k3s # or k3s-agent

  • /etc/sysconfig/k3s # or k3s-agent

This example will add the PATH in /etc/default/k3s:

echo PATH=$PATH >> /etc/default/k3s

PATH changes should be done with care to avoid placing untrusted binaries in the path of services that run as root.