Configurer Cloud Shell

Cloud Shell vous permet de personnaliser votre environnement de développement en fonction de vos préférences. Vous pouvez définir des variables d'environnement persistantes, définir les préférences de la gcloud CLI, exécuter un script de personnalisation pour initialiser les outils dans vos sessions et ajuster la collecte des statistiques d'utilisation.

Fichiers de configuration dans votre répertoire d'accueil Cloud Shell

Cloud Shell provisionne 5 Go d'espace de stockage sur disque persistant sans frais, utilisé comme répertoire $HOME. 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. Étant donné que votre .bashrc persiste à travers les sessions, c'est un excellent moyen de personnaliser votre comportement Cloud Shell. De même, pour que vos installations persistent, vous pouvez installer des packages dans votre répertoire d'accueil.

Variables d'environnement préconfigurées

Lorsque Cloud Shell est démarré, le projet actif dans la console est propagé à votre configuration gcloud dans Cloud Shell pour une utilisation immédiate. GOOGLE_CLOUD_PROJECT, la variable d'environnement utilisée par la bibliothèque d'Identifiants par défaut de l'application pour définir l'ID du projet, est également définie pour pointer vers le projet actif dans Cloud Shell.

La variable d'environnement CLOUD_SHELL est définie sur true. Cette variable peut être vérifiée dans les applications pour déterminer si une application est en cours d'exécution dans Cloud Shell.

Préférences de la gcloud CLI

Lorsque vous utilisez Cloud Shell, vos préférences gcloud CLI sont stockées dans un dossier tmp temporaire, défini uniquement pour l'onglet actuel, et ne sont pas conservées d'une session à l'autre.

Pour que vos configurations gcloud CLI soient conservées, vous pouvez les définir à l'aide de l'une des méthodes suivantes :

• Pour que votre configuration gcloud CLI reste personnalisable par onglet, mais que vous puissiez personnaliser la configuration par défaut elle-même, vous pouvez ajouter des commandes de configuration gcloud (telles que gcloud config set compute/region us-central1 pour définir une région par défaut) à la fin de votre fichier $HOME/.bashrc.

  Cela garantit que chaque nouvel onglet hérite de votre projet de console Google Cloud et de votre configuration par défaut personnalisée, mais vous permet également de personnaliser davantage la configuration de chaque onglet.

• Pour toujours utiliser la même configuration de gcloud CLI, ajoutez export CLOUDSDK_CONFIG=$HOME/.config/gcloud à la fin de votre fichier .bashrc, puis exécutez gcloud config configurations create CONFIG_NAME pour créer la configuration que vous souhaitez utiliser.

Propriétés communes

Pour définir le projet sur lequel vous souhaitez travailler, exécutez :

gcloud config set project [PROJECT_NAME]

Votre invite de commande est mise à jour pour refléter le projet actuellement actif, selon le format suivant : [USERNAME]@cloudshell:~ ([PROJECT_NAME])$

Pour sélectionner la région de votre choix, exécutez :

gcloud config set compute/region us-east1

Les commandes ci-dessus sont des exemples de configurations de gcloud CLI que vous pouvez définir. Pour obtenir la liste complète et plus de détails sur la définition des propriétés, consultez le guide des propriétés de gcloud CLI.

Personnaliser l'environnement

Remarque : Si vous souhaitez qu'un package spécifique soit inclus par défaut dans Cloud Shell, envoyez-nous votre suggestion.

La personnalisation de l'environnement vous permet d'installer des packages supplémentaires dans votre environnement Cloud Shell au démarrage.

Script de personnalisation de l'environnement

Cloud Shell exécute automatiquement le script $HOME/.customize_environment lorsque votre instance démarre. Contrairement à .profile ou .bashrc, ce script s'exécute une fois au démarrage de Cloud Shell (plutôt qu'une fois pour chaque connexion à Cloud Shell).

Ce script s'exécute en tant que racine et vous pouvez installer tous les packages que vous souhaitez inclure dans chaque session Cloud Shell à l'aide des commandes de gestion des packages Debian.

Par exemple, si vous souhaitez installer erlang sur Cloud Shell, votre fichier .customize_environment ressemblera à ceci :

#!/bin/sh
apt-get update
apt-get -y install erlang

Les journaux d'exécution de votre script .customize_environment se trouvent dans /var/log/customize_environment. Le script .customize_environment s'exécute en tant que processus en arrière-plan et, en cas d'exécution réussie, touche /google/devshell/customize_environment_done. Étant donné que l'installation des packages s'exécute en parallèle avec votre connexion, les packages installés peuvent devenir disponibles quelques instants après votre accès à l'invite de connexion.

Ouvrir Cloud Shell avec un compte utilisateur spécifié

Le paramètre authuser vous permet de spécifier un compte utilisateur à utiliser avec Cloud Shell. Vous devez être connecté avec le compte utilisateur spécifié. Si vous n'êtes pas connecté au compte spécifié, Cloud Shell s'ouvre avec le compte connecté par défaut. Par exemple, vous pouvez ouvrir Cloud Shell en vous connectant en tant que [e-mail] à l'aide de l'URL shell.cloud.google.com?authuser=[e-mail].

Compatibilité tmux

Cloud Shell utilise tmux, ce qui lui permet d'améliorer la persistance entre les sessions d'onglets du navigateur. Par exemple, si vous actualisez la consoleGoogle Cloud dans un onglet ou si vous vous connectez à Cloud Shell depuis une autre machine, l'état de la session ne sera pas perdu.

Cloud Shell prend en charge les liaisons de touches tmux par défaut. Par exemple, si vous appuyez sur Ctrl + b puis sur %, tmux divise la fenêtre de session actuelle en volets gauche et droit, ce qui peut être utile pour le débogage.

Statistiques d'utilisation

Cloud Shell recueille des statistiques d'utilisation anonymes sur les commandes exécutées dans le terminal Cloud Shell. Les statistiques sont collectées uniquement sur les commandes préinstallées dans Cloud Shell. Ces statistiques ne peuvent pas être liées à votre compte.

Les métriques ne sont pas collectées sur les informations permettant d'identifier personnellement l'utilisateur, telles que les arguments transmis à ces commandes.

Pour modifier les préférences de collecte de statistiques à tout moment, sélectionnez Statistiques d'utilisation du terminal dans le menu Paramètres . Toute modification de vos préférences dans le menu Paramètres prend effet à la session suivante. Pour activer ou désactiver la collecte de métriques, fermez votre onglet et ouvrez-en un autre après avoir effectué votre modification.

Remarque : Ces statistiques sont distinctes des statistiques d'utilisation de gcloud, qui sont activées par défaut dans Cloud Shell.

Pour désactiver la collecte de métriques gcloud CLI, exécutez la commande suivante dans votre session Cloud Shell :

gcloud config set disable_usage_reporting true