Acerca de la asmcli

asmcli es una herramienta que proporciona Google 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 eres nuevo en Istio y Cloud Service Mesh, pasa a las Plataformas compatibles. La siguiente sección está diseñada para ayudar a que Cloud Service Mesh se actualice a 1.18.

Transición a asmcli

asmcli reemplaza a istioctl install y install_asm. Aunque aún puedes usar las herramientas heredadas en Cloud Service Mesh 1.11, las daremos de baja y ya no serán compatibles con Cloud Service Mesh 1.12 y 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 uno de código abierto de Istio), haz lo siguiente:

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

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

• 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 sueles pasar 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.

Nota: De forma predeterminada, asmcli no instala una puerta de enlace de entrada con el plano de control. Para las implementaciones de producción, recomendamos que instales puertas de enlace por separado. Para obtener más información y prácticas recomendadas, consulta Instala y actualiza puertas de enlace. Para comenzar, proporcionamos archivos de muestra de configuración de Deployment, Service, ServiceAccount y Role en el repositorio anthos-service-mesh para puertas de enlace de entrada y salida. Puedes implementarlas tal como están o personalizarlas según sea necesario.

Plataformas compatibles

Las instalaciones de Cloud Service Mesh que se encuentran en la lista de Plataformas compatibles se pueden configurar o actualizar con 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?

• Requisitos previos