Umgebungsvariablen

Wie in der Kurzanleitung erwähnt, können Sie das Installationsskript unter https://get.k3s.io verwenden, um K3s als Dienst auf systemd- und openrc-basierten Systemen zu installieren.

Die einfachste Form dieses Befehls ist wie folgt:

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

Bei der Verwendung dieser Methode zur Installation von K3s können die folgenden Umgebungsvariablen zur Konfiguration der Installation verwendet werden:

Umgebungsvariable Beschreibung

Umgebungsvariable	Beschreibung
`INSTALL_K3S_SKIP_DOWNLOAD`	Wenn auf true gesetzt, wird der K3s-Hash oder die Binärdatei nicht heruntergeladen.
`INSTALL_K3S_SYMLINK`	Standardmäßig werden Symlinks für die kubectl-, crictl- und ctr-Binärdateien erstellt, wenn die Befehle nicht bereits im Pfad vorhanden sind. Wenn auf 'skip' gesetzt, werden keine Symlinks erstellt, und 'force' überschreibt.
`INSTALL_K3S_SKIP_ENABLE`	Wenn auf true gesetzt, wird der K3s-Dienst nicht aktiviert oder gestartet.
`INSTALL_K3S_SKIP_START`	Wenn auf true gesetzt, wird der K3s-Dienst nicht gestartet.
`INSTALL_K3S_VERSION`	Version von K3s, die von Github heruntergeladen werden soll. Es wird versucht, aus dem stabilen Kanal herunterzuladen, wenn nichts anderes angegeben ist.
`INSTALL_K3S_BIN_DIR`	Verzeichnis, in das die K3s-Binärdatei, Links und das Deinstallationsskript installiert werden sollen, oder verwenden Sie `/usr/local/bin` als Standard.
`INSTALL_K3S_BIN_DIR_READ_ONLY`	Wenn auf true gesetzt, werden keine Dateien in `INSTALL_K3S_BIN_DIR` geschrieben, zwingt die Einstellung von `INSTALL_K3S_SKIP_DOWNLOAD=true`.
`INSTALL_K3S_SYSTEMD_DIR`	Verzeichnis, in das die systemd-Dienst- und Umgebungsdateien installiert werden sollen, oder verwenden Sie `/etc/systemd/system` als Standard.
`INSTALL_K3S_EXEC`	Befehl mit Flags, der zum Starten von K3s im Dienst verwendet werden soll. Wenn der Befehl nicht angegeben ist und `K3S_URL` gesetzt ist, wird standardmäßig "agent" verwendet. Wenn `K3S_URL` nicht gesetzt ist, wird standardmäßig "server" verwendet. Für Hilfe, siehe dieses Beispiel.
`INSTALL_K3S_NAME`	Name des zu erstellenden systemd-Dienstes, standardmäßig 'k3s', wenn K3s als Server ausgeführt wird, und 'k3s-agent', wenn K3s als Agent ausgeführt wird. Wenn angegeben, wird der Name mit 'k3s-' vorangestellt.
`INSTALL_K3S_TYPE`	Typ des zu erstellenden systemd-Dienstes, standardmäßig aus dem K3s-Exec-Befehl, wenn nicht angegeben.
`INSTALL_K3S_SELINUX_WARN`	Wenn auf true gesetzt, wird fortgefahren, wenn die k3s-selinux-Richtlinie nicht gefunden wird.
`INSTALL_K3S_SKIP_SELINUX_RPM`	Wenn auf true gesetzt, wird die automatische Installation des k3s RPM übersprungen.
`INSTALL_K3S_CHANNEL_URL`	Channel-URL zum Abrufen der K3s-Download-URL. Der Standardwert ist https://update.k3s.io/v1-release/channels..
`INSTALL_K3S_CHANNEL`	Channel, der zum Abrufen der K3s-Download-URL verwendet werden soll. Der Standardwert ist "stable". Die gültigen Optionen sind: `stable`, `latest`, `testing`.

INSTALL_K3S_SKIP_DOWNLOAD

Wenn auf true gesetzt, wird der K3s-Hash oder die Binärdatei nicht heruntergeladen.

INSTALL_K3S_SYMLINK

Standardmäßig werden Symlinks für die kubectl-, crictl- und ctr-Binärdateien erstellt, wenn die Befehle nicht bereits im Pfad vorhanden sind. Wenn auf 'skip' gesetzt, werden keine Symlinks erstellt, und 'force' überschreibt.

