O Azure Service Connector permite conectar serviços de computação do Azure aos seus Atlas clusters. Once you've configured your aplicação para usar a string de conexão do Atlas, o Azure Service Connector armazena com segurança sua string de conexão e gerencia a conexão entre seu aplicação e o Atlas.
Este tutorial demonstra como conectar um serviço de computação do Azure (como o Azure App Service) ao seu cluster do Atlas usando o Azure Service Connector dentro do Azure Portal.
Limitações
O conector de serviço do Azure para Atlas tem as seguintes limitações:
O Azure Service Connector for Atlas não valida a string de conexão além de verificar se há strings vazias. Certifique-se de que sua string de conexão seja válida para evitar erros de conexão em tempo de execução.
O Azure Service Connector não suporta todas as regiões do Azure. Para saber mais, consulte Suporte à região do conector de serviços.
Pré-requisitos
Uma conta do Azure com uma assinatura ativa.
Um serviço de computação do Azure para conectar ao Atlas. Para saber quais serviços do Azure são compatíveis com o conector de serviços do Azure, consulte a documentação do Azure.
Um Atlas cluster existente.
Um usuário de banco de dados com as permissões necessárias para acessar seu Atlas cluster.
Importante
OAzure Service Connector for Atlas atualmente só aceita autenticação SCRAM. Para saber mais, consulte Configurar usuários do banco de dados.
A string de conexão do Atlas cluster.
Procedimento
Siga estas etapas para conectar seu serviço de computação do Azure (como o App Service) ao Atlas utilizando o portal do Azure.
Configure a conexão.
Configure os seguintes campos:
Service type: Procure e selecione MongoDB Atlas Cluster (preview).
Connection name: atribua um nome descritivo para esta conexão, por exemplo, "atlas_connection", ou aceite o nome gerado automaticamente. Este nome é para fins de gerenciamento do Azure.
Clique em Next: Authentication
Configurar autenticação.
A opção Connection string é pré-selecionada, pois é o único método suportado para o Atlas.
Insira sua string de conexão do Atlas . Para localizar sua string de conexão, consulte Conectar-se ao seu cluster.
(Opcional) Edite o nome da variável que o Azure Service Connector usa para sua string de conexão. Clique em Advanced e clique no ícone de lápis. Edite o nome da variável e clique em Done.
Clique em Next: Networking.
Pule esta etapa, pois você gerencia os controles de acesso à rede a partir das configurações do projeto Atlas , não por meio das opções de configuração de rede do Service Connector.
Para saber mais sobre o gerenciamento de controles de acesso à rede no Atlas, consulte Configurar recursos de segurança para clusters.
Clique em Next: Review + Create.
Revise o resumo dos detalhes da conexão. Verifique o serviço de destino (Atlas), serviço de computação, método de autenticação e as variáveis de ambiente criadas.
Clique em Create.
Pode demorar um ou dois minutos para o Azure provisionar a conexão. O conector de serviço define as configurações necessárias em seu serviço de computação do Azure (principalmente variáveis de ambiente).
Depois de criar ou modificar uma conexão do Azure Service Connector, as variáveis de ambiente correspondentes podem não ser imediatamente atualizadas ou refletidas no ambiente do aplicativo.
Confirme que a conexão foi criada com sucesso retornando à página Conector de serviço do seu serviço de computação. A nova conexão Atlas deve estar listada.
Usando a conexão em seu aplicativo
Depois de criar a conexão, o Service Connector usa os detalhes da conexão em seu ambiente de serviço de computação do Azure. O código do aplicação acessa essas variáveis de ambiente para se conectar ao Atlas usando um driver ou uma biblioteca padrão do MongoDB apropriada para a linguagem ou estrutura escolhida.
Saiba mais
Visão geral da Integração do conector de serviço Atlas/Azure na documentação do Azure.
Conecte seu Atlas Cluster a um Azure App Service na documentação do Azure.