Membuat instance
Instance Bigtable adalah container untuk cluster Bigtable. Instance yang memiliki lebih dari satu cluster menggunakan replikasi. Anda dapat membuat cluster di hingga 8 region, dengan jumlah cluster di setiap region sebanyak jumlah zona.
Halaman ini menjelaskan cara membuat instance. Sebelum membaca halaman ini, Anda harus memahami ringkasan Bigtable. Anda juga harus membaca ringkasan instance, cluster, dan node.
Sebelum memulai
Siapkan lingkungan Anda:
-
Sign in to your Google Account.
If you don't already have one, sign up for a new account.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Verify that billing is enabled for your Google Cloud project.
-
Enable the Cloud Bigtable API, Cloud Bigtable Admin API APIs.
-
Install the Google Cloud CLI.
-
Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.
-
Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut:
gcloud init
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Verify that billing is enabled for your Google Cloud project.
-
Enable the Cloud Bigtable API, Cloud Bigtable Admin API APIs.
-
Install the Google Cloud CLI.
-
Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.
-
Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut:
gcloud init
- Jalankan perintah berikut untuk menginstal
cbt
CLI :gcloud components install cbt
Opsional: Jika Anda berencana mengaktifkan replikasi, lakukan hal berikut:
- Luangkan waktu beberapa menit untuk membaca ringkasan replikasi.
- Identifikasi kasus penggunaan untuk replikasi.
- Tentukan region atau region tempat instance Anda seharusnya berada, berdasarkan kasus penggunaan dan lokasi aplikasi serta traffic Anda.
- Tentukan cara Anda akan menggunakan profil aplikasi untuk merutekan permintaan masuk.
Opsional: Jika Anda ingin menggunakan kunci enkripsi yang dikelola pelanggan (CMEK), bukan enkripsi yang dikelola Google secara default, selesaikan tugas di bagian Membuat instance yang mendukung CMEK dan siapkan ID kunci CMEK Anda sebelum membuat instance baru. Anda tidak dapat menambahkan perlindungan CMEK ke instance setelah dibuat, dan Anda tidak dapat mengubah atau mengganti kunci CMEK setelah instance dibuat.
Di konsol Google Cloud , buka halaman Create instance.
Masukkan nama untuk instance.
Konsol Google Cloud menampilkan nama ini untuk mengidentifikasi instance Anda.
Masukkan ID instance.
ID instance adalah ID permanen untuk instance.
Klik Lanjutkan.
Pilih apakah akan menggunakan disk SSD atau HDD untuk cluster Anda. Dalam sebagian besar kasus, SSD adalah yang terbaik. Pilihan ini bersifat permanen. Pelajari lebih lanjut.
Klik Lanjutkan.
Masukkan ID cluster untuk cluster pertama.
ID cluster adalah ID permanen untuk cluster.
Pilih region dan zona tempat cluster pertama akan berjalan.
Opsional: Untuk mengonfigurasi cluster agar selalu melakukan penskalaan dalam inkremen dua node, pilih Enable 2x node scaling. Penskalaan node 2x tidak tersedia di semua zona. Untuk mengetahui informasi selengkapnya, lihat Faktor penskalaan node.
Pilih mode penskalaan node untuk cluster. Dalam sebagian besar kasus, Anda harus memilih penskalaan otomatis. Untuk panduan penskalaan, lihat Penskalaan otomatis.
- Untuk Alokasi node manual, masukkan jumlah node Bigtable untuk cluster pertama. Jika Anda tidak yakin berapa banyak node yang Anda butuhkan, gunakan default. Anda dapat menambahkan lebih banyak node nanti.
- Untuk Autoscaling, masukkan nilai untuk berikut ini:
- Jumlah node minimum
- Jumlah node maksimum
- Target pemakaian CPU
- Target pemanfaatan penyimpanan
Opsional: Untuk melindungi instance Anda dengan CMEK, bukan enkripsi yang dikelola Google default, selesaikan langkah-langkah berikut:
- Klik Tampilkan opsi enkripsi.
- Pilih tombol pilihan di samping Kunci enkripsi yang dikelola pelanggan (CMEK).
- Pilih atau masukkan nama resource untuk kunci CMEK yang ingin Anda gunakan untuk cluster. Anda tidak dapat menambahkannya nanti.
- Jika Anda diminta untuk memberikan izin ke akun layanan kunci CMEK, klik Grant. Akun pengguna Anda harus diberi peran Admin Cloud KMS untuk menyelesaikan tugas ini.
- Klik Simpan.
Opsional: Untuk mengaktifkan replikasi sekarang, selesaikan langkah-langkah tambahan berikut:
- Klik Tampilkan opsi lanjutan.
- Klik Tambahkan cluster, masukkan setelan untuk cluster, lalu klik Tambahkan. Ulangi langkah ini untuk membuat cluster tambahan di instance. Anda juga dapat mengaktifkan replikasi nanti dengan menambahkan cluster.
Setiap zona dalam region hanya dapat berisi satu cluster. Jika tombol Tambahkan cluster dinonaktifkan, ubah zona untuk cluster pertama Anda.
Untuk membuat instance yang memiliki lebih dari enam cluster, buat terlebih dahulu instance yang memiliki enam cluster, lalu tambahkan lebih banyak cluster ke instance tersebut.
Klik Buat untuk membuat instance.
Tinjau setelan replikasi di profil aplikasi default untuk melihat apakah setelan tersebut sesuai dengan kasus penggunaan replikasi Anda. Anda mungkin perlu mengupdate profil aplikasi default atau membuat profil aplikasi kustom.
Gunakan perintah
bigtable instances create
untuk membuat instance:gcloud bigtable instances create INSTANCE_ID \ --display-name=DISPLAY_NAME \ [--cluster-storage-type=CLUSTER_STORAGE_TYPE] \ [--cluster-config=id=CLUSTER_ID,zone=CLUSTER_ZONE, \ nodes=NODES] \ [--cluster-config=id=CLUSTER_ID,zone=CLUSTER_ZONE, \ autoscaling-min-nodes=AUTOSCALING_MIN_NODES, \ autoscaling-max-nodes=AUTOSCALING_MAX_NODES, \ autoscaling-cpu-target=AUTOSCALING_CPU_TARGET, \ autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET, \ kms-key=KMS_KEY], \ [node-scaling-factor=NODE_SCALING_FACTOR]
Ganti kode berikut:
INSTANCE_ID
: ID permanen untuk instance.DISPLAY_NAME
: Nama yang dapat dibaca manusia yang mengidentifikasi instance di konsol Google Cloud .CLUSTER_ID
: ID permanen untuk cluster.CLUSTER_ZONE
: Zona tempat cluster berjalan.
Anda harus mengonfigurasi setidaknya satu cluster untuk instance, menggunakan flag
--cluster-config
. Untuk membuat instance yang memiliki beberapa cluster, ulangi tanda--cluster-config
untuk setiap cluster.Untuk alokasi node manual, setelan
nodes
di tanda--cluster-config
bersifat opsional. Jika tidak ada nilai yang ditetapkan, Bigtable akan mengalokasikan node ke cluster secara otomatis berdasarkan jejak data Anda dan mengoptimalkan penggunaan penyimpanan sebesar 50%. Alokasi node otomatis ini berdampak pada harga. Jika Anda ingin mengontrol jumlah node dalam cluster, gantiNODES
dengan jumlah node yang Anda inginkan dalam cluster. Pelajari node lebih lanjut.Dalam sebagian besar kasus, pilih penskalaan otomatis, bukan alokasi node manual. Untuk_autoscaling, berikan opsi
autoscaling-
di flag--cluster-config
(autoscaling-storage-target
bersifat opsional) dan jangan gunakannodes
. Lihat Penskalaan otomatis untuk panduan dalam memilih nilai untuk setelan penskalaan otomatis Anda. Ganti berikut untuk kunci opsicluster-config
:AUTOSCALING_MIN_NODES
: Jumlah minimum node untuk cluster.AUTOSCALING_MAX_NODES
: Jumlah maksimum node untuk cluster.AUTOSCALING_CPU_TARGET
: Persentase target pemakaian CPU untuk cluster. Nilai ini harus dari 10 hingga 80.AUTOSCALING_STORAGE_TARGET
: (Opsional) Target pemanfaatan penyimpanan dalam GiB yang dipertahankan Bigtable dengan menambahkan atau menghapus node.KMS_KEY: Kunci CMEK untuk cluster.
Nilai KMS_KEY harus ditetapkan dalam format berikut:
projects/PROJECT/locations/LOCATION/keyRings/KEYRING/cryptoKeys/KEY
Ganti kode berikut:
- PROJECT: ID permanen untuk project
- LOCATION: lokasi cluster Anda
- KEYRING: nama key ring yang berisi kunci
- KEY: nama kunci
Berikut adalah contohnya:
projects/examplestore.com:dev/locations/us-east1/keyRings/devt-cmek-2/cryptoKeys/key2
Jika instance dilindungi CMEK, setiap cluster harus berada di region yang sama dengan kunci CMEK-nya. Anda dapat menambahkan cluster CMEK hanya ke instance yang sudah dilindungi CMEK. Pelajari lebih lanjut.
Perintah ini menerima flag opsional berikut:
--cluster-storage-type=CLUSTER_STORAGE_TYPE
: Jenis penyimpanan yang akan digunakan untuk instance. Nilai defaultnya adalahSSD
. Dalam sebagian besar kasus, nilai default adalah yang terbaik. Pilihan ini bersifat permanen. Pelajari lebih lanjut.--project=PROJECT
: Project tempat cluster akan dibuat jika berbeda dengan project saat ini.node-scaling-factor=NODE_SCALING_FACTOR
: Flag yang mengaktifkan penskalaan node 2x. Anda dapat mengaktifkan fitur ini dengan penskalaan manual dan penskalaan otomatis. Nilai yang dapat diterima adalahnode-scaling-factor-2x
ataunode-scaling-factor-1x
.
Untuk melihat daftar zona Bigtable yang tidak tersedia untuk penskalaan node 2x, lihat Batasan faktor penskalaan node.
Tinjau setelan replikasi di profil aplikasi default untuk melihat apakah setelan tersebut sesuai dengan kasus penggunaan replikasi Anda. Anda mungkin perlu mengupdate profil aplikasi default atau membuat profil aplikasi kustom.
Mulai dengan membuat instance dengan satu cluster. Gunakan perintah
createinstance
untuk membuat instance:cbt createinstance INSTANCE_ID \ DISPLAY_NAME \ CLUSTER_ID \ CLUSTER_ZONE \ CLUSTER_NUM_NODES \ CLUSTER_STORAGE_TYPE
Berikan hal berikut:
INSTANCE_ID
: ID permanen untuk instance.DISPLAY_NAME
: Nama yang dapat dibaca manusia yang mengidentifikasi instance di konsol Google Cloud .CLUSTER_ID
: ID permanen untuk cluster.CLUSTER_ZONE
: Zona tempat cluster berjalan.CLUSTER_NUM_NODES
: Kolom ini bersifat opsional. Jika tidak ada nilai yang ditetapkan, Bigtable akan otomatis mengalokasikan node berdasarkan jejak data Anda dan mengoptimalkan penggunaan penyimpanan sebesar 50%. Jika Anda ingin mengontrol jumlah node dalam cluster, perbarui nilaiCLUSTER_NUM_NODES
. Pastikan jumlah node ditetapkan ke nilai selain nol. Pelajari node lebih lanjut.CLUSTER_STORAGE_TYPE
: Jenis penyimpanan yang akan digunakan untuk cluster. Setiap cluster dalam instance harus menggunakan jenis penyimpanan yang sama. Menerima nilaiSSD
danHDD
. Dalam sebagian besar kasus,SSD
adalah yang terbaik. Pilihan ini bersifat permanen. Pelajari lebih lanjut.
Untuk mengaktifkan replikasi, gunakan perintah
createcluster
untuk menambahkan cluster:cbt -instance=INSTANCE_ID \ createcluster CLUSTER_ID \ ZONE \ NUM_NODES \ STORAGE_TYPE
Berikan hal berikut:
INSTANCE_ID
: ID permanen untuk instance yang baru saja Anda buat.CLUSTER_ID
: ID permanen untuk cluster.ZONE
: Zona tempat cluster berjalan.Setiap zona dalam region hanya dapat berisi satu cluster. Misalnya, jika instance memiliki cluster di
us-east1-b
, Anda dapat menambahkan cluster di zona lain dalam region yang sama, sepertius-east1-c
, atau zona di region terpisah, sepertieurope-west2-a
.NUM_NODES
: Kolom ini bersifat opsional. Jika tidak ada nilai yang ditetapkan, Bigtable akan otomatis mengalokasikan node berdasarkan jejak data Anda dan mengoptimalkan penggunaan penyimpanan sebesar 50%. Jika Anda ingin mengontrol jumlah node dalam cluster, perbarui nilaiNUM_NODES
. Pastikan jumlah node ditetapkan ke nilai selain nol.Dalam banyak kasus, setiap cluster dalam instance harus memiliki jumlah node yang sama, tetapi ada pengecualian. Pelajari node dan replikasi.
STORAGE_TYPE
: Jenis penyimpanan yang akan digunakan untuk cluster. Setiap cluster dalam instance harus menggunakan jenis penyimpanan yang sama. Menerima nilaiSSD
danHDD
.
(Opsional) Tinjau setelan replikasi di profil aplikasi default untuk melihat apakah setelan tersebut sesuai dengan kasus penggunaan replikasi Anda. Anda mungkin perlu mengupdate profil aplikasi default atau membuat profil aplikasi kustom.
- Cari tahu cara Bigtable menggunakan instance, cluster, dan node.
- Pelajari replikasi Bigtable.
- Tinjau dan perbarui profil aplikasi default untuk replikasi, dan buat profil aplikasi kustom sesuai kebutuhan.
- Cari tahu cara mengubah instance yang ada.
Merencanakan konfigurasi Anda:
Membuat instance
Untuk membuat instance Bigtable:
Konsol
gcloud
cbt
C++
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.
Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
C#
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.
Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.
Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.
Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
PHP
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.
Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.
Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Ruby
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.
Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.