Partilhar via


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.

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

  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.

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.

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

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:

    Initialize git repository

  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.

    Complete an initial commit to the repository

  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