이 페이지에는 AlloyDB Omni 버전 15.5.2에 관한 문서가 표시됩니다. 최신 AlloyDB Omni 버전의 문서를 보려면 여기를 클릭하세요.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

AlloyDB Omni 설치 맞춤설정

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

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

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

시작하기 전에

시스템 요구사항

Debian

Debian 또는 Ubuntu와 같은 Debian 기반 OS를 실행하는 가상 머신 또는 실제 머신
x86/AMD64 아키텍처를 사용하는 CPU 2개 이상
2GB 이상의 RAM. 최적의 성능을 위해 CPU마다 8GB의 RAM을 할당하는 것이 좋습니다.
사용 가능한 저장용량 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개 이상
2GB 이상의 RAM. 최적의 성능을 위해 CPU마다 8GB의 RAM을 할당하는 것이 좋습니다.
사용 가능한 저장용량 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 로그인 텍스트가 표시됩니다.