Acerca de la 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:

  • Otorga los permisos de Identity and Access Management (IAM) necesarios en tu proyecto de Google Cloud.
  • Habilitar las APIs de Google necesarias en tu proyecto de Google Cloud
  • Configurará una etiqueta en el clúster que identifique la malla.
  • Crea una cuenta de servicio que permita que los componentes del plano de datos, como el proxy de sidecar, accedan a los datos y recursos del proyecto de forma segura.
  • Registra el clúster en la flota si aún no está registrado.

Solo incluye la marca --enable_all cuando ejecutes asmcli para permitir que configure tu proyecto y clúster. Para obtener más información sobre las opciones y marcas 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 es la primera vez que usas Istio y Cloud Service Mesh, ve a Plataformas compatibles. La siguiente sección se diseñó para ayudar a que Cloud Service Mesh se actualice a .

Transición a asmcli

asmcli reemplaza a istioctl install y install_asm. Aunque aún puedes usar las herramientas heredadas de Cloud Service Mesh 1.11, las daremos de baja y ya no serán compatibles con Cloud Service Mesh 1.12 ni 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. Consulta Requisitos de las flotas para obtener más detalles.

Transición desde install_asm

Si estás familiarizado con install_asm, asmcli es similar, pero con las siguientes diferencias notables:

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

    • Si la etiqueta de revisión del plano de control existente no coincide con la etiqueta de revisión del plano de control nuevo, asmcli realiza una actualización de versió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 opciones y marcas de asmcli se comportan de la misma manera que las para install_asm.

Transición desde istioctl install

Si estás familiarizado con istioctl install, si en general pasas un archivo YAML IstioOperator con el argumento de línea de comandos -f para configurar el plano de control, puedes pasar el archivo a asmcli con 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

El asmcli puede configurar o actualizar las instalaciones de Cloud Service Mesh de la lista de plataformas compatibles.

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

¿Qué sigue?