Exemplo: conectividade particular para um cluster do Atlas
Nesta página, explicamos como ativar a conectividade dos Integration Connectors para seu cluster do MongoDB Atlas em execução em uma rede privada no Google Cloud.
Configurar a conectividade particular para um cluster do Atlas
Para configurar a conectividade particular de um cluster do Atlas, faça o seguinte:
- Faça login no console de gerenciamento do Atlas.
- Abra o projeto Atlas para o qual você precisa estabelecer a conectividade de rede.
- Abra a página Acesso à rede do projeto e selecione Endpoint particular.
- Selecione Cluster dedicado e clique em Adicionar endpoint particular.
Isso abre a caixa de diálogo para escolher um provedor de nuvem.
- Selecione Google Cloud e clique em Próxima.
- Selecione uma região do Atlas e clique em Próxima.
Esta é a região do Google Cloud em que o cluster Atlas é criado e precisa ser a mesma região do projeto do Google Cloud em que você cria suas conexões. Para ver a lista de todas as regiões compatíveis do Integration Connector, consulte Locais.
- Insira o ID do projeto do Google Cloud. Esse é o ID do projeto do diretório de serviços do ambiente de execução do Integration Connectors. Para saber mais, consulte Receber o ID do projeto do diretório de serviço.
- No campo Nome da VPC, digite
default
. - No campo Nome da sub-rede, insira
default
. - No campo Prefixo do endpoint do Private Service Connect, digite um prefixo.
Esse texto tem como prefixo todos os nomes de endpoint e pode ser usado para identificar os endpoints particulares que você criou.
- Instale a CLI
gcloud
(interface de linha de comando). Para mais informações, consulte Instalar a CLI gcloud. - Copie e salve o seguinte script de shell como
setup_psc.sh
no sistema local.Defina os valores apropriados para as seguintes variáveis no script:
- PROJECT_ID
- REGIÃO
- FAZER
- SERVICE_ATTACHMENT_ID_PREFIX
#!/bin/bash alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)"' # Set PROJECT_ID to the ID of the Google Cloud project where you create your connections. export PROJECT_ID=PROJECT_ID # Set REGION to the Google Cloud region where Atlas cluster is installed. export REGION=REGION export HOSTNAME=https://connectors.googleapis.com/v1 # Set ENDPOINT_PREFIX to the prefix value that you entered for the # "Private service connect endpoint prefix" field (in step 10). export PREFIX=ENDPOINT_PREFIX # Set SERVICE_ATTACHMENT_ID_PREFIX to the prefix of the service attachments # created by Atlas. The service attachments are present in the script # displayed on the Atlas UI and have the following naming format: # projects/{google-cloud-project-id-of-atlas-cluster}/regions/{region}/serviceAttachment/{prefix}-{index} # For example, if the service attachment is # "projects/p-ditnerelrvndieqhe3kh9pop/regions/us-west1/serviceAttachments/sa-us-west1-37204mg5wr0j6-$i", # you must set the value of SERVICE_ATTACHMENT_ID_PREFIX to # "projects/p-ditnerelrvndieqhe3kh9pop/regions/us-west1/serviceAttachments/sa-us-west1-37204mg5wr0j6" export SERVICE_ATTACHMENT_ID_PREFIX=SERVICE_ATTACHMENT_ID_PREFIX function poll_operation() { OPERATION_ID="$1" INDEX="$2" RESULT='' while [[ "$RESULT" != *"true"* ]]; do RESULT=$(gcurl -s -X GET "${HOSTNAME}/${OPERATION_ID}" | grep '"done"') sleep 5 done echo "${PREFIX}-${INDEX} created" } echo "Creating Endpoint Attachments..." for i in {0..49} do export ENDPOINT=${HOSTNAME}/projects/${PROJECT_ID}/locations/${REGION}/endpointAttachments?endpointAttachmentId=${PREFIX}-$i OPERATION_ID=$(gcurl -s -X POST -H "Content-Type: application/json" -d '{"name": "'"projects/${PROJECT_ID}/locations/${REGION}/endpointAttachments/${PREFIX}-$i"'","serviceAttachment": "'"${SERVICE_ATTACHMENT_ID_PREFIX}-$i"'"}' "${ENDPOINT}" | sed 's/ //' | grep -E '"name"' | sed -E 's/"name": "//' | sed 's/",//') poll_operation "$OPERATION_ID" "$i" & done wait echo "All endpoint attachments created." echo "[" > atlasEndpoints-${PREFIX}.json echo "Fetching IP Addresses..." for i in {0..49} do ENDPOINT=${HOSTNAME}/projects/${PROJECT_ID}/locations/${REGION}/endpointAttachments/${PREFIX}-$i gcurl -s -X GET "${ENDPOINT}" | sed 's/ //g' | grep -E 'name|endpointIp' | sed 's/"endpointIp"/"IPAddress"/g' | sed -E 's/"name": "projects\/.+\/locations\/.+\/endpointAttachments\//"name": "/g' | sed '1 s/"/{"/1' | sed '2 s/"/"},/4' >> atlasEndpoints-${PREFIX}.json done sed -i '$s/,/]/' atlasEndpoints-${PREFIX}.json echo "Created atlasEndpoints-${PREFIX}.json"
- Execute o script de shell. Acesse o diretório em que você salvou o script para executar o script de shell
e execute o seguinte comando:
sh setup_psc.sh
Esse script gera um arquivo JSON que tem a lista de endereços IP e os nomes de endpoints do PSC correspondentes. O arquivo JSON é salvo no diretório em que o script de shell é executado.
- Clique em Avançar no console de gerenciamento do Atlas.
- Clique em Upload JSON file e envie o arquivo criado na etapa 13.
- Clique em Criar.
O processo de configuração do endpoint pode levar até 25 minutos para ser concluído e, se a configuração for bem-sucedida, o endpoint estará no estado
Available
. - Verifique sua conectividade particular. Para mais informações, consulte Verificar a conectividade particular.
Consiga o ID do projeto do diretório de serviços
Para conseguir o ID do projeto do diretório de serviços, use a API List Connections, conforme mostrado no exemplo a seguir.
Sintaxe
curl -X GET \ -H "authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://connectors.googleapis.com/v1/projects/CONNECTORS_PROJECT_ID/locations/-/connections"
Substitua:
- CONNECTORS_PROJECT_ID: o ID do projeto do Google Cloud em que você criou a conexão.
Exemplo
Este exemplo usa o ID do projeto do diretório de serviços do projeto connectors-test
do Google Cloud.
curl -X GET \ -H "authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://connectors.googleapis.com/v1/projects/connectors-test/locations/-/connections"
A execução deste comando no terminal exibe uma resposta semelhante a esta:
..... { "connections": [ { "name": "projects/connectors-test/locations/asia-northeast1/connections/big-query-iam-invalid-sa", "createTime": "2022-10-07T09:02:31.905048520Z", "updateTime": "2022-10-07T09:22:39.993778690Z", "connectorVersion": "projects/connectors-test/locations/global/providers/gcp/connectors/bigquery/versions/1", "status": { "state": "ACTIVE" }, "configVariables": [ { "key": "project_id", "stringValue": "connectors-test" }, { "key": "dataset_id", "stringValue": "testDataset" } ], "authConfig": {}, "serviceAccount": "564332356444-compute@developer.gserviceaccount.com", "serviceDirectory": "projects/abcdefghijk-tp/locations/asia-northeast1/namespaces/connectors/services/runtime", "nodeConfig": { "minNodeCount": 2, "maxNodeCount": 50 } }, ....
No exemplo de saída, para o projeto connectors-test
do Google Cloud, o ID do projeto do diretório de serviços é abcdefghijk-tp
.
Verificar a conectividade particular
Para verificar a conectividade particular com os clusters do Atlas, faça o seguinte:
- No console de gerenciamento do Atlas, abra a página Implantações do banco de dados.
- Role até o cluster necessário e clique em Conectar. Isso abre a caixa de diálogo Conectar a <CLUSTER_NAME>.
- Clique em Endpoint particular para o tipo de conexão.
- Selecione o prefixo do endpoint particular que você inseriu na interface do Atlas na lista suspensa Escolher um endpoint particular.
- Clique em Escolher um método de conexão.
- Clique em Drivers na seção Connect to your application. Esta etapa é para conseguir a string de conexão
srv
. - Copie a string de conexão
srv
da seção Adicione sua string de conexão ao código do aplicativo.Formato da string
srv
:mongodb+srv://{cluster-name}-pl-{index}.{unique-pin}.mongodb.net
. - Crie uma conexão do MongoDB usando esta string
srv
como o nome do host. Para mais informações, consulte Configurar um conector do MongoDB.A conexão será criada.