Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
In diesem Artikel wird gezeigt, wie Sie die OSM-Clientbibliothek herunterladen, um das OSM-Add-On für Azure Kubernetes Service (AKS) zu betreiben und zu konfigurieren und die Binärdatei für Ihre Umgebung zu konfigurieren.
Wichtig
Ab dem 30. September 2027 unterstützt Azure Kubernetes Service (AKS) das Open Service Mesh (OSM)-Add-On nicht mehr. Das upstream Open Service Mesh-Projekt wurde eingestellt.
Wenn Ihr Cluster das OSM-Add-On verwendet, migrieren Sie vor dem Enddatum des Supports zum Istio-Add-On. Dieser Hinweis zur Einstellung gilt nur für das verwaltete OSM-Add-On und bezieht sich nicht auf Open-Source- oder selbstverwaltete Service-Mesh-Installationen. Schritte zur Migration finden Sie in den Migrationsanleitungen vom OSM-Add-On zum Istio-Add-On. Um über Ankündigungen und Updates zu AKS auf dem Laufenden zu bleiben, lesen Sie die AKS-Versionshinweise.
Wichtig
Je nach der Version von Kubernetes, die Ihr Cluster ausführt, installiert das OSM-Add-On eine andere Version von OSM:
| Kubernetes-Version | Installierte OSM-Version |
|---|---|
| 1.24.0 oder höher | 1.2.5 |
| Zwischen 1.23.5 und 1.24.0 | 1.1.3 |
| Niedriger als 1.23.5 | 1.0.0 |
Ältere Versionen von OSM sind möglicherweise nicht für die Installation oder aktiv unterstützt, wenn die entsprechende AKS-Version das Ende der Lebensdauer erreicht hat. Überprüfen Sie den Veröffentlichungskalender von AKS Kubernetes , um Informationen zu den Unterstützungsfenstern der AKS-Version zu finden.
Herunterladen und Installieren der Open Service Mesh (OSM)-Clientbinärdatei
Verwenden Sie in einer Bash-basierten Shell unter Linux oder dem Windows-Subsystem für Linuxcurl, um das OSM-Release herunterzuladen, und extrahieren Sie dieses dann wie folgt mit tar:
# Specify the OSM version that will be leveraged throughout these instructions
OSM_VERSION=v1.2.0
curl -sL "https://github.com/openservicemesh/osm/releases/download/$OSM_VERSION/osm-$OSM_VERSION-linux-amd64.tar.gz" | tar -vxzf -
Die osm Clientbinärdatei läuft auf Ihrem Client-Rechner und ermöglicht Ihnen die Verwaltung von OSM in Ihrem AKS-Cluster. Verwenden Sie die folgenden Befehle, um die OSM-Clientbinärdatei osm in einer Bash-basierten Shell unter Linux oder Windows-Subsystem für Linux zu installieren. Diese Befehle kopieren die osm-Clientbinärdatei an den Speicherort des Standardbenutzerprogramms in Ihrem PATH.
sudo mv ./linux-amd64/osm /usr/local/bin/osm
sudo chmod +x /usr/local/bin/osm
Mithilfe des folgenden Befehls können Sie überprüfen, ob die osm Clientbibliothek ordnungsgemäß zu Ihrem Pfad und ihrer Versionsnummer hinzugefügt wurde.
osm version
Herunterladen und Installieren der Open Service Mesh (OSM)-Clientbinärdatei
Verwenden Sie in einer Bash-basierten Shell curl, um das OMS-Release herunterzuladen, und verwenden Sie dann wie folgt tar zum Extrahieren:
# Specify the OSM version that will be leveraged throughout these instructions
OSM_VERSION=v1.2.0
curl -sL "https://github.com/openservicemesh/osm/releases/download/$OSM_VERSION/osm-$OSM_VERSION-darwin-amd64.tar.gz" | tar -vxzf -
Die osm Clientbinärdatei läuft auf Ihrem Client-Rechner und ermöglicht Ihnen die Verwaltung von OSM in Ihrem AKS-Cluster. Verwenden Sie die folgenden Befehle, um die OSM-Clientbinärdatei osm in einer Bash-basierten Shell zu installieren. Diese Befehle kopieren die osm-Clientbinärdatei an den Speicherort des Standardbenutzerprogramms in Ihrem PATH.
sudo mv ./darwin-amd64/osm /usr/local/bin/osm
sudo chmod +x /usr/local/bin/osm
Mithilfe des folgenden Befehls können Sie überprüfen, ob die osm Clientbibliothek ordnungsgemäß zu Ihrem Pfad und ihrer Versionsnummer hinzugefügt wurde.
osm version
Herunterladen und Installieren der Open Service Mesh (OSM)-Clientbinärdatei
Verwenden Sie in einer PowerShell-basierten Shell unter Windows Invoke-WebRequest, um das OSM-Release herunterzuladen, und führen Sie das Extrahieren dann wie folgt mit Expand-Archive durch:
# Specify the OSM version that will be leveraged throughout these instructions
$OSM_VERSION="v1.2.0"
[Net.ServicePointManager]::SecurityProtocol = "tls12"
$ProgressPreference = 'SilentlyContinue'; Invoke-WebRequest -URI "https://github.com/openservicemesh/osm/releases/download/$OSM_VERSION/osm-$OSM_VERSION-windows-amd64.zip" -OutFile "osm-$OSM_VERSION.zip"
Expand-Archive -Path "osm-$OSM_VERSION.zip" -DestinationPath .
Das osmClientbinär läuft auf Ihrem Client-Rechner und ermöglicht Ihnen die Verwaltung des OSM-Controllers in Ihrem AKS-Cluster. Verwenden Sie die folgenden Befehle, um die OSM-Clientbinärdatei osm in einer PowerShell-basierten Shell unter Windows zu installieren. Mit diesen Befehlen wird die osmClientbinärdatei in einen Ordner „OSM“ kopiert und dann sowohl sofort (in der aktuellen Shell) als auch dauerhaft (über Neustarts der Shell) über Ihren PATH verfügbar gemacht. Sie benötigen keine erhöhten Rechte (Administrator), um diese Befehle auszuführen, und Sie müssen Ihre Shell nicht neu starten.
# Copy osm.exe to C:\OSM
New-Item -ItemType Directory -Force -Path "C:\OSM"
Move-Item -Path .\windows-amd64\osm.exe -Destination "C:\OSM\"
# Add C:\OSM to PATH.
# Make the new PATH permanently available for the current User
$USER_PATH = [environment]::GetEnvironmentVariable("PATH", "User") + ";C:\OSM\"
[environment]::SetEnvironmentVariable("PATH", $USER_PATH, "User")
# Make the new PATH immediately available in the current shell
$env:PATH += ";C:\OSM\"
Warnung
Versuchen Sie nicht, OSM über die Binärdatei zu installieren.osm install Dies führt zu einer Installation von OSM, die nicht als Add-On für AKS integriert ist.
Konfigurieren von OSM-CLI-Variablen mit einer OSM_CONFIG-Datei
Benutzer können die Standard-OSM-CLI-Konfiguration überschreiben, um das Add-On zu verbessern. Dies kann durch Erstellen einer Konfigurationsdatei, ähnlich wie kubeconfig, erfolgen. Die Konfigurationsdatei kann entweder unter $HOME/.osm/config.yaml oder unter einem anderen Pfad erstellt werden, der mit der Umgebungsvariablen OSM_CONFIG exportiert wird.
Die Datei muss den folgenden Inhalt im YAML-Format enthalten:
install:
kind: managed
distribution: AKS
namespace: kube-system
Wenn die Datei bei $HOME/.osm/config.yaml nicht erstellt wird, denken Sie daran, die Umgebungsvariable OSM_CONFIG auf den Pfad einzustellen, in dem die Konfigurationsdatei erstellt wird.
Nachdem Sie OSM_CONFIG festgelegt haben, sollte die Ausgabe des Befehls osm env wie folgt lauten:
$ osm env
---
install:
kind: managed
distribution: AKS
namespace: kube-system