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.12.

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):

  • 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.

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.

Aviso: por padrão, o asmcli não instala um gateway de entrada com o plano de controle. Para implantações de produção, recomendamos que você instale gateways separadamente. Para mais informações e práticas recomendadas, consulte Instalar e fazer upgrade de gateways. Fornecemos os arquivos de configuração de amostra, implantação, SerficeAccount, e papel no repositório anthos-service-mesh para os gateways de entrada e saída para você começar. É possível implantá-los como estão ou personalizá-los conforme necessário.

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 certificadora do Anthos Service Mesh (AC do Mesh) não é compatível com clusters do Anthos na AWS, Amazon EKS ou Microsoft AKS. Para detalhes, consulte Recursos compatíveis com o plano de controle no cluster.

A seguir

• Pré-requisitos