À propos d'asmcli

{package_kubectl 1 1

asmcli est un outil fourni par Google que vous pouvez utiliser pour installer ou mettre à niveau Cloud 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.
  • Activer les API Google requises sur votre projet Google Cloud
  • Définir 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 Cloud Service Mesh.

Si vous débutez avec Cloud Service Mesh et Istio, passez directement à Plates-formes compatibles La section suivante vise à faciliter la mise à niveau de Cloud Service Mesh existant vers .

Passer à asmcli

asmcli remplace istioctl install et install_asm. Bien que vous pouvez toujours utiliser les anciens outils dans Cloud Service Mesh 1.11, nous abandonnons et ils ne seront plus pris en charge dans Cloud Service Mesh 1.12 et versions ultérieures. Veuillez mettre à jour vos scripts et vos outils pour qu'ils utilisent asmcli.

Avec Cloud Service Mesh 1.11 et les 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 avec install_asm. Lorsque vous exécutez asmcli install, il vérifie s'il existe un plan de contrôle sur le cluster. S'il n'existe aucun élément plan de contrôle, asmcli installe Cloud Service Mesh. Si le cluster comporte un un plan de contrôle existant (un plan de contrôle Cloud Service Mesh ou un plan de contrôle plan de contrôle Istio):

    • Si l'étiquette de révision sur le plan de contrôle existant ne correspond pas au étiquette de révision du nouveau plan de contrôle, asmcli effectue une mise à niveau Canary.

    • Si les étiquettes de révision du plan de contrôle sont identiques, asmcli effectue une mise à jour mise à niveau.

  • La plupart des options et indicateurs asmcli se comportent de la même manière que ceux de install_asm.

Effectuer la transition depuis istioctl install

Si vous connaissez bien istioctl install, si vous transmettez normalement une valeur le fichier YAML IstioOperator à l'aide de l'argument de ligne de commande -f pour configurer plan de contrôle, vous pouvez transmettre le fichier à asmcli à l'aide de la commande --custom_overlay . Dans la documentation Cloud Service Mesh, ces fichiers sont appelés "superpositions" .

Plates-formes compatibles

Installations Cloud Service Mesh dans la liste Vous pouvez configurer des plates-formes compatibles ou mises à niveau d'ici le asmcli.

Cependant, toutes les fonctionnalités ne sont pas disponibles sur les plates-formes externes à Google Cloud. Pour en savoir plus, consultez la page Fonctionnalités compatibles avec le plan de contrôle au sein du cluster.

Étape suivante