1. Avant de commencer
L'exécution de sites Web peut s'avérer difficile en raison des frais généraux liés à la création et à la gestion d'instances de machines virtuelles (VM), de clusters, de pods, de services, etc. Cela ne pose pas de problème pour les applications plus importantes et à plusieurs niveaux, mais, si vous cherchez simplement à déployer et à assurer la visibilité de votre site Web, cela représente des frais généraux conséquents.
Avec Cloud Run, l'implémentation Google Cloud de Knative, vous pouvez gérer et déployer votre site Web sans les frais généraux liés aux déploiements sur des VM ou Kubernetes. Il s'agit non seulement d'une approche plus simple du point de vue de la gestion, mais cela vous permet également d'effectuer un scaling à zéro instance lorsqu'aucune demande n'arrive sur votre site Web.
Dans cet atelier de programmation, vous commencerez avec une image Docker créée via Cloud Build, que vous déclencherez dans Cloud Shell. Vous allez ensuite déployer cette image dans Cloud Run à l'aide d'une commande dans Cloud Shell.
Prérequis
- Connaissances générales de Docker (consultez la section Premiers pas du site Web de Docker).
Points abordés
- Créer une image Docker avec Cloud Build et l'importer sur gcr.io
- Le déploiement d'images Docker dans Cloud Run
- La gestion des déploiements dans Cloud Run
- Configurer un point de terminaison pour une application sur Cloud Run
Ce que vous allez faire
- Un site Web statique exécuté dans un conteneur Docker
- Une version de ce conteneur qui se trouve dans Container Registry
- Un déploiement Cloud Run pour votre site Web statique
Prérequis
- Compte Google doté d'un accès administrateur pour créer un ou plusieurs projets avec le rôle de propriétaire de projet
2. Cofiguration de l'environnement
Configuration de l'environnement au rythme de chacun
Si vous ne possédez pas encore de compte Google, vous devez en créer un. Connectez-vous ensuite à la console Google Cloud, puis cliquez sur Project > Create project (Projet > Créer un projet).
Mémorisez l'ID du projet, qui est automatiquement renseigné sous le nom du projet. L'ID du projet est un nom unique pour tous les projets Google Cloud. Le nom indiqué dans la capture d'écran est donc déjà pris et ne vous sera pas attribué. Il sera désigné plus loin par le nom PROJECT_ID.
Vous devez ensuite activer la facturation dans la console Cloud pour utiliser les ressources Google Cloud et activer l'API Cloud Run.
Activer l'API Cloud Run
Cliquez sur le menu de navigation ☰ > API et services > Tableau de bord > Activer les API et les services. .
Recherchez "API Cloud Run", puis cliquez sur API Cloud Run > Activer.
Suivre cet atelier de programmation ne devrait pas vous coûter plus d'un euro. Cependant, cela peut s'avérer plus coûteux si vous décidez d'utiliser davantage de ressources ou si vous n'interrompez pas les ressources (voir Nettoyage à la fin). Pour en savoir plus, consultez la section Tarifs.
Les nouveaux utilisateurs de Google Cloud peuvent s'inscrire à un essai sans frais pour bénéficier d'un crédit de 300$valable pour un essai sans frais.
Cloud Shell
Bien que vous puissiez commander Google Cloud et Cloud Run à distance depuis votre ordinateur portable, vous allez utiliser Cloud Shell, un environnement de ligne de commande exécuté dans Google Cloud. L'environnement est préconfiguré avec toutes les bibliothèques et frameworks clients dont vous avez besoin.
Cette machine virtuelle basée sur Debian contient tous les outils de développement dont vous aurez besoin. Elle intègre 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. Cela signifie que tout ce dont vous avez besoin pour cet atelier de programmation est un navigateur (oui, tout fonctionne sur un Chromebook).
- Pour activer Cloud Shell à partir de Cloud Console, cliquez simplement sur Activer Cloud Shell
(l'opération de provisionnement et la connexion à l'environnement ne devraient prendre que quelques minutes).
Une fois connecté à Cloud Shell, vous êtes normalement déjà authentifié et le projet PROJECT_ID est sélectionné :
gcloud auth list
Résultat de la commande
Credentialed accounts: - <myaccount>@<mydomain>.com (active)
gcloud config list project
Résultat de la commande
[core] project = <PROJECT_ID>
Si, pour une raison quelconque, le projet n'est pas défini, exécutez simplement la commande suivante :
gcloud config set project <PROJECT_ID>
Vous recherchez votre PROJECT_ID ? Vérifiez l'ID que vous avez utilisé pendant les étapes de configuration ou recherchez-le dans le tableau de bord Cloud Console :
Par défaut, Cloud Shell définit certaines variables d'environnement qui pourront s'avérer utiles pour exécuter certaines commandes dans le futur.
echo $GOOGLE_CLOUD_PROJECT
Résultat de la commande
<PROJECT_ID>
- Pour finir, définissez la configuration du projet et de la zone par défaut :
gcloud config set compute/zone us-central1-f
Vous pouvez choisir parmi différentes zones. Pour en savoir plus, consultez la page Régions et zones.
3. Cloner le dépôt source
Puisque vous déployez un site Web existant, il vous suffit de cloner la source à partir de votre dépôt, ce qui vous permet de vous concentrer sur la création d'images Docker et sur leur déploiement dans Cloud Run.
Exécutez les commandes suivantes pour cloner le dépôt dans votre instance Cloud Shell et pour accéder au répertoire approprié. Vous allez également installer les dépendances Node.js pour pouvoir tester votre application avant de la déployer.
cd ~ git clone https://github.com/googlecodelabs/monolith-to-microservices.git cd ~/monolith-to-microservices ./setup.sh
Cela clone votre dépôt, accède au répertoire et installe les dépendances nécessaires pour exécuter votre application en local. L'exécution du script peut prendre quelques minutes.
Faites preuve de diligence et testez votre application. Exécutez la commande suivante pour démarrer votre serveur Web:
cd ~/monolith-to-microservices/monolith npm start
Sortie :
Monolith listening on port 8080!
Vous pouvez prévisualiser votre application en cliquant sur Aperçu sur le Web
, puis en sélectionnant Prévisualiser sur le port 8080.
Une nouvelle fenêtre s'affiche, dans laquelle vous pouvez voir votre Fancy Store en ligne.
Vous pouvez fermer cette fenêtre après avoir consulté le site Web. Pour arrêter le processus du serveur Web, appuyez sur CONTROL+C (Command+C sur Macintosh) dans la fenêtre du terminal.
4. Créer un conteneur Docker avec Cloud Build
Maintenant que vos fichiers sources sont prêts à l'emploi, il est temps de déployer votre application dans un conteneur Docker.
En temps normal, vous devriez adopter une approche en deux étapes consistant à créer un conteneur Docker, puis à le transférer vers un registre afin de stocker l'image pour que GKE puisse l'extraire. Toutefois, vous pouvez vous simplifier la vie en utilisant Cloud Build pour créer le conteneur Docker et pour placer l'image dans Container Registry en une seule commande. Pour découvrir comment créer et transférer un fichier Docker manuellement, consultez le Guide de démarrage rapide pour Container Registry.
Cloud Build compresse les fichiers du répertoire et les déplace vers un bucket Cloud Storage. Le processus de compilation récupère ensuite tous les fichiers du bucket et utilise le Dockerfile, qui se trouve dans le même répertoire, pour exécuter le processus de compilation Docker. Étant donné que vous avez spécifié l'option --tag avec l'hôte en tant que gcr.io pour l'image Docker, l'image Docker résultante sera transférée vers Container Registry.
Vous devez d'abord vous assurer que l'API Cloud Build est activée. Exécutez la commande suivante pour l'activer :
gcloud services enable cloudbuild.googleapis.com
Une fois l'API activée, exécutez la commande suivante dans Cloud Shell pour lancer le processus de compilation:
gcloud builds submit --tag gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:1.0.0 .
Ce processus prend quelques minutes, mais une fois terminé, la sortie sur le terminal ressemble à ceci:
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- ID CREATE_TIME DURATION SOURCE IMAGES STATUS 1ae295d9-63cb-482c-959b-bc52e9644d53 2019-08-29T01:56:35+00:00 33S gs://<PROJECT_ID>_cloudbuild/source/1567043793.94-abfd382011724422bf49af1558b894aa.tgz gcr.io/<PROJECT_ID>/monolith:1.0.0 SUCCESS
Pour consulter votre historique de compilation ou suivre le processus en temps réel, accédez à la console Cloud, puis cliquez sur Menu de navigation ☰ > Cloud Build > Historique. La liste de toutes vos compilations précédentes s'affiche ici. Seule celle que vous venez de créer devrait donc apparaître.
Si vous cliquez sur ID de la compilation, vous pouvez consulter tous les détails de cette compilation, y compris la sortie du journal. Vous pouvez consulter l'image de conteneur créée en cliquant sur le lien à côté de Image.
5. Déployer un conteneur dans Cloud Run
Maintenant que vous avez conteneurisé votre site Web et l'avez transféré dans Container Registry, il est temps de le déployer dans Cloud Run.
Deux approches sont possibles pour le déploiement dans Cloud Run :
- Cloud Run (entièrement géré) est le modèle PaaS dans lequel l'ensemble du cycle de vie des conteneurs est géré. Vous utiliserez cette approche pour cet atelier de programmation.
- Cloud Run for Anthos est Cloud Run avec une couche de contrôle supplémentaire qui vous permet d'utiliser vos propres clusters et pods provenant de GKE. Pour en savoir plus, consultez Configurer Cloud Run for Anthos sur Google Cloud.
Les exemples de ligne de commande se trouvent dans Cloud Shell et utilisent les variables d'environnement que vous avez configurées précédemment.
Ligne de commande
Exécutez la commande suivante pour déployer votre application :
gcloud run deploy --image=gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:1.0.0 --platform managed
Vous serez invité à spécifier la région dans laquelle vous souhaitez exécuter l'application. Sélectionnez la région la plus proche de vous, puis acceptez le nom de service suggéré par défaut ("monolith").
À des fins de test, autorisez les requêtes non authentifiées à l'application. Saisissez y à l'invite.
Vérifier le déploiement
Pour vérifier que le déploiement a bien été créé, exécutez la commande suivante. La préparation de Pod status peut prendre quelques instants pour devenir Running:
gcloud run services list
Sélectionnez [1] Cloud Run (entièrement géré).
Sortie :
SERVICE REGION URL LAST DEPLOYED BY LAST DEPLOYED AT ✔ monolith us-east1 <your url> <your email> 2019-09-16T21:07:38.267Z
Le résultat vous indique plusieurs choses. Vous pouvez voir votre déploiement, l'utilisateur responsable du déploiement (votre adresse e-mail) et l'URL que vous pouvez utiliser pour accéder à l'application. Tous les éléments semblent avoir été créés correctement.
Ouvrez l'URL fournie dans la liste des services dans votre navigateur Web. Le site Web qui s'affiche devrait être le même que celui dont vous avez affiché l'aperçu localement.
6. Créer une révision avec une simultanéité inférieure
Déployez à nouveau votre application, mais cette fois-ci, ajustez l'un des paramètres.
Par défaut, la valeur de simultanéité d'une application Cloud Run correspond à 80, ce qui signifie que chaque instance de conteneur peut traiter jusqu'à 80 requêtes à la fois. Cela représente un écart important par rapport au modèle Functions as a Service (FaaS), dans lequel une instance traite une requête à la fois.
Redéployez la même image de conteneur avec une valeur de simultanéité correspondant à 1 (pour les tests uniquement) et observez le résultat.
gcloud run deploy --image=gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:1.0.0 --platform managed --concurrency 1
Répondez aux questions suivantes comme vous l'avez fait la première fois. Une fois la commande réussie, consultez la console Cloud pour afficher le résultat.
Dans le tableau de bord Cloud Run, cliquez sur le service monolith pour afficher les détails.
Cliquez sur l'onglet Révisions. Deux révisions créées devraient s'afficher. Cliquez sur monolith-00002 et examinez les détails. La valeur de simultanéité devrait être réduite à 1.
]
Même si cette configuration est suffisante pour les tests, dans la plupart des scénarios de production, les conteneurs prennent en charge plusieurs requêtes simultanées.
Restaurez maintenant la simultanéité d'origine sans redéploiement. Vous pouvez définir la valeur de simultanéité sur la valeur par défaut de 80 ou 0, ce qui supprimera toute restriction de simultanéité et définira la valeur maximale par défaut (qui se trouve être 80 au moment de la rédaction de cet article).
Exécutez la commande suivante dans Cloud Shell pour mettre à jour la révision actuelle:
gcloud run deploy --image=gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:1.0.0 --platform managed --concurrency 80
Notez qu'une autre révision a été créée, que le trafic a été redirigé et que la simultanéité est à nouveau de 80.
7. Apporter des modifications au site Web
Votre équipe marketing vous a demandé de modifier la page d'accueil du site Web de votre entreprise. Elle estime en effet que cette page doit fournir plus d'informations sur l'entreprise et sur les produits qu'elle commercialise. Dans cette section, vous allez ajouter du texte à la page d'accueil pour répondre aux attentes de l'équipe marketing.
Il semble qu'un de vos développeurs ait déjà créé les modifications avec le nom de fichier index.js.new. Il vous suffit de copier ce fichier dans index.js pour répercuter vos modifications. Suivez les instructions pour apporter les modifications appropriées.
Exécutez les commandes suivantes, copiez le fichier mis à jour sous le nom de fichier correct, puis affichez son contenu pour vérifier les modifications:
cd ~/monolith-to-microservices/react-app/src/pages/Home mv index.js.new index.js cat ~/monolith-to-microservices/react-app/src/pages/Home/index.js
Le code obtenu doit se présenter comme suit :
/*
Copyright 2019 Google LLC
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
https://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/
import React from "react";
import { makeStyles } from "@material-ui/core/styles";
import Paper from "@material-ui/core/Paper";
import Typography from "@material-ui/core/Typography";
const useStyles = makeStyles(theme => ({
root: {
flexGrow: 1
},
paper: {
width: "800px",
margin: "0 auto",
padding: theme.spacing(3, 2)
}
}));
export default function Home() {
const classes = useStyles();
return (
<div className={classes.root}>
<Paper className={classes.paper}>
<Typography variant="h5">
Fancy Fashion & Style Online
</Typography>
<br />
<Typography variant="body1">
Tired of mainstream fashion ideas, popular trends and societal norms?
This line of lifestyle products will help you catch up with the Fancy trend and express your personal style.
Start shopping Fancy items now!
</Typography>
</Paper>
</div>
);
}
Vous avez mis à jour les composants React, mais vous devez compiler l'application React pour générer les fichiers statiques. Exécutez la commande suivante pour compiler l'application React et la copier dans le répertoire public "monolith" :
cd ~/monolith-to-microservices/react-app npm run build:monolith
Maintenant que votre code a été mis à jour, vous devez recompiler votre conteneur Docker et le publier dans Container Registry. Vous pouvez utiliser la même commande que précédemment, mais cette fois en mettant à jour l'étiquette de la version.
Exécutez la commande suivante pour déclencher une nouvelle compilation Cloud Build avec la version d'image mise à jour de 2.0.0 :
cd ~/monolith-to-microservices/monolith
#Feel free to test your application
npm start
gcloud builds submit --tag gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:2.0.0 .
Dans la section suivante, vous allez utiliser cette image pour mettre à jour votre application sans aucun temps d'arrêt.
8. Mettre à jour le site Web sans aucun temps d'arrêt
Les modifications ont été effectuées, puis validées par l'équipe marketing. Il est temps de mettre à jour le site Web sans interrompre le travail des utilisateurs.
Cloud Run traite chaque déploiement comme une nouvelle révision, qui est mise en ligne avant que le trafic y soit redirigé.
Suivez les instructions suivantes pour mettre à jour votre site Web.
Ligne de commande
Depuis la ligne de commande, vous pouvez redéployer le service pour remplacer l'image par une nouvelle version avec la commande suivante:
gcloud run deploy --image=gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:2.0.0 --platform managed
Vérifier le déploiement
Validez la mise à jour de votre déploiement en exécutant la commande suivante:
gcloud run services describe monolith --platform managed
Le résultat ressemble à ceci :
apiVersion: serving.knative.dev/v1alpha1
kind: Service
metadata:
annotations:
client.knative.dev/user-image: gcr.io/my-cloudrun-codelab/monolith:2.0.0
...
Vous constaterez que votre service utilise désormais la dernière version de votre image déployée dans une nouvelle révision.
Pour vérifier vos modifications, accédez à nouveau à l'URL externe de votre service Cloud Run et notez que le titre de votre application a été mis à jour.
Exécutez la commande suivante pour lister les services et afficher l'adresse IP si vous l'avez oubliée:
gcloud run services list
Votre site Web doit maintenant afficher le texte que vous avez ajouté au composant de la page d'accueil.
9. Effectuer un nettoyage
Supprimer des images Container Registry
# Delete the container image for version 1.0.0 of our monolith
gcloud container images delete gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:1.0.0 --quiet
# Delete the container image for version 2.0.0 of our monolith
gcloud container images delete gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:2.0.0 --quiet
Supprimer les artefacts Cloud Build de Cloud Storage
# The following command will take all source archives from all builds and delete them from cloud storage
# Run this command to print all sources:
# gcloud builds list | awk 'NR > 1 {print $4}'
gcloud builds list | awk 'NR > 1 {print $4}' | while read line; do gsutil rm $line; done
Supprimer le service Cloud Run
gcloud run services delete monolith --platform managed
10. Félicitations
Vous avez déployé, redimensionné et mis à jour votre site Web avec Cloud Run.