Sobre o asmcli

O asmcli é uma ferramenta oferecida pelo Google que você pode usar para instalar ou e fazer upgrade do Cloud 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 Cloud Service Mesh.

Se você ainda não conhece o Cloud Service Mesh e o Istio, avance para Plataformas compatíveis. A próxima seção tem como objetivo ajude a fazer upgrade do Cloud Service Mesh atual para 1.23.

Transição para asmcli

O asmcli substitui istioctl install e install_asm. Embora ainda será possível usar as ferramentas legadas no Cloud Service Mesh 1.11, estamos descontinuando elas não terão mais suporte no Cloud Service Mesh 1.12 e versões mais recentes. Atualize seus scripts e ferramentas para usar asmcli.

Com o Cloud Service Mesh 1.11 e mais recente, todos os clusters precisam ser registrados 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 plano de controle, o asmcli instala o Cloud Service Mesh. Se o cluster tiver um plano de controle atual (um plano de controle do Cloud Service Mesh ou um Plano de controle do Istio):

    • Se o rótulo de revisão no plano de controle atual não corresponder ao rótulo de revisão do novo plano de controle, asmcli faz uma upgrade canário.

    • Se os rótulos de revisão do plano de controle forem os mesmos, o asmcli fará uma e fazer o upgrade.

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

Transição de istioctl install

Se você conhece istioctl install, se normalmente transmite um Arquivo YAML IstioOperator usando o argumento de linha de comando -f para configurar o plano de controle, é possível transmitir o arquivo para asmcli usando o método --custom_overlay é a melhor opção. Na documentação do Cloud Service Mesh, chamamos esses arquivos de .

Plataformas compatíveis

instalações do Cloud Service Mesh na lista de É possível configurar plataformas compatíveis ou atualizado por asmcli.

No entanto, nem todos os recursos estão disponíveis nas plataformas fora do Google Cloud. Para detalhes, consulte Recursos compatíveis com o plano de controle no cluster.

A seguir