Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

VPC 피어링을 사용하여 MongoDB Atlas 구성

가상 프라이빗 클라우드 (VPC) 피어링을 사용하면 비공개 네트워크를 통해 MongoDB Atlas 데이터베이스에서 Datastream으로 변경 데이터 캡처 (CDC) 업데이트를 스트리밍할 수 있습니다. VPC 피어링은 비전이적이므로 방화벽 규칙이 있는 Compute Engine 네트워크 주소 변환 (NAT) 가상 머신(VM)을 통해 트래픽을 라우팅합니다. 또한 MongoDB 사용자를 만들고, NAT VM IP 주소를 MongoDB Atlas 허용 목록에 추가하고, 연결 프로필을 만듭니다. 이 구성은 고가용성을 제공하지 않습니다. MongoDB 노드가 연결 프로필 테스트에 실패하면 NAT VM에서 시작 스크립트를 수동으로 실행해야 합니다.

MongoDB 데이터베이스 사용자 구성

MongoDB Atlas 인스턴스에서 Datastream을 사용하려면 먼저 데이터베이스 사용자를 만들고 액세스 권한을 부여해야 합니다.

MongoDB Atlas 대시보드의 보안 아래에서 데이터베이스 액세스를 클릭합니다.
New database user(새 데이터베이스 사용자)를 클릭하고 사용자의 비밀번호 인증 방법을 선택합니다.
Datastream 사용자의 사용자 이름과 비밀번호를 입력합니다.
데이터베이스 사용자 권한에서 특정 사용자 권한 부여를 선택합니다.
특정 권한에서 다음 역할을 추가합니다.
- readAnyDatabase
사용자 추가를 클릭합니다.

가상 프라이빗 클라우드(VPC) 네트워크 설정

Datastream 및 MongoDB Atlas와 피어링할 Google Cloud 프로젝트에서 가상 프라이빗 클라우드 네트워크를 식별합니다. 이 페이지에서는 기본 VPC와 해당 서브넷(예: us-central1 리전의 기본 서브넷)을 사용한다고 가정합니다.

식별한 네트워크에 Datastream 또는 MongoDB Atlas 네트워크와 겹치는 IP 주소 범위가 없는지 확인합니다.
비공개 연결 구성을 만들어 Datastream을 가상 프라이빗 클라우드(VPC) 네트워크와 피어링합니다.
1. 비공개 연결 방법 드롭다운에서 VPC 피어링을 선택해야 합니다.
2. default VPC 네트워크를 선택합니다.
3. Datastream에서 사용할 사용되지 않는 IP 주소 범위(예: 10.0.0.0/29)를 제공합니다.
4. 인그레스 방화벽 규칙에 할당된 IP 범위를 기록해 둡니다.
MongoDB Atlas에서 네트워크 피어링 연결을 설정하여 가상 프라이빗 클라우드 네트워크를 MongoDB Atlas 네트워크와 피어링합니다. 자세한 내용은 MongoDB 문서의 네트워크 피어링 연결 설정을 참조하세요.
1. MongoDB Atlas에서 Google Cloud 프로젝트 ID와 기본 VPC 이름을 제공합니다.
2. Google Cloud 측에서 피어링을 완료하기 위해 MongoDB Atlas에서 제공하는 프로젝트 ID와 VPC 이름을 기록해 둡니다.
연결을 만든 후 MongoDB Atlas 프로젝트에서 네트워크 액세스 > VPC 피어링 탭으로 이동하여 이그레스 방화벽 규칙의 CIDR (Classless Inter-Domain Routing) 블록을 기록해 둡니다.

NAT VM 만들기

Google Cloud 콘솔에서 VM 인스턴스 페이지로 이동합니다.

