Fonctionnement de Cloud Shell

Cloud Shell provisionne une machine virtuelle Compute Engine exécutant un système d'exploitation Linux basé sur Debian pour votre usage temporaire. Cette machine virtuelle appartient à et est gérée par Google Cloud, elle n'apparaît donc dans aucun de vos Google Cloud projets.

Remarque : Votre organisation contrôle si vous avez accès à Cloud Shell.

Les instances Cloud Shell sont provisionnées par utilisateur et par session. L'instance persiste pendant que votre session Cloud Shell est active; après une heure d'inactivité, votre session se termine et sa VM est supprimée. Pour plus d'informations sur les quotas d'utilisation, reportez-vous au guide sur les limites.

Avec l'expérience Cloud Shell par défaut, une VM éphémère pré-configurée vous est attribuée et l'environnement avec lequel vous travaillez est un conteneur Docker exécuté sur cette VM. Vous pouvez également personnaliser votre environnement automatiquement au démarrage de la machine virtuelle pour vous assurer que votre instance Cloud Shell inclut vos outils préférés.

Stockage sur disque persistant

Cloud Shell fournit sans frais 5 Go de stockage sur disque persistant monté en tant que votre répertoire $HOME sur l'instance de machine virtuelle. Cet espace stockage est fourni pour chaque utilisateur et est disponible pour tous les projets. Contrairement à l'instance elle-même, le stockage n'a pas de délai d'inactivité. Tous les fichiers que vous stockez dans votre répertoire d'accueil, y compris les logiciels installés, les scripts et les fichiers de configuration utilisateur tels que .bashrc et .vimrc, persistent entre les sessions. Votre répertoire $HOME est personnel et n'est pas accessible aux autres utilisateurs.

Avertissement : Si vous supprimez votre répertoire $HOME ou si vous n'accédez pas à Cloud Shell pendant 120 jours, Cloud Shell supprime automatiquement votre répertoire $HOME et ne peut pas récupérer vos fichiers. Vous recevrez une notification par e-mail avant que cela ne se produise. Démarrez une session Cloud Shell pour éviter que le stockage persistant du répertoire $HOME ne soit recyclé.

Lorsque vous utilisez Cloud Shell, vous ne pouvez pas étendre l'espace de stockage sur disque persistant. Pour mieux contrôler la persistance de votre stockage et disposer de plus d'espace de stockage, vous pouvez utiliser Cloud Workstations.

Cloud Shell propose également le mode éphémère , qui est l'expérience Cloud Shell sans stockage sur disque persistant. Le mode éphémère vous permet de démarrer plus rapidement, mais tous les fichiers que vous créez dans votre session sont perdus à la fin de la session.

Autorisation

Lorsque vous effectuez un appel d'API Google Cloud ou utilisez un outil de ligne de commande nécessitant des identifiants (comme la Google Cloud CLI) avec Cloud Shell pour la première fois, Cloud Shell vous invite à autoriser l'opération. Cliquez sur Authorize (Autoriser) afin d'autoriser l'outil à utiliser vos identifiants pour effectuer des appels.

Pour plus d'informations, reportez-vous à la page Autoriser avec Cloud Shell.

Variables d'environnement préconfigurées

Lorsque Cloud Shell est démarré, le projet actif dans la Google Cloud console est propagé à votre gcloud configuration dans Cloud Shell pour une utilisation immédiate. GOOGLE_CLOUD_PROJECT, la variable d'environnement utilisée par le service d'identifiants par défaut de l'application pour définir l'ID de projet, est également définie afin de pointer vers le projet actif dans la Google Cloud console. La variable d'environnement WEB_HOST pointe vers le nom d'hôte de votre VM Cloud Shell que vous pouvez utiliser pour envoyer des requêtes HTTPS à l'environnement.

Remarque : Bien que GOOGLE_CLOUD_PROJECT hérite du projet actif de la Google Cloud console, votre instance Cloud Shell n'est pas directement associée à ce projet ni gérée par celui-ci.

Sélectionner la zone

