Sobre o asmcli
O asmcli
é uma ferramenta fornecida pelo Google que pode ser usada para instalar ou
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ê não conhece o Cloud Service Mesh e o Istio, pule 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
. Ainda que
você possa usar as ferramentas legadas no Cloud Service Mesh 1.11, estamos descontinuando
o uso delas e elas não serão mais compatíveis com o 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 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 cominstall_asm
. Quando você executaasmcli install
, ele verifica se há um plano de controle atual no cluster. Se não houver plano de controle, oasmcli
instala o Cloud Service Mesh. Se o cluster tiver 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,
asmcli
fará um upgrade no local.
A maioria das opções e sinalizações
asmcli
se comportam como as deinstall_asm
.
Transição de istioctl install
Se você estiver familiarizado com istioctl install
, se normalmente transmitir um
arquivo YAML IstioOperator
usando o 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 Cloud Service Mesh, chamamos esses arquivos de
.
Plataformas compatíveis
As instalações do Cloud Service Mesh na lista de
plataformas compatíveis podem ser configuradas
ou atualizadas 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.