Acerca de la asmcli

asmcli es una herramienta proporcionada por Google que puedes usar para instalar o actualizar Anthos 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.
• Habilita 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 Anthos Service Mesh.

Si eres nuevo en Istio y Anthos Service Mesh, ve a Plataformas compatibles. La siguiente sección está diseñada para ayudar a Anthos Service Mesh existente a actualizar a 1.13.

Transición a asmcli

asmcli reemplaza a istioctl install y install_asm. Aunque aún puedes usar las herramientas heredadas en Anthos Service Mesh 1.11, las darás de baja y ya no serán compatibles con Anthos Service Mesh 1.12 y versiones posteriores. Actualiza tus secuencias de comandos y herramientas para usar asmcli.

Con Anthos Service Mesh 1.11 y versiones posteriores, todos los clústeres se deben registrar 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 existe un plano de control existente, asmcli instala Anthos Service Mesh. Si el clúster tiene un plano de control existente (ya sea un plano de control de Anthos Service Mesh o un plano de control de Istio de código abierto), usa este comando:

  • Si la etiqueta de revisión en el plano de control existente no coincide con la etiqueta de revisión del plano de control nuevo, asmcli realiza unaactualizació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 normalmente pasas un archivo YAML IstioOperator a través del 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 Anthos Service Mesh, nos referimos a estos archivos como archivos superpuestos.

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. Proporcionamos archivos de configuración de implementación, servicio, ServiceAccount y función en el repositorio anthos-service-mesh para las puertas de enlace de entrada y salida a fin de que puedas comenzar. Puedes implementarlas tal como están o personalizarlas según sea necesario.

Plataformas compatibles

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

No todas las funciones están disponibles en las plataformas fuera de Google Cloud. Por ejemplo, la autoridad certificadora de Anthos Service Mesh (CA de Mesh) no es compatible con GKE en AWS, Amazon EKS o Microsoft AKS. Para obtener más información, consulta Funciones compatibles del plano de control en el clúster.

¿Qué sigue?

• Requisitos previos