Configure a CLI gcloud

Esta página contém uma vista geral da CLI Distributed Cloud e instruções sobre como a transferir e configurar para utilização com a GDC Sandbox.

Vista geral da CLI gdcloud

A CLI gdcloud é um conjunto de ferramentas para criar e gerir recursos isolados do Google Distributed Cloud (GDC). Está disponível apenas para Linux. Use estas ferramentas para realizar tarefas comuns a partir da linha de comandos ou através de scripts e automatização. Pode usar a CLI gdcloud para iniciar a infraestrutura, gerir a autenticação e personalizar as configurações locais. Tenha em atenção que isto é diferente da gcloudCLI usada para gerir Google Cloud.

Esta página contém instruções simplificadas específicas da GDC Sandbox. Para mais detalhes sobre a CLI gdcloud em geral, incluindo configuração, atualização, preenchimento automático e acessibilidade, consulte a documentação GDC air-gapped gdcloud.

Transfira a CLI gcloud

Siga estas instruções se estiver a estabelecer ligação à área de testes do GDC através do sshuttle. Se estiver a estabelecer ligação ao gateway da sua instância através do ambiente de trabalho remoto, não precisa de transferir a ferramenta, uma vez que o gdcloud está pré-instalado na máquina do gateway no caminho /usr/share/gdcloud.

  1. Transfira o pacote da CLI gdcloud a partir da consola da GDC.
    1. Navegue para a consola do GDC conforme descrito em Estabeleça ligação à sua instância.
    2. Navegue para a secção Estabeleça ligação com a CLI.
    3. Clique em Transferir pacote da CLI.

  2. Numa janela de terminal, extraia o pacote da CLI:

    cd ~/Downloads
tar -xf gdcloud_cli.tar.gz

  3. Adicione a gdcloudCLI ao seu PATH para não ter de especificar a localização com todos os comandos. O comando seguinte pressupõe que o pacote da CLI foi transferido e extraído para o diretório Downloads do utilizador e que o perfil da shell do utilizador está localizado em ~/.bashrc.

    echo 'export PATH=$PATH:~/Downloads/google-distributed-cloud-hosted-cli/bin' >> ~/.bashrc
source ~/.bashrc

  4. Abra um novo terminal e execute gdcloud version para confirmar que o comando funcionou.

  5. Instale o plugin auth. Este plugin é necessário para usar as kubeconfigs geradas através da CLI. 

    gdcloud components install gdcloud-k8s-auth-plugin

Configure o gdcloud

  1. Configure a CLI definindo o URL da organização para o URL da consola do GDC.

    gdcloud config set core/organization_console_url https://console.org-1.zone1.google.gdch.test

Transfira o certificado

O gdcloud requer autenticação para executar comandos. Para o usar com o GDC Sandbox, comece por transferir um certificado da instância do GDC Sandbox.

  1. Recupere o certificado para autorizar o início de sessão. O comando seguinte transfere o certificado para a pasta /tmp. Pode optar por transferi-lo para onde quiser.

    echo -n | \
openssl s_client -showcerts -connect console.org-1.zone1.google.gdch.test:443 | \
sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' > /tmp/org-1-web-tls-ca.cert

Autentique com o gdcloud

  1. Inicie sessão na CLI gcloud com o certificado transferido. O exemplo seguinte pressupõe que o certificado foi transferido para a pasta /tmp.

    gdcloud auth login --login-config-cert=/tmp/org-1-web-tls-ca.cert

    Este comando abre uma janela do navegador para o portal OIDC. Selecione fake OIDC Provider e Platform Admin novamente (ou qualquer utilizador que queira usar para desenvolvimento. Certifique-se de que concede o acesso correto à função).

    Repita este passo de autenticação conforme necessário, quando a sessão expirar.