Migrar desde IstioOperador

El plano de control gestionado no admite directamente IstioOperator para la personalización. Para migrar al plano de control gestionado desde Cloud Service Mesh, debes convertir manualmente un IstioOperator. Esta herramienta ayuda a reducir la fricción automatizando ese proceso.

Acerca de la herramienta de migración

La herramienta de migración evalúa de forma no destructiva el archivo IstioOperator proporcionado para hacer lo siguiente:

  • Comprueba si hay problemas de compatibilidad.
  • Convierte las configuraciones de IstioOperator compatibles en configuraciones admitidas por el plano de control gestionado y genera las nuevas configuraciones en archivos.
  • Muestra advertencias sobre los valores de configuración que entrarían en conflicto con los valores predeterminados que requiere el plano de control gestionado.
  • Recomienda cómo usar los archivos generados.

Esta herramienta no examina los datos ni las configuraciones de los clústeres, ni tampoco hace cambios en la configuración de un clúster. Debe aplicar por separado todos los archivos generados.

Antes de usar la herramienta de migración, consulta las limitaciones de las funciones compatibles con el plano de control gestionado para verificar que el plano de control gestionado sea compatible con tu instalación de Cloud Service Mesh.

Usar la herramienta de migración

La herramienta de migración está disponible como parte de la secuencia de comandos asmcli. Para usar esta herramienta, debes descargar la secuencia de comandos.

  1. Ejecuta la herramienta de migración:

    asmcli experimental mcp-migrate-check -f path/to/istiooperator.yaml

  2. Toma nota de los archivos que genera la herramienta, en concreto asm/*meshconfig.yaml y asm/gateways*.

  3. Examina las advertencias de configuración.

  4. Revisa el resultado y sigue los pasos necesarios para completar la migración.

Campos MeshConfig no admitidos

El plano de control gestionado anula los siguientes campos de MeshConfig.

  • trustDomain
  • trustDomainAliases
  • configSources
  • defaultConfig.proxyMetadata: se anulan estos campos específicos. Puedes añadir campos nuevos:
    • XDS_ROOT_CA
    • CA_ROOT_CA
    • OUTPUT_CERTS
    • XDS_AUTH_PROVIDER
    • PROXY_CONFIG_XDS_AGENT
  • defaultConfig.meshId
  • defaultConfig.discoveryAddress

Ejemplo

$ asmcli experimental mcp-migrate-check -f some-iop.yaml
asmcli: Downloading ASM..
Generating equivalent configuration for Anthos Service Mesh managed control plane...

Migrating MeshConfig settings...
✔ Wrote MeshConfig to asm-generated-configs/meshconfig.yaml.

Migrating gateway deployments...

Checking configuration compatibility...
! Found unsupported configurations:
    Components.Base: not configurable in managed control plane
    Components.Pilot: not configurable in managed control plane
    Hub=gcr.io/gke-release/asm: not configurable in managed control plane
    Tag=1.10.4-asm.6: not configurable in managed control plane

Actions required to migrate:
! Found potentially unsupported configurations; review warnings above before proceeding
- Found custom mesh configuration settings. To apply these settings to ASM managed
    control plane, run: `kubectl apply -f 'asm-generated-configs/meshconfig.yaml'`

TIP: steps recommending `kubectl apply` to be run should be integrated into your
  CI/CD pipeline, if applicable.

Siguientes pasos