Personnaliser des images de conteneurs Cloud Shell

Cloud Shell vous permet de personnaliser l'expérience Cloud Shell par défaut.

Pour créer une expérience Cloud Shell personnalisée, créez une image Docker qui fonctionne comme un environnement Cloud Shell personnalisé avec les packages et configurations personnalisées de votre choix. Votre image Docker doit être basée sur l'image Cloud Shell de base et être hébergée dans Container Registry.

Cette page explique comment créer et utiliser une image Docker personnalisée en tant qu'environnement Cloud Shell.

Créer une image Docker personnalisée

Créez votre propre image Docker personnalisée en suivant les instructions suivantes :

Dans un onglet de terminal Cloud Shell, exécutez la commande suivante pour créer une image personnalisée récurrente dans un dépôt hébergé par Cloud Source Repositories:
```
cloudshell env create-custom-image NEW_REPO_NAME
```
Remarque : Si vous souhaitez utiliser un dépôt existant, vous pouvez afficher la liste de vos dépôts en exécutant gcloud source repos list.

Si vous préférez effectuer un déploiement manuel dans Container Registry ou utiliser votre propre flux d'automatisation, vous pouvez créer un fichier Dockerfile vide et passer à l'étape 3.
Ouvrez votre nouveau fichier Dockerfile en suivant les instructions affichées sur votre ligne de commande :
```
cd $HOME/NEW_REPO_NAME && cloudshell edit Dockerfile
```
Ajoutez sous la première ligne les packages supplémentaires que vous souhaitez rendre disponibles dans votre expérience Cloud Shell. Exemple :
```
FROM gcr.io/cloudshell-images/cloudshell:latest
RUN apt-get -y install lsof
```
La première ligne de votre fichier Dockerfile, FROM gcr.io/cloudshell-images/cloudshell:latest, fait référence à l'image Cloud Shell de base et ne doit pas être supprimée.
Créez votre image en local en exécutant la commande suivante :
```
cloudshell env build-local
```
Testez votre image localement et vérifiez que vos packages installés sont présents en exécutant la commande suivante :
```
cloudshell env run
```
Pour quitter les tests, exécutez :
```
exit
```

Validez vos modifications de code en local :

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

Déployez vos modifications de code dans Cloud Source Repositories :
```
git push origin master
```
Enfin, transférez votre image personnalisée vers Container Registry :
```
cloudshell env push
```

Mettre à jour votre lien "Ouvrir dans Cloud Shell"

Pour utiliser votre image personnalisée avec des liens Ouvrir dans Cloud Shell, vous devez d'abord la rendre publique. Pour rendre des images personnalisées publiques, suivez le guide de contrôle d'accès de Container Registry.

Une fois que vous avez configuré les paramètres d'accès appropriés, mettez à jour le lien "Ouvrir dans Cloud Shell" pour spécifier le paramètre cloudshell_image avec l'URL de votre image Docker :

[![Open in Cloud Shell](https://gstatic.com/cloudssh/images/open-btn.svg)](https://ssh.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https://source.developers.google.com/p/project_name/r/repo_name&cloudshell_image=gcr.io/project-id/docker-image-name)