Configurar seu ambiente de desenvolvimento JavaScript local para o Azure

Ao criar aplicativos em 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 dá-lhe a vantagem de uma maior variedade de ferramentas, juntamente com um ambiente familiar.

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

Criação de subscrição única

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

Type	Description
Subscrição de avaliação	Crie uma subscrição de avaliação gratuita.
Subscrição existente	Se você já tiver uma assinatura, acesse sua assinatura existente no portal do Azure, na CLI do Azure ou nos SDKs do Azure para JavaScript.
Em várias subscrições	Se você precisar gerenciar várias assinaturas, saiba como criar um grupo de gerenciamento com JavaScript.

Instalação única de software

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

Nome/Instalador	Description
Nó.js LTS	Instale o mais recente ambiente de tempo de execução LTS (long-term support) para o desenvolvimento de estações de trabalho locais.
Visual Studio Code	O Visual Studio Code lhe dará uma ótima integração JavaScript e experiência de codificação, mas não é necessário. Você pode usar qualquer editor de código.

Tempo de execução 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 tempo de execução do ambiente de desenvolvimento do Nó .js local do Nó.js corresponde ao tempo de execução do recurso do Azure que você planeja usar.

Instalações locais recomendadas

As seguintes instalações comuns de estações de trabalho locais são recomendadas para ajudar com suas 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 na nuvem no fluxo de trabalho do desenvolvedor.
Extensões de código do Visual Studio para Azure	Extensões VS Code para o IDE.
Git ou Git para Windows	Ferramentas de linha de comando para controle do código-fonte. Você pode usar uma ferramenta de controle de origem diferente, se preferir.

Configuração única para autenticação

Para usar 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 o seu projeto

Portal do Azure

1. Abra o portal do Azure em um navegador da Web.

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

3. Selecione + Criar.

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

   Property	valor
   Subscrição	Selecione a sua subscrição.
   Grupo de recursos	Introduza o nome do seu 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 a criação de um banco de dados) ou plano de dados (inserção de dados em uma tabela).
   País/Região	Selecione uma região geográfica para o grupo de recursos.

5. Selecione Rever + 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 subscrição	Entre no Azure, se solicitado. Selecione uma assinatura existente ou crie uma conta do Azure se não tiver uma.
   Insira o nome do novo grupo de recursos.	Introduza o nome do seu 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 a criação de um banco de dados) ou plano de dados (inserção de dados em uma tabela).
   Selecione um local 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 pelos comandos subsequentes:

   az account set --subscription YOUR_SUBSCRIPTION_ID
   

4. Selecione a partir de uma lista de localizações suportadas 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 o Azure e as bibliotecas de cliente 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 precisa usar.

Cada novo projeto usando o Azure deve:

• Crie recursos do Azure e salve chaves ou configurações associadas em um local seguro.
• Instale as bibliotecas do SDK do Azure a partir do NPM ou do Yarn.
• Use sua credencial da Entidade de Serviço local para se autenticar no SDK do Azure e, em seguida, use as informações de configuração para acessar serviços específicos.

Protegendo 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 .env arquivo. Certifique-se de adicionar o .env arquivo ao arquivo para .gitignore que não .env seja feito check-in do arquivo no controle do código-fonte. Saiba mais sobre variáveis de ambiente em aplicativos Web para Azure.

Criar variáveis de ambiente para as bibliotecas do Azure

Para usar as configurações do Azure necessárias pelas bibliotecas do SDK do Azure para acessar a nuvem do Azure, defina os valores mais comuns para 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="<REPLACE-WITH-YOUR-AZURE-SUBSCRIPTION-ID>"
AZURE_TENANT_ID="<REPLACE-WITH-YOUR-AZURE-TENANT-ID>"
AZURE_CLIENT_ID="<REPLACE-WITH-YOUR-AZURE-CLIENT-ID>"
AZURE_CLIENT_SECRET="<REPLACE-WITH-YOUR-AZURE-CLIENT-SECRET>"

CMD

set AZURE_SUBSCRIPTION_ID="<REPLACE-WITH-YOUR-AZURE-SUBSCRIPTION-ID>"
set AZURE_TENANT_ID="<REPLACE-WITH-YOUR-AZURE-TENANT-ID>"
set AZURE_CLIENT_ID="<REPLACE-WITH-YOUR-AZURE-CLIENT-ID>"
set AZURE_CLIENT_SECRET="<REPLACE-WITH-YOUR-AZURE-CLIENT-SECRET>"

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

Criar .env ficheiro

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

Instalar pacotes npm

Para cada projeto, recomendamos que você sempre crie uma pasta separada e seu próprio package.json arquivo usando as seguintes etapas:

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

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

2. Inicialize o arquivo do 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 precisa, como este exemplo:

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

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

Recomendamos que você adquira o hábito de criar um repositório de controle de código-fonte sempre que iniciar um projeto. Você pode fazer isso a partir do Visual Studio Code.

1. No Visual Studio Code, selecione o ícone de controle do código-fonte para abrir o explorador do controle do código-fonte e, em seguida, selecione 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 selecione a marca de seleção para criar a confirmação inicial dos arquivos de origem.

   

3. Crie um novo repositório no GitHub ou no Azure DevOps e copie a URL do repositório para a próxima etapa.

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

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

O Visual Studio Code inclui muitos recursos git internos. Para obter mais informações, consulte Usando o controle de versão no VS Code.

Próximos passos

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