Menyesuaikan penginstalan AlloyDB Omni

Catatan: Penggunaan AlloyDB Omni oleh Anda tunduk pada perjanjian antara Anda dan Google yang mengatur penawaran Google Cloud . Jika Anda tidak memiliki akun Google Cloud , atau belum membuat perjanjian dengan Google yang mengatur penawaran Google Cloud , jangan lanjutkan atau download software ini hingga Anda melakukannya. Untuk membuat akun Google Cloud , lihat halaman beranda Google Cloud .

AlloyDB Omni di-deploy melalui image Docker, yang memungkinkan berbagai bentuk penyesuaian. Halaman ini menampilkan beberapa penyesuaian umum yang digunakan.

Untuk mulai menggunakan AlloyDB Omni dengan cepat menggunakan konfigurasi default, lihat Panduan Memulai: AlloyDB Omni.

Sebelum memulai

Tabel berikut mencantumkan konfigurasi hardware dan software yang direkomendasikan untuk AlloyDB Omni.

OS/Platform	Konfigurasi hardware yang direkomendasikan	Konfigurasi software yang direkomendasikan
Linux	CPU x86-64 atau Arm (*) dengan dukungan AVX2 RAM 8 GB untuk setiap CPU yang dialokasikan ke AlloyDB Omni Kapasitas disk lebih dari 20 GB	OS berbasis Debian (Ubuntu, dll.) atau RHEL 9 Kernel Linux versi 6.1 atau yang lebih tinggi atau kernel Linux versi yang lebih lama dari 5.3 yang memiliki dukungan untuk perintah MADV_COLLAPSE dan MADV_POPULATE_WRITE Cgroupsv2 diaktifkan Docker Engine 25.0.0+ atau Podman 5.0.0+
macOS	CPU Intel dengan dukungan AVX2 atau chip M RAM 8 GB untuk setiap CPU yang dialokasikan ke AlloyDB Omni Kapasitas disk lebih dari 20 GB	Docker Desktop 4.30 atau yang lebih tinggi
(*) Dukungan Arm berada dalam Pratinjau.

AlloyDB Omni berjalan dalam penampung. Instal runtime container seperti Docker atau Podman di komputer Anda sebelum menginstal AlloyDB Omni.

Server tunggal

Memasang direktori data eksternal

Secara default, perintah di Panduan memulai: Menginstal AlloyDB Omni menyimpan data database di area yang dikelola oleh Docker. Hal ini memudahkan untuk memulai, tetapi mempersulit untuk menemukan dan menggunakan direktori data. Sebagai gantinya, Anda dapat menyiapkan pengikatan mount untuk memetakan direktori data ke lokasi yang diketahui di disk.

docker run --name CONTAINER_NAME \
-e POSTGRES_PASSWORD=NEW_PASSWORD \
-v DATA_DIR:/var/lib/postgresql/data \
-p HOST_PORT:5432 -d google/alloydbomni:15.5.4

Ganti kode berikut:

• CONTAINER_NAME: Nama untuk menetapkan penampung AlloyDB Omni baru ini di registry penampung mesin host Anda—misalnya, my-omni.

• NEW_PASSWORD: Sandi yang menetapkan pengguna postgres penampung baru setelah pembuatannya.

• DATA_DIR: Jalur sistem file yang Anda inginkan agar digunakan AlloyDB Omni untuk direktori datanya.

• HOST_PORT: Port TCP di mesin host yang akan digunakan container untuk memublikasikan port 5432-nya sendiri. Untuk menggunakan port default PostgreSQL di mesin host juga, tentukan 5432.

Mengaktifkan ulimits

Parameter ulimit menentukan berbagai batas proses yang diizinkan untuk digunakan penampung Docker. Untuk performa optimal, AlloyDB Omni menyesuaikan prioritas proses agar proses PostgreSQL penting dapat berjalan dengan prioritas yang lebih tinggi, yaitu mendapatkan alokasi CPU yang lebih besar. Untuk mengizinkannya, tentukan -20:-20, yang menghapus batasan untuk penampung AlloyDB Omni.

docker run --name CONTAINER_NAME \
-e POSTGRES_PASSWORD=NEW_PASSWORD \
--ulimit=nice=-20:-20 \
-p HOST_PORT:5432 -d google/alloydbomni:15.5.4

Menentukan driver logging

Secara default, Docker tidak melakukan rotasi log. Hal ini dapat menghabiskan banyak kapasitas disk, dan pada akhirnya menyebabkan kapasitas disk habis. Anda dapat mengonfigurasi Docker untuk menggunakan driver logging yang berbeda. Misalnya, untuk mencatat ke journald:

docker run --name CONTAINER_NAME \
-e POSTGRES_PASSWORD=NEW_PASSWORD \
--log-driver=journald \
-p HOST_PORT:5432 -d google/alloydbomni:15.5.4

Untuk informasi selengkapnya tentang Docker dan driver logging, lihat dokumentasi Docker Mengonfigurasi driver logging.

Anda juga dapat mengonfigurasi logging menggunakan PostgreSQL. Untuk informasi selengkapnya, lihat dokumentasi PostgreSQL Logging dan pelaporan error.

Memasang volume memori bersama

Jika Anda berencana menggunakan mesin kolom AlloyDB dengan AlloyDB Omni, sebaiknya sediakan memori bersama untuk penampung AlloyDB Omni. Metode untuk melakukannya berbeda-beda, bergantung pada sistem operasi host Anda, seperti yang ditunjukkan dalam contoh berikut.

Linux

Agar memori bersama tersedia untuk penampung, pasang /dev/shm:

   docker run --name CONTAINER_NAME \
     -e POSTGRES_PASSWORD=NEW_PASSWORD \
     -p HOST_PORT:5432 \
     -v /dev/shm:/dev/shm \
     -d google/alloydbomni:15.5.4

macOS

Agar memori bersama tersedia untuk penampung, sertakan tanda --shm-size:

 docker run --name CONTAINER_NAME \
    -e POSTGRES_PASSWORD=NEW_PASSWORD \
    -p HOST_PORT:5432 \
    --shm-size=SHARED_MEMORY_SIZE \
    -d google/alloydbomni:15.5.4

Ganti SHARED_MEMORY_SIZE dengan ukuran yang akan ditetapkan untuk /dev/shm di penampung, dalam format yang dijelaskan di Menjalankan penampung. Misalnya, untuk menentukan satu gigabyte, gunakan nilai 1g.

Sebaiknya tetapkan ukuran memori bersama ke sejumlah megabyte yang sama dengan setidaknya nilai flag google_job_scheduler.max_parallel_workers_per_job database Anda, dikalikan 250. Untuk informasi selengkapnya tentang mesin kolom, lihat Mengonfigurasi mesin kolom di AlloyDB Omni.

Misalnya, jika flag database google_job_scheduler.max_parallel_workers_per_job ditetapkan ke nilai defaultnya, yaitu 2, sebaiknya tambahkan flag --shm-size=500m atau yang lebih tinggi saat memulai server database.

Untuk mengetahui informasi selengkapnya tentang flag --shm-size, lihat Menjalankan penampung.