Configurar o ambiente de desenvolvimento do JavaScript local para o Azure

Ao criar aplicativos de nuvem, os desenvolvedores normalmente preferem testar o código em suas estações de trabalho locais antes de implantar esse código em um ambiente de nuvem como o Azure. O desenvolvimento local oferece a vantagem de uma variedade maior de ferramentas, juntamente com um ambiente de desenvolvimento familiar.

Este artigo fornece instruções de configuração para criar e validar um ambiente de desenvolvimento local adequado para o JavaScript com o Azure.

Criação de assinatura única

Os recursos do Azure são criados dentro de uma assinatura e um grupo de recursos.

Tipo	Descrição
Assinatura de avaliação	Crie uma assinatura de avaliação gratuita.
Assinatura existente	Se você já tiver uma assinatura, acesse-a no portal do Azure, na CLI do Azure ou nos SDKs do Azure para JavaScript.
Entre várias assinaturas	Se você precisar gerenciar várias assinaturas, saiba como criar um grupo de gerenciamento com JavaScript.

Instalação de software de uso único

Para o desenvolvimento do Azure com JavaScript em sua estação de trabalho local, sugerimos que você instale o seguinte:

Nome/instalador	Descrição
Node.js LTS	Instale o ambiente de runtime LTS (suporte a longo prazo) mais recente para desenvolvimento na estação de trabalho local.
Visual Studio Code	O Visual Studio Code fornecerá uma ótima experiência de integração e de codificação do JavaScript, mas ele não é exigido. Você pode usar qualquer editor de código.

Runtime de hospedagem do Azure

Se você planeja usar um recurso do Azure como o ambiente de hospedagem para seu aplicativo, como um aplicativo Web do Azure ou o Azure Functions, verifique se a versão do runtime do ambiente de desenvolvimento local do Node.js corresponde ao runtime do recurso do Azure que você planeja usar.

Instalações locais recomendadas

As instalações comuns de estação de trabalho local a seguir são recomendadas para ajudar com as tarefas de desenvolvimento local.

Nome	Descrição
CLI do Azure	CLI local ou baseada em nuvem para criar e usar recursos do Azure.
CLI do Desenvolvedor do Azure	Ferramenta de linha de comando centrada no desenvolvedor para criar aplicativos em nuvem no fluxo de trabalho do desenvolvedor.
Extensões do Visual Studio Code para o Azure	Extensões do VS Code para o IDE.
Git ou Git para Windows	Ferramentas de linha de comando para controle do código-fonte. Você poderá usar uma ferramenta de controle do código-fonte diferente se preferir.

Configuração única para autenticação

Para empregar o mesmo código de autenticação no desenvolvimento local e no ambiente de hospedagem remoto do Azure, use o DefaultAzureCredential.

Criar um grupo de recursos para seu projeto

Portal do Azure

1. Abra o portal do Azure no navegador da Web.

2. Na barra de pesquisa, insira grupos de recursos e selecione-os.

3. Selecione + Criar.

4. Insira as configurações do grupo de recursos:

   Propriedade	Valor
   Subscription	Selecione sua assinatura.
   Resource group	Insira o nome do grupo de recursos. Esse nome de grupo de recursos é usado como parte de um URI de recursos quando você acessa o Gerenciador de Recursos (plano de gerenciamento). O nome não é usado para controle (como criar um banco de dados) ou plano de dados (inserir dados em uma tabela).
   Region	Selecione uma região geográfica para o grupo de recursos.

5. Selecione Revisar + criar para iniciar a validação.

6. Quando a validação for bem-sucedida, selecione Criar.

Visual Studio Code

1. Abra a paleta de comandos, Ctrl + Shift + P.

2. Procure criar grupo de recursos e selecione-o.

3. Responda aos prompts usando as seguintes configurações:

   Prompt	Valor
   Selecionar assinatura	Entre no Azure, caso solicitado. Selecione uma assinatura existente ou crie uma conta do Azure se você não tiver uma.
   Insira o nome do novo grupo de recursos.	Insira o nome do grupo de recursos. Esse nome de grupo de recursos é usado como parte de um URI de recursos quando você acessa o Gerenciador de Recursos (plano de gerenciamento). O nome não é usado para controle (como criar um banco de dados) ou plano de dados (inserir dados em uma tabela).
   Selecione uma localização para novos recursos.	Selecione uma região geográfica para o grupo de recursos.

CLI do Azure

1. Faça logon no Azure:

   az login
   

   Conclua a autenticação em um navegador.

2. Liste seus nomes e IDs de assinatura. Copie o valor SubscriptionId para usar o próximo comando.

   az account subscription list --output table 
   

3. Defina sua assinatura padrão, usada por comandos subsequentes:

   az account set --subscription YOUR_SUBSCRIPTION_ID
   

4. Selecione a partir de uma lista de locais suportados para a sua subscrição. Copie o valor Name de uma região próxima a você.

   az account list-locations --output table
   

