Migrar do IstioOperator
O plano de controle gerenciado não é compatível diretamente com IstioOperator
para
personalização. A migração do Cloud Service Mesh para o plano de controle gerenciado exige
convertendo manualmente de um IstioOperator
. Essa ferramenta ajuda a reduzir o atrito
automatizando esse processo.
Sobre a ferramenta de migração
A ferramenta de migração avalia de forma não destrutiva o arquivo IstioOperator
fornecido
faça o seguinte:
- Verifique se há problemas de compatibilidade.
- Converta configurações
IstioOperator
compatíveis para uma configuração compatível com o plano de controle gerenciado. Isso gera as novas configurações em arquivos. - Avisos de saída sobre valores de configuração que entrariam em conflito com os valores padrão exigidos pelo plano de controle gerenciado.
- Recomende como usar os arquivos gerados.
Essa ferramenta não examina dados ou configurações de cluster, nem faz alterações em uma configuração de cluster. Aplique separadamente todos os arquivos gerados.
Antes de usar a ferramenta de migração, verifique as limitações recursos compatíveis com o plano de controle gerenciado para verificar se o plano de controle gerenciado oferece suporte à instalação do Cloud Service Mesh.
Como usar a ferramenta de migração
A ferramenta de migração está disponível como parte do script asmcli
. É necessário fazer o download do script para usar essa ferramenta.
Execute a ferramenta de migração:
asmcli experimental mcp-migrate-check -f path/to/istiooperator.yaml
Observe a saída dos arquivos listados pela ferramenta, especificamente
asm/*meshconfig.yaml
easm/gateways*
.Examine os avisos de configuração.
Analise o resultado e siga as ações necessárias para a migração.
Campos MeshConfig não compatíveis
Os campos a seguir no MeshConfig são modificados pelo plano de controle gerenciado.
trustDomain
trustDomainAliases
configSources
defaultConfig.proxyMetadata
: esses campos específicos são modificados. É possível adicionar novos campos:XDS_ROOT_CA
CA_ROOT_CA
OUTPUT_CERTS
XDS_AUTH_PROVIDER
PROXY_CONFIG_XDS_AGENT
defaultConfig.meshId
defaultConfig.discoveryAddress
Exemplo de saída
$ 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.
A seguir
- Saiba mais sobre os recursos compatíveis com o plano de controle gerenciado