Se usó la API de Cloud Translation para traducir esta página.

Personaliza imágenes de contenedor de Cloud Shell

En esta página, se describe cómo crear y usar una imagen personalizada de Docker como entorno de Cloud Shell.

Para crear una experiencia personalizada de Cloud Shell, crea una imagen de Docker. que funciona como un entorno personalizado de Cloud Shell con paquetes adicionales especificados y configuraciones personalizadas. Tu imagen de Docker debe basarse en la base Imagen de Cloud Shell y se aloja en Container Registry.

Crea una imagen personalizada de Docker

Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:

GUIARME

Para crear tu propia imagen de Docker personalizada, sigue estas instrucciones:

En una pestaña de la terminal de Cloud Shell, ejecuta el siguiente comando para crear una imagen personalizada estándar en un repositorio alojado por Cloud Source Repositories:
```
cloudshell env create-custom-image NEW_REPO_NAME
```
Nota: Si quieres usar un repositorio existente, puedes ver una lista de a tus repositorios ejecutando gcloud source repos list.

Como alternativa, si prefieres implementar manualmente Container Registry o usas tu propio flujo de automatización, puedes crear un un nuevo Dockerfile vacío y ve al paso 3.
Abre tu nuevo Dockerfile siguiendo las instrucciones impresas en tu Línea de comandos:
```
cd $HOME/NEW_REPO_NAME && cloudshell edit Dockerfile
```
Agrega los paquetes adicionales que quieras que estén disponibles en tu experiencia de Cloud Shell debajo de la primera línea. Por ejemplo:
```
FROM gcr.io/cloudshell-images/cloudshell:latest
RUN apt-get -y install lsof
```
La primera línea de tu Dockerfile, FROM gcr.io/cloudshell-images/cloudshell:latest hace referencia a la base. Cloud Shell y no se debe quitar.
Para compilar tu imagen de manera local, ejecuta el siguiente comando:
```
cloudshell env build-local
```
Prueba tu imagen de forma local y verifica que los paquetes instalados estén presentes ejecutando lo siguiente:
```
cloudshell env run
```
Para salir de la prueba, ejecuta lo siguiente:
```
exit
```

Confirma los cambios de tu código de manera local:

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

Envíe los cambios de los códigos a Cloud Source Repositories:
```
git push origin master
```
Por último, envía tu imagen personalizada a Container Registry:
```
cloudshell env push
```

Actualiza el vínculo Abrir en Cloud Shell

Para usar tu imagen personalizada con la opción Abrir en Cloud Shell, haz lo siguiente: debes hacerla pública. Pasos para crear una imagen personalizada public, sigue la Guía de control de acceso de Container Registry.

Después de establecer la configuración de acceso correcta, puedes actualizar tu Vínculo Abrir en Cloud Shell para especificar cloudshell_git_repo y cloudshell_image. Por ejemplo, para agregar una alerta Abrir en la nube Shell, edita las URLs en el siguiente ejemplo y, luego, agrega un vínculo similar a lo siguiente en tu archivo de 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)

Reemplaza los siguientes valores:

REPO_URL: Es la URL de la ubicación de tu repositorio.
DOCKER_IMAGE_URL: Es la URL de la imagen de Docker.

Para obtener más información sobre estos y otros parámetros, consulta Abrir en Cloud Shell.

Mantén actualizada la imagen de contenedor personalizada

Tu contenedor personalizado debe basarse en la información Imagen de Cloud Shell para trabajar en Cloud Shell. Te recomendamos que vuelvas a compilar semanalmente para mantener actualizada la imagen personalizada.