Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Questo articolo illustra come scaricare la libreria client OSM per operare e configurare il componente aggiuntivo OSM per il servizio Azure Kubernetes e come configurare il file binario per l'ambiente in uso.
Importante
A partire dal 30 settembre 2027, il servizio Azure Kubernetes non supporta più il componente aggiuntivo Open Service Mesh (OSM). Cloud Native Computing Foundation (CNF) ha ritirato il progetto OSM upstream. Eseguire la migrazione di tutte le configurazioni OSM esistenti a configurazioni Istio equivalenti. Per altre informazioni su questo ritiro, vedere l'annuncio di ritiro degli aggiornamenti di Azure. Per rimanere informati sugli annunci e sugli aggiornamenti, seguire le note di rilascio di AKS.
Importante
In base alla versione di Kubernetes in esecuzione, il componente aggiuntivo OSM installa una versione diversa di OSM.
| Versione di Kubernetes | Versione di OSM installata |
|---|---|
| 1.24.0 o versione successiva | 1.2.5 |
| Tra 1.23.5 e 1.24.0 | 1.1.3 |
| Inferiore a 1.23.5 | 1.0.0 |
Le versioni precedenti di OSM potrebbero non essere disponibili per l'installazione o essere supportate attivamente se la versione del servizio Azure Kubernetes corrispondente ha raggiunto la fine del ciclo di vita. È possibile controllare il calendario della versione del servizio Azure Kubernetes per informazioni sulle finestre di supporto della versione del servizio Azure Kubernetes.
Scaricare e installare il file binario del client Open Service Mesh (OSM)
In una shell basata su bash in Linux o sottosistema Windows per Linux, usare curl per scaricare la versione OSM ed estrarre con tar come indicato di seguito:
# 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 -
Il file binario client osm viene eseguito nel computer client e consente di gestire OSM nel cluster del servizio Azure Kubernetes. Per installare il file binario del client osm di OSM in una shell basata su bash in Linux o in un sottosistema di Windows per Linux, usare i comandi indicati di seguito. Questi comandi copiano il file binario del client osm nel percorso del programma dell'utente standard in PATH.
sudo mv ./linux-amd64/osm /usr/local/bin/osm
sudo chmod +x /usr/local/bin/osm
È possibile verificare che la libreria client osm sia stata aggiunta correttamente al percorso e al relativo numero di versione con il comando seguente.
osm version
Scaricare e installare il file binario del client Open Service Mesh (OSM)
In una shell basata su bash usare curl per scaricare la versione OSM e quindi estrarre con tar come indicato di seguito:
# 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 -
Il file binario client osm viene eseguito nel computer client e consente di gestire OSM nel cluster del servizio Azure Kubernetes. Usare i comandi seguenti per installare il file binario del client OSM osm in una shell basata su bash. Questi comandi copiano il file binario del client osm nel percorso del programma dell'utente standard in PATH.
sudo mv ./darwin-amd64/osm /usr/local/bin/osm
sudo chmod +x /usr/local/bin/osm
È possibile verificare che la libreria client osm sia stata aggiunta correttamente al percorso e al relativo numero di versione con il comando seguente.
osm version
Scaricare e installare il file binario del client Open Service Mesh (OSM)
In una shell basata su PowerShell in Windows usare Invoke-WebRequest per scaricare la versione OSM ed estrarre con Expand-Archive come indicato di seguito:
# 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 .
Il file binario client osm viene eseguito nel computer client e consente di gestire il controller OSM nel cluster del servizio Azure Kubernetes. Usare i comandi seguenti per installare il file binario del client OSM osm in una shell basata su PowerShell in Windows. Questi comandi copiano il file binario client osm in una cartella OSM e quindi lo rendono disponibile sia immediatamente (nella shell corrente) che in modo permanente (tra riavvii della shell) tramite PATH. Non sono necessari privilegi (amministratore) elevati per eseguire questi comandi e non è necessario riavviare la shell.
# 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\"
Avviso
Non tentare di installare OSM dal file binario usando osm install. Ciò comporterà un'installazione di OSM che non è integrato come componente aggiuntivo per AKS.
Configurare le variabili dell'interfaccia della riga di comando di OSM con un file OSM_CONFIG
Gli utenti possono eseguire l'override della configurazione predefinita dell'interfaccia della riga di comando di OSM per migliorare l'esperienza del componente aggiuntivo. A tale scopo, è possibile creare un file di configurazione, simile a kubeconfig. Il file di configurazione può essere creato in $HOME/.osm/config.yaml o in un percorso diverso esportato usando la variabile di ambiente OSM_CONFIG.
Il file deve contenere il contenuto YAML seguente:
install:
kind: managed
distribution: AKS
namespace: kube-system
Se il file non viene creato in $HOME/.osm/config.yaml, ricordarsi di impostare la OSM_CONFIG variabile di ambiente in modo che punti al percorso in cui viene creato il file di configurazione.
Dopo aver impostato OSM_CONFIG, l'output del comando osm env deve essere il seguente:
$ osm env
---
install:
kind: managed
distribution: AKS
namespace: kube-system