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 8 또는 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 지원은 미리보기 버전입니다.

머신에서 cgroupsv2가 사용 설정되어 있는지 확인하려면 다음 명령어를 실행합니다.

grep cgroup /proc/filesystems

머신이 cgroupsv2를 지원하는 경우 다음과 같은 출력이 표시됩니다.

  nodev cgroup
  nodev cgroupsv2

머신이 cgroupsv2를 지원하지 않으면 다음과 같은 출력이 표시됩니다.

nodev cgroup

docker run 명령어를 사용하여 AlloyDB Omni가 포함된 새 컨테이너(이름: my-omni)를 만듭니다.
```
  docker run --name my-omni \
    -e POSTGRES_PASSWORD=NEW_PASSWORD \
    -d google/alloydbomni:16
```
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:16
```
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 설치 맞춤설정 페이지를 참고하세요.