1. Introduction
Dernière mise à jour : 01/11/2024
Comment moderniser une ancienne application PHP sur Google Cloud ?
(📽️ Regardez une vidéo de présentation de sept minutes sur cet atelier de programmation)
Il est courant d'avoir des applications anciennes exécutées sur site qui doivent être modernisées. Cela signifie qu'ils doivent être évolutifs, sécurisés et déployables dans différents environnements.
Au cours de cet atelier, vous allez :
- Conteneuriser l'application PHP.
- Migrer vers un service de base de données géré (Cloud SQL)
- Déployez sur Cloud Run (alternative sans opérations à GKE/Kubernetes).
- Sécuriser l'application avec Identity and Access Management (IAM) et Secret Manager
- Définir un pipeline CI/CD via Cloud Build. Cloud Build peut être connecté à votre dépôt Git hébergé sur des fournisseurs Git populaires tels que GitHub ou GitLab, et être déclenché à chaque push vers la branche principale, par exemple.
- Hébergez les images de l'application sur Cloud Storage. Pour ce faire, il suffit de monter le volume. Aucune modification du code de l'application n'est nécessaire.
- Introduire des fonctionnalités d'IA générative via Gemini, orchestrées par Cloud Functions (sans serveur).
- Familiarisez-vous avec les SLO et l'utilisation de votre application récemment actualisée.
En suivant ces étapes, vous pouvez moderniser progressivement votre application PHP, en améliorant son évolutivité, sa sécurité et sa flexibilité de déploiement. De plus, migrer vers Google Cloud vous permet de tirer parti de son infrastructure et de ses services puissants pour assurer le bon fonctionnement de votre application dans un environnement cloud natif.
Nous pensons que ce que vous apprendrez en suivant ces étapes simples pourra être appliqué à votre propre application et à votre organisation, avec un langage/une pile et des cas d'utilisation différents.
À propos de l'application
L'application (code, sous licence MIT) que vous allez dupliquer est une application PHP 5.7 de base avec authentification MySQL. L'idée principale de l'application est de fournir une plate-forme sur laquelle les utilisateurs peuvent importer des photos et les administrateurs peuvent taguer les images inappropriées. L'application comporte deux tables :
- Utilisateurs. Précompilé avec les administrateurs. De nouvelles personnes peuvent s'inscrire.
- Images. Fourni avec quelques exemples d'images. Les utilisateurs connectés peuvent importer de nouvelles photos. Nous allons ajouter un peu de magie ici.
Votre objectif
Nous voulons moderniser l'ancienne application pour l'intégrer à Google Cloud. Nous utiliserons ses outils et services pour améliorer l'évolutivité, renforcer la sécurité, automatiser la gestion de l'infrastructure et intégrer des fonctionnalités avancées telles que le traitement d'images, la surveillance et le stockage de données à l'aide de services tels que Cloud SQL, Cloud Run, Cloud Build, Secret Manager et plus encore.

Plus important encore, nous voulons le faire étape par étape afin que vous puissiez comprendre le raisonnement derrière chaque étape. En général, chaque étape ouvre de nouvelles possibilités pour les suivantes (par exemple, les modules 2 -> 3 et 6 -> 7).
Vous n'êtes pas encore convaincu ? Regardez cette vidéo de sept minutes sur YouTube.
Prérequis
- Un ordinateur avec un navigateur, connecté à Internet.
- Des crédits GCP. Pour ce faire, consultez l'étape suivante.
- Vous allez utiliser Cloud Shell. Il est fourni avec toutes les commandes préinstallées dont vous aurez besoin et un IDE.
- Compte GitHub Vous en aurez besoin pour créer une branche du code d'origine 🧑🏻💻 gdgpescara/app-mod-workshop avec votre propre dépôt Git. Cela est nécessaire pour disposer de votre propre pipeline CI/CD (commit automatique -> compilation -> déploiement).
Vous trouverez des exemples de solutions ici :
- Le dépôt de l'auteur : https://github.com/Friends-of-Ricc/app-mod-workshop
- Le dépôt d'atelier d'origine, dans les dossiers
.solutions/, par chapitre.
Cet atelier est conçu pour être réalisé dans Cloud Shell (dans un navigateur).
Toutefois, vous pouvez également l'essayer depuis votre ordinateur local.
2. Configuration du crédit et fork

Utiliser le crédit GCP et configurer votre environnement GCP [facultatif]
Pour suivre cet atelier, vous devez disposer d'un compte de facturation avec un certain crédit. Utilisez les crédits de la bannière en haut de cet atelier de programmation pour commencer. Si vous êtes déjà connecté à un compte de facturation, vous pouvez ignorer cette étape.
Une fois l'opération terminée, ouvrez la console Google Cloud et créez un projet en cliquant sur le sélecteur de projet dans le menu déroulant en haut à gauche, où s'affiche "Aucune organisation". Voir ci-dessous

Si vous n'avez pas de projet, créez-en un, comme illustré dans la capture d'écran ci-dessous. Une option "NOUVEAU PROJET" s'affiche en haut à droite.

Assurez-vous d'associer le nouveau projet au compte de facturation de l'essai GCP comme suit.

Vous êtes prêt à utiliser Google Cloud Platform. Si vous débutez ou si vous souhaitez simplement tout faire dans un environnement cloud, vous pouvez accéder à Cloud Shell et à son éditeur en cliquant sur le bouton situé en haut à gauche, comme illustré ci-dessous.

Assurez-vous que votre nouveau projet est sélectionné en haut à gauche :
Non sélectionné (mauvais) :

Sélectionné (bon) :

Dupliquer l'application depuis GitHub
- Accédez à l'application de démonstration : https://github.com/gdgpescara/app-mod-workshop.
- Cliquez sur 🍴 Fork (Dupliquer).
- Si vous n'avez pas de compte GitHub, vous devez en créer un.
- Modifiez les éléments comme vous le souhaitez.

- Clonez le code de l'application à l'aide de la commande suivante :
git clonehttps://github.com/YOUR-GITHUB-USER/YOUR-REPO-NAME
- Ouvrez le dossier du projet cloné dans l'éditeur de votre choix. Si vous choisissez Cloud Shell, vous pouvez le faire en cliquant sur Ouvrir l'éditeur, comme indiqué ci-dessous.

Vous disposez de tout ce dont vous avez besoin avec l'éditeur Google Cloud Shell, comme illustré dans la figure suivante.

