Kurzanleitung

Dieses Handbuch hilft Ihnen, schnell einen Cluster mit den Standardoptionen zu starten.

Neu bei Kubernetes? Die offiziellen Kubernetes-Dokumente enthalten bereits einige großartige Tutorials, die die Grundlagen hier umreißen.

Sie können jede RKE2 Prime-Version verwenden, die auf der Prime Artifacts-URL für die in diesen Schritten genannten Assets aufgeführt ist. Um mehr über die Prime Artifacts-URL zu erfahren, siehe unsere Prime-only-Dokumentation. Eine Authentifizierung ist erforderlich. Verwenden Sie Ihre SUSE Customer Center (SCC)-Anmeldeinformationen, um sich anzumelden.

Voraussetzungen

Stellen Sie sicher, dass Ihre Umgebung die Anforderungen erfüllt. Wenn NetworkManager auf Ihren Hosts installiert und aktiviert ist, stellen Sie sicher, dass er so konfiguriert ist, dass er CNI-verwaltete Schnittstellen ignoriert.
Wenn der Host-Kernel AppArmor unterstützt, müssen die AppArmor-Tools (normalerweise über das apparmor-parser-Paket verfügbar) ebenfalls vorhanden sein, bevor Sie RKE2 installieren.
Der SUSE® Rancher Prime: RKE2 Installationsprozess muss als Root-Benutzer oder über sudo ausgeführt werden.

Server-Knoteninstallation

SUSE® Rancher Prime: RKE2 bietet ein Installationsskript, das eine bequeme Möglichkeit ist, es als Dienst auf systemd-basierten Systemen zu installieren. Dieses Skript ist verfügbar unter https://get.rke2.io.. Um SUSE® Rancher Prime: RKE2 mit dieser Methode zu installieren, gehen Sie wie folgt vor:

Führen Sie den Installer aus, wobei INSTALL_RKE2_ARTIFACT_URL die Prime Prime Artifacts URL ist und INSTALL_RKE2_CHANNEL ein Release-Kanal ist, den Sie abonnieren können und der standardmäßig auf stable eingestellt ist. In diesem Beispiel gibt Ihnen INSTALL_RKE2_CHANNEL="latest" die neueste Version von RKE2.
```
curl -sfL https://get.rke2.io/ | sudo INSTALL_RKE2_ARTIFACT_URL=<PRIME-ARTIFACTS-URL>/rke2 INSTALL_RKE2_CHANNEL="latest" sh -
```
Wenn Sie eine Version angeben möchten, setzen Sie die INSTALL_RKE2_VERSION Umgebungsvariable.
```
curl -sfL https://get.rke2.io/ | sudo INSTALL_RKE2_ARTIFACT_URL=<PRIME-ARTIFACTS-URL>/rke2 INSTALL_RKE2_VERSION="<VERSION>" sh -
```
Dies installiert den rke2-server Dienst und die rke2 Binärdatei auf Ihrem Rechner. Aufgrund seiner Natur wird es fehlschlagen, es sei denn, es wird als Root-Benutzer oder über sudo ausgeführt.
Aktivieren Sie den rke2-server Dienst.
```
systemctl enable rke2-server.service
```
Um Images aus dem Rancher Prime-Registry zu ziehen, setzen Sie den folgenden Wert in etc/rancher/rke2/config.yaml:
```
system-default-registry: registry.rancher.com
```
Diese Konfiguration weist RKE2 an, registry.rancher.com als den Standardstandort für alle Container-Images zu verwenden, die es innerhalb des Clusters bereitstellen muss.
Starten Sie den Dienst.
```
systemctl start rke2-server.service
```
Verfolgen Sie die Protokolle mit dem folgenden Befehl:
```
journalctl -u rke2-server -f
```

Nach der Ausführung dieser Installation:

Der rke2-server Dienst wird installiert. Der rke2-server Dienst wird so konfiguriert, dass er nach Neustarts der Knoten oder wenn der Prozess abstürzt oder beendet wird, automatisch neu gestartet wird.
Zusätzliche Dienstprogramme werden unter /var/lib/rancher/rke2/bin/ installiert. Hierzu zählen: kubectl, crictl und ctr. Bitte beachten Sie, dass diese standardmäßig nicht in Ihrem Pfad enthalten sind.
Zwei Bereinigungsskripte, rke2-killall.sh und rke2-uninstall.sh, werden im folgenden Pfad installiert:
- /usr/local/bin für reguläre Dateisysteme
- /opt/rke2/bin für schreibgeschützte und btrfs-Dateisysteme
- INSTALL_RKE2_TAR_PREFIX/bin, wenn INSTALL_RKE2_TAR_PREFIX gesetzt ist
Eine kubeconfig Datei wird in /etc/rancher/rke2/rke2.yaml geschrieben.
Ein Token, das verwendet werden kann, um andere Server- oder Agentknoten zu registrieren, wird unter /var/lib/rancher/rke2/server/node-token erstellt.

