Guide de démarrage rapide: déployer un service Cloud Run avec Cloud Code

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

Vous allez configurer un service Hello World qui s'exécutera sur Cloud Run à l'aide d'un exemple d'application, déployer votre service sur Cloud Run et afficher l'état des ressources du service actif.

Créer un service Cloud Run avec Cloud Code

Si vous exécutez ce guide de démarrage rapide sur le silicium Apple M-series, votre application est créée à l'aide de Cloud Build, ce qui peut entraîner des frais. Pour plus d'informations, consultez la page Compatibilité de Cloud Code avec le silicium Apple M-series.

Avant de commencer

  1. Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.
  2. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

    Accéder au sélecteur de projet

  3. Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier que la facturation est activée pour votre projet.

  4. Activez l'API Cloud Run.

    Activer l'API

Installer Cloud Code

Pour installer le plug-in Cloud Code for IntelliJ:

  1. Installez l'IDE JetBrains version 2020.3+ (par exemple, IntelliJ Ultimate/Community, PyCharm Professional/Community,WebStorm, GoLand, si ce n'est pas déjà fait.

  2. Si vous exécutez Cloud Code sur le silicium Apple M-series, installez Rosetta 2. Cela permet à Cloud Code d'installer kubectl en tant que dépendance gérée.

    Si vous préférez ne pas installer Rosetta 2, désactivez les dépendances gérées (IntelliJ IDEA >Préférences >Outils >Cloud Code >Dépendances ) et installez votre propre version de ARM de kubectl comme décrit dansVersions personnalisées des dépendances (Installation de Python groupée).

  3. 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 doit être visible dans un répertoire de votre répertoire PATH. Pour vérifier si Docker est déjà installé, exécutez la commande docker -v.
    • Cloud Code installe automatiquement les autres dépendances nécessaires.
  4. Ouvrez IntelliJ IDEA (ou tout IDE JetBrains compatible).

  5. Une fois votre IDE ouvert, actualisez cette page.

    Vous pouvez maintenant installer le plug-in Cloud Code directement en cliquant sur le bouton ci-dessous:

    Le bouton lance une boîte de dialogue d'installation dans votre IDE ouvert. Cliquez sur OK pour configurer Cloud Code.

Créer un service

Pour créer un service à l'aide d'un exemple existant, procédez comme suit:

  1. Dans votre IDE, ouvrez File > New Project (Fichier > Nouveau projet), puis sélectionnez Cloud Code: Cloud Run.
  2. Sélectionnez le langage de programmation de votre exemple d'application, puis cliquez sur Suivant. Créer un service à partir d'une liste d'exemples d'applications existants
  3. Nommez votre projet, puis cliquez sur Terminer.

    Cloud Code clone l'exemple d'application, ouvre le projet que vous venez de créer et crée les configurations d'exécution Cloud Run nécessaires.

  4. Si vous avez choisi un exemple d'application Java, lorsque vous y êtes invité, cliquez sur Load Maven project (Charger le projet Maven).

    Notification de création de scripts Maven trouvée : sélectionnez "Charger le projet Maven", "Ignorer" ou "Aide".

Vous pouvez maintenant exécuter votre service Hello World. Cloud Code surveille la modification de votre système de fichiers. Vous pouvez ainsi modifier et réexécuter votre service quasiment en temps réel.

Déployer votre service sur Cloud Run

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

  1. Dans le sélecteur de configuration d'exécution et de débogage de la barre de navigation, choisissez la configuration d'exécution créée automatiquement, Cloud Run: déploiement.

    Si vous exécutez ce guide de démarrage rapide sur le silicium Apple M-series, votre application est créée à l'aide de Cloud Build. Pour en savoir plus sur les tarifs de Cloud Build, consultez la section Tarifs.

  2. Cliquez sur 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 (entièrement géré), comme plate-forme de déploiement.

  5. Cliquez sur Run (Exécuter).

  6. Affichez votre service 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 service (métriques, détails de la révision, etc.) en suivant l'URL des journaux affichée dans la fenêtre de sortie.

    Afficher l'état de votre service dans Cloud Console

Afficher l'état des ressources

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

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

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

  2. Pour afficher les propriétés d'un service ou d'une révision, cliquez sur ce service ou cette révision dans l'explorateur.

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

  3. Pour afficher les journaux d'une révision, faites un clic droit sur la révision, puis cliquez sur Afficher les journaux Cloud.

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

Nettoyer

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

  1. Accédez à la page Projets de Google Cloud Console:

    Accéder à la page Projets

  2. Sélectionnez le projet que vous avez créé pour ce guide de démarrage rapide, puis cliquez sur 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 les étapes décrites dans la section Supprimer des images.
  • Service Cloud Run:pour supprimer un service Cloud Run, accédez à Cloud Run dans Cloud Console à l'aide du menu de navigation. Sélectionnez le service que vous souhaitez supprimer, puis cliquez sur Supprimer.

Étape suivante

Assistance

Pour envoyer des commentaires ou signaler un problème dans votre IDE IntelliJ, accédez à Tools > Cloud Code > Aide / À propos > Envoyez des commentaires ou signalez un problème pour signaler un problème sur GitHub, ou posez une question sur Stack Overflow.

Vous pouvez également rejoindre la chaîne #cloud-code, qui fait partie de la communauté Slack Google Cloud.