Le asmcli
est un outil fourni par Google que vous pouvez utiliser pour installer ou mettre à niveau Anthos Service Mesh. Si vous le permettez, asmcli
configurera votre projet et votre cluster comme suit :
- Accordez les autorisations IAM (gestion de l'authentification et des accès) requises sur votre projet Google Cloud.
- Activez les API Google requises sur votre projet Google Cloud.
- définissant un libellé sur le cluster qui identifie le réseau maillé ;
- Créez un compte de service permettant aux composants du plan de données, tels que le proxy side-car, d'accéder en toute sécurité aux données et aux ressources de votre projet.
- Enregistrer le cluster dans le parc si ce n'est déjà fait.
Il vous suffit d'inclure l'indicateur --enable_all
lorsque vous exécutez asmcli
pour lui permettre de configurer votre projet et votre cluster. Pour en savoir plus sur les options asmcli
, consultez la documentation de référence sur asmcli
.
Ensuite, asmcli
configure les fichiers YAML avec les informations de votre projet et de votre cluster.
Ces fichiers de configuration sont nécessaires pour installer le plan de contrôle d'Anthos Service Mesh.
Si vous débutez avec Anthos Service Mesh et Istio, passez à la section Plates-formes compatibles. La section suivante vise à aider Anthos Service Mesh à passer à 1.12.
Passer à asmcli
asmcli
remplace istioctl install
et install_asm
. Bien que vous puissiez toujours utiliser les anciens outils d'Anthos Service Mesh 1.11, nous les abandonnons et ils ne seront plus compatibles avec Anthos Service Mesh 1.12 et versions ultérieures.
Veuillez mettre à jour vos scripts et vos outils pour qu'ils utilisent asmcli
.
Avec Anthos Service Mesh 1.11 et versions ultérieures, tous les clusters doivent être enregistrés dans un parc. Pour en savoir plus, consultez la section Exigences concernant le parc.
Effectuer la transition depuis install_asm
Si vous connaissez install_asm
, asmcli
est similaire, mais présente les différences notables suivantes :
Vous utilisez
asmcli install
pour les nouvelles installations et les mises à niveau. Aucune option--mode
n'existe, comme avecinstall_asm
. Lorsque vous exécutezasmcli install
, il vérifie s'il existe un plan de contrôle sur le cluster. S'il n'existe aucun plan de contrôle,asmcli
installe Anthos Service Mesh. Si le cluster dispose d'un plan de contrôle existant (plan de contrôle Anthos Service Mesh ou plan de contrôle Open Source Istio) :Si le libellé de révision sur le plan de contrôle existant ne correspond pas au libellé de révision du nouveau plan de contrôle,
asmcli
procède à une mise à niveau Canary.Si les libellés de révision du plan de contrôle sont identiques,
asmcli
effectue une mise à niveau sur place.
La plupart des options et indicateurs
asmcli
se comportent de la même manière que ceux deinstall_asm
.
Effectuer la transition depuis istioctl install
Si vous connaissez bien istioctl install
, si vous transmettez normalement un fichier YAML IstioOperator
via l'argument de ligne de commande -f
pour configurer le plan de contrôle, vous pouvez transmettre le fichier à asmcli
à l'aide de l'option --custom_overlay
. Dans la documentation d'Anthos Service Mesh, ces fichiers sont appelés fichiers de superposition.
Plates-formes compatibles
Les installations Anthos Service Mesh de la liste des plates-formes compatibles peuvent être configurées ou mises à niveau par asmcli
.
Certaines fonctionnalités ne sont pas disponibles sur les plates-formes en dehors de Google Cloud. Par exemple, l'autorité de certification Anthos Service Mesh (Mesh CA) n'est pas compatible avec GKE sur AWS, Amazon EKS ou Microsoft AKS. Pour en savoir plus, consultez la page Fonctionnalités compatibles avec le plan de contrôle au sein du cluster.