AlloyDB Omni RPM 오케스트레이터 설치

문서 버전을 선택합니다.

RPM 조정자를 사용하는 AlloyDB Omni는 가상 머신 (VM) 또는 베어메탈 서버 집합에 AlloyDB Omni 데이터베이스 클러스터를 설치, 설정, 관리하는 자동화 플랫폼을 제공합니다. RPM 조정자를 사용하는 AlloyDB Omni는 하나 이상의 클러스터를 원격으로 관리하는 전용 제어 노드에서 실행되는 CLI 및 Ansible 인터페이스를 제공합니다.

자동화 요구사항에 따라 다음 두 가지 조정자 인터페이스 중에서 선택할 수 있습니다.

  • AlloyDB Omni 조정자 CLI alloydbctl: 자동화에 셸 스크립트를 사용하는 환경에 권장됩니다.
  • AlloyDB Omni 조정자 Ansible 컬렉션: Ansible 기반 자동화를 사용하는 환경에 권장됩니다.

제한사항

이 출시 버전에는 다음 제한사항이 적용됩니다.

  • 이 출시 버전은 AlloyDB Omni PostgreSQL 18만 지원합니다.
  • 이 출시 버전은 RHEL 버전 9 호환 소프트웨어 패키지만 지원합니다.
  • 이 출시 버전은 Intel x86 64비트 기반 플랫폼만 지원합니다.
  • 이 출시 버전에서는 메이저 버전 업그레이드가 지원되지 않습니다.
  • 이 출시 버전에는 재해 복구를 설정하는 방법에 대한 안내가 포함되어 있지 않습니다.
  • 이 출시 버전에는 읽기 풀 인스턴스를 설정하는 방법에 대한 안내가 포함되어 있지 않습니다.
  • AlloyDB Omni 모니터는 SSL 연결을 지원하지 않습니다. AlloyDB Omni 노드와 동일한 비공개 네트워크에 모니터링 대시보드 서버를 배포해야 합니다.

시작하기 전에

배포를 시작하기 전에 다음 요구사항을 충족하는지 확인하세요.

AlloyDB Omni 패키지 가져오기

RPM 조정자를 사용하는 AlloyDB Omni 소프트웨어 패키지는 미리보기로 제공됩니다. RPM 파일을 받으려면 RPM 조정자를 사용하는 AlloyDB Omni 미리보기 가입 양식을 사용하여 가입해야 합니다.

비공개 Yum 저장소를 통해 소프트웨어 패키지를 관리하는 경우 저장소 관리에 따라 종속 RPM 파일을 저장소에 포함합니다. 자세한 내용은 소프트웨어 패키지 종속 항목을 참고하세요.

소프트웨어 저장소 설정

AlloyDB Omni RPM은 전역 Yum 저장소에서 유지관리됩니다. 또는 조직에서 비공개 Yum 저장소를 통해 소프트웨어를 관리하는 경우 가입 후 제공되는 RPM 패키지를 관리 도구에 따라 저장소에 포함해야 합니다. 배포 프로세스 중에 비공개 저장소 URL이 필요합니다.

머신 프로비저닝

다음을 포함하여 RHEL 9를 실행하는 VM 집합을 프로비저닝합니다.

  • 컨트롤러: 배포를 조정하고 다른 모든 노드에 비밀번호 없는 SSH 액세스 권한이 있는 노드 1개
  • 데이터베이스: AlloyDB Omni 코어 및 모니터링 서비스를 실행하는 노드 1개 또는 3개
  • 부하 분산기: HAProxy 및 PgBouncer와 같은 선택적 연결 풀러를 실행하는 선택적 노드 2개

네트워크 및 방화벽 구성

아키텍처에 따라 다음 TCP 포트를 허용하도록 방화벽을 구성합니다.

