Hello Cloud Run avec C#

1. Introduction

Cloud Run est une plate-forme gérée qui vous permet d'exécuter des conteneurs sans état accessibles via des requêtes HTTP. Cloud Run fonctionne sans serveur : il élimine toute gestion de l'infrastructure pour vous permettre de vous concentrer sur ce qui compte le plus : créer des applications de qualité.

La plate-forme étant basée sur Knative, vous pouvez exécuter vos conteneurs soit de façon entièrement gérée avec Cloud Run, soit dans votre cluster Google Kubernetes Engine avec Cloud Run sur GKE.

L'objectif de cet atelier de programmation est de créer une image de conteneur et de la déployer sur Cloud Run.

2. Préparation

Configuration de l'environnement au rythme de chacun

1. Connectez-vous à la console Google Cloud, puis créez un projet ou réutilisez un projet existant. (Si vous ne possédez pas encore de compte Gmail ou Google Workspace, vous devez en créer un.)

• Le nom du projet est le nom à afficher pour les participants au projet. Il s'agit d'une chaîne de caractères non utilisée par les API Google. Vous pourrez toujours le modifier.
• L'ID du projet est unique parmi tous les projets Google Cloud et non modifiable une fois défini. La console Cloud génère automatiquement une chaîne unique (en général, vous n'y accordez d'importance particulière). Dans la plupart des ateliers de programmation, vous devrez indiquer l'ID de votre projet (généralement identifié par PROJECT_ID). Si l'ID généré ne vous convient pas, vous pouvez en générer un autre de manière aléatoire. Vous pouvez également en spécifier un et voir s'il est disponible. Après cette étape, l'ID n'est plus modifiable et restera donc le même pour toute la durée du projet.
• Pour information, il existe une troisième valeur (le numéro de projet) que certaines API utilisent. Pour en savoir plus sur ces trois valeurs, consultez la documentation.

Attention : Un ID de projet est unique. Une fois que vous l'avez choisi, personne d'autre ne peut l'employer. Vous en êtes le seul utilisateur. Même si un projet est supprimé, son ID ne peut pas être réutilisé.

Remarque : Si vous utilisez un compte Gmail, vous pouvez conserver l'emplacement par défaut défini sur Aucune organisation. Si vous utilisez un compte Google Workspace, choisissez un emplacement qui ait du sens pour votre organisation.

2. Vous devez ensuite activer la facturation dans la console Cloud pour utiliser les ressources/API Cloud. L'exécution de cet atelier de programmation est très peu coûteuse, voire sans frais. Pour désactiver les ressources et éviter ainsi que des frais ne vous soient facturés après ce tutoriel, vous pouvez supprimer le projet ou les ressources que vous avez créées. Les nouveaux utilisateurs de Google Cloud peuvent participer au programme d'essai sans frais pour bénéficier d'un crédit de 300 $.

Google Cloud Shell

Bien que Google Cloud puisse être utilisé à distance depuis votre ordinateur portable, nous allons utiliser Google Cloud Shell dans cet atelier de programmation, un environnement de ligne de commande exécuté dans le cloud.

Cloud Shell est un environnement de développement et d'opérations en ligne accessible depuis votre navigateur, où que vous soyez. Vous pouvez gérer vos ressources grâce à son terminal en ligne doté d'utilitaires préchargés, tels que l'outil de ligne de commande gcloud, kubectl, etc. Vous pouvez également développer, compiler, déboguer et déployer vos applications cloud à l'aide de l'éditeur Cloud Shell en ligne.

Cette machine virtuelle contient tous les outils de développement dont vous avez besoin. Elle comprend un répertoire d'accueil persistant de 5 Go et s'exécute directement dans Google Cloud, ce qui améliore considérablement les performances du réseau et l'authentification. Cela signifie que tout ce dont vous avez besoin pour cet atelier de programmation est un navigateur (oui, tout fonctionne sur un Chromebook).

• Pour activer Cloud Shell à partir de la console Cloud, il vous suffit de cliquer sur Activer Cloud Shell :

Si vous démarrez Cloud Shell pour la première fois, un écran intermédiaire vous explique de quoi il s'agit. Si un écran intermédiaire vous s'est présenté, cliquez sur Continuer.

Le provisionnement de l'environnement ne devrait prendre que quelques secondes :

Une fois connecté à Cloud Shell, vous devez être authentifié :

gcloud auth list

Résultat de la commande

Credentialed Accounts

ACTIVE: *
ACCOUNT: <my-account>@<mydomain>

Remarque : gcloud est l'outil de ligne de commande performant et unifié de Google Cloud. Il est préinstallé dans Cloud Shell. Il est également compatible avec la saisie semi-automatique via la touche de tabulation. Vous pouvez être invité à vous authentifier la première fois que vous exécutez une commande. Pour en savoir plus, consultez la présentation de l'outil de ligne de commande gcloud.

Le projet devrait également déjà être défini sur votre PROJECT_ID (en supposant que vous ayez sélectionné un projet dans la console Web) :

gcloud config list project

Résultat de la commande

[core]
project = <PROJECT_ID>

Si, pour une raison quelconque, le projet n'est pas défini, exécutez simplement la commande suivante :

gcloud config set project <PROJECT_ID>

