Personnaliser des images de conteneurs Cloud Shell

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

Pour créer une expérience Cloud Shell personnalisée, vous devez créer une image Docker qui fonctionne comme un environnement Cloud Shell personnalisé avec les packages et configurations personnalisés spécifiés. Votre image Docker doit être basée sur l'image Cloud Shell de base et 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 ces instructions:

Dans un onglet de terminal Cloud Shell, exécutez la commande suivante pour créer une image personnalisée récurrent 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 la commande 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 imprimées dans votre ligne de commande:
```
cd $HOME/NEW_REPO_NAME && cloudshell edit Dockerfile
```
Ajoutez tous les packages supplémentaires que vous souhaitez rendre disponibles dans votre expérience Cloud Shell sous la première ligne. 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 localement 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 le test, exécutez la commande suivante:
```
exit
```

Validez vos modifications de code localement:

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

Transférez vos modifications de code vers 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 connaître la procédure à suivre pour rendre une image personnalisée publique, suivez les instructions du guide du contrôle des accès dans Container Registry.

Une fois que vous avez configuré les paramètres d'accès corrects, vous pouvez mettre à 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)