Démarrage rapide: Déployer une application Cloud Run avec Cloud Code

Cette page explique comment faire vos premiers pas avec Cloud Code.

Vous allez configurer une application Hello World qui s'exécute sur Cloud Run à l'aide d'un modèle de départ, déployer votre application sur Cloud Run et afficher l'état des ressources actives de votre application.

Créer une application Cloud Run avec Cloud Code

Avant de commencer

Pour utiliser Cloud Run, vous devez créer un projet GCP et activer la facturation.

En outre, vous devez activer la compatibilité avec Cloud Run sur votre projet. Dans la console, utilisez le menu de navigation pour accéder à "APIs and Services > Dashboard" (API et services > Tableau de bord). Cliquez sur "API Cloud Run" dans la liste des API disponibles, puis cliquez sur "Activer l'API".

Installer Cloud Code

Pour installer le plug-in Cloud Code, procédez comme suit :

  1. Installez l'IDE JetBrains version 2019.3+ (par exemple, IntelliJ Ultimate/Community, PyCharm Professional/Community, WebStorm ou GoLand), si ce n'est pas déjà fait.
  2. Installez les dépendances :
    • Pour toutes les plates-formes cloud, assurez-vous que le client Docker (authentifié avec votre registre Docker) est installé sur le PATH de votre machine (son dossier respectif doit être visible dans un répertoire de votre PATH). Pour vérifier si Docker est déjà installé, exécutez docker -v.
    • Cloud Code installe automatiquement les autres dépendances nécessaires.
  3. Ouvrez IntelliJ IDEA (ou tout IDE JetBrains compatible).
  4. Sur la place de marché de plug-ins (File > Settings > Plugins (Fichier > Paramètres > Plug-ins) ou, pour macOS X, IntelliJ IDEA > Preferences > Plugins (IntelliJ IDEA > Préférences > Plug-ins)), recherchez le plug-in "Cloud Code" et installez-le. Vous serez peut-être invité à redémarrer votre IDE pour activer le plug-in.

Créer une application

Pour créer une application à l'aide d'un exemple existant :

  1. Dans votre IDE, ouvrez File (Fichier > New Project (Nouveau projet) et sélectionnez Cloud Code: Cloud Run.
  2. Sélectionnez un modèle "Hello World" dans la liste d'exemples d'applications. Création d'une application à partir d'une liste d'exemples d'applications
  3. Indiquez un nom pour votre projet.

    Une fois que vous avez cliqué sur Finish (Terminer), Cloud Code clone le modèle choisi, ouvre le projet que vous venez de créer et crée les configurations d'exécution Cloud Run nécessaires.

    • Pour les modèles Java, vous êtes invité à importer des projets Maven pour synchroniser votre fichier pom.xml. Cliquez sur "Add as Maven project" (Ajouter en tant que projet Maven).

      Notification indiquant que le fichier pom.xml n'est pas géré

      Vous pouvez également importer les projets Maven nécessaires en cliquant sur "Import Changes" (Importer les modifications).

      Notification d'importation des modifications Maven

Déployer votre application dans Cloud Run

Pour déployer votre application, procédez comme suit :

  1. Choisissez la configuration d'exécution créée automatiquement, Cloud Run: Deploy, dans la boîte de dialogue "Run/Debug configurations" (Configuration d'exécution/de débogage) de la barre des tâches supérieure.
  2. Cliquez sur Run (Exécuter) icône d'action d'exécution. La fenêtre "Edit configuration" (Modifier la configuration) s'affiche.
  3. Définissez l'ID du projet Google Cloud.
  4. Choisissez une région pour votre plate-forme de déploiement. Ce guide de démarrage rapide utilise l'option de plate-forme par défaut, "Cloud Run (fully managed)" (Cloud Run (entièrement géré)), comme "Deployment Platform" (Plate-forme de déploiement).
  5. Cliquez sur "Run" (Exécuter).
  6. Affichez votre application en cours d'exécution en suivant l'URL affichée dans la fenêtre de sortie.
  7. Vous pouvez également afficher l'état de votre application (métriques, détails des révisions, etc.) en suivant l'URL des journaux affichée dans la fenêtre de sortie.

    Afficher l'état de votre application dans la console

Afficher l'état des ressources

Pour afficher l'état des ressources de votre application en cours d'exécution, procédez comme suit :

  1. Accédez à l'explorateur Cloud Run. Vous pouvez y accéder à partir du panneau latéral situé à droite.

    Cliquez sur l'onglet de l'explorateur Cloud Run mis en évidence dans le panneau de droite

  2. Cliquez sur un service ou une révision dans l'explorateur pour afficher ses propriétés.

    L'explorateur Cloud Run s'ouvre avec un service sélectionné et ses propriétés sont affichées ci-dessous.

  3. Effectuez un clic droit sur une révision pour afficher ses journaux.

    Effectuer un clic droit sur une révision pour afficher ses journaux

Nettoyer

Si vous avez créé un projet pour ce démarrage rapide, veillez à le supprimer pour éviter des frais inutiles :

  • Accédez à la page "Projets" de Cloud Console :

    Accéder à la page Projets

  • Sélectionnez le projet que vous avez créé dans ce démarrage rapide, puis cliquez sur l'icône en forme de corbeille située à côté pour le supprimer.

    Cette opération ferme le projet et programme sa suppression.

Si vous utilisez un projet préexistant et que vous souhaitez supprimer les ressources que vous avez créées pour ce démarrage rapide :

  • Image du conteneur : bien que Cloud Run ne facture pas lorsque le service n'est pas utilisé, il se peut que des frais vous soient facturés pour le stockage de l'image de conteneur dans Container Registry. Pour supprimer votre image, suivez ce guide.
  • Service Cloud Run : pour supprimer un service Cloud Run, accédez à Cloud Run dans la console à l'aide du menu de navigation. Sélectionnez le service que vous souhaitez supprimer, puis cliquez sur l'icône de suppression de la corbeille.

Étapes suivantes

Assistance

Pour envoyer vos commentaires, signalez tout problème sur GitHub ou posez une question sur Stack Overflow.