環境変数
クイックスタートガイドで述べたように、https://get.k3s.io で利用可能なインストールスクリプトを使用して、systemdおよびopenrcベースのシステムにK3sをサービスとしてインストールできます。
このコマンドの最も簡単な形式は次のとおりです:
curl -sfL https://get.k3s.io | sh -
この方法を使用してK3sをインストールする場合、次の環境変数を使用してインストールを構成できます:
環境変数 | 説明 |
---|---|
|
trueに設定すると、K3sのハッシュまたはバイナリをダウンロードしません。 |
|
デフォルトでは、パスにコマンドが存在しない場合、kubectl、crictl、およびctrバイナリのシンボリックリンクを作成します。'skip’に設定するとシンボリックリンクを作成せず、'force’に設定すると上書きします。 |
|
trueに設定すると、K3sサービスを有効化または開始しません。 |
|
trueに設定すると、K3sサービスを開始しません。 |
|
GithubからダウンロードするK3sのバージョン。指定しない場合は安定版チャネルからダウンロードを試みます。 |
|
K3sバイナリ、リンク、およびアンインストールスクリプトをインストールするディレクトリ。デフォルトは |
|
trueに設定すると、 |
|
systemdサービスおよび環境ファイルをインストールするディレクトリ。デフォルトは |
|
サービスでK3sを起動するためのフラグ付きコマンド。コマンドが指定されておらず、 |
|
作成するsystemdサービスの名前。k3sをサーバーとして実行する場合はデフォルトで「k3s」、エージェントとして実行する場合は「k3s-agent」になります。指定された場合、名前の前に「k3s-」が付加されます。 |
|
作成するsystemdサービスのタイプ。指定されていない場合、K3sの実行コマンドからデフォルトが設定されます。 |
|
trueに設定すると、k3s-selinuxポリシーが見つからない場合でも続行します。 |
|
trueに設定すると、k3s RPMの自動インストールをスキップします。 |
|
K3sダウンロードURLを取得するためのチャネルURL。デフォルトはlink:https://update.k3s.io/v1-release/channelsです。 |
|
K3sダウンロードURLを取得するためのチャネル。デフォルトは「stable」です。オプションには |
次の例は、前述の環境変数をオプションとして(パイプの後に)配置する方法を示しています:
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
|