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 sem custo financeiro montado como seu $HOME diretório. 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 ID 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 temporária tmp, definida somente para sua guia atual e não persistem em 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 gcloud comandos de configuração (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 Google Cloud console 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ê gostaria de 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

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. É necessário fazer login com a conta de usuário especificada. Se você não estiver conectado à conta especificada, o Cloud Shell será aberto com a conta conectada padrão. Por exemplo, é possível abrir o Cloud Shell conectado como client1@example.com usando o URL shell.cloud.google.com?authuser=client1@example.com.

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 Google Cloud console em uma guia ou se conectar ao Cloud Shell a partir 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