Configure o Cloud Shell

Esta página descreve as maneiras de configurar o Cloud Shell para personalizar sua experiência.

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

O Cloud Shell fornece 5 GB de armazenamento em disco permanente gratuito, montado como seu diretório $HOME. Todos os arquivos armazenados no diretório inicial, incluindo softwares instalados, scripts e arquivos de configuração do usuário como .bashrc e .vimrc, permanecem entre as sessões. Como seu .bashrc permanece nas sessões, é uma ótima maneira de personalizar seu comportamento no Cloud Shell. Da mesma forma, para que suas instalações persistam, é possível instalar pacotes no diretório principal.

Variáveis de ambiente pré-configuradas

Quando o Cloud Shell é iniciado, o projeto ativo no Cloud Shell é propagado para sua configuração gcloud no Cloud Shell para uso imediato. A variável ambiental GOOGLE_CLOUD_PROJECT, usada pelo suporte da biblioteca do Application Default Credentials para definir o código do projeto, também é definida para apontar para o projeto ativo no Cloud Shell.

A variável de ambiente CLOUD_SHELL está definida como true. Essa variável pode ser verificada nos aplicativos para determinar se um aplicativo está em execução no Cloud Shell.

Preferências da CLI gcloud

Ao usar o Cloud Shell, suas preferências da CLI gcloud são armazenadas em uma pasta tmp temporária, definida apenas para a guia atual, e não permanecem entre as sessões.

Para que as configurações da CLI gcloud persistam, defina-as usando um dos seguintes métodos:

• Para manter a configuração da CLI gcloud personalizável por guia, mas personalizar a configuração padrão, adicione comandos de configuração gcloud (como gcloud config set compute/region us-central1 para definir uma região padrão) ao final do arquivo $HOME/.bashrc.

  Isso garante que cada nova guia herde o projeto do console do Google Cloud e a configuração padrão personalizada, mas também permite que você personalize ainda mais a configuração de cada guia.

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

Propriedades comuns

Para definir o projeto em que você quer trabalhar, execute:

gcloud config set project [PROJECT_NAME]

O prompt de comando é atualizado para refletir seu projeto ativo no momento, respeitando este formato: [USERNAME]@cloudshell:~ ([PROJECT_NAME])$

Para selecionar sua região preferida, execute:

gcloud config set compute/region us-east1

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

Personalização do ambiente

Observação: se você quiser que um pacote específico seja incluído no Cloud Shell por padrão, envie sua sugestão como feedback.

A personalização do ambiente permite instalar pacotes adicionais no ambiente do Cloud Shell quando ele é iniciado.

Script de personalização do ambiente

O Cloud Shell executa automaticamente o script $HOME/.customize_environment quando sua instância é inicializada. Diferentemente de .profile ou .bashrc, esse script é executado uma vez quando o Cloud Shell é inicializado (em vez de uma vez para cada login do Shell).

Esse script é executado como root e você pode instalar qualquer pacote que quiser que exista em uma sessão do Cloud Shell usando comandos de gerenciamento de pacotes Debian.

Por exemplo, se quiser ter o erlang instalado no Cloud Shell, seu arquivo .customize_environment ficará assim:

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

Os registros de execução do seu script .customize_environment podem ser encontrados em /var/log/customize_environment. O script .customize_environment é executado como um processo em segundo plano e, quando a execução for bem-sucedida, tocará em /google/devshell/customize_environment_done. Como a instalação do pacote é executada em paralelo ao seu login, os pacotes instalados podem ser disponibilizados pouco depois do prompt de login.

Abrir o Cloud Shell com uma conta de usuário especificada

O parâmetro authuser permite especificar uma conta de usuário para usar com o Cloud Shell. Você precisa estar conectado com a conta de usuário especificada. Se você não estiver conectado à conta especificada, o Cloud Shell será aberto com a conta padrão conectada. Por exemplo, é possível abrir o Cloud Shell com login como [e-mail] usando o URL shell.cloud.google.com?authuser=[e-mail].

Personalização de imagem do contêiner

A personalização de imagens do contêiner permite criar uma imagem do Docker que funciona como um ambiente personalizado do Cloud Shell com os pacotes especificados e as configurações personalizadas. A imagem do Docker precisa ser baseada na imagem do Cloud Shell e hospedada no Container Registry.

Para detalhes sobre como criar uma imagem de contêiner personalizada, consulte o guia Como personalizar imagens de contêiner.

Ao contrário da personalização do ambiente, a personalização da imagem do contêiner não afeta a experiência padrão do Cloud Shell. É possível usar e compartilhar sua imagem personalizada com links Abrir no Cloud Shell.

Suporte tmux

O Cloud Shell usa tmux, o que melhora a persistência nas sessões da guia do navegador. Por exemplo, se você atualizar o console do Google Cloud em uma guia ou se conectar ao Cloud Shell de uma máquina diferente, o estado da sessão não será perdido.

O Cloud Shell é compatível com as ligações de teclas padrão tmux. Por exemplo, se você pressionar Ctrl + b e %, tmux dividirá a janela da sessão atual em um painel à esquerda e um à direita, que podem ser úteis para depuração.

Estatísticas de uso

O Cloud Shell coleta estatísticas anônimas de uso em comandos executados no terminal do Cloud Shell. As estatísticas são coletadas apenas em comandos pré-instalados no Cloud Shell. Não é possível vincular essas métricas à sua conta.

Não coletamos métricas sobre nenhuma informação de identificação pessoal, como argumentos passados para esses comandos.

Para alterar as preferências de coleta de métricas a qualquer momento, selecione Estatísticas de uso do terminal no menu Configurações . Qualquer alteração nas preferências do menu "Configurações" entra em vigor na próxima sessão. Para ativar ou desativar a coleta de métricas, feche sua guia e abra outra guia depois de fazer a alteração.

Observação: esses dados são separados das estatísticas de uso do gcloud, ativadas por padrão no Cloud Shell.

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

gcloud config set disable_usage_reporting true