INSTALL_K3S_SKIP_ENABLE

Wenn auf true gesetzt, wird der K3s-Dienst nicht aktiviert oder gestartet.

INSTALL_K3S_SKIP_START

Wenn auf true gesetzt, wird der K3s-Dienst nicht gestartet.

INSTALL_K3S_VERSION

Version von K3s, die von Github heruntergeladen werden soll. Es wird versucht, aus dem stabilen Kanal herunterzuladen, wenn nichts anderes angegeben ist.

INSTALL_K3S_BIN_DIR

Verzeichnis, in das die K3s-Binärdatei, Links und das Deinstallationsskript installiert werden sollen, oder verwenden Sie /usr/local/bin als Standard.

INSTALL_K3S_BIN_DIR_READ_ONLY

Wenn auf true gesetzt, werden keine Dateien in INSTALL_K3S_BIN_DIR geschrieben, zwingt die Einstellung von INSTALL_K3S_SKIP_DOWNLOAD=true.

INSTALL_K3S_SYSTEMD_DIR

Verzeichnis, in das die systemd-Dienst- und Umgebungsdateien installiert werden sollen, oder verwenden Sie /etc/systemd/system als Standard.

INSTALL_K3S_EXEC

Befehl mit Flags, der zum Starten von K3s im Dienst verwendet werden soll. Wenn der Befehl nicht angegeben ist und K3S_URL gesetzt ist, wird standardmäßig "agent" verwendet. Wenn K3S_URL nicht gesetzt ist, wird standardmäßig "server" verwendet. Für Hilfe, siehe dieses Beispiel.

INSTALL_K3S_NAME

Name des zu erstellenden systemd-Dienstes, standardmäßig 'k3s', wenn K3s als Server ausgeführt wird, und 'k3s-agent', wenn K3s als Agent ausgeführt wird. Wenn angegeben, wird der Name mit 'k3s-' vorangestellt.

INSTALL_K3S_TYPE

Typ des zu erstellenden systemd-Dienstes, standardmäßig aus dem K3s-Exec-Befehl, wenn nicht angegeben.

INSTALL_K3S_SELINUX_WARN

Wenn auf true gesetzt, wird fortgefahren, wenn die k3s-selinux-Richtlinie nicht gefunden wird.

INSTALL_K3S_SKIP_SELINUX_RPM

Wenn auf true gesetzt, wird die automatische Installation des k3s RPM übersprungen.

INSTALL_K3S_CHANNEL_URL

Channel-URL zum Abrufen der K3s-Download-URL. Der Standardwert ist https://update.k3s.io/v1-release/channels..

INSTALL_K3S_CHANNEL

Channel, der zum Abrufen der K3s-Download-URL verwendet werden soll. Der Standardwert ist "stable". Die gültigen Optionen sind: stable, latest, testing.

Dieses Beispiel zeigt, wo die oben genannten Umgebungsvariablen als Optionen (nach dem Pipe-Zeichen) platziert werden sollten:

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

Umgebungsvariablen, die mit K3S_ beginnen, werden für die systemd- und openrc-Dienste beibehalten.

Das Setzen von K3S_URL ohne explizites Setzen eines exec-Befehls setzt den Befehl standardmäßig auf "agent".

Beim Ausführen des Agents muss auch K3S_TOKEN gesetzt werden.

Versionssperre

Verfügbar ab den Veröffentlichungen im Oktober 2024: v1.28.15+k3s1, v1.29.10+k3s1, v1.30.6+k3s1, v1.31.2+k3s1.

K3s wird nun PATH verwenden, um alternative Container-Laufzeiten zu finden, zusätzlich zur Überprüfung der Standardpfade, die von den Container-Laufzeit-Paketen verwendet werden. Um diese Funktion zu nutzen, müssen Sie die PATH-Umgebungsvariable des K3s-Dienstes ändern, um die Verzeichnisse hinzuzufügen, die die Binärdateien der Container-Laufzeit enthalten.

Es wird empfohlen, eine dieser beiden Umgebungsdateien zu ändern:

/etc/default/k3s # oder k3s-agent
/etc/sysconfig/k3s # oder k3s-agent

Dieses Beispiel wird PATH in /etc/default/k3s hinzufügen:

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

Änderungen an PATH sollten mit Vorsicht vorgenommen werden, um zu vermeiden, dass nicht vertrauenswürdige Binärdateien in den Pfad von Diensten gelangen, die als root ausgeführt werden.