Sobre o asmcli

O asmcli é uma ferramenta fornecida pelo Google que pode ser usada 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
  • Crie uma conta de serviço que permita que os componentes do plano de dados, como o proxy sidecar, acessem com segurança os dados e os recursos do seu projeto.
  • 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. Para mais informações sobre as opções e sinalizações do asmcli, consulte a referência do asmcli.

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 do Anthos Service Mesh.

Se você for novo no Anthos Service Mesh e no Istio, pule para Plataformas compatíveis. A próxima seção ajuda a fazer o upgrade do Anthos Service Mesh para 1.11.

Transição para asmcli

O asmcli substitui istioctl install e install_asm. Ainda que você possa usar as ferramentas legadas no Anthos Service Mesh 1.11, estamos suspendendo o uso delas e elas não serão mais compatíveis com o Anthos Service Mesh 1.12 e versões mais recentes. Atualize seus scripts e ferramentas para usar asmcli.

Com o Anthos Service Mesh 1.11 e versões mais recentes, todos os clusters precisam ser registrados em uma frota. Consulte os requisitos da frota para mais detalhes.

Transição de 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):

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

Transição de istioctl install

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.

Plataformas com suporte

As instalações do Anthos Service Mesh na lista de plataformas compatíveis podem ser configuradas ou atualizadas por asmcli.

Nem todos os recursos estão disponíveis nas plataformas fora do Google Cloud. Por exemplo, a autoridade de certificação do Anthos Service Mesh (CA da malha) não é compatível com o GKE na AWS ou no Amazon EKS. Para detalhes, consulte Recursos compatíveis com o plano de controle no cluster.

A seguir