Démarrage rapide : Créer une instance Cloud Run

Démarrage rapide : Créer une instance Cloud Run

Aperçu : Instances Cloud Run

Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une prise en charge limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Cette page explique comment utiliser Cloud Run pour créer une instance Cloud Run dans un exemple de conteneur, afficher ses journaux et gérer son cycle de vie à l'aide de la gcloud CLI.

Avant de commencer

1. Installez la Google Cloud CLI.

   Remarque : Si vous avez déjà installé la gcloud CLI, assurez-vous que vous disposez de la dernière version en exécutant gcloud components update.

2. Configurez la gcloud CLI afin d'utiliser votre identité fédérée.

   Pour en savoir plus, consultez Se connecter à la gcloud CLI avec votre identité fédérée.

3. Pour initialiser la gcloud CLI, exécutez la commande suivante :

   gcloud init

4. Créez ou sélectionnez un Google Cloud projet.

   Rôles requis pour sélectionner ou créer un projet

   • Sélectionner un projet : la sélection d'un projet ne nécessite pas de rôle IAM spécifique Vous pouvez sélectionner n'importe quel projet pour lequel un rôle vous a été attribué.
   • Créer un projet : pour créer un projet, vous avez besoin du rôle Créateur de projet (roles/resourcemanager.projectCreator), qui contient l'autorisation resourcemanager.projects.create. Découvrez comment attribuer des rôles.
   Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu d'en sélectionner un existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

   • Créez un Google Cloud projet :

     gcloud projects create PROJECT_ID

     Remplacez PROJECT_ID par le nom du Google Cloud projet que vous créez.

   • Sélectionnez le Google Cloud projet que vous avez créé :

     gcloud config set project PROJECT_ID

     Remplacez PROJECT_ID par le nom de votre Google Cloud projet.

5. Si vous utilisez un projet existant pour ce guide, vérifiez que vous disposez des autorisations nécessaires pour suivre les instructions. Si vous avez créé un nouveau projet, vous disposez déjà des autorisations requises.

6. Vérifiez que la facturation est activée pour votre Google Cloud projet.

7. Activez l'API Cloud Run Admin et les API Cloud Logging :

   Rôles requis pour activer les API

   Pour activer les API, vous avez besoin de l'autorisation serviceusage.services.enable. Si vous avez créé le projet, vous disposez probablement déjà de cette autorisation via le rôle Propriétaire (roles/owner). Sinon, vous pouvez obtenir cette autorisation via le rôle Administrateur d'utilisation du service (roles/serviceusage.serviceUsageAdmin). Découvrez comment attribuer des rôles.

   gcloud services enable run.googleapis.com logging.googleapis.com

8. Pour définir le projet par défaut pour votre instance Cloud Run :

   gcloud config set project PROJECT_ID

   Remplacez PROJECT_ID par le nom du projet que vous avez créé pour ce guide de démarrage rapide.
9. Assurez-vous que le composant gcloud beta est installé :

   gcloud components install beta

10. Consultez les tarifs de Cloud Run ou estimez les coûts à l'aide du simulateur de coût.

Rôles requis

Pour obtenir les autorisations nécessaires pour suivre ce guide de démarrage rapide, demandez à votre administrateur de vous accorder les rôles IAM suivants :

• Administrateur Cloud Run (roles/run.admin) sur l'instance
• Utilisateur du compte de service (roles/iam.serviceAccountUser) sur l'identité du service
• Lecteur des journaux (roles/logging.viewer) on the project

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.

Créer une instance

Pour créer une instance Cloud Run dans un exemple de conteneur à l'aide de la gcloud CLI :

1. Exécutez la commande suivante :

   gcloud beta run instances create my-instance \
   --image us-docker.pkg.dev/cloudrun/container/hello \
   --region REGION \
   --port 8080 \
   --no-invoker-iam-check

   Remplacez REGION par une région prise en charge Google Cloud .

   L'option --no-invoker-iam-check désactive l'authentification de l'appelant IAM, ce qui rend l'URL de l'instance accessible sans authentification IAM.

2. Patientez pendant la création des instances. Une fois l'opération terminée, la commande affiche un résultat semblable à celui-ci :

   Creating instance...
   Importing container..............done
   Provisioning resources.......done
   Starting instance.....done
   Done.
   Instance [my-instance] has successfully been created.
   
   URL: https://my-instance-PROJECT-NUMBER.REGION.run.app
   

3. Ouvrez l'URL renvoyée dans votre navigateur pour interagir avec le conteneur en cours d'exécution.

Afficher les journaux d'instances

Pour afficher les journaux générés par votre instance Cloud Run :

1. Dans la Google Cloud console, accédez à l'explorateur de journaux:

   Accéder à l'explorateur de journaux

2. Filtrez les journaux de votre instance spécifique :

   resource.type="cloud_run_instance"
   resource.labels.location="<var>REGION</var>"
   resource.labels.instance_name="my-instance"
   

Effectuer un nettoyage

Pour éviter que les ressources utilisées dans cette démonstration soient facturées sur votre Google Cloud compte, procédez comme suit :

Supprimer votre instance

Pour arrêter et supprimer l'instance Cloud Run :

gcloud beta run instances delete my-instance --region REGION

Supprimer le projet de test

La suppression de votre Google Cloud projet arrête la facturation de toutes les ressources de ce projet. Pour libérer toutes les Google Cloud ressources de votre projet, procédez comme suit :

Attention : La suppression d'un projet aura les effets suivants :
• Tout le contenu du projet est supprimé. Si vous avez utilisé un projet existant pour les tâches décrites dans ce document et que vous le supprimez, vous supprimerez également tout autre travail effectué dans le projet.
• Les ID de projets personnalisés sont perdus. Lorsque vous avez créé ce projet, vous avez peut-être créé un ID de projet personnalisé que vous souhaitez utiliser à l'avenir. Pour conserver les URL qui utilisent l'ID de projet, telle qu'une appspot.com URL, supprimez les ressources sélectionnées dans le projet au lieu de supprimer l'ensemble du projet.

Supprimez un Google Cloud projet :

gcloud projects delete PROJECT_ID

Étape suivante

Pour en savoir plus sur les instances Cloud Run, consultez les ressources suivantes :

• Créer et gérer des instances Cloud Run
• Cycle de vie des instances Cloud Run