AlloyDB Omni 설치

이 빠른 시작에서는 컨테이너 런타임을 지원하는 모든 UNIX 기반 환경에서 실행할 수 있는 AlloyDB Omni를 설치하는 방법을 보여줍니다.

AlloyDB Omni에 관한 개요는 AlloyDB Omni 개요를 참고하세요.

시작하기 전에

다음 표에는 AlloyDB Omni의 최소 하드웨어 및 소프트웨어 요구사항이 나와 있습니다.

OS/플랫폼	최소 하드웨어	최소 소프트웨어
Linux	AVX2를 지원하는 x86-64 또는 Arm (*) CPU RAM 2GB 디스크 공간 10GB	Debian 기반 OS (Ubuntu 등) 또는 RHEL 9 Linux 커널 버전 5.3 이상 Cgroupsv2 사용 설정됨 Docker Engine 20.10 이상 또는 Podman 4.2.0 이상
macOS	AVX2 지원 또는 M 칩이 있는 Intel CPU RAM 2GB 디스크 공간 10GB	Docker 데스크톱 4.20 이상
(*) Arm 지원은 미리보기 버전입니다.

AlloyDB Omni는 컨테이너에서 실행됩니다. AlloyDB Omni를 설치하기 전에 머신에 Docker 또는 Podman과 같은 컨테이너 런타임을 설치합니다.

docker run 명령어를 사용하여 AlloyDB Omni가 포함된 새 컨테이너(이름: my-omni)를 만듭니다.
```
  docker run --name my-omni \
    -e POSTGRES_PASSWORD=NEW_PASSWORD \
    -d google/alloydbomni:15.5.5
```
NEW_PASSWORD을 비밀번호로 바꾸어 새 컨테이너의 postgres 사용자를 생성 후 할당합니다.

참고: 기본적으로 AlloyDB Omni는 호스트 파일 시스템이 아닌 컨테이너 자체에 데이터를 저장합니다. AlloyDB Omni 컨테이너를 삭제하면 데이터 디렉터리가 삭제됩니다. 호스트 파일 시스템에 저장된 데이터 디렉터리를 마운트하려면 AlloyDB Omni 설치 맞춤설정의 안내를 참고하세요.
psql를 사용하여 컨테이너화된 AlloyDB Omni에 연결합니다.
```
  docker exec -it my-omni psql -h localhost -U postgres
```
터미널 창에 postgres=# 프롬프트로 끝나는 psql 로그인 텍스트가 표시됩니다.

docker run 명령어를 사용하여 AlloyDB Omni가 포함된 새 컨테이너(이름: my-omni)를 만듭니다.
```
  podman run --name my-omni \
    -e POSTGRES_PASSWORD=NEW_PASSWORD \
    -d google/alloydbomni:15.5.5
```
NEW_PASSWORD을 비밀번호로 바꾸어 새 컨테이너의 postgres 사용자를 생성 후 할당합니다.

참고: 기본적으로 AlloyDB Omni는 호스트 파일 시스템이 아닌 컨테이너 자체에 데이터를 저장합니다. AlloyDB Omni 컨테이너를 삭제하면 데이터 디렉터리가 삭제됩니다. 호스트 파일 시스템에 저장된 데이터 디렉터리를 마운트하려면 AlloyDB Omni 설치 맞춤설정의 안내를 참고하세요.
psql를 사용하여 컨테이너화된 AlloyDB Omni에 연결합니다.
```
podman exec -it my-omni psql -h localhost -U postgres
```
터미널 창에 postgres=# 프롬프트로 끝나는 psql 로그인 텍스트가 표시됩니다.

이 빠른 시작에서 만든 AlloyDB Omni 컨테이너를 삭제하려면 다음 단계를 따르세요.

my-omni라는 이름의 AlloyDB Omni 컨테이너를 중지합니다.
```
  docker container stop my-omni
```
이름이 my-omni인 AlloyDB Omni 컨테이너를 삭제합니다.
```
  docker container rm my-omni
```

my-omni라는 이름의 AlloyDB Omni 컨테이너를 중지합니다.
```
  podman container stop my-omni
```
이름이 my-omni인 AlloyDB Omni 컨테이너를 삭제합니다.
```
  podman container rm my-omni
```

프로덕션 사용을 위해 새 컨테이너에 AlloyDB Omni를 설치하는 방법에 관한 안내는 AlloyDB Omni 설치 맞춤설정 페이지를 참고하세요.