Configurer un environnement de développement .NET

Ce tutoriel explique comment préparer votre machine locale pour le développement d'applications .NET et .NET Core s'exécutant sur Google Cloud et appelant des API Google Cloud.

Installer un environnement de développement

L'environnement de développement recommandé pour l'exécution des exemples d'applications et des tutoriels .NET présentés dans cette documentation est Visual Studio ou Visual Studio Code.

Créer un projet Google Cloud

Créez un projet Google Cloud pour exécuter vos applications. Les projets Google Cloud constituent la base de la création, de l'activation et de l'utilisation de tous les services Google Cloud.

Authentification

Lors du développement local, votre application .NET doit s'authentifier pour interagir avec les API Google Cloud. Les instructions suivantes décrivent comment créer une clé de compte de service pour authentifier votre application. Les applications peuvent utiliser cette méthode pour s'authentifier localement et lorsqu'elles sont déployées sur Google Cloud. En savoir plus sur l'authentification, y compris la gestion de l'authentification une fois que votre application est déployée.

Créer une clé de compte de service pour l'authentification

Cloud Console

Créez un compte de service :

  1. Dans Cloud Console, accédez à la page Créer un compte de service.

    Accéder à la page "Créer un compte de service"
  2. Sélectionnez un projet.
  3. Dans le champ Nom du compte de service, saisissez un nom. Cloud Console remplit le champ ID du compte de service en fonction de ce nom.

    Dans le champ Description du compte de service, saisissez une description. Exemple : Service account for quickstart.

  4. Cliquez sur Create (Créer).
  5. Cliquez sur le champ Sélectionner un rôle.

    Dans la section Accès rapide, cliquez sur Basique, puis sur Propriétaire.

  6. Cliquez sur Continuer.
  7. Cliquez sur OK pour terminer la création du compte de service.

    Ne fermez pas la fenêtre de votre navigateur. Vous en aurez besoin lors de la tâche suivante.

Créez une clé de compte de service :

  1. Dans Cloud Console, cliquez sur l'adresse e-mail du compte de service que vous avez créé.
  2. Cliquez sur Clés.
  3. Cliquez sur Ajouter une clé, puis sur Créer une clé.
  4. Cliquez sur Create (Créer). Un fichier de clé JSON est téléchargé sur votre ordinateur.
  5. Cliquez sur Close (Fermer).

Ligne de commande

Vous pouvez exécuter les commandes suivantes à l'aide du SDK Cloud sur votre ordinateur local, ou dans Cloud Shell.

  1. Créez le compte de service. Remplacez NAME par le nom que vous souhaitez donner au compte de service.

    gcloud iam service-accounts create NAME
  2. Accordez des autorisations au compte de service. Remplacez PROJECT_ID par votre ID de projet.

    gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:NAME@PROJECT_ID.iam.gserviceaccount.com" --role="roles/owner"
  3. Générez le fichier de clé. Remplacez FILE_NAME par le nom du fichier de clé.

    gcloud iam service-accounts keys create FILE_NAME.json --iam-account=NAME@PROJECT_ID.iam.gserviceaccount.com

Ensuite, définissez la variable d'environnement GOOGLE_APPLICATION_CREDENTIALS sur le chemin de la clé JSON qui a été téléchargée. Les commandes utilisées dans PowerShell sont indiquées ci-dessous.

Pour cette session PowerShell

Serveur de paramètres > $env:GOOGLE_APPLICATION_CREDENTIALS = "$env:USERPROFILE\Downloads\your-project-id-dea9fa230eae3.json"

Pour tous les processus créés après cette commande

Serveur de paramètres > [Environment]::SetEnvironmentVariable("GOOGLE_APPLICATION_CREDENTIALS", "$env:USERPROFILE\Downloads\your-project-id-dea9fa230eae3.json", "User")

(Facultatif) Installer les outils .NET et les SDK

Même si vous pouvez créer et gérer des ressources Google Cloud via votre navigateur Web à l'aide de la Google Cloud Console, si vous préférez gérer vos ressources Google Cloud à partir de Visual Studio ou à partir de la ligne de commande, vous peut envisager d'installer les outils suivants :

  • SDK Cloud : le SDK Cloud est une interface de ligne de commande pour les produits et services Google Cloud.

  • Outils pour Visual Studio : les outils pour Visual Studio permettent le développement dans Visual Studio sur Google Cloud.

  • Tools for PowerShell : Tools for PowerShell est un ensemble de cmdlets pour Windows PowerShell, qui vous permet de gérer les ressources Google Cloud.

Étape suivante