Migrazione da IstioOperator

Anteprima — strumento di migrazione

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Il control plane gestito non supporta direttamente IstioOperator per la personalizzazione. La migrazione al control plane gestito da Cloud Service Mesh richiede la conversione manuale da un IstioOperator. Questo strumento contribuisce a ridurre le difficoltà automatizzando la procedura.

Informazioni sullo strumento di migrazione

Lo strumento di migrazione valuta in modo non distruttivo il file IstioOperator fornito per eseguire le seguenti operazioni:

• Verifica la presenza di problemi di compatibilità.
• Converte le configurazioni IstioOperator compatibili nella configurazione supportata dal control plane gestito, generando i nuovi file di configurazione.
• Genera avvisi sui valori di configurazione che potrebbero essere 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 a una configurazione del cluster. Devi applicare separatamente tutti i file generati.

Prima di utilizzare lo strumento di migrazione, controlla le limitazioni delle funzionalità supportate dal control plane gestito per verificare che il control plane gestito supporti l'installazione di Cloud Service Mesh.

Utilizzare lo strumento di migrazione

Avviso: gli strumenti GitOps (inclusi Config Sync, Argo CD, Terraform, e Jenkins) potrebbero interferire con i processi di installazione, migrazione o upgrade di Cloud Service Mesh. Per risultati ottimali, disattiva gli strumenti GitOps prima di installare, eseguire la migrazione o l'upgrade di Cloud Service Mesh.

Lo strumento di migrazione è disponibile come parte dello script asmcli. Devi scaricare 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. Esamina gli avvisi di configurazione.

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

Campi MeshConfig non supportati

I seguenti campi di MeshConfig vengono sostituiti dal control plane gestito.

Nota: questo elenco di campi è soggetto a modifiche.

• 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

• Scopri di più sulle funzionalità supportate dal control plane gestito