Como configurar um ambiente de desenvolvimento .NET

Este tutorial mostra como preparar sua máquina local para desenvolver aplicativos .NET e .NET core que são executados no Google Cloud e chamam as APIs do Google Cloud.

Instalar um ambiente de desenvolvimento

O ambiente de desenvolvimento recomendado para executar os tutoriais do .NET e os aplicativos de exemplo nesta documentação é o Visual Studio ou o Visual Studio Code.

Criar um projeto do Google Cloud

Crie um projeto do Google Cloud para executar seus aplicativos. Os projetos do Google Cloud formam a base para criar, ativar e usar todos os serviços do Google Cloud.

Autenticação

Durante o desenvolvimento local, seu aplicativo .NET precisa se autenticar para interagir com as APIs do Google Cloud. As instruções a seguir descrevem como criar uma chave de conta de serviço para autenticar seu aplicativo. Os aplicativos podem usar esse método para autenticar localmente e quando implantados no Google Cloud. Leia mais sobre autenticação, incluindo como a autenticação é tratada depois que o aplicativo é implantado.

Criar uma chave da conta de serviço para autenticação

Console do Cloud

  1. No Console do Cloud, acesse a página Criar chave da conta de serviço.

    Acessar página "Criar chave da conta de serviço"
  2. Na lista Conta de serviço, selecione Nova conta de serviço.
  3. No campo Nome da conta de serviço, insira um nome.
  4. Na lista Papel, selecione Projeto > Proprietário.

  5. Clique em Criar. O download de um arquivo JSON que contém sua chave é feito no seu computador.

Linha de comando

É possível executar os seguintes comandos usando o SDK do Cloud na máquina local ou no Cloud Shell.

  1. Crie a conta de serviço. Substitua NAME por um nome para a conta de serviço.

    gcloud iam service-accounts create NAME
  2. Conceda permissões à conta de serviço. Substitua PROJECT_ID pelo ID do seu projeto.

    gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:NAME@PROJECT_ID.iam.gserviceaccount.com" --role="roles/owner"
  3. Gere o arquivo de chave. Substitua FILE_NAME pelo nome do arquivo de chave.

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

Defina a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS para o caminho da chave JSON que foi salva. No PowerShell, os comandos são:

Para esta sessão do PowerShell.

PS > $env:GOOGLE_APPLICATION_CREDENTIALS = "$env:USERPROFILE\Downloads\your-project-id-dea9fa230eae3.json"

Para todos os processos criados depois deste comando.

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

(Opcional) Instalar ferramentas .NET e SDKs

Mesmo que seja possível criar e gerenciar recursos do Google Cloud através do navegador da Web usando o Console do Google Cloud, se preferir gerenciar seus recursos do Google Cloud no Visual Studio ou na linha de comando, você pode considerar a instalação das seguintes ferramentas:

  • SDK do Cloud: o SDK do Cloud é uma interface de linha de comando para produtos e serviços do Google Cloud.

  • Ferramentas para o Visual Studio: as ferramentas para o Visual Studio permitem o desenvolvimento no Visual Studio no Google Cloud.

  • Ferramentas para PowerShell: as ferramentas para PowerShell são um conjunto de cmdlets para Windows PowerShell que permitem gerenciar recursos do Google Cloud.

A seguir