arrow_back

Premiers pas avec API Gateway : atelier challenge

Accédez à plus de 700 ateliers et cours

Premiers pas avec API Gateway : atelier challenge

Atelier 45 minutes universal_currency_alt 1 crédit show_chart Débutant
info Cet atelier peut intégrer des outils d'IA pour vous accompagner dans votre apprentissage.
Accédez à plus de 700 ateliers et cours

ARC109

Logo des ateliers d'auto-formation Google Cloud

Présentation

Dans un atelier challenge, vous devez suivre un scénario et effectuer une série de tâches. Aucune instruction détaillée n'est fournie : vous devez utiliser les compétences acquises au cours des ateliers du cours correspondant pour déterminer comment procéder par vous-même. Vous saurez si vous avez exécuté correctement les différentes tâches grâce au score calculé automatiquement (affiché sur cette page).

Lorsque vous participez à un atelier challenge, vous n'étudiez pas de nouveaux concepts Google Cloud. Vous allez approfondir les compétences précédemment acquises. Par exemple, vous devrez modifier les valeurs par défaut ou encore examiner des messages d'erreur pour corriger vous-même les problèmes.

Pour atteindre le score de 100 %, vous devez mener à bien l'ensemble des tâches dans le délai imparti.

Préparation

Avant de cliquer sur le bouton "Démarrer l'atelier"

Lisez ces instructions. Les ateliers sont minutés, et vous ne pouvez pas les mettre en pause. Le minuteur, qui démarre lorsque vous cliquez sur Démarrer l'atelier, indique combien de temps les ressources Google Cloud resteront accessibles.

Cet atelier pratique vous permet de suivre les activités dans un véritable environnement cloud, et non dans un environnement de simulation ou de démonstration. Des identifiants temporaires vous sont fournis pour vous permettre de vous connecter à Google Cloud le temps de l'atelier.

