Esta página foi traduzida pela API Cloud Translation.

Personalizar imagens de contêiner do Cloud Shell

Esta página descreve como criar e usar uma imagem personalizada do Docker como um ambiente do Cloud Shell para tutoriais e atividades de aprendizado.

Para criar uma experiência personalizada do Cloud Shell, crie uma imagem do Docker que funcione como um ambiente personalizado com os pacotes adicionais especificados e as configurações personalizadas. A imagem do Docker precisa ser baseada na imagem do Cloud Shell básica e hospedada no Container Registry.

Criar uma imagem do Docker personalizada

Para seguir as instruções da tarefa diretamente no editor do Cloud Shell, clique em Orientação:

Orientações

Crie sua própria imagem personalizada do Docker seguindo estas instruções:

Em uma guia do terminal do Cloud Shell, execute o seguinte comando para criar uma imagem personalizada padrão em um repositório hospedado pelo Cloud Source Repositories:
```
cloudshell env create-custom-image NEW_REPO_NAME
```
Observação: se você quiser usar um repositório que já existe, execute o comando gcloud source repos list para conferir uma lista de seus repositórios.

Como alternativa, se preferir implantar manualmente no Container Registry ou usar seu próprio fluxo de automação, crie um Dockerfile novo e vazio e pule para a etapa 3.
Abra o novo Dockerfile seguindo as instruções impressas na linha de comando:
```
cd $HOME/NEW_REPO_NAME && cloudshell edit Dockerfile
```
Adicione outros pacotes que você quer disponibilizar na sua experiência do Cloud Shell abaixo da primeira linha. Exemplo:
```
FROM gcr.io/cloudshell-images/cloudshell:latest
RUN apt-get -y install lsof
```
A primeira linha no Dockerfile, FROM gcr.io/cloudshell-images/cloudshell:latest, faz referência à imagem do Cloud Shell de base e não pode ser removida.
Crie a imagem localmente executando:
```
cloudshell env build-local
```
Teste a imagem localmente e verifique se os pacotes instalados estão presentes executando:
```
cloudshell env run
```
Para sair do teste, execute:
```
exit
```

Confirme as alterações de código localmente:

git commit -a -m "Initial custom environment check-in."

Envie as alterações de código para o Cloud Source Repositories:
```
git push origin master
```
Por fim, envie sua imagem personalizada para o Container Registry:
```
cloudshell env push
```

Atualizar o link "Abrir no Cloud Shell"

Para usar sua imagem personalizada com links de Abrir no Cloud Shell, primeiro você precisa torná-la pública. Para saber como tornar uma imagem personalizada pública, siga o guia de controle de acesso do Container Registry.

Depois de definir as configurações de acesso corretas, atualize o link Abrir no Cloud Shell para especificar os parâmetros cloudshell_git_repo e cloudshell_image. Por exemplo, para adicionar um botão Open in Cloud Shell, edite os URLs no exemplo a seguir e adicione um link semelhante ao seguinte no arquivo Markdown:

[![Open in Cloud Shell](https://gstatic.com/cloudssh/images/open-btn.svg)](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=REPO_URL&cloudshell_image=DOCKER_IMAGE_URL)

Substitua os seguintes valores:

REPO_URL: URL para o local do repositório
DOCKER_IMAGE_URL: URL da imagem do Docker

Para mais informações sobre esses e outros parâmetros, consulte Abrir no Cloud Shell.

Como manter a imagem de contêiner personalizada atualizada

Seu contêiner personalizado precisa ser baseado na imagem pública do Cloud Shell mais recente para funcionar no Cloud Shell. Recomendamos que você faça reconstruções semanais para manter a imagem personalizada atualizada.