Présentation

Dans cet atelier, vous allez déployer l'application Quiz dans l'environnement flexible App Engine, et exploiter certaines fonctionnalités d'App Engine, comme les versions et la répartition du trafic.

Objectifs

Dans cet atelier, vous allez apprendre à effectuer les tâches suivantes :

• Créer un fichier app.yaml pour décrire les exigences de l'application dans l'environnement flexible App Engine

• Déployer l'application Quiz dans l'environnement flexible App Engine

• Utiliser les versions et la répartition du trafic pour procéder à un test A/B d'une fonctionnalité de l'application

Prérequis

Pour chaque atelier, nous vous attribuons un nouveau projet Google Cloud et un nouvel ensemble de ressources pour une durée déterminée, sans frais.

1. Connectez-vous à Qwiklabs dans une fenêtre de navigation privée.

2. Vérifiez le temps imparti pour l'atelier (par exemple : 01:15:00) : vous devez pouvoir le terminer dans ce délai.
   Une fois l'atelier lancé, vous ne pouvez pas le mettre en pause. Si nécessaire, vous pourrez le redémarrer, mais vous devrez tout reprendre depuis le début.

3. Lorsque vous êtes prêt, cliquez sur Démarrer l'atelier.

4. Notez vos identifiants pour l'atelier (Nom d'utilisateur et Mot de passe). Ils vous serviront à vous connecter à Google Cloud Console.

5. Cliquez sur Ouvrir la console Google.

6. Cliquez sur Utiliser un autre compte, puis copiez-collez les identifiants de cet atelier lorsque vous y êtes invité.
   Si vous utilisez d'autres identifiants, des messages d'erreur s'afficheront ou des frais seront appliqués.

7. Acceptez les conditions d'utilisation et ignorez la page concernant les ressources de récupération des données.

Activer Google Cloud Shell

Google Cloud Shell est une machine virtuelle qui contient de nombreux outils pour les développeurs. Elle comprend un répertoire d'accueil persistant de 5 Go et s'exécute sur Google Cloud. Google Cloud Shell offre un accès en ligne de commande à vos ressources GCP.

1. Dans la barre d'outils située en haut à droite de la console GCP, cliquez sur le bouton Open Cloud Shell (Ouvrir Cloud Shell).

   

2. Cliquez sur Continue (Continuez):

   

Le provisionnement et la connexion à l'environnement ne devraient pas prendre plus de quelques minutes. Une fois connecté, vous êtes en principe authentifié et le projet est défini sur votre ID_PROJET. Exemple :

gcloud est l'outil de ligne de commande associé à Google Cloud Platform. Pré-installé sur Cloud Shell, il est également compatible avec la saisie semi-automatique via la touche de tabulation.

Vous pouvez répertorier le nom des comptes actifs à l'aide de cette commande :

gcloud auth list

Résultat :

Credentialed accounts:
 - <myaccount>@<mydomain>.com (active)

Exemple de résultat :

Credentialed accounts:
 - google1623327_student@qwiklabs.net

Pour répertorier les ID de projet, exécutez la commande suivante :

gcloud config list project

Résultat :

[core]
project = <ID_projet>

Exemple de résultat :

[core]
project = qwiklabs-gcp-44776a13dea667a6

Préparer l'application de l'étude de cas

Dans cette section, vous allez accéder à Cloud Shell, cloner le dépôt Git qui contient l'application Quiz, configurer les variables d'environnement et exécuter l'application.

Cloner le code source dans Cloud Shell

1. Clonez le dépôt pour la classe.

git clone --depth=1 https://github.com/GoogleCloudPlatform/training-data-analyst

2. Créez un lien symbolique qui servira de raccourci vers le répertoire de travail :

ln -s ~/training-data-analyst/courses/developingapps/v1.3/nodejs/appengine ~/appengine

Configurer l'application de l'étude de cas et examiner le code

1. Passez au répertoire qui contient les exemples de fichiers de l'atelier.

cd ~/appengine/start

2. Configurez l'application Quiz.

. prepare_environment.sh

