Personaliza las imágenes de contenedor de Cloud Shell

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

Para crear una experiencia personalizada de Cloud Shell, crea una imagen de Docker que funcione como un entorno personalizado de Cloud Shell con los paquetes adicionales y las configuraciones personalizadas que especificaste. Tu imagen de Docker debe estar basada en la imagen de Cloud Shell base y estar alojada en Container Registry.

Crea una imagen de Docker personalizada

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

Guiarme

Sigue estas instrucciones para crear tu propia imagen de Docker personalizada:

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 tus repositorios con gcloud source repos list.

Como alternativa, si prefieres realizar la implementación de forma manual en Container Registry o usar tu propio flujo de automatización, puedes crear un Dockerfile nuevo y vacío y pasar al paso 3.
Sigue las instrucciones impresas en tu línea de comandos para abrir el Dockerfile nuevo:
```
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 imagen base de Cloud Shell y no se debe quitar.
Ejecuta el siguiente comando para compilar tu imagen de forma local:
```
cloudshell env build-local
```
Ejecuta el siguiente comando para probar la imagen de forma local y verificar que los paquetes instalados estén presentes:
```
cloudshell env run
```
Para salir de la prueba, ejecuta el siguiente comando:
```
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 los vínculos de Abrir en Cloud Shell, primero debes hacerla pública. Si quieres conocer los pasos para hacer pública una imagen personalizada, sigue la Guía de control de acceso a Container Registry.

Después de establecer la configuración de acceso correcta, puedes actualizar el vínculo Abrir en Cloud Shell para especificar los parámetros cloudshell_git_repo y cloudshell_image. Por ejemplo, para agregar el botón Abrir en Cloud Shell, edita las URL del siguiente ejemplo y, luego, agrega un vínculo similar al siguiente a 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 a la ubicación del repositorio.
DOCKER_IMAGE_URL: Es la URL a 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 imagen pública de Cloud Shell más reciente para funcionar en Cloud Shell. Te recomendamos que vuelvas a compilar cada semana para mantener actualizada la imagen personalizada.