Informazioni su asmcli

asmcli è uno strumento fornito da Google che puoi utilizzare per installare o eseguire l'upgrade di Cloud Service Mesh. Se lo consenti, asmcli configurerà il progetto e il cluster nel seguente modo:

  • Ti concede le autorizzazioni IAM (Identity and Access Management) necessarie per il tuo progetto Google Cloud.
  • Abilita le API Google richieste nel tuo progetto Google Cloud.
  • Imposta un'etichetta sul cluster che identifichi il mesh.
  • Crea un account di servizio che consenta ai componenti del piano dati, come il proxy sidecar, di accedere in modo sicuro ai dati e alle risorse del tuo progetto.
  • Registra il cluster nel parco risorse se non è già registrato.

Basta includere il flag --enable_all quando esegui asmcli per consentire la configurazione del progetto e del cluster. Per ulteriori informazioni sulle opzioni e sui flag asmcli, consulta la documentazione di riferimento di asmcli.

Successivamente, asmcli configura i file YAML con le informazioni del progetto e del cluster. Questi file di configurazione sono necessari per installare il control plane di Cloud Service Mesh.

Se non hai dimestichezza con Cloud Service Mesh e Istio, vai a Piattaforme supportate. La sezione successiva è intesa per aiutare a eseguire l'upgrade a 1.19di Cloud Service Mesh esistente.

Transizione a asmcli

asmcli sostituisce istioctl install e install_asm. Anche se puoi ancora utilizzare gli strumenti precedenti in Cloud Service Mesh 1.11, li stiamo ritirando e non saranno più supportati in Cloud Service Mesh 1.12 e versioni successive. Aggiorna gli script e gli strumenti per utilizzare asmcli.

Con Cloud Service Mesh 1.11 e versioni successive, tutti i cluster devono essere registrati in un parco risorse. Per maggiori dettagli, consulta i Requisiti del parco veicoli.

Transizione da install_asm

Se conosci install_asm, asmcli è simile, ma presenta le seguenti differenze sostanziali:

  • Utilizzi asmcli install per nuove installazioni e upgrade. Non esiste un'opzione --mode come per install_asm. Quando esegui asmcli install, viene controllato se sul cluster è già presente un control plane. Se non esiste un control plane, asmcli installa Cloud Service Mesh. Se il cluster ha un piano di controllo esistente (un piano di controllo Cloud Service Mesh o un piano di controllo Istio open source):

    • Se l'etichetta di revisione del piano di controllo esistente non corrisponde all'etichetta di revisione del nuovo piano di controllo, asmcli esegue un upgrade canary.

    • Se le etichette delle revisioni del piano di controllo sono uguali, asmcli esegue un upgrade in situ.

  • La maggior parte delle opzioni e dei flag di asmcli si comporta come quelle di install_asm.

Transizione da istioctl install

Se hai dimestichezza con istioctl install e di solito passi un IstioOperator file YAML utilizzando l'argomento della riga di comando -f per configurare il piano di controllo, puoi passare il file a asmcli utilizzando l'opzione --custom_overlay. Nella documentazione di Cloud Service Mesh, ci riferiamo a questi file come file di overlay.

Piattaforme supportate

Le installazioni di Cloud Service Mesh nell'elenco delle piattaforme supportate possono essere configurate o sottoposte ad upgrade entro il giorno asmcli.

Tuttavia, non tutte le funzionalità sono disponibili sulle piattaforme esterne a Google Cloud. Per maggiori dettagli, consulta Funzionalità supportate dal control plane in cluster.

Passaggi successivi