Premiers pas avec Cloud Shell et gcloud

1. Présentation

Google Cloud Shell vous permet d'accéder en ligne de commande aux ressources de calcul hébergées sur Google Cloud Platform. Il est désormais disponible dans la console Google Cloud Platform. Cloud Shell vous permet de gérer facilement vos projets et vos ressources de la console Cloud Platform, sans avoir à installer le SDK Google Cloud ni aucun autre outil sur votre système. Avec Cloud Shell, la commande gcloud du SDK Cloud et les autres utilitaires dont vous avez besoin sont toujours disponibles en temps voulu.

Dans cet atelier de programmation, vous allez apprendre à vous connecter à des ressources de calcul hébergées sur Google Cloud Platform via le Web. Vous apprendrez à utiliser Cloud Shell et la commande gcloud du SDK Cloud.

Ce tutoriel est adapté de https://cloud.google.com/cloud-shell/docs/quickstart et https://cloud.google.com/sdk/gcloud/.

Points abordés

Se connecter à des ressources de calcul hébergées sur Google Cloud Platform
Utiliser les commandes gcloud

Prérequis

Bonne connaissance des éditeurs de texte Linux standards tels que Vim, EMACs ou Nano

Comment allez-vous utiliser ce tutoriel ?

Je vais le lire uniquement

Je vais le lire et effectuer les exercices

Quel est votre niveau d'expérience avec les services Google Cloud Platform et Firebase ?

Débutant

Intermédiaire

Expert

2. Préparation

Configuration de l'environnement d'auto-formation

Connectez-vous à la console Cloud, puis créez un projet ou réutilisez un projet existant. (Si vous ne possédez pas encore de compte Gmail ou Google Workspace, vous devez en créer un.)

Mémorisez l'ID du projet. Il s'agit d'un nom unique permettant de différencier chaque projet Google Cloud (le nom ci-dessus est déjà pris ; vous devez en trouver un autre). Il sera désigné par le nom PROJECT_ID tout au long de cet atelier de programmation.

Vous devez ensuite activer la facturation dans Cloud Console pour pouvoir utiliser les ressources Google Cloud.

L'exécution de cet atelier de programmation est très peu coûteuse, voire sans frais. Veillez à suivre les instructions de la section "Nettoyer" qui indique comment désactiver les ressources afin d'éviter les frais une fois ce tutoriel terminé. Les nouveaux utilisateurs de Google Cloud peuvent participer au programme d'essai sans frais pour bénéficier d'un crédit de 300$.

Lancer Cloud Shell

Activer Cloud Shell

Dans Cloud Console, cliquez sur Activer Cloud Shell .

Si vous n'avez jamais démarré Cloud Shell auparavant, un écran intermédiaire s'affiche en dessous de la ligne de flottaison, décrivant de quoi il s'agit. Si tel est le cas, cliquez sur Continuer. Cet écran ne s'affiche qu'une seule fois. Voici à quoi il ressemble :

Le provisionnement et la connexion à Cloud Shell ne devraient pas prendre plus de quelques minutes.

Cette machine virtuelle contient tous les outils de développement dont vous avez besoin. Elle comprend un répertoire d'accueil persistant de 5 Go et s'exécute sur Google Cloud, ce qui améliore nettement les performances du réseau et l'authentification. Vous pouvez réaliser une grande partie, voire la totalité, des activités de cet atelier dans un simple navigateur ou sur votre Chromebook.

Une fois connecté à Cloud Shell, vous êtes en principe authentifié et le projet est défini avec votre ID de projet.

Exécutez la commande suivante dans Cloud Shell pour vérifier que vous êtes authentifié :

gcloud auth list

Résultat de la commande

 Credentialed Accounts
ACTIVE  ACCOUNT
*       <my_account>@<my_domain.com>

To set the active account, run:
    $ gcloud config set account `ACCOUNT`

Exécutez la commande suivante dans Cloud Shell pour vérifier que la commande gcloud connaît votre projet :

gcloud config list project

Résultat de la commande

[core]
project = <PROJECT_ID>

Si vous obtenez un résultat différent, exécutez cette commande :

gcloud config set project <PROJECT_ID>

Résultat de la commande

Updated property [core/project].

3. Utiliser la ligne de commandes

Une fois l'environnement Cloud Shell lancé, vous pouvez utiliser la ligne de commande pour appeler la commande gcloud du SDK Cloud ou d'autres outils disponibles sur l'instance de machine virtuelle. Vous pouvez également utiliser votre répertoire $HOME dans le stockage sur disque persistant pour stocker des fichiers dans différents projets et entre les sessions Cloud Shell. Votre répertoire $HOME est privé. Les autres utilisateurs ne peuvent pas y accéder.

Commençons par examiner les commandes à votre disposition. Essayez ce qui suit :

gcloud -h

Des consignes d'utilisation simples sont disponibles en ajoutant -h à la fin d'un appel gcloud. Pour obtenir une aide plus détaillée, ajoutez l'option --help ou exécutez gcloud help COMMAND.

Essayez cette commande :

gcloud config --help

Essayez maintenant

gcloud help config

Vous remarquerez que les commandes gcloud config --help et gcloud help config sont équivalentes. Elles permettent toutes les deux d'obtenir une aide détaillée.

4. Utiliser les commandes gcloud

Essayons d'afficher la liste des configurations dans notre environnement. Après avoir lu l'aide longue et détaillée de l'étape précédente, nous savons que nous pouvons utiliser la commande gcloud list.

gcloud config list

Vous vous demandez peut-être s'il existe d'autres propriétés qui n'ont pas été définies. Vous pouvez afficher toutes les propriétés en appelant la commande suivante :

gcloud config list --all

Résumé

Dans cette étape, vous avez lancé Cloud Shell et appelé quelques commandes gcloud simples.

5. Félicitations !

Vous avez appris à lancer Cloud Shell et vous avez exécuté des exemples de commandes gcloud.

En savoir plus

Documentation et tutoriel vidéo sur Cloud Shell.
gcloud Documentation et tutoriel vidéo.

Licence

Ce document est publié sous une licence Creative Commons Attribution 2.0 Generic.