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.

Authentication

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

Crie uma conta de serviço:

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

    Acesse Criar conta de serviço
  2. Selecione um projeto.
  3. No campo Nome da conta de serviço, insira um nome. O Console do Cloud preenche o campo ID da conta de serviço com base nesse nome.

    No campo Descrição da conta de serviço, insira uma descrição. Por exemplo, Service account for quickstart.

  4. Clique em Criar e continuar.
  5. Clique no campo Selecionar um papel.

    Em Acesso rápido, clique em Básico e em Proprietário.

  6. Clique em Continuar.
  7. Clique em Concluído para terminar a criação da conta de serviço.

    Não feche a janela do navegador. Você vai usá-lo na próxima etapa.

Crie uma chave de conta de serviço:

  1. No Console do Cloud, clique no endereço de e-mail da conta de serviço que você criou.
  2. Clique em Chaves.
  3. Clique em Adicionar chave e em Criar nova chave.
  4. Clique em Criar. O download de um arquivo de chave JSON é feito no seu computador.
  5. Clique em Fechar.

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