Informazioni su asmcli

asmcli è uno strumento fornito da Google che puoi utilizzare per installare 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 (Gestione di identità e accessi) 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.
  • Creare un account di servizio che consenta ai componenti del piano dati di eseguire il piano dati, come proxy sidecar, puoi accedere in modo sicuro ai dati e alle risorse del progetto.
  • Registra il cluster al parco risorse, se non è già registrato.

Includi 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 il riferimento 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 prossima sezione intende per facilitare l'upgrade dell'attuale Cloud Service Mesh a 1.19.

Transizione a asmcli

asmcli prende il posto di 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 flotta. Consulta: Requisiti del parco risorse per maggiori dettagli.

Transizione da install_asm

Se conosci install_asm, asmcli è simile ma con alcune differenze significative:

  • Utilizzi asmcli install per le nuove installazioni e gli upgrade. Non esiste un'opzione --mode come per install_asm. Quando esegui asmcli install, controlla se esiste già un piano di controllo sul cluster. 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):

    • Se l'etichetta di revisione sul piano di controllo esistente non corrisponde alla con l'etichetta di revisione del nuovo piano di controllo, asmcli esegue una upgrade canary.

    • Se le etichette di revisione del piano di controllo sono identiche, asmcli esegue una upgrade.

  • 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 al di fuori di Google Cloud. Per maggiori dettagli, vedi Funzionalità supportate dal piano di controllo in-cluster.

Passaggi successivi