VM 인스턴스로 이동
인스턴스 만들기를 클릭합니다.
이름 필드에 VM의 이름을 입력합니다(예: mongo-nat-gateway).
리전 필드에서 기본 VPC 내의 리전(예: us-central1)을 선택합니다.
탐색 메뉴에서 네트워킹을 클릭합니다.
네트워크 태그 필드에 태그(예: mongo-nat-vm)를 추가합니다. 이 태그는 방화벽 규칙에서 사용됩니다.
IP 전달에서 사용 설정 체크박스를 선택합니다.
네트워크 인터페이스에서 기본 VPC 및 해당 서브넷(예: us-central1의 default)을 선택합니다.
탐색 메뉴에서 고급을 클릭합니다.

자동화 섹션에서 시작 스크립트 필드에 다음 스크립트를 붙여넣습니다. PRIVATE_SRV_RECORD을 MongoDB Atlas 클러스터의 비공개 SRV 레코드(예: my-cluster-pri.abcde.mongodb.net)로 바꿉니다.

#!/bin/bash

# --- Startup script for MongoDB Atlas NAT gateway ---
# This script has two main functions:
# 1. Resolves the IP address of a MongoDB Atlas node from its SRV record.
# 2. Configures iptables to forward traffic to the resolved MongoDB IP.
# --------------------------------------------------------------------------

# --- Part 1: Resolve MongoDB node IP address ---

#
# EDIT THIS LINE to match your Mongo Atlas private SRV record
#
export SRV_RECORD=PRIVATE_SRV_RECORD

echo "Resolving SRV record for: $SRV_RECORD"

# Function to install DNS utilities if needed
install_dns_tools() {
    echo "'dig' not found. Attempting to install DNS utilities..."
    if command -v apt-get &> /dev/null; then
        # Wait for any existing apt processes to finish before trying to install packages.
        # This is common on VM startup where the system might be running automatic updates.
        echo "Checking for and waiting on existing apt-get processes..."
        while fuser /var/lib/apt/lists/lock /var/lib/dpkg/lock /var/lib/dpkg/lock-frontend >/dev/null 2>&1; do
            echo "Another apt process is running. Waiting 10 seconds..."
            sleep 10
        done
        echo "Apt lock is free. Proceeding with installation."

        apt-get update && apt-get install -y dnsutils
    else
        echo "Error: Could not find apt-get to install DNS utilities."
        exit 1
    fi

    # Verify that dig is now available
    if ! command -v dig &> /dev/null; then
        echo "Error: Failed to install DNS utilities."
        exit 1
    fi
}

# Check if 'dig' is installed. If not, install it.
if ! command -v dig &> /dev/null; then
    install_dns_tools
fi

echo "Using 'dig' for DNS resolution."
# The `+short` option provides a concise output.
# We use `awk` to grab the 4th column (the hostname) and `head` to get the first one.
NODE_HOSTNAME=$(dig +short SRV "_mongodb._tcp.${SRV_RECORD}" | awk '{print $4}' | head -n 1)
if [ -n "$NODE_HOSTNAME" ]; then
    NODE_IP=$(dig +short A "$NODE_HOSTNAME")
fi

# Check if the SRV lookup was successful and we got a hostname.
if [ -z "$NODE_HOSTNAME" ]; then
    echo "Error: Could not resolve SRV record. Check the hostname and your
    network connection."
    exit 1
fi

echo "Found node hostname: $NODE_HOSTNAME"

# Check if the A record lookup was successful.
if [ -z "$NODE_IP" ]; then
    echo "Error: Could not resolve the IP address for node: $NODE_HOSTNAME"
    exit 1
fi

# 3. Print the final result of the lookup.
echo "Successfully resolved IP address of a node: $NODE_IP"

# --- Part 2: Configure iptables for NAT ---

# Substitute the resolved IP address into the DB_ADDR variable.
export DB_ADDR=$NODE_IP
export DB_PORT=27017

# Enable the VM to receive packets whose destinations do
# not match any running process local to the VM
echo 1 > /proc/sys/net/ipv4/ip_forward

