Configure o Cloud Shell

Esta página descreve as formas como pode configurar o Cloud Shell para personalizar a sua experiência.

Ficheiros de configuração no diretório inicial do Cloud Shell

O Cloud Shell aprovisiona 5 GB de armazenamento em disco persistente gratuito montado como o seu diretório $HOME. Todos os ficheiros que armazena no seu diretório principal, incluindo software instalado, scripts e ficheiros de configuração do utilizador, como .bashrc e .vimrc, persistem entre sessões. Uma vez que o seu .bashrc persiste entre sessões, é uma excelente forma de personalizar o comportamento do Cloud Shell. Da mesma forma, para que as suas instalações persistam, pode instalar pacotes no seu diretório pessoal.

Variáveis de ambiente pré-configuradas

Quando o Cloud Shell é iniciado, o projeto ativo no Cloud Shell é propagado para a sua configuração gcloud no Cloud Shell para utilização imediata. GOOGLE_CLOUD_PROJECT, a variável de ambiente usada pelo suporte da biblioteca de credenciais padrão da aplicação para definir o ID do projeto, também está definida para apontar para o projeto ativo no Cloud Shell.

A variável de ambiente CLOUD_SHELL está definida como true. Esta variável pode ser verificada a partir de aplicações para determinar se uma aplicação está a ser executada no Cloud Shell.

Preferências da CLI gcloud

Quando usa o Cloud Shell, as suas preferências da CLI gcloud são armazenadas numa pasta tmp temporária, definida apenas para o separador atual, e não persistem entre sessões.

Para que as configurações da gcloud CLI persistam, pode defini-las através de um dos seguintes métodos:

  • Para manter a configuração da CLI gcloud personalizável por separador, mas personalizar a própria configuração predefinida, pode adicionar gcloudcomandos de configuração (como gcloud config set compute/region us-central1 para definir uma região predefinida) ao final do ficheiro $HOME/.bashrc.

    Isto garante que cada novo separador herda o seu Google Cloud projeto da consola e a sua configuração predefinida personalizada, mas também lhe permite personalizar ainda mais a configuração de cada separador.

  • Para usar sempre a mesma configuração da CLI gcloud, adicione export CLOUDSDK_CONFIG=$HOME/.config/gcloud ao final do ficheiro .bashrc e, em seguida, execute gcloud config configurations create CONFIG_NAME para criar a configuração que quer usar.

Propriedades comuns

Para definir o projeto no qual quer trabalhar, execute o seguinte comando:

gcloud config set project [PROJECT_NAME]

A linha de comandos é atualizada para refletir o seu projeto atualmente ativo, respeitando este formato: [USERNAME]@cloudshell:~ ([PROJECT_NAME])$

Para selecionar a sua região preferida, execute o seguinte comando:

gcloud config set compute/region us-east1

Os comandos acima são exemplos de configurações da CLI gcloud que pode definir. Para ver uma lista completa e mais detalhes sobre a definição de propriedades, consulte o guia de propriedades da CLI gcloud.

Personalização do ambiente

A personalização do ambiente permite-lhe instalar pacotes adicionais no seu ambiente do Cloud Shell quando este é iniciado.

Script de personalização do ambiente

O Cloud Shell executa automaticamente o script, $HOME/.customize_environment, quando a instância é iniciada. Ao contrário de .profile ou .bashrc, este script é executado uma vez quando o Cloud Shell é iniciado (em vez de uma vez para cada início de sessão na shell).

Este script é executado como root e pode instalar todos os pacotes que quer que existam em cada sessão do Cloud Shell através de comandos de gestão de pacotes Debian.

Por exemplo, se quiser ter o erlang instalado no Cloud Shell, o ficheiro .customize_environment vai ter o seguinte aspeto:

#!/bin/sh
apt-get update
apt-get -y install erlang

Pode encontrar os registos de execução do seu script .customize_environment em /var/log/customize_environment. O .customize_environment script é executado como um processo em segundo plano e, após a execução bem-sucedida, vai tocar /google/devshell/customize_environment_done. Uma vez que a instalação de pacotes é executada em paralelo com o seu início de sessão, os pacotes instalados podem ficar disponíveis alguns momentos depois de receber o pedido de início de sessão.

Abra o Cloud Shell com uma conta de utilizador especificada

O parâmetro authuser permite-lhe especificar uma conta de utilizador a usar com o Cloud Shell. Tem de ter sessão iniciada com a conta de utilizador especificada. Se não tiver sessão iniciada na conta especificada, o Cloud Shell é aberto com a conta predefinida em que tem sessão iniciada. Por exemplo, pode abrir o Cloud Shell com sessão iniciada como client1@example.com através do URL shell.cloud.google.com?authuser=client1@example.com.

Personalização de imagens de contentores

A personalização de imagens de contentores permite-lhe criar uma imagem do Docker que funciona como um ambiente do Cloud Shell personalizado com os pacotes adicionais e as configurações personalizadas especificados. A sua imagem Docker tem de se basear na imagem do Cloud Shell e estar alojada no Artifact Registry.

Ao contrário da personalização do ambiente, a personalização da imagem do contentor não afeta a sua experiência predefinida do Cloud Shell. Pode usar e partilhar a sua imagem personalizada com links Abrir no Cloud Shell.

Suporte do tmux

O Cloud Shell usa tmux, o que lhe permite melhorar a persistência nas sessões de separadores do navegador. Por exemplo, se atualizar a Google Cloud consola num separador ou estabelecer ligação ao Cloud Shell a partir de uma máquina diferente, o estado da sessão não é perdido.

O Cloud Shell suporta as tmux associações de teclas predefinidas. Por exemplo, se premir Ctrl+b e, em seguida, %, tmux divide a janela da sessão atual em painéis esquerdo e direito, o que pode ser útil para a depuração.

Estatísticas de utilização

O Cloud Shell recolhe estatísticas de utilização anónimas sobre os comandos que são executados no terminal do Cloud Shell. As estatísticas são recolhidas apenas em comandos pré-instalados no Cloud Shell. Não é possível associar estas métricas à sua conta.

As métricas não são recolhidas em nenhuma informação de identificação pessoal, como argumentos transmitidos a estes comandos.

Para alterar as preferências de recolha de métricas em qualquer altura, selecione Estatísticas de utilização do terminal no menu Definições Botão Definições. Qualquer alteração nas suas preferências no menu Definições entra em vigor na sessão seguinte. Para ativar ou desativar a recolha de métricas, feche o separador e abra outro separador depois de fazer a alteração.

Nota: isto é independente das estatísticas de utilização do gcloud, que estão ativadas por predefinição no Cloud Shell.

Para desativar a recolha de métricas da CLI gcloud, execute o seguinte comando na sua sessão do Cloud Shell:

gcloud config set disable_usage_reporting true