Início Rápido: Usar o Construtor de API de Dados com o Azure Cosmos DB for NoSQL e Aplicativos Web Estáticos do Azure

Neste Início Rápido, você implanta um modelo de Azure Developer CLI (AZD). O modelo implanta um Aplicativo Web Estático do Azure que hospeda o construtor de API de Dados usando seu recurso conexões de banco de dados. O modelo também inclui um aplicativo de exemplo que você pode usar como ponto de partida para suas soluções.

Pré-requisitos

• Assinatura do Azure. Se você não tiver uma assinatura do Azure, crie uma conta de avaliação gratuita
• .NET 8
• CLI do Desenvolvedor do Azure

Dica

Como alternativa, abra este Início Rápido nos Codespaces do GitHub com todos os pré-requisitos do desenvolvedor já instalados. Basta trazer sua própria assinatura do Azure. As contas do GitHub incluem um direito de armazenamento e horas principais sem custo. Para obter mais informações, consulte armazenamento incluído e horas principais para contas do GitHub.

Implantar o modelo

Primeiro, implante todos os serviços necessários usando o modelo do AZD.

1. Abra um terminal no diretório raiz do projeto.

2. Autentique-se no Azure Developer CLI usando azd auth login. Siga as etapas especificadas pela ferramenta para autenticar na CLI usando suas credenciais preferenciais do Azure.

   azd auth login
   

3. Use azd init para inicializar o projeto.

   azd init --template dab-azure-cosmos-db-nosql-quickstart
   

   Importante

   Se você estiver executando no GitHub Codespaces, poderá omitir com segurança o --template argumento, pois o código já foi clonado em seu ambiente.

4. Durante a inicialização, configure um nome de ambiente exclusivo.

   Dica

   O nome do ambiente também será usado como o nome do grupo de recursos de destino. Para este início rápido, considere usar msdocs-swa-dab.

5. Implante a solução Aplicativos Web Estáticos do Azure usando azd up. Os modelos do Bicep implantam uma conta do Azure Cosmos DB for NoSQL junto com os serviços de armazenamento, identidade e host de suporte. Um aplicativo Web de exemplo é implantado no host da Web.

   azd up
   

6. Durante o processo de provisionamento, selecione sua assinatura e o local desejado. Aguarde o processo de provisionamento ser concluído. O processo pode levar aproximadamente cinco minutos.

7. Depois que o provisionamento dos recursos do Azure é feito, o modelo gera uma mensagem SUCCESS junto com a duração da execução.

   SUCCESS: Your application was provisioned and deployed to Azure in 5 minutes 0 seconds.
   

Configurar a conexão de banco de dados

Agora, use o recurso conexões de banco de dados de Aplicativos Web Estáticos do Azure para criar uma conexão entre o aplicativo Web estático implantado e o banco de dados implantado. Esse recurso usa o Construtor de API de Dados perfeitamente para criar uma conexão com uma conta do Azure Cosmos DB for NoSQL em execução usando as credenciais especificadas.

1. Navegue até o recurso aplicativo Web estático do Azure no portal do Azure.

2. Configure o aplicativo Web estático para adicionar uma Conexão de Banco de Dados à conta do Azure Cosmos DB for NoSQL usando essas configurações. Em seguida, selecione Link.

   	Valor
   Tipo de banco de dados	Azure Cosmos DB for NoSQL
   Assinatura	Selecione a assinatura usada para a implantação do AZD
   Grupo de recursos	Selecione o grupo de recursos (ambiente) usado para a implantação do AZD
   Nome do recurso	Selecione o único recurso do Azure Cosmos DB for NoSQL com um prefixo de nosql-*
   Nome do banco de dados	cosmicworks
   Tipo de autenticação	User-assigned managed identity
   Identidade gerenciada atribuída pelo usuário	*Selecione o único recurso de identidade gerenciada com um prefixo de ua-id-*

   

3. Agora, selecione a opção Procurar na página de recursos para observar o aplicativo Web em execução.

   

Limpar

Quando você não precisar mais do aplicativo ou dos recursos de exemplo, remova a implantação correspondente e todos os recursos.

1. Remova a implantação de sua assinatura do Azure.

   azd down
   

2. Exclua o codespace em execução para maximizar o armazenamento e os direitos principais se você estiver usando os Codespaces do GitHub.

Próxima etapa

pontos de extremidade GraphQL