Informazioni su asmcli

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

  • Concederti le autorizzazioni IAM (Identity and Access Management) necessarie per il tuo progetto Google Cloud.
  • Abilita le API di Google richieste nel tuo progetto Google Cloud.
  • Imposta un'etichetta sul cluster che identifica il mesh.
  • Registra il cluster nel parco risorse, se non è già registrato.

È sufficiente includere il flag --enable_all quando esegui asmcli per consentire la configurazione del progetto e del cluster.

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

Per impostazione predefinita, asmcli non installa un gateway in entrata con il piano di controllo. Sebbene sia consentito per la valutazione e i casi d'uso semplici, l'accoppiamento del gateway al piano di controllo rende la gestione e l'upgrade più complicati. Per i deployment in produzione, ti consigliamo di installare i gateway separatamente.

asmcli sostituisce istioctl install e lo script install_asm.

Se conosci install_asm, asmcli è simile ma con 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, questo controllo verifica se nel cluster è già presente un piano di controllo. Se non esiste un piano di controllo, 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 sul piano di controllo esistente non corrisponde all'etichetta di revisione del nuovo piano, 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 opzioni e dei flag di asmcli si comporta come quelli di install_asm.

Se hai familiarità con istioctl install, se di solito passi 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 definiti file di overlay.

Con questa anteprima, è disponibile la documentazione per l'utilizzo di asmcli per l'installazione del piano di controllo in-cluster Anthos Service Mesh sulle seguenti piattaforme:

  • GKE:

    • Per le nuove installazioni, i cluster possono trovarsi nello stesso progetto o in progetti diversi.

    • Per gli upgrade, a meno che tu non abbia utilizzato asmcli per l'installazione iniziale, questa release di anteprima di asmcli non supporta l'upgrade dei cluster che si trovano in progetti diversi. Per eseguire l'upgrade di un mesh multiprogetto, consulta Upgrade di Anthos Service Mesh su GKE in un mesh multiprogetto.

  • On-premise: la nuova installazione e gli upgrade sono supportati su GKE su VMware e Google Distributed Cloud Virtual for Bare Metal

Passaggi successivi