Tutorial: Usar o MongoDB com funções do Azure

Criar recursos de nuvem do Azure.

Execute o seguinte comando para criar um grupo de recursos, substituindo <GROUP_NAME> por um nome para seu grupo e <AZURE_REGION> por uma região do Azure compatível:

az group create \
  --name <GROUP_NAME> \
  --location <AZURE_REGION>

Opcionalmente, se você estiver usando o Azure pela primeira vez, talvez seja necessário executar os seguintes comandos para registrar o fornecedor de recursos de funções:

az provider register --namespace Microsoft.Storage
az provider register --namespace Microsoft.Web

Em seguida, execute o seguinte comando para criar uma conta de armazenamento. Use a mesma região e nome de grupo do código anterior e forneça um nome exclusivo para a conta de armazenamento, substituindo o espaço reservado <STORAGE_NAME> por este nome exclusivo:

az storage account create \
  --name <STORAGE_NAME> \
  --location <AZURE_REGION> \
  --resource-group <GROUP_NAME> \
  --sku Standard_LRS

Por fim, execute o seguinte comando para criar o aplicativo de Funções:

az functionapp create \
  --resource-group <GROUP_NAME> \
  --consumption-plan-location <AZURE_REGION> \
  --runtime node \
  --functions-version 4 \
  --name <APP_NAME> \
  --storage-account <STORAGE_NAME>

Inicialize o projeto local .

Execute o seguinte comando para inicializar um projeto de função local:

func init MongoExample

Quando solicitado, selecione node como o tempo de execução do trabalhador e javascript como o idioma.

Execute os seguintes comandos para navegar até o diretório do projeto e criar uma nova função acionada por HTTP:

cd MongoExample
func new --name GetMovies --template "HTTP trigger"

O comando cria o arquivo src/functions/GetMovies.js, que você edita nas etapas posteriores.

Para vincular seu projeto local ao aplicativo Azure Function, execute o seguinte comando no diretório do projeto :

func azure functionapp fetch-app-settings <APP_NAME>

Este comando baixa todas as configurações do aplicativo do Azure, incluindo a configuração da conta de armazenamento, e preenche o arquivo local.settings.json do seu projeto.

Instale o driver Node.js do MongoDB.

Na raiz do seu projeto, execute o seguinte comando para instalar o driver do MongoDB Node.js :

npm install mongodb

Este comando adiciona o driver ao seu projeto e o registra em package.json para que o driver esteja disponível quando você implantar.

Configure a conexão do banco de dados .

Abra o src/functions/GetMovies.js e substitua seu conteúdo pelo seguinte código:

const { app } = require("@azure/functions");
const { MongoClient } = require("mongodb");
const mongoClient = new MongoClient(
  process.env.MONGODB_ATLAS_URI
);
app.http("GetMovies", {
  methods: ["GET"],
  authLevel: "anonymous",
  handler: async (request, context) => {
    // Query logic added in the next step
  }
});

Dependendo da sua versão do Node.js, você poderá encontrar um erro relacionado à resolução de DNS ao tentar se conectar ao MongoDB. Se isso ocorrer, adicione o seguinte código ao seu arquivo src/functions/GetMovies.js antes de criar a instância do MongoClient:

const { app } = require("@azure/functions");
const { MongoClient } = require("mongodb");
// Forces DNS servers explicitly before connecting to MongoDB
require("node:dns/promises").setServers(["1.1.1.1", "8.8.8.8"]);
const mongoClient = new MongoClient(
  process.env.MONGODB_ATLAS_URI
);
app.http("GetMovies", {
  methods: ["GET"],
  authLevel: "anonymous",
  handler: async (request, context) => {
    // Query logic added in the next step
  }
});

Abra o local.settings.json e adicione os seguintes campos ao objeto Values, substituindo cada espaço reservado pelos seus valores reais:

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "<storage-connection-string>",
    "FUNCTIONS_WORKER_RUNTIME": "node",
    "MONGODB_ATLAS_URI": "<atlas-connection-string>",
    "MONGODB_ATLAS_DATABASE": "sample_mflix",
    "MONGODB_ATLAS_COLLECTION": "movies"
  },
  "ConnectionStrings": {}
}

Para recuperar sua string de conexão do MongoDB Atlas , navegue até o dashboard do Atlas , selecione seu cluster e clique em Connect. Para saber como recuperar a string de conexão do armazenamento Azure, consulte Configurar uma string de conexão na documentação do Azure.

Escreva uma função para query MongoDB.

Em src/functions/GetMovies.js, substitua o comentário // Query logic added in the next step dentro do manipulador pelo seguinte código:

    try {
      const database = mongoClient.db(
        process.env.MONGODB_ATLAS_DATABASE
      );
      const collection = database.collection(
        process.env.MONGODB_ATLAS_COLLECTION
      );
      const results = await collection
        .find({})
        .limit(10)
        .toArray();
      return { jsonBody: results };
    } catch (error) {
      return {
        status: 500,
        jsonBody: { message: "Internal server error." }
      };
    }

Quando a função recebe uma solicitação, ela se conecta ao banco de dados e à coleção especificados por suas variáveis de ambiente e retorna até 10 documentos. Se ocorrer um erro, a função retornará uma resposta 500 que contém a mensagem de erro.

Teste a função localmente.

Na raiz do seu projeto, execute o seguinte comando para iniciar sua função:

func start

Quando o servidor é iniciado, a CLI exibe a URL local da sua função. Navegue até http://localhost:7071/api/GetMovies em seu navegador ou envie uma solicitação usando uma ferramenta como cURL ou Postman.

Implemente no Azure.

Defina suas variáveis de ambiente no Azure executando os seguintes comandos, substituindo cada espaço reservado por seus valores reais:

az functionapp config appsettings set \
  --name <APP_NAME> \
  --resource-group <GROUP_NAME> \
  --settings MONGODB_ATLAS_URI=<atlas-connection-string>
az functionapp config appsettings set \
  --name <APP_NAME> \
  --resource-group <GROUP_NAME> \
  --settings MONGODB_ATLAS_DATABASE=sample_mflix
az functionapp config appsettings set \
  --name <APP_NAME> \
  --resource-group <GROUP_NAME> \
  --settings MONGODB_ATLAS_COLLECTION=movies

Implemente sua função executando o seguinte comando:

func azure functionapp publish <APP_NAME>

Deployment successful.
Remote build succeeded!
Syncing triggers...
Functions in <APP_NAME>:
    GetMovies - [httpTrigger]
        Invoke url: https://<APP_NAME>.azurewebsites.net/api/getmovies

Quando a implantação for concluída, a CLI exibirá um URL público para sua função. Como a função usa authLevel: "anonymous", ela é acessível sem uma chave.