Acerca da asmcli

O asmcli é uma ferramenta fornecida pela Google que pode usar para instalar ou atualizar o Cloud Service Mesh. Se o permitir, o asmcli vai configurar o seu projeto e cluster da seguinte forma:

  • Conceder-lhe as autorizações da gestão de identidade e de acesso (IAM) necessárias no seu Google Cloud projeto.
  • Ative as APIs Google necessárias no seu Google Cloud projeto.
  • Defina uma etiqueta no cluster que identifique a malha.
  • Crie uma conta de serviço que permita que os componentes do plano de dados, como o proxy sidecar, acedam de forma segura aos dados e recursos do seu projeto.
  • Registe o cluster na frota, se ainda não estiver registado.

Basta incluir a flag --enable_all quando executar asmcli para permitir que configure o seu projeto e cluster. Para mais informações sobre as asmcliopções e as flags, consulte a asmcli referência.

Em seguida, asmcli configura os ficheiros YAML com as informações do projeto e do cluster. Estes ficheiros de configuração são necessários para instalar o plano de controlo da Cloud Service Mesh.

Se não conhece o Cloud Service Mesh nem o Istio, avance para a secção Plataformas suportadas. A secção seguinte destina-se a ajudar os utilizadores do Cloud Service Mesh a atualizarem para o 1.19.

A fazer a transição para asmcli

O asmcli substitui istioctl install e install_asm. Embora ainda possa usar as ferramentas antigas no Cloud Service Mesh 1.11, vamos descontinuá-las e deixarão de ser suportadas no Cloud Service Mesh 1.12 e posterior. Atualize os seus scripts e ferramentas para usar asmcli.

Com o Cloud Service Mesh 1.11 e posterior, todos os clusters têm de estar registados numa frota. Consulte os requisitos da frota para ver detalhes.

Transição de install_asm

Se conhece o install_asm, o asmcli é semelhante, mas com as seguintes diferenças notáveis:

  • Usa o asmcli install para novas instalações e atualizações. Não existe uma opção --mode como com o install_asm. Quando executa asmcli install, verifica se existe um plano de controlo no cluster. Se não existir um plano de controlo, o asmcli instala o Cloud Service Mesh. Se o cluster tiver um plano de controlo existente (um plano de controlo do Cloud Service Mesh ou um plano de controlo do Istio de código aberto):

    • Se a etiqueta de revisão no plano de controlo existente não corresponder à etiqueta de revisão do novo plano de controlo, o asmcli faz uma atualização canária.

    • Se as etiquetas de revisão do plano de controlo forem iguais, o asmcli faz uma atualização no local.

  • A maioria das asmcli opções e flags comporta-se da mesma forma que as do install_asm.

Transição de istioctl install

Se tiver familiaridade com o istioctl install, se normalmente transmitir um ficheiro YAMLIstioOperator usando o argumento de linha de comandos -f para configurar o plano de controlo, pode transmitir o ficheiro para asmcli usando a opção --custom_overlay. Na documentação do Cloud Service Mesh, referimo-nos a estes ficheiros como ficheiros de sobreposição.

Plataformas suportadas

As instalações do Cloud Service Mesh na lista de plataformas suportadas podem ser configuradas ou atualizadas por asmcli.

No entanto, nem todas as funcionalidades estão disponíveis nas plataformas fora do Google Cloud. Para ver detalhes, consulte o artigo Funcionalidades suportadas do plano de controlo no cluster.

O que se segue?