
Before you begin
- Labs create a Google Cloud project and resources for a fixed time
- Labs have a time limit and no pause feature. If you end the lab, you'll have to restart from the beginning.
- On the top left of your screen, click Start lab to begin
Deploying the Endpoints configuration
/ 20
Deploying the API backend
/ 20
Sending requests to the API
/ 20
Add a quota to the API
/ 20
Create API key and testing quota limit by sending requests
/ 20
Dans cet atelier, vous allez déployer un exemple d'API avec Google Cloud Endpoints, un ensemble d'outils permettant de générer des API à partir d'une application App Engine. L'exemple de code comprendra les éléments suivants :
IATA
à trois lettres (SFO, JFK, AMS, par exemple).Après avoir envoyé quelques requêtes à l'exemple d'API, vous pouvez consulter les journaux et graphiques d'activité Cloud Endpoints. Ces outils vous permettent de surveiller vos API et d'obtenir des informations sur leur utilisation.
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 vous-même les activités dans un véritable environnement cloud, et non dans un environnement de simulation ou de démonstration. Nous vous fournissons des identifiants temporaires pour vous connecter à Google Cloud le temps de l'atelier.
Pour réaliser cet atelier :
Cliquez sur le bouton Démarrer l'atelier. Si l'atelier est payant, un pop-up s'affiche pour vous permettre de sélectionner un mode de paiement. Sur la gauche, vous trouverez le panneau Détails concernant l'atelier, qui contient les éléments suivants :
Cliquez sur Ouvrir la console Google Cloud (ou effectuez un clic droit et sélectionnez Ouvrir le lien dans la fenêtre de navigation privée si vous utilisez le navigateur Chrome).
L'atelier lance les ressources, puis ouvre la page Se connecter dans un nouvel onglet.
Conseil : Réorganisez les onglets dans des fenêtres distinctes, placées côte à côte.
Si nécessaire, copiez le nom d'utilisateur ci-dessous et collez-le dans la boîte de dialogue Se connecter.
Vous trouverez également le nom d'utilisateur dans le panneau Détails concernant l'atelier.
Cliquez sur Suivant.
Copiez le mot de passe ci-dessous et collez-le dans la boîte de dialogue Bienvenue.
Vous trouverez également le mot de passe dans le panneau Détails concernant l'atelier.
Cliquez sur Suivant.
Accédez aux pages suivantes :
Après quelques instants, la console Cloud s'ouvre dans cet onglet.
Cloud Shell est une machine virtuelle qui contient de nombreux outils pour les développeurs. Elle comprend un répertoire d'accueil persistant de 5 Go et s'exécute sur Google Cloud. Cloud Shell vous permet d'accéder via une ligne de commande à vos ressources Google Cloud.
Une fois connecté, vous êtes en principe authentifié et le projet est défini sur votre ID_PROJET. Le résultat contient une ligne qui déclare YOUR_PROJECT_ID (VOTRE_ID_PROJET) pour cette session :
gcloud
est l'outil de ligne de commande pour Google Cloud. Il est préinstallé sur Cloud Shell et permet la complétion par tabulation.
Cliquez sur Autoriser.
Vous devez à présent obtenir le résultat suivant :
Résultat :
Résultat :
Exemple de résultat :
gcloud
, dans Google Cloud, accédez au guide de présentation de la gcloud CLI.
Pour publier une API REST dans Endpoints, vous avez besoin d'un fichier de configuration OpenAPI qui décrit l'API. L'exemple d'API de cet atelier est fourni avec un fichier OpenAPI préconfiguré et intitulé openapi.yaml
.
Cloud Endpoints utilise Service Management
, un service d'infrastructure de Google Cloud, pour créer et gérer des API et des services. Pour utiliser Endpoints afin de gérer une API, vous devez déployer la configuration OpenAPI de l'API dans Service Management.
Pour déployer la configuration Endpoints :
endpoints-qwikstart
, saisissez la commande suivante :Cloud Endpoints identifie le service à l'aide du champ host
du fichier de configuration OpenAPI. Le script deploy_api.sh
définit l'ID de votre projet Cloud comme une partie du nom configuré dans le champ host
. Notez que lorsque vous préparez un fichier de configuration OpenAPI pour votre propre service, vous devez réaliser cette opération manuellement.
Le script déploie ensuite la configuration OpenAPI dans Service Management avec la commande suivante : gcloud endpoints services deploy openapi.yaml
.
Lors de la création et de la configuration du service, Service Management fournit des informations à la console. Vous pouvez ignorer en toute sécurité les avertissements indiquant que les chemins de openapi.yaml
ne nécessitent pas de clé API. Si l'opération réussit, une ligne semblable à la suivante affiche l'ID de configuration et le nom du service :
Cliquez sur Vérifier ma progression pour valider l'objectif.
Vous avez déployé la configuration OpenAPI dans Service Management, mais vous n'avez pas encore déployé le code qui diffusera le backend de l'API. Le script deploy_app.sh
inclus dans l'exemple de l'atelier crée un environnement flexible App Engine pour héberger le backend de l'API, puis déploie l'API dans App Engine.
endpoints-quickstart/scripts
. Exécutez ensuite le script suivant :Le script exécute la commande suivante pour créer un environnement flexible App Engine dans la région gcloud app create --region="$REGION"
.
La création du backend flexible App Engine prend quelques minutes.
ERROR: NOT_FOUND: Unable to retrieve P4SA: from GAIA
, réexécutez le script deploy_app.sh
.
Une fois l'opération terminée, le message suivant s'affiche dans Cloud Shell :
Le script exécute ensuite la commande gcloud app deploy
pour déployer l'exemple d'API dans App Engine.
Une ligne semblable à la suivante s'affiche dans Cloud Shell :
Le déploiement de l'API dans App Engine prend quelques minutes. Une ligne semblable à la suivante s'affiche lorsque l'API a été déployée dans App Engine :
Cliquez sur Vérifier ma progression pour valider l'objectif.
Le script répercute la commande curl
qu'il utilise pour envoyer une requête à l'API, puis affiche le résultat. Une réponse semblable à la suivante s'affiche alors dans Cloud Shell :
L'API s'attend à recevoir un paramètre de requête, iataCode
, défini sur un code d'aéroport IATA valide tel que SEA ou JFK.
Vous venez de déployer et de tester une API dans Cloud Endpoints.
Cliquez sur Vérifier ma progression pour valider l'objectif.
Grâce aux API déployées avec Cloud Endpoints, vous pouvez surveiller les métriques liées à vos opérations critiques dans la console Cloud, et obtenir des informations sur vos utilisateurs et votre utilisation avec Cloud Logging :
Si le panneau latéral "Autorisations" n'est pas ouvert, cliquez sur Afficher le panneau des autorisations. Le panneau "Autorisations" vous permet de contrôler qui a accès à votre API et le niveau d'accès.
Cliquez sur l'onglet Historique des déploiements. Cet onglet affiche l'historique de vos déploiements d'API, dont l'heure de déploiement et l'utilisateur qui a déployé la modification.
Cliquez sur l'onglet Vue d'ensemble. Le trafic entrant s'affiche ici. Une fois que le script de génération de trafic s'est exécuté pendant une minute, faites défiler la page vers le bas pour afficher les trois lignes du graphique Latence totale : 50e, 95e et 99e centiles. Ces données donnent une estimation rapide des temps de réponse.
Au bas des graphiques Endpoints, sous "Méthode", cliquez sur le lien Afficher les journaux pour GET/airportName. La page "Visionneuse de journaux" affiche les journaux des requêtes pour l'API.
Appuyez sur CTRL+C dans Cloud Shell pour arrêter le script.
Cloud Endpoints vous permet de définir des quotas pour contrôler le débit auquel les applications peuvent appeler votre API. Les quotas peuvent être utilisés pour protéger votre API contre une utilisation excessive par un seul client.
Cliquez sur Vérifier ma progression pour valider l'objectif.
Une réponse semblable à la suivante s'affiche dans la console :
Après avoir exécuté le script pendant 5 à 10 secondes, appuyez sur CTRL+C dans Cloud Shell pour arrêter le script.
Envoyez une autre requête authentifiée à l'API :
Une réponse semblable à la suivante s'affiche dans la console :
Si vous obtenez une réponse différente, réessayez d'exécuter le script generate_traffic_with_key.sh
, puis d'envoyer une requête authentifiée à l'API.
Cliquez sur Vérifier ma progression pour valider l'objectif.
Félicitations ! Vous avez réussi à limiter le débit de votre API. Vous pouvez également définir des limites variables en fonction des différentes méthodes d'API, créer plusieurs types de quotas et effectuer le suivi de l'utilisation des API par vos clients.
Cet atelier fait partie d'une série appelée "Qwik Starts". Les ateliers de cette série sont conçus pour vous donner un aperçu des nombreuses fonctionnalités proposées par Google Cloud. Recherchez "Qwik Starts" dans le catalogue pour trouver le prochain atelier que vous aimeriez suivre.
Pour en savoir plus sur les quotas, consultez les pages suivantes :
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 : 25 avril 2024
Dernier test de l'atelier : 25 avril 2024
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.
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
One lab at a time
Confirm to end all existing labs and start this one