Vous recherchez votre PROJECT_ID ? Consultez le menu déroulant en haut de la console Cloud :

Vous pouvez également consulter les détails de votre projet dans la section "Paramètres et utilitaires" :

Par défaut, Cloud Shell définit certaines variables d'environnement qui pourront s'avérer utiles pour exécuter certaines commandes dans le futur.

echo $GOOGLE_CLOUD_PROJECT

Résultat de la commande

<PROJECT_ID>

• Enfin, vous pouvez définir la zone par défaut :

gcloud config set compute/zone us-central1-f

Vous pouvez choisir différentes zones. Pour en savoir plus, consultez la page Régions et zones.

Remarque : Lorsque vous exécutez gcloud sur votre propre machine, les paramètres de configuration sont conservés d'une session à l'autre. Toutefois, dans Cloud Shell, vous devrez définir ce paramètre à chaque nouvelle session ou reconnexion.

Activez l'API Cloud Run

Dans Cloud Shell, activez l'API Cloud Run :

gcloud services enable run.googleapis.com

Un message de réussite semblable à celui-ci doit s'afficher :

Operation "operations/acf.cc11852d-40af-47ad-9d59-477a12847c9e" finished successfully.

3. Coder l'exemple d'application

Nous allons créer une application ASP.NET C# simple qui répond aux requêtes HTTP.

Pour créer votre application, utilisez l'outil de ligne de commande dotnet dans Cloud Shell:

dotnet new web -o helloworld-csharp

Accédez au répertoire helloworld-csharp:

cd helloworld-csharp

Pour modifier des fichiers, utilisez vi, emacs, nano ou l'éditeur Web Cloud Shell en cliquant simplement sur l'icône de l'éditeur en forme de crayon dans Cloud Shell ("Lancer l'éditeur de code").

Modifiez ensuite Program.cs pour qu'il corresponde à ce qui suit:

var builder = WebApplication.CreateBuilder(args);

var port = Environment.GetEnvironmentVariable("PORT") ?? "8080";
var url = $"http://0.0.0.0:{port}";
builder.WebHost.UseUrls(url);

var app = builder.Build();

app.MapGet("/", () => "Hello World!");

app.Run();

Ce code crée un serveur Web de base qui écoute le port défini par la variable d'environnement PORT et répond avec Hello World.

Vous pouvez tester l'application en l'exécutant localement dans Cloud Shell. Il doit normalement être en écoute sur le port 8080:

$ dotnet run
Using launch settings from /home/atameldev/helloworld-csharp/Properties/launchSettings.json...
Hosting environment: Development
Content root path: /home/atameldev/helloworld-csharp
Now listening on: http://0.0.0.0:8080
Application started. Press Ctrl+C to shut down.

De nombreux autres langages sont documentés pour la prise en main de Cloud Run. Vous trouverez des instructions pour Go, Python, Java, PHP, PHP, Ruby, les scripts shell et plus encore sur cette page : https://cloud.google.com/run/docs/quickstarts/build-and-deploy.

4. Déployer dans Cloud Run

Déployez votre application sur Cloud Run à l'aide de la commande suivante:

gcloud run deploy hello-world \
    --allow-unauthenticated \
    --region us-central1 \
    --source .

• hello-world correspond au nom du service.
• L'option allow-unauthenticated déploie le service en tant que service accessible au public sans aucune exigence d'authentification.
• us-central1 est la région dans laquelle l'application sera déployée.
• L'option source détermine l'emplacement de la source à compiler. Cloud Run utilise des buildpacks pour créer automatiquement un conteneur à partir du code source.

Patientez quelques minutes jusqu'à la fin du déploiement. En cas de réussite, la ligne de commande affiche l'URL du service :

Service [hello-world] revision [hello-world-00001-yos] has been deployed and is serving 100 percent of traffic.
Service URL: https://helloworld-wdl7fdwaaa-uc.a.run.app

Vous pouvez maintenant accéder au conteneur déployé en ouvrant l'URL du service dans un navigateur Web :

Félicitations ! Vous venez de déployer une application empaquetée dans une image de conteneur sur Cloud Run. Cloud Run effectue un scaling automatique et horizontal de votre image de conteneur pour traiter les requêtes reçues, puis un scaling à la baisse lorsque la demande diminue. Vous ne payez que pour le processeur, la mémoire et le réseau utilisés lors du traitement des requêtes.

Bien que ce court atelier ait été réalisé à l'aide de la ligne de commande gcloud, Cloud Run est disponible via la console Cloud ( console.cloud.google.com). Accédez simplement à Compute > Cloud Run, et votre service helloworld doit s'afficher dans la liste :

Bien évidemment, vous pouvez également utiliser la console pour déployer un service Cloud Run.

5. Il est temps de nettoyer

Vous pouvez soit supprimer votre projet GCP pour éviter que des frais ne vous soient facturés, ce qui interrompra la facturation de toutes les ressources utilisées dans ce projet, ou simplement supprimer le service Cloud Run:

gcloud run services delete helloworld

6. Étape suivante

Vous pouvez par exemple déployer une instance sur Cloud Run sur GKE.

Pour savoir comment créer un conteneur HTTP sans état pour Cloud Run à partir du code source et le transférer dans Container Registry, reportez-vous à la page suivante :

• Développer des services Cloud Run
• Créer des conteneurs