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

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 votre 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 Créer et continuer.
  5. Pour accorder l'accès à votre projet, attribuez le ou les rôles suivants à votre compte de service : Projet > Propriétaire.

    Dans la liste Sélectionner un rôle, sélectionnez un rôle.

    Pour ajouter des rôles supplémentaires, cliquez sur Ajouter un autre rôle et ajoutez chaque rôle supplémentaire.

  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 Keys (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).

gcloud

Configurez l'authentification :

  1. Créez le compte de service :

    gcloud iam service-accounts create NAME

    Remplacez NAME par le nom que vous souhaitez donner au compte de service.

  2. Attribuez des rôles au compte de service. Exécutez la commande suivante une fois pour chacun des rôles IAM suivants : roles/owner :

    gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com" --role=ROLE

    Remplacez les éléments suivants :

    • SERVICE_ACCOUNT_NAME : nom du compte de service.
    • PROJECT_ID : ID du projet dans lequel vous avez créé le compte de service.
    • ROLE : rôle à accorder
  3. Générez le fichier de clé :

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

    Remplacez les éléments suivants :

    • FILE_NAME : nom du fichier de clé
    • SERVICE_ACCOUNT_NAME : nom du compte de service.
    • PROJECT_ID : ID du projet dans lequel vous avez créé le compte de service.

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 Google Cloud Console, si vous préférez gérer vos ressources Google Cloud à partir de Visual Studio ou de la ligne de commande, vous pouvez installer les outils suivants:

  • CLI Google Cloud : la CLI gcloud 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.

Étapes suivantes