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

    Observação: o campo Papel autoriza sua conta de serviço a acessar recursos. É possível visualizar e alterar esse campo mais tarde usando o Console do Cloud. Se você estiver desenvolvendo um aplicativo de produção, especifique permissões mais granulares do que Projeto > Proprietário. Para mais informações, consulte Como atribuir papéis a contas de serviço.
  5. Clique em Criar. O download de um arquivo JSON que contém a chave é feito no 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 código do seu projeto.

    gcloud projects add-iam-policy-binding [PROJECT_ID] --member "serviceAccount:[NAME]@[PROJECT_ID].iam.gserviceaccount.com" --role "roles/owner"
    Observação: o campo Papel autoriza a conta de serviço a acessar recursos. Se quiser visualizar e alterar esse campo mais tarde, use o Console do Cloud. Se você estiver desenvolvendo um aplicativo de produção, especifique permissões mais granulares do que Projeto > Proprietário. Para mais informações, consulte Como atribuir papéis a contas de serviço.
  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