Información sobre el asmcli

asmcli es una herramienta proporcionada por Google que puedes usar para instalar o actualizar Cloud Service Mesh. Si lo permites, asmcli configurará tu proyecto y tu clúster de la siguiente manera:

  • Concederte los permisos de gestión de identidades y accesos (IAM) necesarios en tuGoogle Cloud proyecto.
  • Habilita las APIs de Google necesarias en tu Google Cloud proyecto.
  • Define una etiqueta en el clúster que identifique la malla.
  • Crea una cuenta de servicio que permita a los componentes del plano de datos, como el proxy sidecar, acceder de forma segura a los datos y recursos de tu proyecto.
  • Registra el clúster en la flota si aún no lo has hecho.

Solo tienes que incluir la marca --enable_all al ejecutar asmcli para que configure tu proyecto y tu clúster. Para obtener más información sobre las opciones y las marcas de asmcli, consulta la referencia de asmcli.

A continuación, asmcli configura los archivos YAML con la información de tu proyecto y clúster. Estos archivos de configuración son necesarios para instalar el plano de control de Cloud Service Mesh.

Si no conoces Cloud Service Mesh e Istio, ve a la sección Plataformas compatibles. En la siguiente sección se explica cómo actualizar a 1.19si ya usas Cloud Service Mesh.

Cambiando a asmcli

El asmcli sustituye a istioctl install y install_asm. Aunque puedes seguir usando las herramientas antiguas en Cloud Service Mesh 1.11, vamos a dejar de ofrecerlas y ya no se admitirán en Cloud Service Mesh 1.12 ni en versiones posteriores. Actualiza tus secuencias de comandos y herramientas para usar asmcli.

Con Cloud Service Mesh 1.11 y versiones posteriores, todos los clústeres deben registrarse en una flota. Para obtener más información, consulta los requisitos de la flota.

Cambiar de install_asm

Si ya conoces install_asm, asmcli es similar, pero con las siguientes diferencias notables:

  • Utiliza asmcli install para las nuevas instalaciones y actualizaciones. No hay una opción --mode como en el caso de install_asm. Cuando ejecutas asmcli install, se comprueba si hay un plano de control en el clúster. Si no hay ningún plano de control, asmcli instala Cloud Service Mesh. Si el clúster tiene un plano de control (ya sea un plano de control de Cloud Service Mesh o un plano de control de Istio de código abierto):

    • Si la etiqueta de revisión del plano de control actual no coincide con la etiqueta de revisión del nuevo plano de control, asmcli realiza una actualización canary.

    • Si las etiquetas de revisión del plano de control son las mismas, asmcli realiza una actualización in situ.

  • La mayoría de las asmcli opciones y las marcas se comportan igual que las de install_asm.

Cambiar de istioctl install

Si conoces istioctl install y normalmente pasas un archivo YAML de IstioOperator mediante el argumento de línea de comandos -f para configurar el plano de control, puedes pasar el archivo a asmcli mediante la opción --custom_overlay. En la documentación de Cloud Service Mesh, nos referimos a estos archivos como archivos de superposición.

Plataformas compatibles

Las instalaciones de Cloud Service Mesh en la lista de plataformas admitidas se pueden configurar o actualizar mediante asmcli.

Sin embargo, no todas las funciones están disponibles en las plataformas que no son de Google Cloud. Para obtener más información, consulta Funciones admitidas del plano de control en el clúster.

Siguientes pasos