Migre do IstioOperator

O plano de controlo gerido não suporta diretamente o IstioOperator para personalização. A migração para o plano de controlo gerido a partir do Cloud Service Mesh requer a conversão manual de um IstioOperator. Esta ferramenta ajuda a reduzir o atrito através da automatização desse processo.

Acerca da ferramenta de migração

A ferramenta de migração avalia de forma não destrutiva o ficheiro IstioOperator fornecido para fazer o seguinte:

  • Verifique se existem problemas de compatibilidade.
  • Converter configurações IstioOperator compatíveis em configurações suportadas pelo plano de controlo gerido, gerando as novas configurações em ficheiros.
  • Gera avisos sobre valores de configuração que entrariam em conflito com os valores predefinidos necessários pelo plano de controlo gerido.
  • Recomendar como usar os ficheiros gerados.

Esta ferramenta não examina os dados nem as configurações dos clusters, nem faz alterações a uma configuração de cluster. Tem de aplicar separadamente todos os ficheiros gerados.

Antes de usar a ferramenta de migração, verifique as limitações nas funcionalidades suportadas do plano de controlo gerido para confirmar que o plano de controlo gerido suporta a sua instalação do Cloud Service Mesh.

Usar a ferramenta de migração

A ferramenta de migração está disponível como parte do script asmcli. Tem de transferir o script para usar esta ferramenta.

  1. Execute a ferramenta de migração:

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

  2. Tome nota dos ficheiros apresentados pela ferramenta, especificamente asm/*meshconfig.yaml e asm/gateways*.

  3. Examine os avisos de configuração.

  4. Reveja o resultado e siga as ações necessárias para migrar.

Campos MeshConfig não suportados

Os seguintes campos em MeshConfig são substituídos pelo plano de controlo gerido.

  • trustDomain
  • trustDomainAliases
  • configSources
  • defaultConfig.proxyMetadata - Estes campos específicos são substituídos. Pode adicionar novos campos:
    • XDS_ROOT_CA
    • CA_ROOT_CA
    • OUTPUT_CERTS
    • XDS_AUTH_PROVIDER
    • PROXY_CONFIG_XDS_AGENT
  • defaultConfig.meshId
  • defaultConfig.discoveryAddress

Exemplo de resultado

$ 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.

O que se segue?