# Ask the Metadata server for the IP address of the VM nic0
# network interface:
md_url_prefix="http://169.254.169.254/computeMetadata/v1/instance"
vm_nic_ip="$(curl -H "Metadata-Flavor: Google" ${md_url_prefix}/network-interfaces/0/ip)"

# Clear any existing iptables NAT table entries (all chains):
iptables -t nat -F

# Create a NAT table entry in the prerouting chain, matching
# any packets with destination database port, changing the destination
# IP address of the packet to the MongoDB instance IP address:
iptables -t nat -A PREROUTING \
     -p tcp --dport $DB_PORT \
     -j DNAT \
     --to-destination $DB_ADDR

# Create a NAT table entry in the postrouting chain, matching
# any packets with destination database port, changing the source IP
# address of the packet to the NAT VM's primary internal IPv4 address:
iptables -t nat -A POSTROUTING \
     -p tcp --dport $DB_PORT \
     -j SNAT \
     --to-source $vm_nic_ip

# Save iptables configuration:
iptables-save

echo "Startup script completed successfully. iptables rules are configured and saved."

만들기를 클릭하여 VM을 실행합니다.
VM이 실행되면 내부 IP 주소(예: 10.128.0.2)를 기록해 둡니다.

인그레스 및 이그레스 방화벽 규칙 만들기

VPC 네트워크에 방화벽 규칙 두 개를 만들어야 합니다.

다음 특성을 사용하여 인그레스 방화벽 규칙을 만듭니다.
- 이름: INGRESS_RULE_NAME
- 방향: 인그레스
- 작업: 허용
- 대상 매개변수: mongo-nat-vm 대상 태그
- 소스 매개변수: Datastream 비공개 연결 구성에서 사용하는 IP 주소 범위(예: 10.0.0.0/29)
- 프로토콜: TCP
- 포트: 27017
다음 특성을 사용하여 이그레스 방화벽 규칙을 만듭니다.
- 이름: EGRESS_RULE_NAME
- 방향: 이그레스
- 작업: 허용
- 대상 매개변수: mongo-nat-vm 대상 태그
- 대상 매개변수: MongoDB Atlas CIDR 블록(예: 192.168.240.0/21)
- 프로토콜: TCP
- 포트: 27017

MongoDB Atlas에서 IP 허용 목록 구성

MongoDB Atlas 보안 설정에서 NAT VM의 내부 IP 주소를 허용합니다.

MongoDB Atlas 계정에 로그인합니다.
탐색 메뉴에서 보안을 클릭한 다음 네트워크 액세스를 클릭합니다.
IP 주소 추가를 클릭합니다.
액세스 목록 항목 필드에 VPC 네트워크에서 만든 NAT VM 인스턴스의 내부 IP 주소를 입력합니다.
확인을 클릭하고 상태가 활성으로 변경될 때까지 기다립니다.

연결 프로필 만들기

데이터베이스의 Datastream 연결 프로필을 만듭니다.

Google Cloud 콘솔에서 연결 프로필 페이지로 이동합니다.

연결 프로필 페이지로 이동
프로필 만들기를 클릭하고 MongoDB를 선택합니다.
호스트 이름 필드에 VPC 네트워크에서 만든 NAT VM 인스턴스의 내부 IP 주소를 입력합니다.
포트 입력란에 27017을 입력합니다.
데이터베이스 사용자의 사용자 이름과 비밀번호를 입력합니다.
tls 및 tls_allow_invalid_hostnames 라벨을 추가하고 값을 true로 설정합니다. 라벨 설정에 대한 자세한 내용은 MongoDB 데이터베이스의 연결 프로필 만들기를 참조하세요.
연결 방법으로 비공개 연결을 선택합니다.
만든 비공개 연결 구성을 선택합니다.
만들기를 클릭하여 연결 프로필을 저장합니다.
테스트를 실행하여 데이터베이스 연결을 확인합니다.

VPC 피어링을 사용하여 MongoDB Atlas 구성 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.