Acerca de la asmcli

asmcli es una herramienta de 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
  • Configura 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, pasa a los siguientes pasos: Plataformas compatibles. La siguiente sección tiene como objetivo ayudar a actualizar Cloud Service Mesh existente a 1.23.

Transición a asmcli

asmcli reemplaza a istioctl install y install_asm. Si bien aún puedes usar las herramientas heredadas en Cloud Service Mesh 1.11, 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 un 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, 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):

    • Si la etiqueta de revisión del plano de control existente no coincide 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 acción actualización.

  • 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 conoces istioctl install, si sueles pasar un archivo YAML IstioOperator con el argumento de línea de comandos -f para configurar la plano de control, puedes pasar el archivo a asmcli con el --custom_overlay de 12 a 1 con la nueva opción de compresión. En la documentación de la malla de servicios de Cloud, nos referimos a estos archivos como superposiciones archivos.

Plataformas compatibles

instalaciones de Cloud Service Mesh en la lista de Se pueden configurar las plataformas compatibles. o antes del asmcli.

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?