Migre do IstioOperator

Pré-visualização — Migration tool

Esta funcionalidade está sujeita aos "Termos das Ofertas de Pré-DG" na secção Termos Gerais de Serviço dos Termos Específicos do Serviço. As funcionalidades de pré-DG estão disponíveis "tal como estão" e podem ter apoio técnico limitado. Para mais informações, consulte as descrições das fases de lançamento.

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

Aviso: as ferramentas GitOps (incluindo Config Sync, Argo CD, Terraform e Jenkins) podem interferir com os processos de instalação, migração ou atualização do Cloud Service Mesh. Para obter os melhores resultados, desative as ferramentas GitOps antes de instalar, migrar ou atualizar o Cloud Service Mesh.

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.

Nota: esta lista de campos está sujeita a alterações.

• 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?

• Saiba mais sobre as funcionalidades suportadas do plano de controlo gerido