Instalar a CLI gdcloud

Para instalar e inicializar a CLI do Distributed Cloud, faça o download do pacote da CLI e conclua as etapas a seguir.

Adicionar o diretório bin da CLI gdcloud ao caminho

O Google recomenda adicionar o diretório bin da CLI gdcloud ao seu caminho.

Quando o diretório bin é adicionado ao seu caminho:

  • Não será necessário especificar toda a estrutura de diretórios em cada comando.
  • Os componentes cruciais da CLI gdcloud são instalados no diretório bin, que permite que comandos como gdcloud components funcionem corretamente.

Adicione o diretório bin da CLI gdcloud ao seu caminho:

eval echo 'export GDCLOUD_PATH=$(pwd)/google-distributed-cloud-hosted-cli' >> ~/.bashrc
echo 'export PATH="$GDCLOUD_PATH/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Inicializar a configuração padrão da CLI gdcloud

Inicialize a configuração padrão da CLI gdcloud:

gdcloud init

Siga as instruções para inicializar a configuração. Você precisa fornecer duas propriedades para concluir a inicialização:

  • organization_console_url: o URL do console da sua organização atual do GDC. Esse URL pode ser global ou zonal:

    • Para um URL de console global, use a sintaxe https://console.ORG_NAME.SUFFIX, como https://console.org-1.gdch.google.com.
    • Para um URL de console zonal, use a sintaxe https://console.ORG_NAME.ZONE.SUFFIX, como https://console.org-1.zone-1.gdch.google.com.

    Entre em contato com o operador de infraestrutura ou o administrador da plataforma se você não souber o URL do console da sua organização. Se você estiver testando a CLI gdcloud no sandbox do Google Distributed Cloud, consulte as instruções de configuração da CLI do sandbox do GDC para encontrar o URL do console da sua instância.

  • project: o nome do seu projeto atual do GDC.

Veja essas propriedades usando o comando gdcloud config list.

Gerenciar componentes da CLI gdcloud

Os componentes são partes instaláveis da CLI do GDC. A CLI gdcloud é instalada por padrão. Liste, instale e atualize os componentes da CLI gdcloud conforme necessário.

Listar componentes

Confira a lista atual de componentes disponíveis:

gdcloud components list

Instalar componentes

Instale um componente na versão atual da instalação da CLI gdcloud:

gdcloud components install COMPONENT_ID

Por exemplo, este comando instala o componente kubectl:

gdcloud components install kubectl

Atualizar componentes

Para atualizar todos os componentes do GDC para a versão mais recente da CLI gdcloud, consulte Fazer upgrade para a CLI gdcloud mais recente.