포트 프로토콜 노드 서비스 트래픽 참고
5432 TCP 부하 분산기 HAProxy 수신 해당하는 경우 부하 분산기 노드
6432 TCP 부하 분산기 PgBouncer 수신 해당하는 경우 연결 풀러
9187 TCP 데이터베이스 AlloyDB 모니터 수신 해당하는 경우 모니터, TLS 지원 안 함
5432 TCP 데이터베이스 AlloyDB 수신 3노드 복원 아키텍처
6432 TCP 데이터베이스 PgBouncer 수신 3노드 복원 아키텍처에서 해당하는 경우 연결 풀러
2380 TCP etcd etcd 수신 etcd 피어 투 피어 프로토콜
- VRRP 부하 분산기 Keepalived 수신 Keepalived 리더 선택
- VRRP 데이터베이스 Keepalived 수신 3노드 복원 아키텍처에서 Keepalived 리더 선택
6703 TCP Cluster Manager Cluster Manager 수신 Cluster Manager gRPC 포트
6702 TCP 모든 노드 노드 관리자 수신 노드 관리자 gRPC 포트
6700 TCP 모든 노드 노드 관리자 수신 노드 관리자 Init gRPC 포트
8086 HTTP 모든 노드 노드 관리자 수신 기본 또는 대기 상태를 확인하는 노드 관리자 HTTP 포트
2379 TCP etcd etcd 수신 Cluster Manager가 etcd와 작동하도록
443 HTTPS 데이터베이스 Cloud Storage 발신 백업 데이터 전송용

호스트 SELinux 모드

AlloyDB Omni는 허용 모드와 적용 모드 모두에서 SELinux를 지원합니다.

SELinux를 사용 설정 또는 중지하려면 모든 노드에서 /etc/selinux/config 파일이 업데이트되었는지 확인합니다. 클러스터를 부트스트랩하기 전에 모든 데이터베이스 노드와 부하 분산기 노드에서 SELinux 설정이 일관적인지 확인합니다. 현재 설정을 확인하려면 getenforce 명령어를 사용합니다.

자세한 내용은 SELinux 정책 사양을 참고하세요.

조정자 설치

Ansible

Ansible 플레이북을 사용하여 클러스터를 관리하려는 경우 이 방법을 사용합니다.

  1. 제어 노드에 Ansible 및 필수 Python 라이브러리를 설치합니다.

    # Install EPEL for RHEL 9
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm -y
# Install Ansible and dependencies
sudo dnf install ansible
sudo dnf install python3-grpcio python3-protobuf python3-googleapis-common-protos

  2. Ansible 컬렉션 tar 파일과 서명을 다운로드하고 패키지를 확인한 후 설치합니다.

    # Download the collection and its signature
wget ALLOYDBOMNI_SERVER/google-alloydbomni_orchestrator-0.1.0-1.tar.gz
wget ALLOYDBOMNI_SERVER/google-alloydbomni_orchestrator-0.1.0-1.tar.gz.asc

# Import the Google Linux signing key
curl -sS https://dl.google.com/linux/linux_signing_key.pub | gpg --import

# Verify the collection tarball
gpg --verify google-alloydbomni_orchestrator-0.1.0-1.tar.gz.asc \
google-alloydbomni_orchestrator-0.1.0-1.tar.gz

# Install the collection
ansible-galaxy collection install google-alloydbomni_orchestrator-0.1.0-1.tar.gz

# Verify the installation
ansible-galaxy collection list | grep alloydbomni_orchestrator

    ALLOYDBOMNI_SERVER를 Ansible 컬렉션 tar 파일을 포함하여 AlloyDB Omni 소프트웨어 패키지가 호스팅되는 서버의 URL로 바꿉니다. 이 소스는 RPM 조정자를 사용하는 AlloyDB Omni 미리보기에 가입한 후에 제공됩니다.

alloydbctl

명령줄 유틸리티를 사용하여 리소스를 관리하려는 경우 이 방법을 사용합니다.

  1. 제어 노드의 /etc/yum.repos.d/alloydbomni_orchestrator.repo에 Yum 구성 파일을 만듭니다.

    [alloydbomni_orchestrator]
name=Google AlloyDB Omni orchestrator packages
baseurl=ALLOYDB_OMNI_ORCHESTRATOR_REPOSITORY_URL
enabled=1
repo_gpgcheck=0
gpgcheck=1
gpgkey=REPO_GPG_KEY

    다음을 바꿉니다.

    • ALLOYDB_OMNI_ORCHESTRATOR_REPOSITORY_URL: AlloyDB Omni 조정자 RPM이 포함된 저장소의 URL
    • REPO_GPG_KEY: GNU 개인 정보 보호(GPG) 확인을 위한 Google 공개 키의 위치(예: https://dl.google.com/linux/linux_signing_key.pub) 키가 파일에 다운로드된 경우 경로로 설정할 수도 있습니다(예: file:///tmp/linux_signing_key.pub).

  2. 패키지를 설치하고 바이너리를 시스템의 PATH에 추가합니다.

    sudo dnf install alloydbomni_orchestrator
export PATH=$PATH:/usr/local/bin

  3. 다음을 실행하여 설치를 확인합니다.

    alloydbctl --help