この文書は自動機械翻訳技術を使用して翻訳されています。 正確な翻訳を提供するように努めておりますが、翻訳された内容の完全性、正確性、信頼性については一切保証いたしません。 相違がある場合は、元の英語版 英語 が優先され、正式なテキストとなります。

環境変数

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

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

curl -sfL https://get.k3s.io | INSTALL_K3S_ARTIFACT_URL=<PRIME-ARTIFACTS-URL>/k3s 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 execコマンドからデフォルトされます。

INSTALL_K3S_SELINUX_WARN

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

INSTALL_K3S_SKIP_SELINUX_RPM

trueに設定されている場合、k3s RPMの自動インストールをスキップします。

INSTALL_K3S_CHANNEL_URL

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

INSTALL_K3S_CHANNEL

K3sのダウンロードURLを取得するために使用するチャネル。デフォルトは「stable」です。指定できる値は、stablelatest、`testing`です。

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

curl -sfL https://get.k3s.io | INSTALL_K3S_ARTIFACT_URL=<PRIME-ARTIFACTS-URL>/k3s INSTALL_K3S_CHANNEL=latest sh -

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

execコマンドを明示的に設定せずに`K3S_URL`を設定すると、コマンドは「agent」にデフォルトされます。

エージェントを実行する際には、`K3S_TOKEN`も設定する必要があります。

バージョンゲート

2024年10月のリリースから利用可能:v1.28.15+k3s1、v1.29.10+k3s1、v1.30.6+k3s1、v1.31.2+k3s1。

K3sは、コンテナランタイムパッケージによって使用されるデフォルトのパスを確認することに加えて、代替のコンテナランタイムを見つけるために`PATH`を使用します。この機能を使用するには、K3sサービスのPATH環境変数を変更して、コンテナランタイムバイナリを含むディレクトリを追加する必要があります。

この2つの環境ファイルのいずれかを変更することをお勧めします:

  • /etc/default/k3s # または k3s-agent

  • /etc/sysconfig/k3s # または k3s-agent

この例では、PATH`を/etc/default/k3s`に追加します。

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

`PATH`の変更は、rootユーザーとして実行されるサービスのパスに信頼できないバイナリを配置しないように注意して行う必要があります。