Sobre o asmcli

O asmcli é um script fornecido pelo Google que pode ser usado para instalar ou fazer upgrade do Anthos Service Mesh. Se você permitir, asmcli configurará o projeto e o cluster da seguinte maneira:

  • Conceda as permissões necessárias de gerenciamento de identidade e acesso (IAM, na sigla em inglês) no seu projeto do Google Cloud.
  • Ative as APIs do Google necessárias no seu projeto do Google Cloud.
  • Definir um identificador no cluster para reconhecer a malha
  • Registre o cluster na frota se ele ainda não estiver registrado.

Basta incluir a sinalização --enable_all ao executar asmcli para permitir que ela configure o projeto e o cluster.

Em seguida, asmcli configura arquivos YAML com as informações do projeto e do cluster. Esses arquivos de configuração são necessários para instalar o plano de controle no cluster do Anthos Service Mesh.

Por padrão, o asmcli não instala um gateway de entrada com o plano de controle. Apesar de ser bom para avaliações e casos de uso simples, acoplar o gateway ao plano de controle dificulta o gerenciamento e o upgrade. Para implantações de produção, recomendamos que você instale gateways separadamente.

O asmcli substitui o istioctl install e o script install_asm.

Se você tem familiaridade com install_asm, asmcli é semelhante, mas com as seguintes diferenças notáveis:

  • Use asmcli install para novas instalações e upgrades. Não há uma opção --mode como com install_asm. Quando você executa asmcli install, ele verifica se há um plano de controle atual no cluster. Se não houver um plano de controle existente, o asmcli instalará o Anthos Service Mesh. Se o cluster tiver um plano de controle existente (um plano de controle do Anthos Service Mesh ou um plano de controle do Istio de código aberto):

    • Se o rótulo de revisão no plano de controle existente não corresponde ao rótulo de revisão do novo plano de controleasmcli faz um upgrade canário.

    • Se os rótulos de revisão do plano de controle forem os mesmos, asmcli fará um upgrade no local.

  • A maioria das opções e sinalizações asmcli se comportam como as de install_asm.

Se você estiver familiarizado com istioctl install, se normalmente transmitir um arquivo YAML IstioOperator por meio do argumento de linha de comando -f para configurar o plano de controle, poderá transmitir o arquivo para asmcli usando a opção --custom_overlay. Na documentação do Anthos Service Mesh, nos referimos a esses arquivos como arquivos de sobreposição.

Com essa visualização, temos documentação para usar o asmcli para instalar o plano de controle no cluster do Anthos Service Mesh nas seguintes plataformas:

  • GKE:

    • Para novas instalações, os clusters podem estar em projetos iguais ou diferentes.

    • Para upgrades, a menos que você tenha usado asmcli na instalação inicial, esta versão de visualização do asmcli não é compatível com o upgrade de clusters que estejam em projetos diferentes. Para fazer upgrade de uma malha de vários projetos, consulte Como fazer upgrade do Anthos Service Mesh no GKE em uma malha de vários projetos.

  • No local: a nova instalação e os upgrades são compatíveis com o GKE on VMware e o Google Distributed Cloud Virtual para Bare Metal

A seguir