Menginstal AlloyDB Omni

Pilih versi dokumentasi:

Panduan memulai ini menunjukkan cara menginstal AlloyDB Omni yang dapat berjalan di lingkungan berbasis UNIX yang mendukung runtime container.

Untuk mengetahui info tentang AlloyDB Omni, baca Ringkasan AlloyDB Omni.

Sebelum memulai

Sebelum menginstal AlloyDB Omni, pastikan Anda memenuhi persyaratan berikut.

Memilih opsi download atau penginstalan

Media Lokasi download dan panduan penginstalan Deployment ke
Image Debian DockerHub (tag)
  • Docker, Podman. Anda dapat menjalankan alat containerization ini sebagai container di mesin virtual (VM) mana pun.
Image UBI (Red Hat) Red Hat Ecosystem Catalog
  • Lingkungan Red Hat. Jalankan ini sebagai container.

Memenuhi persyaratan hardware dan software

Pastikan Anda memenuhi persyaratan hardware dan software minimum berikut:

OS/Platform Hardware minimum Software minimum
Linux
  • CPU x86-64 atau Arm (*) dengan dukungan AVX2
  • RAM 2 GB
  • Kapasitas disk 10 GB
  • OS berbasis Debian (Ubuntu, dll.), RHEL 8 atau 9
  • Kernel Linux versi 5.3 atau yang lebih tinggi
  • Cgroupsv2 diaktifkan
  • Docker Engine 20.10+ atau Podman 4.2.0+
  • macOS
  • CPU Intel dengan dukungan AVX2 atau M-chip
  • RAM 2 GB
  • Kapasitas disk 10 GB
  • Docker Desktop 4.20 atau yang lebih tinggi
  • Memastikan cgroupsv2 diaktifkan

    Untuk menentukan apakah cgroupsv2 diaktifkan di mesin Anda, jalankan perintah berikut:

    grep cgroup /proc/filesystems
    

    Jika mesin Anda mendukung cgroupsv2, Anda akan melihat output berikut:

    nodev cgroup
    nodev cgroupsv2
    

    Jika mesin Anda tidak mendukung cgroupsv2, Anda akan melihat output berikut:

    nodev cgroup
    

    Menginstal runtime container

    Instal runtime container seperti Docker atau Podman. AlloyDB Omni berjalan dalam container.

    Menginstal AlloyDB Omni menggunakan Docker

    Akses root tidak diperlukan untuk menginstal AlloyDB Omni.

    Docker

    1. Gunakan perintah docker run untuk membuat container baru dengan AlloyDB Omni bernama my-omni:

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

      Ganti variabel berikut:

      • NEW_PASSWORD: sandi untuk menetapkan pengguna container baru postgres setelah pembuatannya.
      • IMAGE_TAG: gunakan 16.3.0 untuk image Debian terbaru atau 16.3.0-ubi untuk image UBI terbaru.

    2. Terhubung ke AlloyDB Omni yang di-container menggunakan psql:

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

      Jendela terminal menampilkan psql teks login yang diakhiri dengan perintah postgres=#.

    Podman

    1. Gunakan perintah docker run untuk membuat container baru dengan AlloyDB Omni bernama my-omni:

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

      Ganti variabel berikut:

      • NEW_PASSWORD: sandi untuk menetapkan pengguna container baru postgres setelah pembuatannya.
      • IMAGE_TAG: gunakan 16.3.0 untuk image Debian terbaru atau 16.3.0-ubi untuk image UBI terbaru.

    2. Terhubung ke AlloyDB Omni yang di-container menggunakan psql:

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

      Jendela terminal menampilkan teks login psql yang diakhiri dengan perintah postgres=#.

    Pembersihan

    Untuk membersihkan container AlloyDB Omni yang Anda buat selama panduan memulai ini, gunakan langkah-langkah berikut:

    Docker

    1. Hentikan container AlloyDB Omni Anda yang bernama my-omni:

        docker container stop my-omni
    2. Hapus container AlloyDB Omni Anda yang bernama my-omni:

        docker container rm my-omni

    Podman

    1. Hentikan container AlloyDB Omni Anda yang bernama my-omni:

        podman container stop my-omni
    2. Hapus container AlloyDB Omni Anda yang bernama my-omni:

        podman container rm my-omni

    Untuk mengetahui petunjuk cara menginstal AlloyDB Omni di container baru untuk penggunaan produksi, buka halaman Menyesuaikan penginstalan AlloyDB Omni.

    Langkah berikutnya