Informazioni su asmcli

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

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

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

Successivamente, asmcli configura i file YAML con le tue informazioni relative a progetto e cluster. Questi file di configurazione sono necessari per installare il piano di controllo di Anthos Service Mesh.

Se non hai mai utilizzato Anthos Service Mesh e Istio, vai direttamente alle piattaforme supportate. La sezione successiva intende aiutare l'upgrade di Anthos Service Mesh esistente a 1.16.

Transizione a asmcli

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

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

Transizione da install_asm

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

• Utilizzi asmcli install per nuove installazioni e upgrade. Non esiste un'opzione --mode come con install_asm. Quando esegui asmcli install, controlla se nel cluster è presente un piano di controllo esistente. Se non è presente un piano di controllo esistente, asmcli installa Anthos Service Mesh. Se il cluster ha un piano di controllo esistente (un piano di controllo Anthos Service Mesh o un piano di controllo Istio open source):

  • Se l'etichetta di revisione nel piano di controllo esistente non corrisponde a quella per il nuovo piano di controllo, asmcli esegue un upgrade canary.

  • Se le etichette di revisione del piano di controllo sono uguali, asmcli esegue un upgrade in loco.

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

Transizione da istioctl install

Se hai dimestichezza con istioctl install, se normalmente trasferisci un file YAML IstioOperator tramite 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 Anthos Service Mesh, questi file vengono chiamati file overlay.

Nota: per impostazione predefinita, asmcli non installa un gateway in entrata con il piano di controllo. Per i deployment in produzione, consigliamo di installare i gateway separatamente. Per ulteriori informazioni e best practice, consulta Installare ed eseguire l'upgrade dei gateway. Per aiutarti a iniziare, abbiamo fornito i file di configurazione di esempio per Deployment, Service, ServiceAccount e Role nel repository anthos-service-mesh per i gateway sia in entrata che in uscita. Puoi eseguirne il deployment così com'è o personalizzarlo in base alle esigenze.

Piattaforme supportate

Le installazioni di Anthos Service Mesh nell'elenco delle piattaforme supportate possono essere configurate o aggiornate da asmcli.

Tuttavia, non tutte le funzionalità sono disponibili sulle piattaforme esterne a Google Cloud. Per i dettagli, consulta Funzionalità supportate dal piano di controllo nel cluster.

Passaggi successivi

• Prerequisiti