5. Use a seguinte CLI do Azure para criar um grupo de recursos com seu nome ou ID de assinatura:

   az group create --name "YOUR_RESOURCE_GROUP_NAME" --location YOUR_REGION
   

   Por exemplo:

   az group create --name "my-azure-app" --location westus
   

Trabalhando com as bibliotecas de cliente do Azure e do SDK do Azure

As bibliotecas do SDK do Azure são fornecidas individualmente para cada serviço. Você instala cada biblioteca com base no serviço do Azure que você precisa usar.

Cada novo projeto que usa o Azure deve:

• Crie recursos do Azure e salve as chaves ou configurações associadas em um local seguro.
• Instalar as bibliotecas do SDK do Azure do NPM ou Yarn.
• Use as credenciais da Entidade de Serviço local para fazer a autenticação no SDK do Azure, depois use as informações de configuração para acessar serviços específicos.

Como proteger informações de configuração

Você tem várias opções para armazenar informações de configuração:

• Azure Key Vault para criar e manter chaves que acessam e criptografam seus recursos, aplicativos e soluções de nuvem.
• Dotenv é um pacote npm popular para ler variáveis de ambiente de um arquivo .env. Adicione o arquivo .env ao arquivo .gitignore para não fazer check-in do arquivo .env no controle do código-fonte. Saiba mais sobre as variáveis de ambiente nos aplicativos Web do Azure.

Criar variáveis de ambiente para as bibliotecas do Azure

Para usar as configurações do Azure exigidas pelas bibliotecas de SDK do Azure a fim de acessar a nuvem do Azure, defina os valores mais comuns como variáveis de ambiente. Os comandos a seguir definem as variáveis de ambiente para a estação de trabalho local.

Nos exemplos a seguir, a ID do cliente é a ID da entidade de serviço e o segredo da entidade de serviço.

Bash

AZURE_SUBSCRIPTION_ID="aa11bb33-cc77-dd88-ee99-0918273645aa"
AZURE_TENANT_ID="00112233-7777-8888-9999-aabbccddeeff"
AZURE_CLIENT_ID="12345678-1111-2222-3333-1234567890ab"
AZURE_CLIENT_SECRET="abcdef00-4444-5555-6666-1234567890ab"

cmd

set AZURE_SUBSCRIPTION_ID="aa11bb33-cc77-dd88-ee99-0918273645aa"
set AZURE_TENANT_ID=00112233-7777-8888-9999-aabbccddeeff
set AZURE_CLIENT_ID=12345678-1111-2222-3333-1234567890ab
set AZURE_CLIENT_SECRET=abcdef00-4444-5555-6666-1234567890ab

Substitua os valores mostrados nesses comandos pelos de sua entidade de serviço específica.

Criar arquivo .env

Outro mecanismo comum é usar o pacote NPM DOTENV para criar um arquivo .env para essas configurações. Se você planeja usar um .env, não faça check-in do arquivo no controle do código-fonte. A adição do arquivo .env ao arquivo .ignore do git é a maneira padrão de fazer check-in dessas configurações no controle do código-fonte.

Instalar pacotes npm

Para cada projeto, é recomendável que você sempre crie uma pasta separada e o próprio arquivo package.json dela usando as seguintes etapas:

1. Abra um terminal, um prompt de comando ou um shell de bash e crie uma pasta para o projeto. Em seguida, acesse a nova pasta.

   mkdir MY-NEW-PROJECT && cd MY-NEW-PROJECT
   

2. Inicialize o arquivo de pacote:

   npm init -y
   

   Isso cria o arquivo package.json e inicializa as propriedades mínimas.

3. Instale as bibliotecas do SDK do Azure de que você precisa, como neste exemplo:

   npm install @azure/ai-text-analytics@5.0.0
   

Usar o controle do código-fonte com o Visual Studio Code

É recomendável que você tenha o hábito de criar um repositório de controle do código-fonte, sempre que iniciar um projeto. Você pode fazer isso no Visual Studio Code.

1. No Visual Studio Code, selecione o ícone do controle do código-fonte para abrir o Source Control Explorer e escolha Inicializar Repositório para inicializar um repositório Git local:

   

2. Depois que o repositório for inicializado e você tiver arquivos para armazenar no controle do código-fonte, insira a mensagem Initial commit e clique na marca de seleção para criar o commit inicial de seus arquivos de origem.

   

3. Crie um repositório no GitHub ou no Azure DevOps e copie a URL do repositório para as próximas etapas.

4. No terminal integrado do Visual Studio, use o comando git a seguir para adicionar seu repositório remoto ao repositório local. Substitua YOUR-ALIAS e YOUR-REPOSITORY pelos seus próprios valores.

   git remote add origin https://github.com/YOUR-ALIAS/YOUR-REPOSITORY
   

O Visual Studio Code inclui muitos recursos internos do git. Para saber mais, confira Usar o controle de versão no VS Code.

Próximas etapas

• Criar e usar uma entidade de serviço
• Autenticar com os módulos do Azure para Node.js