Pour réaliser cet atelier :

  • Vous devez avoir accès à un navigateur Internet standard (nous vous recommandons d'utiliser Chrome).
Remarque : Ouvrez une fenêtre de navigateur en mode incognito (recommandé) ou de navigation privée pour effectuer cet atelier. Vous éviterez ainsi les conflits entre votre compte personnel et le compte temporaire de participant, qui pourraient entraîner des frais supplémentaires facturés sur votre compte personnel.
  • Vous disposez d'un temps limité. N'oubliez pas qu'une fois l'atelier commencé, vous ne pouvez pas le mettre en pause.
Remarque : Utilisez uniquement le compte de participant pour cet atelier. Si vous utilisez un autre compte Google Cloud, des frais peuvent être facturés à ce compte.

Scénario du challenge

Vous venez d'être embauché en tant qu'analyste de données junior. Jusqu'à présent, vous avez aidé des équipes à créer, gérer et accéder à des ressources de données de backend.

Vous êtes censé disposer des compétences et des connaissances requises pour ces tâches.

Votre challenge

On vous demande d'aider une équipe de développement récemment constituée à démarrer un nouveau projet portant sur l'exposition de services de backend en tant qu'API. Vous devez aider l'équipe à utiliser des passerelles API Gateway. Les tâches que vous devez effectuer sont les suivantes :

  • Développer le système backend à l'aide d'une fonction Cloud Run
  • Déployer et gérer une API exposant le service de backend avec une passerelle entièrement gérée
  • S'abonner aux messages publiés dans un sujet Pub/Sub pour réagir aux événements

Chaque tâche est décrite ci-dessous. Bonne chance !

Tâche 1 : Créer une fonction Cloud Run

Remarque : Cloud Run Functions (2e génération) dépend des API Cloud Run Admin. Les API Cloud Run Admin ont été activées pour vous au début de cet atelier. Toutefois, la propagation de tous les services activés peut prendre quelques minutes. Si vous rencontrez un problème lors du déploiement de votre fonction Cloud Run, attendez quelques minutes, puis réessayez.

Créez une fonction Cloud Run (2e génération) nommée gcfunction dans la région à l'aide de Node.js 22, et qui autorise les appels non authentifiés. Pour l'instant, faites en sorte que la fonction renvoie simplement "Hello World!" lorsqu'elle est appelée.

Cliquez sur Vérifier ma progression pour valider l'objectif. Créer une fonction Cloud Run

Tâche 2 : Créer une passerelle API

Une fois la fonction Cloud Run déployée, configurez une passerelle API pour connecter en proxy les requêtes vers le backend.

Créez un fichier nommé openapispec.yaml (à l'aide du code ci-dessous), qui fait référence à la fonction Cloud Run déployée dans la tâche 1.

Utilisez openapispec.yaml pour déployer la passerelle API avec les propriétés suivantes :

Nom Valeur
Nom à afficher API gcfunction (partout où cela est demandé)
ID de l'API gcfunction-api
Sélectionner un compte de service Compte de service Compute Engine par défaut
Emplacement
Nom de la configuration gcfunction-api
swagger: '2.0' info: title: gcfunction API description: Sample API on API Gateway with a Google Cloud Run functions backend version: 1.0.0 schemes: - https produces: - application/json x-google-backend: address: https://gcfunction-{{{ project_0.startup_script.project_number | PROJECT_NUMBER }}}.{{{project_0.default_region | REGION}}}.run.app paths: /gcfunction: get: summary: gcfunction operationId: gcfunction responses: '200': description: A successful response schema: type: string Remarque : La création de la passerelle prend environ 10 minutes. Pour vérifier l'état du processus de création et de déploiement, vous pouvez cliquer sur l'icône de notifications (en forme de cloche) dans la barre de navigation principale en haut de la page. Veuillez vous assurer que l'icône d'état de Création de la passerelle "gcfunction API" est accompagnée d'une coche verte avant de continuer.

Cliquez sur Vérifier ma progression pour valider l'objectif. Créer une passerelle API

Tâche 3 : Créer un sujet Pub/Sub et publier des messages via un backend d'API

L'équipe de développement souhaite que le backend de l'API publie des messages dans un nouveau sujet Pub/Sub nommé demo-topic.

Créez un sujet Pub/Sub (demo-topic) et envoyez-y des messages dans la fonction Cloud Run déployée précédemment. Veillez à laisser l'option de création d'un abonnement par défaut activée lors de la création du sujet.

Utilisez l'extrait ci-dessous pour mettre à jour le fichier package.json et le code index.js dans la fonction Cloud Run déployée à la tâche 1.

package.json

{ "dependencies": { "@google-cloud/functions-framework": "^3.0.0", "@google-cloud/pubsub": "^3.4.1" } }

index.js

/** * Responds to any HTTP request. * * @param {!express:Request} req HTTP request context. * @param {!express:Response} res HTTP response context. */ const {PubSub} = require('@google-cloud/pubsub'); const pubsub = new PubSub(); const topic = pubsub.topic('demo-topic'); const functions = require('@google-cloud/functions-framework'); exports.helloHttp = functions.http('helloHttp', (req, res) => { // Send a message to the topic topic.publishMessage({data: Buffer.from('Hello from Cloud Run functions!')}); res.status(200).send("Message sent to Topic demo-topic!"); });

Redéployez la fonction Cloud Run une fois que les fichiers index.js et package.json ont été mis à jour.

Ensuite, vous allez appeler la fonction Cloud Run via la passerelle API. Si vous avez correctement suivi les étapes, un message sera publié dans le sujet demo-topic que vous avez créé dans cette tâche.

Remarque : L'affichage des messages publiés dans la section "Messages" de l'abonnement prendra plusieurs minutes (environ cinq) après l'appel du point de terminaison de la passerelle API.

Cliquez sur Vérifier ma progression pour valider l'objectif. Créer un sujet Pub/Sub et publier des messages via un backend d'API

Félicitations !

Vous avez terminé le défi qui consistait à déployer et à gérer une API exposant le service de backend avec une passerelle entièrement gérée.

Formations et certifications Google Cloud

Les formations et certifications Google Cloud vous aident à tirer pleinement parti des technologies Google Cloud. Nos cours portent sur les compétences techniques et les bonnes pratiques à suivre pour être rapidement opérationnel et poursuivre votre apprentissage. Nous proposons des formations pour tous les niveaux, à la demande, en salle et à distance, pour nous adapter aux emplois du temps de chacun. Les certifications vous permettent de valider et de démontrer vos compétences et votre expérience en matière de technologies Google Cloud.

Dernière mise à jour du manuel : 01 avril 2025

Dernier test de l'atelier : 01 avril 2025

Copyright 2025 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.

Avant de commencer

  1. Les ateliers créent un projet Google Cloud et des ressources pour une durée déterminée.
  2. Les ateliers doivent être effectués dans le délai imparti et ne peuvent pas être mis en pause. Si vous quittez l'atelier, vous devrez le recommencer depuis le début.
  3. En haut à gauche de l'écran, cliquez sur Démarrer l'atelier pour commencer.

Utilisez la navigation privée

  1. Copiez le nom d'utilisateur et le mot de passe fournis pour l'atelier
  2. Cliquez sur Ouvrir la console en navigation privée

Connectez-vous à la console

  1. Connectez-vous à l'aide des identifiants qui vous ont été attribués pour l'atelier. L'utilisation d'autres identifiants peut entraîner des erreurs ou des frais.
  2. Acceptez les conditions d'utilisation et ignorez la page concernant les ressources de récupération des données.
  3. Ne cliquez pas sur Terminer l'atelier, à moins que vous n'ayez terminé l'atelier ou que vous ne vouliez le recommencer, car cela effacera votre travail et supprimera le projet.

Ce contenu n'est pas disponible pour le moment

Nous vous préviendrons par e-mail lorsqu'il sera disponible

Parfait !

Nous vous contacterons par e-mail s'il devient disponible

Un atelier à la fois

Confirmez pour mettre fin à tous les ateliers existants et démarrer celui-ci

Utilisez la navigation privée pour effectuer l'atelier

Ouvrez une fenêtre de navigateur en mode navigation privée pour effectuer cet atelier. Vous éviterez ainsi les conflits entre votre compte personnel et le compte temporaire de participant, qui pourraient entraîner des frais supplémentaires facturés sur votre compte personnel.