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.
  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