AlloyDB Omni 설치

문서 버전을 선택합니다.

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

AlloyDB Omni 개요는 AlloyDB Omni 개요를 참고하세요.

시작하기 전에

AlloyDB Omni를 설치하기 전에 다음 요구사항을 충족해야 합니다.

다운로드 또는 설치 옵션 선택

미디어 다운로드 위치 및 설치 가이드 배포 대상
Debian 이미지 DockerHub (태그)
  • Docker, Podman 이러한 컨테이너화 도구를 가상 머신(VM)에서 컨테이너로 실행할 수 있습니다.
UBI 이미지 (Red Hat) Red Hat Ecosystem Catalog
  • Red Hat 환경 이를 컨테이너로 실행합니다.

하드웨어 및 소프트웨어 요구사항 충족

다음 최소 하드웨어 및 소프트웨어 요구사항을 충족하는지 확인합니다.

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를 지원하는 Intel CPU 또는 M 칩
  • RAM 2GB
  • 디스크 공간 10GB
    		•
  • Docker Desktop 4.20 이상
    		•
    (*) Arm 지원은 미리보기 상태입니다.

    cgroupsv2가 사용 설정되어 있는지 확인

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

    grep cgroup /proc/filesystems

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

    nodev cgroup
nodev cgroupsv2

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

    nodev cgroup

    컨테이너 런타임 설치

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

    Docker를 사용하여 AlloyDB Omni 설치

    AlloyDB Omni를 설치하는 데 루트 액세스가 필요하지 않습니다.

    Docker

    1. docker run 명령어를 사용하여 AlloyDB Omni가 포함된 새 컨테이너를 만듭니다(이름: my-omni).

        docker run --name my-omni \
    -e POSTGRES_PASSWORD=NEW_PASSWORD \
     -d google/alloydbomni:IMAGE_TAG

      다음 변수를 바꿉니다.

      • NEW_PASSWORD: 새 컨테이너의 postgres 사용자 생성 후 할당할 비밀번호입니다.

      • IMAGE_TAG: 최신 Debian 이미지에는 16.8.0을, 최신 UBI 이미지에는 16.8.0-ubi을 사용합니다.

    2. psql을 사용하여 컨테이너화된 AlloyDB Omni에 연결합니다.

        docker exec -it my-omni psql -h localhost -U postgres

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

    Podman

    1. docker run 명령어를 사용하여 AlloyDB Omni가 포함된 새 컨테이너를 만듭니다(이름: my-omni).

        podman run --name my-omni \
    -e POSTGRES_PASSWORD=NEW_PASSWORD \
    -d google/alloydbomni:IMAGE_TAG

      다음 변수를 바꿉니다.

      • NEW_PASSWORD: 새 컨테이너의 postgres 사용자 생성 후 할당할 비밀번호입니다.

      • IMAGE_TAG: 최신 Debian 이미지에는 16.3.0을, 최신 UBI 이미지에는 16.3.0-ubi을 사용합니다.

    2. psql을 사용하여 컨테이너화된 AlloyDB Omni에 연결합니다.

      podman exec -it my-omni psql -h localhost -U postgres

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

    삭제

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

    Docker

    1. my-omni라는 AlloyDB Omni 컨테이너를 중지합니다.

        docker container stop my-omni

    2. my-omni라는 AlloyDB Omni 컨테이너를 삭제합니다.

        docker container rm my-omni

    Podman

    1. my-omni라는 AlloyDB Omni 컨테이너를 중지합니다.

        podman container stop my-omni

    2. my-omni라는 AlloyDB Omni 컨테이너를 삭제합니다.

        podman container rm my-omni

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

    다음 단계