Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Cet article explique comment télécharger la bibliothèque de client OSM pour fonctionner et configurer le module complémentaire OSM pour Azure Kubernetes Service (AKS) et comment configurer le fichier binaire pour votre environnement.
Important
À compter du 30 septembre 2027, Azure Kubernetes Service (AKS) ne prend plus en charge le module complémentaire Open Service Mesh (OSM). Cloud Native Computing Foundation (CNCF) a mis hors service le projet OSM en amont. Migrez les configurations OSM existantes vers des configurations Istio équivalentes. Pour plus d’informations sur cette mise hors service, consultez l’annonce de mise hors service des mises à jour Azure. Pour rester informé des annonces et des mises à jour, suivez les notes de publication d’AKS.
Important
En fonction de la version de Kubernetes exécutée par votre cluster, le module complémentaire OSM installe une autre version d’OSM.
| Version de Kubernetes | Version d’OSM installée |
|---|---|
| 1.24.0 ou version ultérieure | 1.2.5 |
| Entre 1.23.5 et 1.24.0 | 1.1.3 |
| Antérieure à la version 1.23.5 | 1.0.0 |
Les versions antérieures d’OSM peuvent ne pas être disponibles pour l’installation ou être activement prises en charge, si la version AKS correspondante a atteint sa fin de vie. Vous pouvez consulter le Calendrier des versions d’AKS Kubernetes pour plus d’informations sur les fenêtres de prise en charge des versions d’AKS.
Télécharger et installer le fichier binaire client Open Service Mesh (OSM)
Dans un interpréteur de commandes bash sur Linux ou sur Sous-système Windows pour Linux, utilisez curl pour télécharger la version d’OSM, puis extrayez-la avec tar, de la manière suivante :
# 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 -
Le binaire client osm s’exécute sur votre machine cliente et vous permet de gérer OSM dans votre cluster AKS. Utilisez les commandes suivantes pour installer le binaire client OSM osm dans un interpréteur de commandes bash sur Linux ou le Sous-système Windows pour Linux. Ces commandes copient le binaire client osm à l’emplacement du programme utilisateur standard dans votre PATH.
sudo mv ./linux-amd64/osm /usr/local/bin/osm
sudo chmod +x /usr/local/bin/osm
Vous pouvez vérifier que la bibliothèque de client osm a été correctement ajoutée à votre chemin et son numéro de version à l’aide de la commande suivante.
osm version
Télécharger et installer le fichier binaire client Open Service Mesh (OSM)
Dans l’interpréteur de commandes bash, utilisez curl pour télécharger la version d’OSM, puis extrayez-la avec tar de la façon suivante :
# 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 -
Le binaire client osm s’exécute sur votre machine cliente et vous permet de gérer OSM dans votre cluster AKS. Utilisez les commandes suivantes pour installer le binaire client OSM osm dans un interpréteur de commandes bash. Ces commandes copient le binaire client osm à l’emplacement du programme utilisateur standard dans votre PATH.
sudo mv ./darwin-amd64/osm /usr/local/bin/osm
sudo chmod +x /usr/local/bin/osm
Vous pouvez vérifier que la bibliothèque de client osm a été correctement ajoutée à votre chemin et son numéro de version à l’aide de la commande suivante.
osm version
Télécharger et installer le fichier binaire client Open Service Mesh (OSM)
Dans l’interpréteur de commandes PowerShell sur Windows, utilisez Invoke-WebRequest pour télécharger la version d’OSM, puis extrayez-la avec Expand-Archive de la manière suivante :
# 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 .
Le binaire client osm s’exécute sur votre machine cliente et vous permet de gérer le contrôleur OSM dans votre cluster AKS. Utilisez les commandes suivantes pour installer le binaire client OSM osm dans un interpréteur de commandes PowerShell sur Windows. Ces commandes copient le binaire client osm vers un dossier OSM et le rendent accessible immédiatement (dans l’interpréteur de commandes actuel) et en permanence (entre les redémarrages de l’interpréteur de commandes) via votre PATH. Vous n’avez pas besoin de privilèges élevés (Admin) pour exécuter ces commandes et vous ne devez pas redémarrer votre interpréteur de commandes.
# 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\"
Avertissement
N’essayez pas d’installer OSM à partir du fichier binaire en utilisant osm install. Cela entraîne une installation d’OSM qui n’est pas intégrée en tant que module complémentaire pour AKS.
Configurer les variables CLI OSM avec un fichier OSM_CONFIG
Les utilisateurs peuvent remplacer la configuration CLI OSM par défaut pour améliorer l’expérience du module complémentaire. Pour ce faire, vous pouvez créer un fichier de configuration, semblable à kubeconfig. Le fichier de configuration peut être créé au niveau de $HOME/.osm/config.yaml ou dans un chemin différent qui est exporté à l’aide de la variable d’environnement OSM_CONFIG.
Le fichier doit contenir le contenu au format YAML suivant :
install:
kind: managed
distribution: AKS
namespace: kube-system
Si le fichier n’est pas créé à $HOME/.osm/config.yaml, n’oubliez pas de définir la variable d’environnement OSM_CONFIG pour qu’elle pointe vers le chemin d’accès où le fichier de configuration est créé.
Après avoir défini OSM_CONFIG, la sortie de la commande osm env doit être la suivante :
$ osm env
---
install:
kind: managed
distribution: AKS
namespace: kube-system