Premiers pas avec .NET sur Compute Engine

Ce tutoriel explique comment débuter avec Compute Engine. Suivez-le pour déployer une application Web Hello World .NET sur Compute Engine. Si vous avez besoin d'aide pour vous familiariser avec App Engine, consultez la page sur l'environnement standard App Engine.

Objectifs

• Déployer un exemple d'application Hello World sur une instance Compute Engine unique

Coûts

Dans ce document, vous utilisez les composants facturables suivants de Google Cloud :

• Compute Engine

Pour obtenir une estimation des coûts en fonction de votre utilisation prévue, utilisez le simulateur de coût.

Les nouveaux utilisateurs de Google Cloud peuvent bénéficier d'un essai sans frais.

Avant de commencer

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 sans frais pour exécuter, tester et déployer des charges de travail.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Compute Engine API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Compute Engine API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

1. Installez le SDK.NET Core 2.1 ou une version ultérieure sur votre ordinateur local exécutant Microsoft Windows.
2. Installez Web Deploy 3.6 ou une version ultérieure sur votre ordinateur local exécutant Microsoft Windows.

Exécuter l'application en local

1. Téléchargez et décompressez ou clonez l'exemple de dépôt depuis github :

   git clone https://github.com/GoogleCloudPlatform/getting-started-dotnet.git
   

2. Dans une fenêtre PowerShell, accédez au répertoire HelloWorld :

   cd getting-started-dotnet\HelloWorld
   

3. Démarrez un serveur Web local :

   dotnet run
   

4. Ouvrez un navigateur Web pour accéder à localhost:8080.

   Dans votre navigateur Web, vous voyez du texte Hello World, diffusé depuis votre ordinateur local.

5. Lorsque vous êtes prêt à continuer, arrêtez le serveur Web local en appuyant sur Ctrl+C.

Déployer l'application sur une instance unique

Cette section décrit la procédure d'exécution d'une instance unique de votre application sur Compute Engine.

Créer et configurer une instance Compute Engine

Google Cloud Marketplace vous permet de lancer une instance de Windows exécutant Microsoft IIS sur Compute Engine.

1. Dans la console Google Cloud , accédez à la page Cloud Marketplace ASP.NET Framework.

   Accéder à Cloud Marketplace

2. Cliquez sur Lancer.

3. Conservez les valeurs par défaut des paramètres, puis cliquez sur Déployer.

   Attendez le déploiement de l'instance Compute Engine. En règle générale, cela prend environ cinq minutes.

4. Pour afficher les informations sur les ressources, cliquez sur Instance de VM.

5. Pour modifier l'instance de VM, cliquez sur Gérer les ressources.

6. Cliquez sur Définir un mot de passe Windows, puis notez le nom d'utilisateur.

7. Copiez le nouveau mot de passe Windows, puis cliquez sur Fermer.

8. Dans la page Informations sur l'instance de VM, notez l'adresse IP externe.

9. Sur votre machine Windows locale, modifiez le fichier HelloWorld/Properties/PublishProfiles/ComputeEngine.pubxml.

10. Saisissez l'adresse IP externe de votre instance de VM entre <MSDeployServiceURL> et </MSDeployServiceURL>. Par exemple, <MSDeployServiceURL>203.0.113.22</MSDeployServiceURL>.

11. Saisissez le nom d'utilisateur de l'instance que vous avez noté précédemment entre <UserName> et </UserName>.

12. Enregistrez les modifications apportées au fichier ComputeEngine.pubxml.

13. Dans une fenêtre PowerShell, publiez votre application sur l'instance Compute Engine :

    dotnet publish -c Release `
      /p:PublishProfile=Properties\PublishProfiles\ComputeEngine.pubxml `
      "/p:Password=YOUR-PASSWORD"
    

    Remplacez YOUR-PASSWORD par le mot de passe que vous avez copié précédemment.

14. Ouvrez un navigateur Web sur l'adresse IP externe de votre instance.

    Dans votre navigateur Web, vous voyez du texte Hello World, diffusé à partir de votre instance Compute Engine.

Gérer et surveiller une instance

Vous pouvez utiliser la console Google Cloud pour surveiller et gérer votre instance.

1. Pour afficher tous les journaux générés par vos ressources Compute Engine, accédez à la page Explorateur de journaux.

   Accéder à l'explorateur de journaux

   Cloud Logging est automatiquement configuré pour collecter les journaux issus de divers services courants, comme syslog.

Effectuer un nettoyage

Pour éviter que les ressources utilisées lors de ce tutoriel soient facturées sur votre compte Google Cloud, supprimez le projet contenant les ressources, ou conservez le projet et supprimez les ressources individuelles.

Supprimer le projet

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 URL appspot.com, supprimez les ressources sélectionnées dans le projet au lieu de supprimer l'ensemble du projet.

Si vous envisagez d'explorer plusieurs architectures, tutoriels et guides de démarrage rapide, réutiliser des projets peut vous aider à ne pas dépasser les limites de quotas des projets.

1. Dans la console Google Cloud , accédez à la page Gérer les ressources.

   Accéder à la page "Gérer les ressources"

2. Dans la liste des projets, sélectionnez le projet que vous souhaitez supprimer, puis cliquez sur Supprimer.
3. Dans la boîte de dialogue, saisissez l'ID du projet, puis cliquez sur Arrêter pour supprimer le projet.

Supprimer les ressources individuelles

gcloud compute instances delete my-app-instance --zone=YOUR_ZONE --delete-disks=all
gcloud compute firewall-rules delete default-allow-http-80

Étapes suivantes

• Découvrez des architectures de référence, des schémas et des bonnes pratiques concernant Google Cloud. Consultez notre Centre d'architecture cloud.

• Pour d'autres ressources .NET pour la création de vos applications, consultez les éléments suivants :

  • Gérez et surveillez le déploiement de vos groupes d'instances depuis la page Compute Engine > Groupes d'instances.
  • Gérez la configuration de votre équilibrage de charge, y compris les mappages d'URL et les services de backend, depuis la page Services réseau > Équilibrage de charge.
  • Déployer une application sur Google Kubernetes Engine
  • Découvrez d'autres Google Cloud services.