Wenn Sie zusätzliche Serverknoten hinzufügen, müssen Sie insgesamt eine ungerade Anzahl haben. Eine ungerade Anzahl ist erforderlich, um das Quorum aufrechtzuerhalten. Siehe die Dokumentation zur hohen Verfügbarkeit für weitere Details.

Installation des Linux-Agenten (Worker) Knotens

Die Schritte in diesem Abschnitt erfordern Root-Zugriff oder sudo, um zu funktionieren.

Führen Sie das Installationsprogramm aus.
```
curl -sfL https://get.rke2.io | INSTALL_RKE2_ARTIFACT_URL=<PRIME-ARTIFACTS-URL>/rke2 INSTALL_RKE2_CHANNEL="latest" INSTALL_RKE2_TYPE="agent" sh -
```
Wenn Sie eine Version angeben möchten, setzen Sie die INSTALL_RKE2_VERSION Umgebungsvariable.
```
curl -sfL https://get.rke2.io/ | sudo INSTALL_RKE2_ARTIFACT_URL=<PRIME-ARTIFACTS-URL>/rke2 INSTALL_RKE2_VERSION="<VERSION>" INSTALL_RKE2_TYPE="agent" sh -
```
Dies installiert den rke2-agent Dienst und die rke2 Binärdatei auf Ihrem Rechner. Aufgrund seiner Natur wird es fehlschlagen, es sei denn, es wird als Root-Benutzer oder über sudo ausgeführt.
Aktivieren Sie den rke2-agent Dienst.
```
systemctl enable rke2-agent.service
```
Konfigurieren Sie den rke2-agent Dienst.
```
mkdir -p /etc/rancher/rke2/
vim /etc/rancher/rke2/config.yaml
```
Inhalt für config.yaml:
```
server: https://<server>:9345
token: <token from server node>
```
Der rke2 server Prozess hört auf Port 9345 auf neue Knoten, die sich registrieren. Die Kubernetes API wird weiterhin auf Port 6443 wie gewohnt bereitgestellt.
Starten Sie den Dienst.
```
systemctl start rke2-agent.service
```
Verfolgen Sie die Protokolle mit dem folgenden Befehl:
```
journalctl -u rke2-agent -f
```

Jede Maschine muss einen eindeutigen Hostnamen haben. Wenn Ihre Maschinen keine eindeutigen Hostnamen haben, setzen Sie den node-name Parameter in der config.yaml Datei und geben Sie einen Wert mit einem gültigen und eindeutigen Hostnamen für jeden Knoten an. Um mehr über die config.yaml Datei zu erfahren, siehe die Konfigurationsdokumentation.

Installation des Windows Agent (Worker) Knotens

Der Windows Support funktioniert mit Calico oder Flannel als CNI für den RKE2 Cluster.

Bereiten Sie den Windows Agent Knoten vor.

Die Windows Server Container-Funktion muss aktiviert sein, damit der RKE2 Agent funktioniert.
1. Öffnen Sie ein neues Powershell-Fenster mit Administratorrechten.
  powershell -Command "Start-Process PowerShell -Verb RunAs"
2. Führen Sie im neuen Powershell-Fenster den folgenden Befehl aus, um die Container-Funktion zu installieren.
  Enable-WindowsOptionalFeature -Online -FeatureName containers –All
  Dies erfordert einen Neustart, damit die Containers Funktion ordnungsgemäß funktioniert.
Laden Sie das Installationsskript herunter.
```
Invoke-WebRequest -Uri https://raw.githubusercontent.com/rancher/rke2/master/install.ps1 -Outfile install.ps1
```
Dieses Skript wird die rke2.exe Windows-Binärdatei auf Ihren Computer herunterladen.

Konfigurieren Sie den rke2-agent für Windows.

New-Item -Type Directory c:/etc/rancher/rke2 -Force
Set-Content -Path c:/etc/rancher/rke2/config.yaml -Value @"
server: https://<server>:9345
token: <token from server node>
"@

Um mehr über die config.yaml Datei zu erfahren, siehe die Konfigurationsdokumentation.

Konfigurieren Sie den Pfad.

$env:PATH+=";c:\var\lib\rancher\rke2\bin;c:\usr\local\bin"

[Environment]::SetEnvironmentVariable(
    "Path",
    [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::Machine) + ";c:\var\lib\rancher\rke2\bin;c:\usr\local\bin",
    [EnvironmentVariableTarget]::Machine)

Führen Sie das Installationsprogramm aus.
```
./install.ps1
```
Starten Sie den Windows RKE2 Dienst.
```
rke2.exe agent service --add
```

Jede Maschine muss einen eindeutigen Hostnamen haben.

Vergessen Sie nicht, den RKE2 Dienst mit folgendem Befehl zu starten:

Start-Service rke2

Wenn Sie stattdessen lieber nur CLI-Parameter verwenden möchten, führen Sie die Binärdatei mit den gewünschten Parametern aus.

rke2.exe agent --token <> --server <>