이 페이지에서는 Kubernetes 배포 옵션을 사용하여 AlloyDB Omni 버전 15.5.2를 설명합니다. 다른 배포 옵션을 선택합니다.

AlloyDB Omni 설치 맞춤설정

문서 버전을 선택합니다.

이 페이지에서는 AlloyDB Omni를 다운로드, 설치, 연결하는 방법을 보여줍니다. 기본 구성을 사용하여 AlloyDB Omni를 빠르게 시작하려면 Debian 또는 Ubuntu에 AlloyDB Omni 설치를 참조하세요.

이 문서에서는 다음 작업을 수행하는 방법도 알아봅니다.

데이터 스토리지를 최적화하기 위해 새 디스크 파티션을 만듭니다.
서버를 구성합니다.
Debian, Ubuntu, RHEL과의 호환성을 보장합니다.

시작하기 전에

시스템 요구사항

Debian

Debian 또는 Ubuntu와 같은 Debian 기반 OS를 실행하는 가상 또는 실제 머신
x86/AMD64 아키텍처의 CPU 2개 이상
RAM 2GB 이상. 최적의 성능을 위해 CPU당 RAM 8GB를 할당하는 것이 좋습니다.
사용 가능한 스토리지 최소 20GB 이상
OS 내에서 무제한 루트 액세스
Docker 버전 20.10 이상
Linux 커널 버전 4.18 이상. 최상의 성능을 위해 커널 버전 5.3 이상을 사용하는 것이 좋습니다.
Linux cgroup v2 사용 설정
기본적으로 cgroup v2는 대부분의 최신 Linux 시스템에서 사용 설정되어 있습니다. cgroup v2가 사용 설정되었는지 확인하려면 셸에서 stat -fc %T /sys/fs/cgroup/을 실행합니다. cgroup v2가 사용 설정되면 명령어 출력에 cgroup2fs가 표시됩니다.
Vertex AI와 통합하려면 환경에서 Google Cloud CLI를 사용할 수 있어야 합니다.
클라우드 플랫폼에 AlloyDB Omni를 설치하려면 다음 인스턴스 유형을 사용하는 것이 좋습니다.
- Google Cloud에서는 n2-highmem 인스턴스를 사용하는 것이 좋습니다.
- Amazon Web Services에서는 R6i 인스턴스를 사용하는 것이 좋습니다.
- Microsoft Azure에서는 Ebsv5 인스턴스를 사용하는 것이 좋습니다.
데이터 저장에 전용 SSD 스토리지 기기를 사용하는 것이 좋습니다. 이 목적으로 실제 기기를 사용하는 경우에는 호스트 머신에 직접 연결하는 것이 좋습니다.

RHEL

Red Hat Enterprise Linux(RHEL) 버전 8 이상을 실행하는 가상 또는 실제 머신 AlloyDB Omni의 자동 메모리 관리 기능이 작동하게 하려면 RHEL 버전 9 이상을 사용합니다.
x86/AMD64 아키텍처의 CPU 2개 이상
RAM 2GB 이상. 최적의 성능을 위해 CPU당 RAM 8GB를 할당하는 것이 좋습니다.
사용 가능한 스토리지 최소 20GB 이상
OS 내에서 무제한 루트 액세스
Docker 버전 20.10 이상
Linux 커널 버전 4.18 이상. 최상의 성능을 위해 커널 버전 5.3 이상을 사용하는 것이 좋습니다.
Linux cgroup v2 사용 설정
기본적으로 cgroup v2는 대부분의 최신 Linux 시스템에서 사용 설정되어 있습니다. cgroup v2가 사용 설정되었는지 확인하려면 셸에서 stat -fc %T /sys/fs/cgroup/을 실행합니다. cgroup v2가 사용 설정되면 명령어 출력에 cgroup2fs가 표시됩니다.
Vertex AI와 통합하려면 환경에서 Google Cloud CLI를 사용할 수 있어야 합니다.
클라우드 플랫폼에 AlloyDB Omni를 설치하려면 다음 인스턴스 유형을 사용하는 것이 좋습니다.
- Google Cloud에서는 n2-highmem 인스턴스를 사용하는 것이 좋습니다.
- Amazon Web Services에서는 R6i 인스턴스를 사용하는 것이 좋습니다.
- Microsoft Azure에서는 Ebsv5 인스턴스를 사용하는 것이 좋습니다.
데이터 저장에 전용 SSD 스토리지 기기를 사용하는 것이 좋습니다. 이 목적으로 실제 기기를 사용하는 경우에는 호스트 머신에 직접 연결하는 것이 좋습니다.

