Migrazione da IstioOperator

Il piano di controllo gestito non supporta direttamente IstioOperator per personalizzazione. La migrazione al piano di controllo gestito da Cloud Service Mesh richiede la conversione manuale da un IstioOperator. Questo strumento riduce l'attrito automatizzando questo processo.

Informazioni sullo strumento di migrazione

Lo strumento di migrazione valuta in modo non distruttivo il file IstioOperator fornito per:

  • Controlla se ci sono problemi di compatibilità.
  • Converti le configurazioni IstioOperator compatibili in configurazioni supportate dal piano di controllo gestito, esportando le nuove configurazioni in file.
  • Mostra avvisi sui valori di configurazione in conflitto con i valori predefiniti richiesti dal control plane gestito.
  • Consiglia come utilizzare i file generati.

Questo strumento non esamina i dati o le configurazioni del cluster né apporta modifiche alla configurazione di un cluster. Devi applicare separatamente tutti i file generati.

Prima di utilizzare lo strumento di migrazione, verifica le limitazioni funzionalità supportate dal piano di controllo gestito per verificare che il piano di controllo gestito supporti l'installazione di Cloud Service Mesh.

Utilizzo dello strumento di migrazione

Lo strumento di migrazione è disponibile nell'ambito dello script asmcli. Devi scarica lo script per utilizzare questo strumento.

  1. Esegui lo strumento di migrazione:

    asmcli experimental mcp-migrate-check -f path/to/istiooperator.yaml
    
  2. Prendi nota dei file elencati generati dallo strumento, in particolare asm/*meshconfig.yaml e asm/gateways*.

  3. Esaminare gli avvisi di configurazione.

  4. Esamina l'output e segui le azioni necessarie per la migrazione.

Campi MeshConfig non supportati

I seguenti campi di MeshConfig vengono sostituiti dal piano di controllo gestito.

  • trustDomain
  • trustDomainAliases
  • configSources
  • defaultConfig.proxyMetadata: questi campi specifici vengono sostituiti. Puoi aggiungere nuovi campi:
    • XDS_ROOT_CA
    • CA_ROOT_CA
    • OUTPUT_CERTS
    • XDS_AUTH_PROVIDER
    • PROXY_CONFIG_XDS_AGENT
  • defaultConfig.meshId
  • defaultConfig.discoveryAddress

Output di esempio

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

Passaggi successivi