メインコンテンツまでスキップ

環境変数

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

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

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

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

環境変数説明
INSTALL_K3S_SKIP_DOWNLOADtrueに設定すると、K3sのハッシュまたはバイナリをダウンロードしません。
INSTALL_K3S_SYMLINKデフォルトでは、パスにコマンドが存在しない場合、kubectl、crictl、およびctrバイナリのシンボリックリンクを作成します。'skip'に設定するとシンボリックリンクを作成せず、'force'に設定すると上書きします。
INSTALL_K3S_SKIP_ENABLEtrueに設定すると、K3sサービスを有効化または開始しません。
INSTALL_K3S_SKIP_STARTtrueに設定すると、K3sサービスを開始しません。
INSTALL_K3S_VERSIONGithubからダウンロードするK3sのバージョン。指定しない場合は安定版チャネルからダウンロードを試みます。
INSTALL_K3S_BIN_DIRK3sバイナリ、リンク、およびアンインストールスクリプトをインストールするディレクトリ。デフォルトは/usr/local/binです。
INSTALL_K3S_BIN_DIR_READ_ONLYtrueに設定すると、INSTALL_K3S_BIN_DIRにファイルを書き込みません。INSTALL_K3S_SKIP_DOWNLOAD=trueを強制設定します。
INSTALL_K3S_SYSTEMD_DIRsystemdサービスおよび環境ファイルをインストールするディレクトリ。デフォルトは/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_WARNtrueに設定すると、k3s-selinuxポリシーが見つからない場合でも続行します。
INSTALL_K3S_SKIP_SELINUX_RPMtrueに設定すると、k3s RPMの自動インストールをスキップします。
INSTALL_K3S_CHANNEL_URLK3sダウンロードURLを取得するためのチャネルURL。デフォルトはhttps://update.k3s.io/v1-release/channelsです。
INSTALL_K3S_CHANNELK3sダウンロードURLを取得するためのチャネル。デフォルトは「stable」です。オプションにはstablelatesttestingがあります。

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

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

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

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

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