Pour ce faire, vous pouvez cliquer sur "Ouvrir un dossier" et sélectionner le dossier, probablement app-mod-workshop dans votre dossier d'accueil.
3. Module 1 : Créer une instance SQL
Créer l'instance Google Cloud SQL
Notre application PHP se connectera à une base de données MySQL. Nous devons donc la répliquer sur Google Cloud pour une migration sans problème. Cloud SQL est la solution idéale, car il vous permet d'exécuter une base de données MySQL entièrement gérée dans le cloud. Voici les étapes à suivre :
- Accédez à la page Cloud SQL : https://console.cloud.google.com/sql/instances.
- Cliquez sur "Créer une instance".
- Activer l'API (si nécessaire). Cette opération peut prendre quelques secondes.
- Choisissez MySQL.
- (Nous essayons de vous proposer la version la moins chère pour qu'elle dure plus longtemps) :
- Édition : Enterprise
- Preset : development (nous avons essayé Sandbox, mais cela n'a pas fonctionné pour nous)
- Version de MySQL : 5.7 (un vrai retour dans le passé !)
- ID d'instance : sélectionnez
appmod-phpapp(si vous modifiez cette valeur, n'oubliez pas de modifier également les scripts et solutions futurs en conséquence). - Mot de passe : celui de votre choix, mais notez-le sous le nom CLOUDSQL_INSTANCE_PASSWORD
- Région : conservez la même que celle que vous avez choisie pour le reste de l'application (par exemple, Milan =
europe-west8). - Disponibilité zonale : zone unique (nous économisons de l'argent pour la démonstration)
Cliquez sur le bouton "Créer une instance" pour déployer la base de données Cloud SQL. ⌛ Cette opération prend environ 10 minutes.⌛ En attendant, continuez à lire la documentation. Vous pouvez également commencer à résoudre le module suivant ("Conteneuriser votre application PHP"), car il ne dépend pas de ce module dans la première partie (jusqu'à ce que vous corrigiez la connexion à la base de données).
Remarque : Cette instance devrait vous coûter environ 7 $/jour. Veillez à le faire après l'atelier.
Créer la base de données image_catalog et l'utilisateur dans Cloud SQL
Le projet d'application est fourni avec un dossier db/ contenant deux fichiers SQL :
- 01_schema.sql : contient le code SQL permettant de créer deux tables contenant des données sur les utilisateurs et les images.
- 02_seed.sql : contient le code SQL permettant d'insérer des données dans les tables créées précédemment.
Ces fichiers seront utilisés ultérieurement, une fois la base de données image_catalog créée. Pour ce faire, procédez comme suit :
- Ouvrez votre instance et cliquez sur l'onglet "Bases de données" :
- cliquez sur "Créer une base de données".
- Nommez-le
image_catalog(comme dans la configuration de l'application PHP).

Ensuite, nous créons l'utilisateur de la base de données. Cela nous permet de nous authentifier dans la base de données image_catalog.
- Cliquez maintenant sur l'onglet Utilisateurs.
- Cliquez sur "Ajouter un compte utilisateur".
- Utilisateur : créons-en un :
- Nom d'utilisateur :
appmod-phpapp-user - Mot de passe : choisissez un mot de passe dont vous vous souviendrez ou cliquez sur "Générer".
- Conservez l'option "Autoriser tous les hôtes (%)".
- cliquez sur "AJOUTER".
Ouvrir la base de données aux adresses IP connues
Notez que toutes les bases de données de Cloud SQL sont créées "isolées". Vous devez configurer explicitement un réseau à partir duquel l'accès est possible.
- Cliquez sur votre instance.
- Ouvrez le menu "Connexions".
- Cliquez sur l'onglet "Mise en réseau".
- Cliquez sous "Réseaux autorisés". Ajoutez maintenant un réseau (c'est-à-dire un sous-réseau).
- Pour l'instant, choisissons des paramètres rapides, mais NON SÉCURISÉS, pour permettre à l'application de fonctionner. Vous pourrez ensuite limiter l'accès aux adresses IP de confiance :
- Nom : "Tout le monde – NON SÉCURISÉ".
- Réseau : "
0.0.0.0/0"(Remarque : il s'agit de la partie NON SÉCURISÉE !) - Cliquez sur OK.
- Cliquez sur "Enregistrer".
L'écran qui s'affiche devrait ressembler à ce qui suit :

Remarque : Cette solution est un bon compromis pour terminer l'atelier en quelques heures. Toutefois, consultez le document SÉCURITÉ pour sécuriser votre solution pour la production.
Il est temps de tester la connexion à la base de données.
Vérifions si l'utilisateur image_catalog que nous avons créé précédemment fonctionne.
Accédez à "Cloud SQL Studio" dans l'instance, puis saisissez la base de données, l'utilisateur et le mot de passe pour vous authentifier, comme indiqué ci-dessous :

Maintenant que vous êtes connecté, vous pouvez ouvrir l'éditeur SQL et passer à la section suivante.
Importer la base de données à partir du codebase
Utilisez l'éditeur SQL pour importer les tables image_catalog avec leurs données. Copiez le code SQL des fichiers du dépôt (01_schema.sql, puis 02_seed.sql) et exécutez-les l'un après l'autre dans un ordre séquentiel.
Vous devriez alors obtenir deux tables dans image_catalog : users et images, comme illustré ci-dessous :

Vous pouvez le tester en exécutant la commande suivante dans l'éditeur : select * from images;
Notez également l'adresse IP publique de l'instance Cloud SQL, car vous en aurez besoin plus tard. Pour obtenir l'adresse IP, accédez à la page principale de l'instance Cloud SQL, sous la page Présentation. (Présentation > Se connecter à cette instance > Adresse IP publique).
4. Module 2 : Conteneuriser votre application PHP

Nous voulons créer cette application pour le cloud.
Cela signifie que vous devez empaqueter le code dans un fichier ZIP contenant toutes les informations nécessaires pour l'exécuter dans le cloud.
Il existe plusieurs façons de l'empaqueter :
- Docker Très populaire, mais assez complexe à configurer correctement.
- Buildpacks. Moins populaire, mais tend à "deviner automatiquement" ce qu'il faut compiler et exécuter. Souvent, cela fonctionne sans problème.
Dans le cadre de cet atelier, nous supposerons que vous utilisez Docker.
Si vous avez choisi d'utiliser Cloud Shell, rouvrez-le maintenant (cliquez en haut à droite de la console Cloud).

Un shell pratique devrait s'ouvrir en bas de la page, où vous devriez avoir dupliqué le code à l'étape de configuration.

Docker
Si vous souhaitez garder le contrôle, c'est la solution qu'il vous faut. Cela est utile lorsque vous devez configurer des bibliothèques spécifiques et injecter certains comportements non évidents (un chmod dans les importations, un exécutable non standard dans votre application, etc.).
Comme nous voulons déployer notre application conteneurisée sur Cloud Run, consultez la documentation suivante. Comment feriez-vous pour le rétro-porter de PHP 8 vers PHP 5.7 ? Peut-être que vous pouvez utiliser Gemini pour ça. Vous pouvez également utiliser cette version préconfigurée :
# Use the official PHP image: https://hub.docker.com/_/php
FROM php:5.6-apache
# Configure PHP for Cloud Run.
# Precompile PHP code with opcache.
# Install PHP's extension for MySQL
RUN docker-php-ext-install -j "$(nproc)" opcache mysqli pdo pdo_mysql && docker-php-ext-enable pdo_mysql
RUN set -ex; \
{ \
echo "; Cloud Run enforces memory & timeouts"; \
echo "memory_limit = -1"; \
echo "max_execution_time = 0"; \
echo "; File upload at Cloud Run network limit"; \
echo "upload_max_filesize = 32M"; \
echo "post_max_size = 32M"; \
echo "; Configure Opcache for Containers"; \
echo "opcache.enable = On"; \
echo "opcache.validate_timestamps = Off"; \
echo "; Configure Opcache Memory (Application-specific)"; \
echo "opcache.memory_consumption = 32"; \
} > "$PHP_INI_DIR/conf.d/cloud-run.ini"
# Copy in custom code from the host machine.
WORKDIR /var/www/html
COPY . .
# Setup the PORT environment variable in Apache configuration files: https://cloud.google.com/run/docs/reference/container-contract#port
ENV PORT=8080
# Tell Apache to use 8080 instead of 80.
RUN sed -i 's/80/${PORT}/g' /etc/apache2/sites-available/000-default.conf /etc/apache2/ports.conf
# Note: This is quite insecure and opens security breaches. See last chapter for hardening ideas.
# Uncomment at your own risk:
#RUN chmod 777 /var/www/html/uploads/
# Configure PHP for development.
# Switch to the production php.ini for production operations.
# RUN mv "$PHP_INI_DIR/php.ini-production" "$PHP_INI_DIR/php.ini"
# https://github.com/docker-library/docs/blob/master/php/README.md#configuration
RUN mv "$PHP_INI_DIR/php.ini-development" "$PHP_INI_DIR/php.ini"
# Expose the port
EXPOSE 8080
La dernière version de Dockerfile est disponible ici.
Pour tester notre application localement, nous devons modifier le fichier config.php de manière à ce que notre application PHP se connecte à la base de données MySQL disponible sur Google Cloud SQL. En fonction de ce que vous avez configuré précédemment, remplissez les espaces vides :
<?php
// Database configuration
$db_host = '____________';
$db_name = '____________';
$db_user = '____________';
$db_pass = '____________';
try {
$pdo = new PDO("mysql:host=$db_host;dbname=$db_name", $db_user, $db_pass);
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
} catch (PDOException $e) {
die("Errore di connessione: " . $e->getMessage());
}
session_start();
?>
DB_HOSTest l'adresse IP publique Cloud SQL. Vous la trouverez dans la console SQL :

DB_NAMEne doit pas être modifié :image_catalogDB_USERdoit êtreappmod-phpapp-userDB_PASSest un élément que vous avez choisi. Configurez-le entre guillemets simples et échappez-le si nécessaire.
N'hésitez pas non plus à traduire les quelques passages en italien 🇮🇹 en français à l'aide de Gemini !
Maintenant que vous disposez de l'adresse IP Dockerfile et que vous avez configuré votre application PHP pour qu'elle se connecte à votre base de données, essayons de l'exécuter.
Installez Docker si vous ne l'avez pas encore fait (lien). Vous n'en avez pas besoin si vous utilisez Cloud Shell (génial, non ?).
Essayez maintenant de créer et d'exécuter votre application PHP conteneurisée à l'aide des commandes docker build et docker run appropriées.
# Build command - don't forget the final . This works if Dockerfile is inside the code folder:
$ docker build -t my-php-app-docker .
# Local Run command: most likely ports will be 8080:8080
$ docker run -it -p <CONTAINER_PORT>:<LOCAL_MACHINE_PORT> my-php-app-docker
Si tout fonctionne, vous devriez voir la page Web suivante lorsque vous êtes connecté à l'hôte local. Maintenant que votre application s'exécute sur le port 8080, cliquez sur l'icône "Aperçu sur le Web" (un navigateur avec un œil), puis sur Prévisualiser sur le port 8080 (ou "Changer de port" pour tout autre port).

Tester le résultat dans votre navigateur
Votre application devrait maintenant ressembler à ceci :

Si vous vous connectez avec Admin/admin123, vous devriez voir quelque chose comme ceci.

Super ! À part le texte en italien, ça fonctionne ! 🎉🎉🎉
Si votre dockerisation est correcte, mais que les identifiants de la base de données sont incorrects, vous pouvez obtenir un résultat semblable à celui-ci :

Réessayez, vous y êtes presque !
Enregistrer dans Artifact Registry [facultatif]
Vous devriez maintenant disposer d'une application PHP conteneurisée fonctionnelle, prête à être déployée dans le cloud. Nous avons maintenant besoin d'un emplacement dans le cloud pour stocker notre image Docker et la rendre accessible pour le déploiement sur des services Google Cloud tels que Cloud Run. Cette solution de stockage s'appelle Artifact Registry. Il s'agit d'un service Google Cloud entièrement géré conçu pour stocker des artefacts d'application, y compris des images de conteneurs Docker, des packages Maven, des modules npm et plus encore.
Créons un dépôt dans Google Cloud Artifact Registry à l'aide du bouton approprié.

Choisissez un nom valide, le format et la région appropriés pour stocker les artefacts.

Revenez à votre environnement de développement local, puis ajoutez un tag à l'image de conteneur de l'application et transférez-la vers le dépôt Artifact Registry que vous venez de créer. Pour ce faire, exécutez les commandes suivantes.
- docker tag SOURCE_IMAGE[:TAG] TARGET_IMAGE[:TAG]
- docker push TARGET_IMAGE[:TAG]
Le résultat doit ressembler à la capture d'écran suivante.

Bravo 🎉🎉🎉 ! Vous pouvez passer au niveau suivant. Avant cela, prenez deux minutes pour essayer d'importer des fichiers, de vous connecter et de vous déconnecter, et pour vous familiariser avec les points de terminaison de l'application.Vous en aurez besoin plus tard.
Erreurs possibles
Si vous rencontrez des erreurs de conteneurisation, essayez d'utiliser Gemini pour expliquer et corriger l'erreur, en fournissant :
- Votre Dockerfile actuel
- L'erreur reçue
- [si nécessaire] le code PHP en cours d'exécution.
Autorisations d'importation. Essayez également le point de terminaison /upload.php et essayez d'importer une image. L'erreur ci-dessous peut s'afficher. Si c'est le cas, vous devez corriger chmod/chown dans Dockerfile.
Warning: move_uploaded_file(uploads/image (3).png): failed to open stream: Permission denied in /var/www/html/upload.php on line 11
PDOException "could not find driver" (ou "Errore di connessione: could not find driver"). Assurez-vous que votre Dockerfile dispose des bibliothèques PDO appropriées pour mysql (pdo_mysql) afin de se connecter à la base de données. Inspirez-vous des solutions ici.
Impossible de transférer votre requête à un backend. Impossible de se connecter à un serveur sur le port 8080. Cela signifie que vous exposez probablement le mauvais port. Assurez-vous d'exposer le port à partir duquel Apache/Nginx diffuse réellement. Ce n'est pas une tâche anodine. Si possible, essayez d'utiliser le port 8080 (ce qui facilite les choses avec Cloud Run). Si vous souhaitez conserver le port 80 (par exemple, parce qu'Apache l'exige), utilisez une autre commande pour l'exécuter :
$ docker run -it -p 8080:80 # force 80
# Use the PORT environment variable in Apache configuration files.
# https://cloud.google.com/run/docs/reference/container-contract#port
RUN sed -i 's/80/${PORT}/g' /etc/apache2/sites-available/000-default.conf /etc/apache2/ports.conf
5. Module 3 : Déployer l'application sur Cloud Run

Pourquoi utiliser Cloud Run ?
C'est une bonne question. Il y a quelques années, vous auriez sûrement choisi Google App Engine.
En résumé, Cloud Run dispose aujourd'hui d'une pile technologique plus récente, est plus facile à déployer, est moins cher et effectue un scaling à la baisse jusqu'à zéro instance lorsque vous ne l'utilisez pas. Grâce à sa flexibilité permettant d'exécuter n'importe quel conteneur sans état et à son intégration à divers services Google Cloud, il est idéal pour déployer des microservices et des applications modernes avec un minimum de frais généraux et une efficacité maximale.
Plus précisément, Cloud Run est une plate-forme entièrement gérée par Google Cloud qui vous permet d'exécuter des applications conteneurisées sans état dans un environnement sans serveur. Il gère automatiquement l'ensemble de l'infrastructure, en effectuant un scaling à partir de zéro pour répondre au trafic entrant et en réduisant la capacité lorsqu'il est inactif, ce qui le rend économique et efficace. Cloud Run est compatible avec tous les langages et bibliothèques, à condition qu'ils soient empaquetés dans un conteneur, ce qui offre une grande flexibilité de développement. Il s'intègre bien aux autres services Google Cloud et convient à la création de microservices, d'API, de sites Web et d'applications basées sur des événements, sans avoir à gérer l'infrastructure de serveurs.
Prérequis
Pour effectuer cette tâche, vous devez avoir installé gcloud sur votre ordinateur local. Si ce n'est pas le cas, consultez ces instructions. Si vous utilisez Google Cloud Shell, aucune action n'est requise.
Avant de déployer…
Si vous travaillez dans votre environnement local, authentifiez-vous auprès de Google Cloud à l'aide de la commande suivante :
$ gcloud auth login –update-adc # not needed in Cloud Shell
Vous devriez être authentifié via une connexion OAuth dans votre navigateur. Assurez-vous de vous connecter via Chrome avec le même utilisateur (par exemple, vattelapesca@gmail.com) que celui connecté à Google Cloud avec la facturation activée.
Activez l'API Cloud Run à l'aide de la commande suivante :
$ gcloud services enable run.googleapis.com cloudbuild.googleapis.com
À ce stade, tout est prêt pour le déploiement sur Cloud Run.
Déployer votre application sur Cloud Run via gcloud
La commande qui vous permet de déployer l'application sur Cloud Run est gcloud run deploy. Plusieurs options sont disponibles pour atteindre votre objectif. L'ensemble minimal d'options (que vous pouvez fournir via la ligne de commande ou que l'outil vous demandera via une invite interactive) est le suivant :
- Nom du service Cloud Run que vous souhaitez déployer pour votre application. Un service Cloud Run vous renvoie une URL qui fournit un point de terminaison à votre application.
- Région Google Cloud dans laquelle votre application sera exécutée. (
--regionREGION) - Image de conteneur qui encapsule votre application.
- Variables d'environnement que votre application doit utiliser lors de son exécution.
- L'option Allow-Unauthenticated, qui permet à tout le monde d'accéder à votre application sans authentification supplémentaire.
Consultez la documentation (ou faites défiler la page vers le bas pour trouver une solution possible) afin de savoir comment appliquer cette option à votre ligne de commande.
Le déploiement prendra quelques minutes. Si tout est correct, vous devriez voir quelque chose comme ceci dans la console Google Cloud.


Cliquez sur l'URL fournie par Cloud Run et testez votre application. Une fois l'authentification effectuée, vous devriez voir un écran semblable à celui-ci.

"gcloud run deploy" sans argument
Vous avez peut-être remarqué que gcloud run deploy vous pose les bonnes questions et remplit les blancs que vous avez laissés. C'est incroyable !
Cependant, dans quelques modules, nous allons ajouter cette commande à un déclencheur de compilation Cloud Build. Nous ne pouvons donc pas nous permettre d'avoir des questions interactives. Nous devons renseigner chaque option de la commande. Vous voulez donc créer le gcloud run deploy --option1 blah --foo bar --region your-fav-region parfait. Comment faut-il que vous procédiez ?
- Répétez les étapes 2, 3 et 4 jusqu'à ce que gcloud cesse de poser des questions :
- [LOOP]
gcloud run deployavec les options trouvées jusqu'à présent - [LOOP] systems ask for option X
- [LOOP] Search in public docs how to set up X from CLI adding option
--my-option [my-value]. - Revenez à l'étape 2, sauf si gcloud se termine sans autre question.
- Cette commande gcloud run deploy BLAH BLAH BLAH est géniale ! Enregistrez la commande quelque part, car vous en aurez besoin plus tard pour l'étape Cloud Build.
Une solution possible est disponible sur cette page. La documentation est disponible sur cette page.
Félicitations ! 🎉🎉🎉 Vous avez déployé votre application dans Google Cloud, ce qui constitue la première étape de la modernisation.
6. Module 4 : Nettoyer le mot de passe avec Secret Manager

À l'étape précédente, nous avons réussi à déployer et à exécuter notre application dans Cloud Run. Cependant, nous avons utilisé une mauvaise pratique de sécurité : fournir des secrets en texte clair.
Première itération : modifier votre fichier config.php pour utiliser ENV
Vous avez peut-être remarqué que nous avons placé le mot de passe de la base de données directement dans le code du fichier config.php. Cela convient pour les tests et pour vérifier si l'application fonctionne. Cependant, vous ne pouvez pas valider ni utiliser un tel code dans un environnement de production. Le mot de passe (et les autres paramètres de connexion à la base de données) doit être lu de manière dynamique et fourni à l'application au moment de l'exécution. Modifiez le fichier config.php afin qu'il lise les paramètres de la base de données à partir des variables d'environnement. Si l'opération échoue, vous devriez envisager de définir des valeurs par défaut. Cela est utile si vous ne parvenez pas à charger ENV, car la sortie de la page vous indiquera si les valeurs par défaut sont utilisées. Remplissez les espaces vides et remplacez le code dans le fichier config.php.
<?php
// Database configuration with ENV variables. Set default values as well
$db_host = getenv('DB_HOST') ?: 'localhost';
$db_name = getenv('DB_NAME') ?: 'image_catalog';
$db_user = getenv('DB_USER') ?: 'appmod-phpapp-user';
$db_pass = getenv('DB_PASS') ?: 'wrong_password';
// Note getenv() is PHP 5.3 compatible
try {
$pdo = new PDO("mysql:host=$db_host;dbname=$db_name", $db_user, $db_pass);
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
} catch (PDOException $e) {
die("Errore di connessione: " . $e->getMessage());
}
session_start();
?>
Comme votre application est conteneurisée, vous devez fournir un moyen de lui transmettre les variables d'environnement. Vous pouvez procéder de plusieurs manières :
- Au moment de la compilation, sur le Dockerfile. Ajoutez les quatre paramètres à votre Dockerfile précédent en utilisant la syntaxe ENV DB_VAR=ENV_VAR_VALUE. Cela permet de configurer des valeurs par défaut qui peuvent être remplacées au moment de l'exécution. Par exemple, "DB_NAME" et "DB_USER" peuvent être définis ici et nulle part ailleurs.
- Lors de l'exécution. Vous pouvez configurer ces variables pour Cloud Run, depuis la CLI ou l'UI. C'est l'endroit idéal pour placer vos quatre variables (sauf si vous souhaitez conserver les valeurs par défaut définies dans le fichier Dockerfile).
Dans localhost, vous pouvez placer vos variables ENV dans un fichier .env (consultez le dossier solutions).
Assurez-vous également que .env est ajouté à votre .gitignore : vous ne voulez pas transférer vos secrets vers GitHub !
echo .env >> .gitignore
Vous pouvez ensuite tester l'instance localement :
docker run -it -p 8080:8080 --env-file .env my-php-app-docker
Vous avez maintenant atteint les objectifs suivants :
- Votre application lira la variable de manière dynamique à partir de votre ENV
- Vous avez amélioré la sécurité en supprimant le mot de passe de la base de données de votre code.
Vous pouvez maintenant déployer une nouvelle révision sur Cloud Run. Passons à l'interface utilisateur et définissons manuellement les variables d'environnement :
- Accédez à https://console.cloud.google.com/run.
- Cliquez sur votre application.
- Cliquez sur "Modifier et déployer une nouvelle révision".
- Dans le premier onglet "Conteneur(s)", cliquez sur l'onglet inférieur "Variables et secrets".
- Cliquez sur "+ Ajouter une variable" et ajoutez toutes les variables nécessaires. Vous devriez obtenir un résultat semblable à celui-ci :


Est-ce parfait ? Non, votre PASS reste visible par la plupart des opérateurs. Vous pouvez y remédier avec Google Cloud Secret Manager.
Deuxième itération : Secret Manager
Vos mots de passe ont disparu de votre propre code : victoire ! Mais attendez, sommes-nous en sécurité ?
Vos mots de passe sont toujours visibles par toute personne ayant accès à la console Google Cloud. En fait, si vous accédez au fichier de déploiement YAML Cloud Run, vous pourrez le récupérer. Si vous essayez de modifier ou de déployer une nouvelle révision Cloud Run, le mot de passe est visible dans la section "Variables et secrets", comme illustré dans les captures d'écran ci-dessous.
Google Cloud Secret Manager est un service centralisé et sécurisé qui permet de gérer les informations sensibles telles que les clés API, les mots de passe, les certificats et d'autres secrets.
Il vous permet de stocker et de gérer les secrets, et d'y accéder, avec des autorisations précises et un chiffrement robuste. Intégré à Identity and Access Management (IAM) de Google Cloud, Secret Manager vous permet de contrôler qui peut accéder à des secrets spécifiques, ce qui garantit la sécurité des données et la conformité réglementaire.
Il est également compatible avec la rotation et la gestion des versions automatiques des secrets, ce qui simplifie la gestion du cycle de vie des secrets et renforce la sécurité des applications dans les services Google Cloud.
Pour accéder à Secret Manager, accédez aux services de sécurité depuis le menu hamburger, puis recherchez-le dans la section Protection des données, comme illustré dans la capture d'écran ci-dessous.

Activez l'API Secret Manager, comme illustré dans l'image suivante.

- Cliquez maintenant sur Créer un secret. Donnez-lui un nom logique :
- Nom :
php-amarcord-db-pass - Valeur du secret : "votre mot de passe de base de données" (ignorez la partie "importer un fichier").
- Annotez ce lien secret, qui doit ressembler à
projects/123456789012/secrets/php-amarcord-db-pass. Il s'agit du pointeur unique vers votre secret (pour Terraform, Cloud Run, etc.). Le numéro est le numéro unique de votre projet.
Conseil : Essayez d'utiliser des conventions d'attribution de noms cohérentes pour vos secrets, en les spécialisant de gauche à droite, par exemple : cloud-devrel-phpamarcord-dbpass
- Organisation (avec l'entreprise)
- Équipe (au sein de l'organisation)
- Application (au sein de l'équipe)
- Nom de la variable (dans l'application)
Vous pourrez ainsi utiliser des expressions régulières simples pour trouver tous vos secrets pour une seule application.
Créer une révision Cloud Run
Maintenant que nous avons un nouveau secret, nous devons supprimer la variable d'environnement DB_PASS et la remplacer par le nouveau secret. Exemple :
- Accès à Cloud Run à l'aide de la console Google Cloud
- Sélectionnez l'application.
- Cliquez sur "Modifier et déployer la nouvelle révision".
- recherchez l'onglet "Variables et secrets".
- Utilisez le bouton "+ Référencer un secret" pour réinitialiser la variable d'environnement DB_PASS.
- Utilisez le même "DB_PASS" pour les secrets référencés et utilisez la dernière version.

Une fois l'opération terminée, l'erreur suivante devrait s'afficher :

Essayez de trouver comment résoudre le problème. Pour résoudre ce problème, vous devez accéder à la section IAM et administration, puis modifier les autorisations accordées. Bon débogage !
Une fois que vous avez trouvé la solution, revenez à Cloud Run et redéployez une nouvelle révision. Le résultat doit ressembler à la figure suivante :

Conseil : La Developer Console (UI) est très utile pour identifier les problèmes d'autorisation. Prenez le temps de parcourir tous les liens de vos entités Cloud.
7. Module 5 : Configurer votre CI/CD avec Cloud Build

Pourquoi utiliser un pipeline CI/CD ?
À ce stade, vous devriez avoir saisi gcloud run deploy plusieurs fois, peut-être en répondant à la même question encore et encore.
Vous en avez assez de déployer manuellement votre application avec gcloud run deploy ? Ne serait-il pas formidable que votre application puisse se déployer automatiquement chaque fois que vous envoyez une nouvelle modification dans votre dépôt Git ?
Pour utiliser un pipeline CI/CD, vous avez besoin de deux éléments :
- Un dépôt Git personnel : heureusement, vous devriez déjà avoir dupliqué le dépôt de l'atelier dans votre compte GitHub à l'étape 2. Si ce n'est pas le cas, revenez en arrière et effectuez cette étape. Votre dépôt dupliqué doit se présenter comme suit :
https://github.com/<YOUR_GITHUB_USER>/app-mod-workshop - Cloud Build. Ce service incroyable et peu coûteux vous permet de configurer des automatisations de compilation pour à peu près tout : Terraform, les applications Docker, etc.
Cette section explique comment configurer Cloud Build.
Découvrez Cloud Build
Pour ce faire, nous allons utiliser Cloud Build :
- compiler votre source (avec Dockerfile). Considérez-le comme un "gros fichier .zip" contenant tout ce dont vous avez besoin pour le créer et l'exécuter (votre "artefact de compilation").
- et de transférer cet artefact vers Artifact Registry (AR).
- Ensuite, lancez un déploiement d'AR vers Cloud Run pour l'application "php-amarcord".
- Cela créera une nouvelle version ("révision") de l'application existante (pensez à une couche avec le nouveau code) et nous la configurerons pour rediriger le trafic vers la nouvelle version si le push réussit.
Voici un exemple de builds pour mon application php-amarcord :

Comment faisons-nous tout cela ?
- En créant un fichier YAML parfait :
cloudbuild.yaml - En créant un déclencheur de compilation Cloud Build.
- En nous connectant à notre dépôt GitHub via l'interface utilisateur de Cloud Build.
Créer un déclencheur (et connecter un dépôt)
- Accédez à https://console.cloud.google.com/cloud-build/triggers.
- Cliquez sur "Créer un déclencheur".
- Compiler :
- Nom : un nom explicite, tel que
on-git-commit-build-php-app - Événement : Déployer sur la branche
- Source : "Associer un nouveau dépôt"

- Une fenêtre s'ouvre sur la droite : "Connecter un dépôt".
- Fournisseur source : "GitHub" (premier)
- "Continue"
- "Authenticate" (Authentifier) ouvre une fenêtre sur GitHub pour l'authentification croisée. Laissez-vous porter et soyez patient. Si vous avez de nombreux dépôts, cela peut prendre un certain temps.
- "Select repo" (Sélectionner un dépôt) : sélectionnez votre compte/dépôt et cochez la case "I understand..." (Je comprends...).
- Si vous avez reçu l'erreur "L'application GitHub n'est installée sur aucun de vos dépôts", cliquez sur "Installer Google Cloud Build" et suivez les instructions.
Cliquez sur "Connecter".
- Bravo ! Votre dépôt est maintenant connecté.
- Revenons à la partie "Déclencheur"…
- Configuration : Détection automatique (*)
- Avancé : sélectionnez le compte de service "[PROJECT_NUMBER]- compute@developer.gserviceaccount.com".
- xxxxx est l'ID de votre projet.
- Le compte de service Compute par défaut est adapté à une approche d'atelier, mais ne l'utilisez pas en production. (En savoir plus)
- Laissez tout le reste tel quel.
- Cliquez sur le bouton "Créer".
(*) Il s'agit de la méthode la plus simple, car elle recherche un fichier Dockerfile ou cloudbuild.yaml. Toutefois, cloudbuild.yaml vous permet de décider de l'action à effectuer à chaque étape.
I've got the power!
Le déclencheur ne fonctionnera pas tant que vous n'aurez pas accordé au compte de service Cloud Build (qu'est-ce qu'un compte de service ? Il s'agit de l'adresse e-mail d'un "robot" qui agit en votre nom pour une tâche (dans ce cas, créer des éléments dans le cloud).
Votre architecte de solutions ne pourra pas créer ni déployer l'architecture si vous ne l'y autorisez pas. Heureusement, c'est facile !
- Accédez à Cloud Build > Paramètres.
- Compte de service "[PROJECT_NUMBER]-compute@developer.gserviceaccount.com"
- Cochez les cases suivantes :
- Cloud Run
- Secret Manager
- Comptes de service
- Cloud Build
- Cochez également l'option "Définir comme compte de service préféré".

Où est le fichier YAML Cloud Build ?
Nous vous encourageons vivement à prendre le temps de créer votre propre fichier YAML Cloud Build.
Toutefois, si vous n'avez pas le temps ou si vous ne souhaitez pas prendre le temps, vous pouvez vous inspirer du dossier de solution suivant : .solutions.
Vous pouvez maintenant transférer une modification vers GitHub et observer Cloud Build faire son travail.
La configuration de Cloud Build peut être complexe. Attendez-vous à des échanges par :
- Vérification des journaux sur https://console.cloud.google.com/cloud-build/builds;region=global…
- Recherche de l'erreur…
- Corriger le code, puis exécuter à nouveau git commit/git push.
- Parfois, l'erreur ne se trouve pas dans le code, mais dans une configuration. Dans ce cas, vous pouvez lancer une nouvelle compilation à partir de l'interface utilisateur (Cloud Build > Déclencheurs > Exécuter).

Notez que si vous utilisez cette solution, il vous reste encore du travail à faire. Par exemple, vous devez définir les variables ENV pour les points de terminaison dev/prod nouvellement créés :

Pour cela, vous avez le choix entre deux méthodes :
- Via l'UI, en définissant à nouveau les variables d'environnement
- Via la CLI en créant le script "parfait" pour vous. Vous trouverez un exemple ici : gcloud-run-deploy.sh. Vous devez modifier quelques éléments, par exemple le point de terminaison et le numéro de projet. Vous trouverez votre numéro de projet dans la vue d'ensemble de Cloud.
Comment puis-je valider du code sur GitHub ?
La meilleure façon d'effectuer un git push sur GitHub n'entre pas dans le cadre de cet atelier. Toutefois, si vous êtes bloqué et que vous êtes dans Cloud Shell, deux options s'offrent à vous :
- CLI. Ajoutez une clé SSH localement et ajoutez un dépôt distant avec git@github.com:YOUR_USER/app-mod-workshop.git (au lieu de http).
- VSCode. Si vous utilisez l'éditeur Cloud Shell, vous pouvez utiliser l'onglet "Contrôle de code source" (Ctrl+Maj+G), cliquer sur "Synchroniser les modifications" et suivre les instructions. Vous devriez pouvoir authentifier votre compte GitHub auprès de VS Code, ce qui facilitera les opérations d'extraction et de transfert.

N'oubliez pas d'git add clodubuild.yaml parmi les autres fichiers, sinon cela ne fonctionnera pas.
Parité "dev/prod" profonde ou superficielle [facultatif]
Si vous avez copié la version du modèle depuis ici, vous aurez deux versions DEV et PROD identiques. C'est une bonne chose, et cela est conforme à la règle 10 de la méthodologie Twelve-Factor App.
Cependant, nous utilisons deux points de terminaison Web différents pour qu'une application pointe vers la même base de données. Cela suffit pour un atelier, mais dans la réalité, vous devez prendre le temps de créer un environnement de production approprié. Cela signifie que vous devez disposer de deux bases de données (une pour le développement et une pour la production) et choisir où les placer pour la reprise après sinistre et la haute disponibilité. Cela dépasse le cadre de cet atelier, mais c'est une piste de réflexion.
Si vous avez le temps de créer une version "approfondie" de la production, n'oubliez pas de dupliquer toutes les ressources dont vous avez besoin, par exemple :
- Base de données Cloud SQL (et probablement instance SQL).
- Bucket GCS
- Cloud Functions.
- Vous pouvez utiliser Gemini 1.5 Flash comme modèle en développement (moins cher, plus rapide) et Gemini 1.5 Pro (plus puissant).
En général, chaque fois que vous effectuez une action sur l'application, posez-vous la question suivante : la production doit-elle avoir la même valeur ou non ? Dans le cas contraire, redoublez d'efforts. Bien sûr, c'est beaucoup plus facile avec Terraform, où vous pouvez injecter votre environnement (-dev, -prod) en tant que suffixe à vos ressources.
8. Module 6 : Migrer vers Google Cloud Storage

Stockage

Actuellement, l'application stocke l'état dans un conteneur Docker. Si la machine tombe en panne, si l'application explose ou si vous publiez simplement une nouvelle révision, une nouvelle révision sera planifiée, avec un nouvel espace de stockage vide : 🙈
Comment résoudre ce problème ? Il existe plusieurs approches.
- Stocker les images dans la base de données. C'est ce que j'ai fini par faire avec mon application PHP précédente. C'est la solution la plus simple, car elle n'ajoute pas de complexité. Mais cela ajoute de la latence et de la charge à votre base de données.
- Migrer votre application Cloud Run vers une solution adaptée au stockage : GCE + disque persistant ? Peut-être GKE + Storage ? Remarque : Ce que vous gagnez en contrôle, vous le perdez en agilité.
- Passez à GCS. Google Cloud Storage offre le meilleur stockage de sa catégorie pour l'ensemble de Google Cloud et constitue la solution la plus idiomatique pour le cloud. Toutefois, cela nécessite de se familiariser avec les bibliothèques PHP. Disposons-nous de bibliothèques PHP 5.7 pour GCS ? Est-ce que
PHP 5.7est compatible avecComposer(il semble que PHP 5.3.2 soit la version la plus ancienne compatible avec Composer) ? - Peut-être en utilisant un sidecar Docker ?
- Vous pouvez également utiliser les installations de volume Cloud Run GCS. C'est incroyable.
🤔 Migrer le stockage (question ouverte)
[Question ouverte] Dans cet exercice, nous souhaitons que vous trouviez une solution pour déplacer vos images de manière à ce qu'elles soient conservées d'une manière ou d'une autre.
Test d'acceptation
Je ne veux pas vous donner la solution, mais je veux que cela se produise :
- Vous importez
newpic.jpg. Vous le voyez dans l'application. - Vous mettez à niveau l'application vers une nouvelle version.
newpic.jpgest toujours là, visible.
💡 Solution possible (montages de volumes Cloud Run GCS)
Il s'agit d'une solution très élégante qui nous permet d'effectuer des importations de fichiers avec état sans toucher DU TOUT au code (à part pour afficher une description d'image, mais c'est trivial et juste pour le plaisir des yeux).
Cela devrait vous permettre d'installer un dossier de Cloud Run sur GCS. Par conséquent :
- Toutes les importations dans GCS seront visibles dans votre application.
- Tous les fichiers importés dans votre application seront en fait importés dans GCS.
- La magie opérera sur les objets importés dans GCS (chapitre 7).
Remarque : Veuillez lire les mentions en petits caractères concernant FUSE. Cela n'est PAS acceptable si les performances sont un problème.
Créer un bucket GCS
GCS est le service de stockage omniprésent de Google Cloud. Il a fait ses preuves et est utilisé par tous les services GCP nécessitant du stockage.
Notez que Cloud Shell exporte PROJECT_ID en tant que GOOGLE_CLOUD_PROJECT :
$ export PROJECT_ID=$GOOGLE_CLOUD_PROJECT
#!/bin/bash
set -euo pipefail
# Your Cloud Run Service Name, eg php-amarcord-dev
SERVICE_NAME='php-amarcord-dev'
BUCKET="${PROJECT_ID}-public-images"
GS_BUCKET="gs://${BUCKET}"
# Create bucket
gsutil mb -l "$GCP_REGION" -p "$PROJECT_ID" "$GS_BUCKET/"
# Copy original pictures there - better if you add an image of YOURS before.
gsutil cp ./uploads/*.png "$GS_BUCKET/"
Configurer Cloud Run pour installer le bucket dans le dossier /uploads/
Passons maintenant à la partie élégante. Nous créons un volume php_uploads et demandons à Cloud Run d'effectuer un montage FUSE sur MOUNT_PATH (par exemple, /var/www/html/uploads/) :
#!/bin/bash
set -euo pipefail
# .. keep variables from previous script..
# Uploads folder within your docker container.
# Tweak it for your app code.
MOUNT_PATH='/var/www/html/uploads/'
# Inject a volume mount to your GCS bucket in the right folder.
gcloud --project "$PROJECT_ID" beta run services update "$SERVICE_NAME" \
--region $GCP_REGION \
--execution-environment gen2 \
--add-volume=name=php_uploads,type=cloud-storage,bucket="$BUCKET" \
--add-volume-mount=volume=php_uploads,mount-path="$MOUNT_PATH"
Répétez maintenant cette étape pour tous les points de terminaison que vous souhaitez faire pointer vers Cloud Storage.
Vous pouvez également le faire depuis l'interface utilisateur.
- Dans l'onglet "Volumes", créez un point d'installation de volume pointant vers votre bucket, de type "Bucket Cloud Storage", par exemple avec le nom "php_uploads".
- Sous "Conteneur(s) > Installations de volumes", installez le volume que vous venez de créer sur le point de volume demandé par votre application. Cela dépend du fichier Dockerfile, mais cela peut ressembler à
var/www/html/uploads/.
Dans les deux cas, si cela fonctionne, la modification de la nouvelle révision Cloud Run devrait ressembler à ceci :

Testez maintenant la nouvelle application en important une nouvelle image sur le point de terminaison /upload.php.
Les images doivent être transférées de manière fluide vers GCS sans écrire une seule ligne de PHP :

Que s'est-il passé ?
Quelque chose de magique s'est produit.
Une ancienne application avec un ancien code fonctionne toujours. Une nouvelle pile modernisée nous permet de stocker toutes les images de notre application dans un bucket Cloud avec état. Les possibilités sont désormais infinies :
- Vous souhaitez envoyer un e-mail chaque fois qu'une image contenant du contenu "dangereux" ou "nu" est reçue ? Vous pouvez le faire sans toucher au code PHP.
- Vous souhaitez utiliser un modèle multimodal Gemini pour décrire chaque image reçue et importer la base de données avec sa description ? Vous pouvez le faire sans toucher au code PHP. Tu ne me crois pas ? Poursuivez votre lecture au chapitre 7.
Nous venons de découvrir un vaste champ d'opportunités.
9. Module 7 : Améliorer votre application avec Google Gemini

Vous disposez maintenant d'une superbe application PHP modernisée et flambant neuve (comme une Fiat 126 de 2024) avec un stockage cloudifié.
À quoi sert-il ?
Prérequis
Dans le chapitre précédent, une solution de modèle nous a permis d'installer des images /uploads/ sur GCS, séparant de facto la logique de l'application du stockage des images.
Pour cet exercice, vous devez :
- Avoir terminé l'exercice du chapitre 6 (Stockage).
- Vous disposez d'un bucket GCS contenant les images importées, où les utilisateurs importent des images dans votre application et où les images sont transférées vers votre bucket.
Configurer une fonction Cloud (en Python)
Vous êtes-vous déjà demandé comment implémenter une application basée sur les événements ? Par exemple :
- lorsque <événement> se produit => envoyer un e-mail
- lorsque <event> se produit => si <condition> est vraie, mettez à jour la base de données.
Un événement peut être n'importe quoi : un nouvel enregistrement disponible dans BigQuery, un nouvel objet modifié dans un dossier GCS ou un nouveau message en attente dans une file d'attente Pub/Sub.
Google Cloud est compatible avec plusieurs paradigmes pour y parvenir. Notamment :
- EventArc. Découvrez comment recevoir des événements GCS. Idéal pour créer des DAG et orchestrer des actions basées sur des conditions if-then-else dans le cloud.
- Cloud Scheduler. C'est idéal, par exemple, pour un job Cron de minuit dans le cloud.
- Cloud Workflows. Comme Eventarc, il vous permet de
- Cloud Run Functions (communément appelé
lambdas). - Cloud Composer. Il s'agit de la version Google d'Apache Airflow, qui est également idéale pour les DAG.
Dans cet exercice, nous allons nous pencher sur Cloud Functions pour obtenir un résultat assez spectaculaire. Nous vous proposerons également des exercices facultatifs.
Notez que l'exemple de code est fourni sous .solutions/.
Configurer une fonction Cloud (🐍 Python)
Nous essayons de créer un GCF très ambitieux.
- Lorsqu'une image est créée sur GCS… (probablement parce que quelqu'un l'a importée dans l'application, mais pas seulement)
- .. appeler Gemini pour la décrire et obtenir une description textuelle de l'image .. (il serait utile de vérifier le type MIME et de s'assurer qu'il s'agit d'une image et non d'un PDF, d'un MP3 ou d'un texte)
- .. and update the DB with this description. (cela peut nécessiter l'application d'un correctif à la base de données pour ajouter une colonne
descriptionà la tableimages).
Appliquer un correctif à la base de données pour ajouter description aux images
- Ouvrez Cloud SQL Studio :

- Saisissez votre nom d'utilisateur et votre mot de passe pour la base de données d'images.
- Injectez ce code SQL, qui ajoute une colonne pour une description d'image :
ALTER TABLE images ADD COLUMN description TEXT;

Et voilà ! Essayez maintenant de vérifier si cela a fonctionné :
SELECT * FROM images;
La nouvelle colonne de description devrait s'afficher :

Écrire la fonction Gemini f(x)
Remarque : Cette fonction a été créée avec l'aide de Gemini Code Assist.
Remarque : La création de cette fonction peut entraîner des erreurs d'autorisation IAM. Certaines sont documentées ci-dessous dans le paragraphe "Erreurs possibles".
- Activer les API
- Accédez à https://console.cloud.google.com/functions/list.
- Cliquez sur "Créer une fonction".
- Activez les API à l'aide de l'assistant d'API :

Vous pouvez créer la fonction Cloud depuis l'interface utilisateur ou la ligne de commande. Ici, nous allons utiliser la ligne de commande.
Vous trouverez un exemple de code sous .solutions/.
- Créez un dossier pour héberger votre code, par exemple "gcf/". Accédez au dossier.
- Créez un fichier
requirements.txt:
google-cloud-storage
google-cloud-aiplatform
pymysql
- Créer une fonction Python. Exemple de code : gcf/main.py.
#!/usr/bin/env python
"""Complete this"""
from google.cloud import storage
from google.cloud import aiplatform
import vertexai
from vertexai.generative_models import GenerativeModel, Part
import os
import pymysql
import pymysql.cursors
# Replace with your project ID
PROJECT_ID = "your-project-id"
GEMINI_MODEL = "gemini-1.5-pro-002"
DEFAULT_PROMPT = "Generate a caption for this image: "
def gemini_describe_image_from_gcs(gcs_url, image_prompt=DEFAULT_PROMPT):
pass
def update_db_with_description(image_filename, caption, db_user, db_pass, db_host, db_name):
pass
def generate_caption(event, context):
"""
Cloud Function triggered by a GCS event.
Args:
event (dict): The dictionary with data specific to this type of event.
context (google.cloud.functions.Context): The context parameter contains
event metadata such as event ID
and timestamp.
"""
pass
- Transférez la fonction. Vous pouvez utiliser un script semblable à celui-ci : gcf/push-to-gcf.sh.
Remarque 1 : Veillez à sourcer les variables d'environnement avec les bonnes valeurs, ou ajoutez-les simplement en haut (GS_BUCKET=blah, etc.) :
Remarque 2 : Cette opération va transférer l'intégralité du code local (.). Veillez donc à placer votre code dans un dossier spécifique et à utiliser .gcloudignore comme un pro pour éviter de transférer d'énormes bibliothèques. (exemple).
#!/bin/bash
set -euo pipefail
# add your logic here, for instance:
source .env || exit 2
echo "Pushing ☁️ f(x)☁ to 🪣 $GS_BUCKET, along with DB config.. (DB_PASS=$DB_PASS)"
gcloud --project "$PROJECT_ID" functions deploy php_amarcord_generate_caption \
--runtime python310 \
--region "$GCP_REGION" \
--trigger-event google.cloud.storage.object.v1.finalized \
--trigger-resource "$BUCKET" \
--set-env-vars "DB_HOST=$DB_HOST,DB_NAME=$DB_NAME,DB_PASS=$DB_PASS,DB_USER=$DB_USER" \
--source . \
--entry-point generate_caption \
--gen2
Remarque : Dans cet exemple, generate_caption sera la méthode appelée, et Cloud Functions lui transmettra l'événement GCS avec toutes les informations pertinentes (nom du bucket, nom de l'objet, etc.). Prenez le temps de déboguer ce dictionnaire Python d'événement.
Tester la fonction
Tests unitaires
La fonction comporte de nombreux éléments mobiles. Vous voudrez peut-être pouvoir tester tous les éléments individuels.
Vous trouverez un exemple dans gcf/test.py.
Interface utilisateur de Cloud Functions
Prenez également le temps d'explorer votre fonction dans l'interface utilisateur. Chaque onglet mérite d'être exploré, en particulier Source (mon préféré), Variables, Trigger et Logs. Vous passerez beaucoup de temps dans Logs pour résoudre les erreurs (voir également les erreurs possibles en bas de cette page). N'oubliez pas non plus de consulter Permissions.

Test de bout en bout
Il est temps de tester manuellement la fonction.
- Accédez à votre application et connectez-vous.
- Importez une image (pas trop volumineuse, car nous avons rencontré des problèmes avec les images volumineuses).
- Vérifiez dans l'UI que l'image a bien été importée.
- Vérifiez dans Cloud SQL Studio que la description a bien été mise à jour. Connectez-vous et exécutez la requête suivante :
SELECT * FROM images.

Et il est efficace ! Nous pouvons également mettre à jour l'interface pour afficher cette description.
Update PHP to show [optional]
Nous avons prouvé que l'application fonctionne. Cependant, il serait utile que les utilisateurs puissent également voir cette description.
Il n'est pas nécessaire d'être un expert PHP pour ajouter la description à index.php. Ce code devrait faire l'affaire (oui, Gemini l'a écrit pour moi aussi) :
<?php if (!empty($image['description'])): ?>
<p class="font-bold">Gemini Caption:</p>
<p class="italic"><?php echo $image['description']; ?></p>
<?php endif; ?>
Positionnez ce code dans foreach selon vos préférences.
Dans les étapes suivantes, nous verrons également une version plus esthétique de l'interface utilisateur, grâce à Gemini Code Assist. Une version plus lisible pourrait ressembler à ceci :

Conclusions
Vous avez une fonction Cloud déclenchée par l'arrivée de nouveaux objets dans GCS, qui peut annoter le contenu de l'image comme le ferait un humain et mettre à jour automatiquement la base de données. Impressionnant !
Étape suivante Vous pouvez suivre le même raisonnement pour obtenir deux fonctionnalités intéressantes.
[optional] Add further Cloud Functions [open ended]
Deux fonctionnalités supplémentaires me viennent à l'esprit.
📩 Déclencheur d'e-mail
Un déclencheur d'e-mail qui vous envoie un e-mail chaque fois que quelqu'un envoie une photo.
- Trop souvent ? Ajoutez une autre contrainte : une GRANDE image ou une image dont le contenu Gemini contient les mots "nu/nudité/violent".
- Vérifiez
EventArcpour cela.
🚫 Modérez automatiquement les photos inappropriées
Actuellement, un administrateur humain signale les images comme "inappropriées". Et si vous laissiez Gemini se charger des tâches fastidieuses et modérer l'espace ? Ajoutez un test pour signaler un contenu déclencheur inapproprié et mettre à jour la base de données, comme nous l'avons vu dans la fonction précédente. Cela signifie essentiellement qu'il faut prendre la fonction précédente, modifier le prompt et mettre à jour la base de données en fonction de la réponse.
Remarque : L'IA générative produit des résultats imprévisibles. Assurez-vous que la "production créative" de Gemini est "sur les rails". Vous pouvez demander une réponse déterministe, comme un score de confiance de 0 à 1, un JSON, etc. Vous pouvez y parvenir de différentes manières, par exemple : * En utilisant les bibliothèques Python pydantic, langchain, etc. * En utilisant la sortie structurée Gemini.
Conseil : Vous pouvez avoir PLUSIEURS fonctions ou un seul prompt qui applique une réponse JSON (fonctionne très bien avec "Gemini Structured Output", comme indiqué ci-dessus), par exemple :
Quel prompt permettrait de générer ce résultat ?
{
"description": "This is the picture of an arrosticino",
"suitable": TRUE
}
Vous pouvez ajouter des champs supplémentaires au prompt pour obtenir des insights, par exemple : "Y a-t-il quelque chose de positif ?" Qu'est-ce qui ne va pas ? Reconnaissez-vous l'endroit ? Y a-t-il du texte (la reconnaissance optique des caractères n'a jamais été aussi simple) ?
goods: "Ça a l'air délicieux"bads: "On dirait de la nourriture malsaine"OCR: "Da consumare preferibilmente prima del 10 Novembre 2024"location: "Pescara, Lungomare"
Bien qu'il soit généralement préférable d'avoir N fonctions pour N résultats, il est incroyablement gratifiant d'en créer une qui fait 10 choses. Pour savoir comment procéder, consultez cet article de Riccardo.
Erreurs possibles (principalement liées à IAM/aux autorisations)
La première fois que j'ai développé cette solution, j'ai rencontré des problèmes d'autorisation IAM. Je les ajouterai ici par empathie et pour donner quelques idées sur la façon de les résoudre.
Erreur : Autorisations insuffisantes pour le compte de service
- Notez que pour déployer une fonction GCF qui écoute un bucket GCS, vous devez configurer les autorisations appropriées pour le compte de service que vous utilisez pour le job, comme illustré dans la figure :

Vous devrez peut-être également activer les API Eventarc. Attendez quelques minutes avant qu'elles ne soient entièrement disponibles.
Erreur : Demandeur Cloud Run manquant
- Voici un autre commentaire de l'interface utilisateur pour l'attribution d'autorisations GCF (rôle Demandeur Cloud Run) :

Pour corriger cette erreur, exécutez la commande dans l'image, qui est semblable à fix-permissions.sh.
Ce problème est décrit sur la page https://cloud.google.com/functions/docs/securing/authenticating.
Erreur : Limite de mémoire dépassée
La première fois que je l'ai exécutée, mes journaux ont indiqué : "Limite de mémoire de 244 Mio dépassée avec 270 Mio utilisés. Envisagez d'augmenter la limite de mémoire. Consultez la page https://cloud.google.com/functions/docs/configuring/memory. Là encore, ajoutez de la RAM à votre GCF. C'est très facile à faire dans l'interface utilisateur. Voici un exemple de bump :

Vous pouvez également corriger votre script de déploiement Cloud Run pour augmenter la mémoire/le processeur. Cela prend un peu plus de temps.
Erreur : Pub/Sub publié
La création d'un déclencheur avec GCF v1 a généré l'erreur suivante :

Là encore, vous pouvez facilement résoudre ce problème en accédant à IAM et en attribuant le rôle "Éditeur Pub/Sub" à votre compte de service.
Erreur : Vertex AI n'a pas été utilisé
Si vous recevez cette erreur :
Permission Denied: 403 Vertex AI API has not been used in project YOUR_PROJECT before or it is disabled. Accédez à la page https://console.developers.google.com/apis/api/aiplatform.googleapis.com/overview?project=YOR_PROJECT pour l'activer.
Il vous suffit d'activer les API Vertex AI. Le moyen le plus simple d'activer TOUTES les API nécessaires est le suivant :
- https://console.cloud.google.com/vertex-ai
- Cliquez sur "Activer toutes les API recommandées".

Erreur : Déclencheur Eventarc introuvable.
Si vous obtenez ce message, veuillez redéployer la fonction.

Erreur : 400 Des agents de service sont en cours de provisionnement
400 Service agents are being provisioned ( https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents ). Service agents are needed to read the Cloud Storage file provided. Veuillez réessayer dans quelques minutes.
Si cela se produit, patientez un peu ou demandez de l'aide à un Googler.
10. Module 8 : Créer des SLO de disponibilité
Dans ce chapitre, nous essayons d'atteindre l'objectif suivant :
- Créer des SLI
- Créer des SLO basés sur les SLI
- Créer des alertes basées sur des SLO

Ce sujet tient particulièrement à cœur à l'auteur, car Riccardo travaille dans le domaine SRE/DevOps de Google Cloud.
(Question ouverte) Créez des SLI et des SLO pour cette application
À quoi sert une application si vous ne pouvez pas savoir quand elle est indisponible ?
Qu'est-ce qu'un SLO ?
Oh mon Dieu ! Google a inventé les SLO. Pour en savoir plus, je vous suggère de consulter :
- Livre sur l'ingénierie SRE – Chapitre 2 – Implementing SLOs (Mettre en œuvre des SLO) (👉 Plus de livres sur l'ingénierie SRE)
- Art of SLOs (vidéo). Cette formation est idéale pour apprendre à créer un SLO parfait pour votre service.
- Cours sur l'ingénierie SRE sur Coursera J'y ai contribué !
Étape 1 : Créez un SLI/SLO de disponibilité
Commençons par le SLO de disponibilité, car il s'agit de la métrique la plus simple et probablement la plus importante que vous souhaitez mesurer.
Heureusement, Cloud Run est compatible avec les SLO prédéfinis grâce à Istio.
Une fois votre application sur Cloud Run, c'est très simple à faire. Cela me prend 30 secondes.
- Accédez à la page Cloud Run.
- Cliquez sur votre application ou sélectionnez-la.
- Sélectionnez l'onglet
SLOs. - Cliquez sur "+ Créer un SLO".
- Disponibilité, basée sur les requêtes
- Continuer
- Mois calendaire / 99 %.
- cliquez sur "Créer un SLO".

Étape 2 : Configurez les alertes pour ce SLO
Je vous suggère de créer deux alertes :
- Une avec un taux de consommation faible ("Slowburn") pour vous alerter par e-mail (simule un ticket de faible priorité).
- Une avec un taux de consommation élevé ("Fastburn") pour vous alerter par SMS (simule un ticket/bipeur de priorité élevée)
Accédez à votre SLO tab.
Répétez cette opération deux fois :

- Cliquez sur "Créer une alerte de SLO" (le bouton 🔔 avec un signe plus à l'intérieur, à droite).
- Durée de l'analyse, seuil du taux d'utilisation :
- [FAST]. Premier :
60min/10x - [SLOW]. Deuxième :
720min/2x - Canal de notification : cliquez sur "Gérer les canaux de notification".
- Tout d'abord, "E-mail" -> Ajouter -> ..
- Ensuite, sélectionnez "SMS" -> "Ajouter" -> "Valider sur le téléphone".
- Conseil : J'aime utiliser des emoji dans les noms. C'est amusant pour les démonstrations.
- Une fois que vous avez terminé, cliquez sur le grand X en haut à droite.
- Sélectionnez d'abord le téléphone (rapide), puis l'e-mail (lent).
- Ajoutez des exemples de documentation, par exemple :
[PHP Amarcord] Riccardo told me to type sudo reboot or to check documentation in http://example.com/playbooks/1.php but I guess he was joking.
Bravo !
Résultat final
Nous pouvons considérer cet exercice comme terminé une fois que vous disposez d'un SLO fonctionnel et de deux alertes pour votre disponibilité, et que vous recevez des alertes par e-mail et sur votre téléphone.
Si vous le souhaitez, vous pouvez ajouter une latence (et je vous encourage vivement à le faire) ou même une latence plus complexe. Pour la latence, choisissez une valeur que vous jugez raisonnable. En cas de doute, choisissez 200 ms.
11. Étapes suivantes
Vous avez TOUT terminé. Qu'est-ce qui manque ?
Voici quelques pistes de réflexion :
Jouez avec Gemini
Vous pouvez utiliser Gemini de deux manières :
- Vertex AI. La "méthode Enterprise", intégrée à votre GCP, que nous avons explorée au chapitre 7 (GCF+Gemini). L'authentification fonctionne comme par magie, et les services s'interconnectent parfaitement.
- IA de Google. La "méthode grand public". Vous obtenez une clé API Gemini ici et commencez à créer de petits scripts qui peuvent être associés à n'importe quelle charge de travail existante (travail propriétaire, autres clouds, localhost, etc.). Il vous suffit de remplacer votre clé API pour que le code commence à fonctionner comme par magie.
Nous vous encourageons à explorer (2) avec vos propres projets.
UI Lifting
Je ne suis pas doué pour les UI. Mais Gemini l'est ! Vous pouvez simplement prendre une seule page PHP et dire quelque chose comme ceci :
I have a VERY old PHP application. I want to touch it as little as possible. Can you help me:
1. add some nice CSS to it, a single static include for tailwind or similar, whatever you prefer
2. Transform the image print with description into cards, which fit 4 per line in the canvas?
Here's the code:
-----------------------------------
[Paste your PHP page, for instance index.php - mind the token limit!]
Vous pouvez facilement l'obtenir en moins de cinq minutes, en un seul Cloud Build ! :)
La réponse de Gemini était parfaite (je n'ai rien eu à changer) :

Voici la nouvelle mise en page dans l'application personnelle de l'auteur :

Remarque : Le code est collé sous forme d'image, car nous ne voulons pas vous encourager à le copier, mais plutôt à demander à Gemini de l'écrire pour vous, avec vos propres contraintes d'UI/de frontend. Croyez-moi, vous n'aurez ensuite que des modifications très mineures à apporter.
Sécurité
La sécurisation de cette application n'est pas l'objectif de cet atelier de quatre heures, car cela augmenterait le temps nécessaire pour le terminer d'un ou deux ordres de grandeur.
Cependant, ce sujet est très important. Nous avons rassemblé quelques idées dans SECURITY.
12. Félicitations !
Félicitations 🎉🎉🎉 ! Vous avez modernisé votre ancienne application PHP avec Google Cloud.

Voici un résumé des concepts appris au cours de cet atelier de programmation :
- Déployer une base de données dans Google Cloud SQL et y migrer votre base de données existante.
- Conteneuriser votre application PHP avec Docker et Buildpacks, et stocker son image dans Google Cloud Artifact Registry
- Déployer votre application conteneurisée sur Cloud Run et l'exécuter avec Cloud SQL
- Stocker/Utiliser secrètement des paramètres de configuration sensibles (comme un mot de passe de base de données) à l'aide de Google Secret Manager
- Comment configurer votre pipeline CI/CD avec Google Cloud Build pour compiler et déployer automatiquement votre application PHP à chaque envoi de code vers votre dépôt GitHub.
- Utiliser Cloud Storage pour "cloudifier" les ressources de votre application
- Comment exploiter les technologies sans serveur pour créer des workflows incroyables sur Google Cloud sans toucher au code de votre application.
- Utiliser les capacités multimodales de Gemini pour un cas d'utilisation adapté
- Implémenter les principes d'ingénierie SRE dans Google Cloud
C'est un excellent début pour votre parcours de modernisation des applications avec Google Cloud.
🔁 Commentaires
Si vous souhaitez nous faire part de votre expérience avec cet atelier, n'hésitez pas à remplir ce formulaire de commentaires.
N'hésitez pas à nous faire part de vos commentaires et à nous envoyer des demandes d'extraction pour les morceaux de code dont vous êtes particulièrement fier.
🙏 Merci
L'auteur tient à remercier Mirko Gilioli et Maurizio Ipsale de Datatonic pour leur aide dans la rédaction et le test de la solution.