3. Dans Cloud Shell, cliquez sur Open Editor (Ouvrir l'éditeur). Si vous y êtes invité, cliquez sur Open in a new window (Ouvrir dans une nouvelle fenêtre).
4. Accédez à appengine/start.

Cliquez sur "Check my progress" (Vérifier ma progression) pour vérifier l'objectif. Préparer l'application de l'étude de cas

Préparer le code de l'application pour son déploiement dans l'environnement flexible App Engine

Dans cette section, vous allez modifier les fichiers de configuration associés au déploiement de l'interface de l'application Quiz dans l'environnement flexible App Engine.

Créer le fichier app.yaml pour l'interface

1. Dans l'éditeur de code Cloud Shell, ouvrez le fichier appengine/start/frontend/app.yaml.
2. Ajoutez deux paires key: value et définissez la mise à l'échelle sur manuelle :

• La première indique que vous voulez utiliser l'environnement d'exécution node.js.

• La deuxième indique que vous voulez utiliser un environnement flexible.

• Le nombre d'instances est défini sur 1. Un service de production doit généralement être autorisé à évoluer vers plus d'instances.

...frontend/app.yaml

runtime: nodejs env: flex manual_scaling: instances: 1

3. Modifiez le fichier appengine/start/frontend/config.json pour inclure une clé GCLOUD_BUCKET. La valeur correspond au nom du bucket -media dans votre projet, qui est <GCP-Project-ID>-media.

...frontend/config.json

{ "GCLOUD_BUCKET" : "<REPLACE_WITH_BUCKET_NAME>" }

4. Enregistrez les fichiers.

Déployer l'interface dans l'environnement flexible App Engine

1. Dans Cloud Shell, déployez l'application Quiz dans l'environnement flexible App Engine.

gcloud app deploy ~/appengine/start/frontend/app.yaml

Si la question "Do you want to continue (Y/n)?" (Voulez-vous continuer (O/N) ?) s'affiche, appuyez sur Y.

2. Attendez la fin du déploiement.
3. Dans le menu de navigation de Cloud Console, cliquez sur App Engine.
4. Cliquez sur le lien vers votre application en haut à droite du tableau de bord App Engine.

Deploy the frontend to App Engine Flex

Mettre à jour une application dans l'environnement flexible App Engine

Dans cette section, vous allez modifier le code de l'application avant de redéployer celle-ci.

Modifier l'application Quiz

1. Dans l'éditeur de code Cloud Shell, ouvrez le fichier appengine/start/frontend/web-app/views/home.pug.

2. Ajoutez plusieurs points d'exclamation au titre de premier niveau.

...frontend/web-app/views/home.pug

extends base.pug block content h1 Welcome to the Quite Interesting Quiz!!!!!!!!!! .jumbotron p Welcome to the Quite Interesting Quiz where you can create a question, take a test or review feedback h3.col-md-4 a(href="/questions/add") Create Question h3.col-md-4 a(href="/client/") Take Test h3.col-md-4 a(href="/leaderboard") Leaderboard

3. Enregistrez le fichier.

Déployer l'application modifiée

1. Dans Cloud Shell, redéployez l'application App Engine.

gcloud app deploy ~/appengine/start/frontend/app.yaml --no-promote \ --no-stop-previous-version

Si la question "Do you want to continue (Y/n)?" (Voulez-vous continuer (O/N) ?) s'affiche, appuyez sur Y.

2. Dans le menu de navigation de Cloud Console, cliquez sur App Engine > Dashboard (Tableau de bord).
3. Cliquez sur l'URL de l'application en haut à droite de la fenêtre. L'ancien titre de l'application reste affiché.
4. Dans la fenêtre App Engine, cliquez sur Versions.

5. Cliquez sur le lien de la nouvelle version.

6. Cochez les cases correspondant aux deux versions de l'application, puis cliquez sur Split traffic (Répartir le trafic) en haut à droite de la page "Versions".
7. Configurez la répartition du trafic de manière à en diffuser 50 % vers l'ancienne version et 50 % vers la nouvelle.
8. Sélectionnez la case d'option permettant de répartir le trafic entre les versions de manière aléatoire.
9. Cliquez sur Save (Enregistrer).
10. Accédez au site et actualisez la page d'accueil plusieurs fois.

Mettre à jour l'application dans l'environnement flexible App Engine

Bonus

En prime, vous pouvez explorer l'activation des fonctionnalités Cloud Debugger et Cloud Error Reporting dans votre application. Suivez les étapes décrites dans le guide de l'atelier Déboguer les erreurs liées aux applications pour effectuer les opérations suivantes :

1. Créer un dépôt Cloud Source Repositories
2. Transférer le code approprié dans le dépôt
3. Configurer Cloud Debugger et Cloud Error Reporting
4. Explorer les instantanés et les points de journalisation associés au débogage
5. Explorer Error Reporting
6. Consulter Cloud Logging

Terminer l'atelier

Une fois l'atelier terminé, cliquez sur Terminer l'atelier. Google Cloud Skills Boost supprime les ressources que vous avez utilisées, puis efface le compte.

Si vous le souhaitez, vous pouvez noter l'atelier. Sélectionnez un nombre d'étoiles, saisissez un commentaire, puis cliquez sur Envoyer.

Le nombre d'étoiles correspond à votre degré de satisfaction :

• 1 étoile = très insatisfait(e)
• 2 étoiles = insatisfait(e)
• 3 étoiles = ni insatisfait(e), ni satisfait(e)
• 4 étoiles = satisfait(e)
• 5 étoiles = très satisfait(e)

Si vous ne souhaitez pas donner votre avis, vous pouvez fermer la boîte de dialogue.

Pour soumettre des commentaires, suggestions ou corrections, veuillez accéder à l'onglet Assistance.

Copyright 2020 Google LLC Tous droits réservés. Google et le logo Google sont des marques de Google LLC. Tous les autres noms d'entreprises et de produits peuvent être des marques des entreprises auxquelles ils sont associés.