AlloyDB Omni 다운로드 및 설치

AlloyDB Omni CLI를 설치합니다.
AlloyDB Omni CLI를 사용하여 Linux 머신에 AlloyDB Omni를 설치할 수 있는지 확인합니다.
```
sudo alloydb system-check
```
필요한 경우 system-check 명령어 출력에서 성공적인 확인을 반환할 때까지 시스템을 수정합니다.
선택사항: AlloyDB Omni에서 데이터 저장에 사용할 새 디스크 파티션을 만들려면 최적의 성능을 위해 ext4 파일 시스템을 사용하는 것이 좋습니다.
1. ext4 파일 시스템을 만들려면 다음 명령어를 사용합니다.
```
mkfs.ext4 -m 1 -F "$disk_path"
```
2. 디스크를 마운트하려면 다음 명령어를 사용합니다.
```
mount --make-shared -o noatime,discard,errors=panic "$disk_path" "$disk_mountpoint"
```
다음 옵션 중 하나를 사용하여 서버 소프트웨어를 설치합니다.

참고: 대규모 언어 모델(LLM)을 쿼리하는 기능을 포함한 머신러닝(ML) 기능이 사용 설정된 AlloyDB Omni를 설치하려면 AlloyDB AI를 사용하여 AlloyDB Omni 설치를 참조하세요.
- 서버를 기본 인스턴스로 구성하려면 다음 명령어를 실행합니다.
```
sudo alloydb database-server install --data-dir=$(realpath DATA_DIR)
```
  DATA_DIR를 AlloyDB Omni가 데이터, 메타데이터, 구성 파일을 저장할 로컬 파일 시스템의 디렉터리로 바꿉니다. 이 디렉터리가 아직 없으면 AlloyDB Omni에서 디렉터리를 만들려고 시도합니다. 이 값을 지정하지 않으면 AlloyDB Omni는 /var/alloydb/main/를 기본값으로 설정합니다.
  
  AlloyDB Omni가 기본 5432 이외의 TCP 포트에서 연결을 리슨하게 하려면 --pg-port 플래그를 포함합니다.
```
sudo alloydb database-server install \
    --data-dir=$(realpath DATA_DIR) \
    --pg-port=PORT
```
  PORT를 AlloyDB Omni가 연결을 수락할 TCP 포트로 바꿉니다.
- 서버를 읽기 복제본으로 구성하려면 --replica-source-ip 및 --replica-source-port 플래그를 포함합니다.
```
sudo alloydb database-server install \
    --data-dir=$(realpath DATA_DIR) \
    --replica-source-ip=SOURCE_IP \
    --replica-source-port=SOURCE_PORT
```
  다음을 바꿉니다.
  - DATA_DIR: AlloyDB Omni가 데이터, 메타데이터, 구성 파일을 저장할 로컬 파일 시스템의 디렉터리. 이 디렉터리가 아직 없으면 AlloyDB Omni에서 디렉터리를 만들려고 시도합니다. 이 값을 지정하지 않으면 AlloyDB Omni는 /var/alloydb/main/를 기본값으로 설정합니다.
  - SOURCE_IP: 복제할 기본 AlloyDB Omni 인스턴스의 IP 주소
  - SOURCE_PORT: 복제할 기본 AlloyDB Omni 인스턴스의 TCP 포트. 이 값을 제공하지 않으면 AlloyDB Omni에서 기본값 5432를 적용합니다.
  AlloyDB Omni 읽기 복제본에 대한 자세한 내용은 읽기 전용 복제본 만들기를 참조하세요.
시스템에서 Red Hat Enterprise Linux를 실행하는 경우 다음을 사용하여 /usr/lib/tuned/virtual-guest/tuned.conf 파일을 업데이트합니다.
```
vm.swappiness=1
```

데이터베이스 서버에 연결 및 사용

psql을 사용하여 AlloyDB Omni에 연결합니다.

sudo docker exec -it pg-service psql -h localhost -U postgres

터미널 창에 postgres=# 프롬프트로 끝나는 psql 로그인 텍스트가 표시됩니다.