Dieses Dokument wurde mithilfe automatisierter maschineller Übersetzungstechnologie übersetzt. Wir bemühen uns um korrekte Übersetzungen, übernehmen jedoch keine Gewähr für die Vollständigkeit, Richtigkeit oder Zuverlässigkeit der übersetzten Inhalte. Im Falle von Abweichungen ist die englische Originalversion maßgebend und stellt den verbindlichen Text dar.

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.