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 ringkasan AlloyDB Omni, lihat 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 containerisasi ini sebagai container di virtual machine (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
  • Ruang 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 chip M
  • RAM 2 GB
  • Ruang disk 10 GB
  • Docker Desktop 4.20 atau yang lebih baru
  • (*) Dukungan Arm masih dalam Pratinjau.

    Memastikan cgroupsv2 diaktifkan

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

    grep cgroup /proc/filesystems
    

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

    nodev cgroup
    nodev cgroupsv2
    

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

    nodev cgroup
    

    Menginstal runtime container

    Instal runtime container seperti Docker atau Podman. AlloyDB Omni berjalan di 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 postgres penampung baru setelah pembuatannya.
      • IMAGE_TAG: gunakan 16.8.0 untuk image Debian terbaru atau16.8.0-ubi untuk image UBI terbaru.

    2. Terhubung ke AlloyDB Omni dalam penampung menggunakan psql:

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

      Jendela terminal menampilkan teks login psql 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 postgres penampung baru setelah pembuatannya.
      • IMAGE_TAG: gunakan 16.3.0 untuk image Debian terbaru atau16.3.0-ubi untuk image UBI terbaru.

    2. Terhubung ke AlloyDB Omni dalam penampung 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, ikuti langkah-langkah berikut:

    Docker

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

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

        docker container rm my-omni

    Podman

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

        podman container stop my-omni
    2. Hapus penampung 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