Cloud Shell est distribué à l'échelle mondiale dans plusieurs Google Cloud régions. Lors de votre première connexion à Cloud Shell, la région la plus proche disponible vous est automatiquement attribuée. Vous ne pouvez pas choisir votre propre région. Si Cloud Shell ne choisit pas la région la plus proche, il tente de migrer votre VM Cloud Shell vers une région plus proche lorsque votre VM Cloud Shell n'est pas en cours d'utilisation.

Pour afficher votre région actuelle, exécutez la commande suivante à partir d'une session Cloud Shell :

curl metadata/computeMetadata/v1/instance/zone

Déployer une image

L'image de conteneur Cloud Shell est mise à jour chaque semaine pour maintenir à jour les outils préinstallés. Cela signifie que Cloud Shell est toujours fourni avec les dernières versions de la gcloud CLI, de Docker et d'autres utilitaires.

Utilisateur racine

Lorsque vous configurez une session Cloud Shell, vous obtenez un compte utilisateur Unix standard avec un nom d'utilisateur basé sur votre adresse e-mail. Avec cet accès, vous disposez de tous les privilèges racine sur votre machine virtuelle allouée et pouvez même exécuter des commandes sudo, si vous en avez besoin.

Outils disponibles

L'instance de machine virtuelle Cloud Shell comprend les outils pré-installés suivants :

Type	Outil
Interpréteurs shell Linux	bash sh
Utilitaires Linux	Utilitaires système Debian standards
gcloud CLI et outils	Google Cloud CLI, y compris la gcloud CLI
Éditeurs de texte	Emacs Vim Nano
Outils de compilation et d'empaquetage	Gradle Helm Make Maven Bazel npm nvm pip uv Composer
Outils de gestion des versions	Git Mercurial
Outils complémentaires	Docker iPython Client MySQL Compilateur gRPC TensorFlow

Vous pouvez installer des packages logiciels supplémentaires sur l'instance de machine virtuelle, mais l'installation ne persistera pas une fois l'instance terminée, sauf si vous installez le logiciel dans votre répertoire $HOME ou créez un environnement personnalisé.

Langues acceptées

Remarque : Les versions linguistiques peuvent changer. Vous pouvez cependant installer différentes versions si vous devez utiliser le script de personnalisation de l'environnement.

L'instance de machine virtuelle Cloud Shell est compatible avec les langages suivants :

Langage	Version
Java	JRE/JDK 17 (OpenJDK)
Go	Les plus récents
Python	3.12
Node.js	LTS
Ruby	3.2
PHP	8,3
.NET Core	SDK 6.0, 7.0 et 8.0

L'environnement Java par défaut est la version 17. Pour modifier la session Cloud Shell actuelle afin qu'elle utilise la version 1.11 de JRE et JDK, saisissez les informations suivantes dans l'invite de commande Cloud Shell :

sudo update-java-alternatives -s java-1.11.0-openjdk-amd64 && export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64

Pour passer à la version 21 :

sudo update-java-alternatives -s java-1.21.0-openjdk-amd64 && export JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64

Pour revenir à la version 17 :

sudo update-java-alternatives -s java-1.17.0-openjdk-amd64 && export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64/jre

Mode sécurisé

En cas de problème dans vos fichiers .bashrc ou .tmux.conf, Cloud Shell se ferme immédiatement après la connexion. Le mode sécurisé redémarre votre instance Cloud Shell et vous connecte en tant qu'utilisateur racine, ce qui vous permet de résoudre tout problème dans les fichiers.

Pour ouvrir Cloud Shell en mode sécurisé :

• Ajoutez cloudshellsafemode=true à l'URL.
• Dans Cloud Shell, cliquez sur , cliquez sur Safe Mode (Mode sécurisé), puis sur Restart (Redémarrer).

Pour supprimer définitivement tous les fichiers de votre répertoire d'accueil et restaurer votre répertoire personnel Cloud Shell dans un état propre, vous pouvez réinitialiser votre VM Cloud Shell.