Database mode Datastore kini disediakan tanpa ditautkan dari App Engine secara default.
Jika database Anda ditautkan ke App Engine, Anda dapat membatalkan tautan database.
App Engine Aktif
Aplikasi App Engine yang aktif berarti aplikasi ada dalam project yang sama dan aplikasi ini tidak dinonaktifkan. Aplikasi tersebut tidak memerlukan penggunaan apa pun. Aplikasi dan database tertaut harus berada di region yang sama.
Jika menonaktifkan aplikasi App Engine, Anda juga menonaktifkan akses ke database mode Datastore yang ditautkan ke aplikasi tersebut.
Melihat status link App Engine
Anda dapat memeriksa status pembatalan tautan App Engine menggunakan REST API:
curl --header "Authorization: Bearer $(gcloud auth print-access-token)" \
--header "Content-type: application/json" \
"https://firestore.googleapis.com/v1/projects/PROJECT_ID/databases/(default)"
Dalam respons, lihat nilai appEngineIntegrationMode
. Jika nilainya adalah DISABLED
, database Anda tidak ditautkan ke aplikasi App Engine.
Membatalkan tautan database dari App Engine
Anda dapat membatalkan tautan database mode Datastore dari aplikasi App Engine untuk menghapus persyaratan App Engine yang aktif. Saat membatalkan tautan database, Anda dapat menonaktifkan App Engine tanpa memengaruhi akses ke database.Pembatalan tautan adalah operasi permanen.
Jika membatalkan tautan database, Anda tidak dapat menggunakan fitur Disable Writes di halaman Datastore Admin. Jika operasi tulis saat ini dinonaktifkan, membatalkan penautan database akan mengaktifkan operasi tulis.
Sebelum membatalkan tautan database dari App Engine, pastikan Anda mengaktifkan Firestore API dan memperbarui izin IAM.
Untuk membatalkan tautan database, Buka halaman Datastore Admin, lalu klik Batalkan tautan database dari aplikasi. Mungkin perlu waktu hingga lima menit agar operasi pembatalan tautan diterapkan.
Memigrasikan Resource App Engine Terraform
Jika sebelumnya Anda mengelola database mode Datastore melalui resource Terraform google_app_engine_application
, Anda dapat menggunakan resource Terraform google_firestore_database
.
Untuk petunjuk umum tentang cara mengelola database mode Datastore melalui Terraform, lihat Mengotomatiskan pembuatan database.
Membuat resource google_firestore_database
Di file konfigurasi Terraform, buat resource google_firestore_database
baru:
datastore.tf
resource "google_firestore_database" "database" { project = "project" name = "(default)" location_id = "location" type = "DATASTORE_MODE" app_engine_integration_mode = "DISABLED" // Optional, but recommended for safety delete_protection_state = "DELETE_PROTECTION_ENABLED" }
Lihat Lokasi datastore untuk mengetahui daftar lokasi yang tersedia. Pilih lokasi yang sesuai dengan database yang ada.
Mengimpor database mode Datastore yang ada
Pertama, pastikan Firestore API diaktifkan.
Selanjutnya, impor database mode Datastore yang ada ke status Terraform Anda:
terraform import google_firestore_database.database "(default)"
Kemudian jalankan:
terraform plan
Periksa output untuk memastikan impor berhasil diselesaikan. Jika output menampilkan kolom yang berubah, pastikan perubahan ini memang diinginkan. Jika output menyertakan baris yang mirip dengan:
google_firestore_database.database must be replaced
lalu periksa file konfigurasi Terraform untuk melihat apakah ada
kesalahan, terutama di kolom project, location, atau
name, lalu jalankan terraform plan
lagi. Setiap kolom yang
memerlukan Terraform untuk mengganti database Anda akan ditandai dengan
# forces replacement
dalam output rencana.
Setelah Anda puas dengan output rencana Terraform, jalankan:
terraform apply
Menghapus resource google_app_engine_application
Jika Anda sudah memiliki resource google_app_engine_application
di
file konfigurasi Terraform, hapus dari file tersebut sekarang.
Setelah itu, jalankan lagi:
terraform plan
Anda akan melihat output yang mirip dengan berikut ini:
Terraform will perform the following actions: # google_app_engine_application.app will be destroyed # (because google_app_engine_application.app is not in configuration)
Setelah Anda puas dengan output rencana, jalankan
terraform apply
Terraform saat ini tidak mendukung penghapusan resource App Engine; walaupun Terraform akan menampilkan resource sebagai dihancurkan, Terraform tidak akan benar-benar menghapus aplikasi App Engine. Namun, aplikasi App Engine tidak akan lagi dikelola oleh Terraform.
Persyaratan Firestore API
Sebelumnya, semua database Firestore dalam mode Datastore ditautkan ke aplikasi App Engine. Database mode Datastore kini disediakan tanpa ditautkan dari App Engine secara default. Selain itu, semua database, baik yang sudah ada maupun yang baru dibuat, kini memiliki persyaratan berikut:
- Untuk mengelola database dari konsol Google Cloud dan gcloud CLI, Firestore API harus diaktifkan dalam project. Hal ini diperlukan untuk database Firestore dalam mode Native dan Firestore dalam mode Datastore.
Saat dijalankan dari konsol Google Cloud atau gcloud CLI, operasi administratif di bawah akan memerlukan izin IAM berikut:
- Membuat database:
datastore.databases.create
- Melihat metadata database:
datastore.databases.getMetadata
- Mengedit metadata database:
datastore.databases.update
- Membuat database:
Jika belum mengaktifkan Firestore API, Anda akan melihat error di halaman Datastore di konsol Google Cloud yang menyertakan pemberitahuan berikut:
Firestore API diperlukan untuk mengelola database Anda.
Error ini juga menyertakan tombol untuk mengaktifkan Firestore API. Klik tombol untuk mengaktifkan API.
Anda juga harus memverifikasi izin IAM untuk memastikan akses Anda ke database tidak terpengaruh.
Pastikan akun yang mengakses database melalui konsol Google Cloud memiliki izin yang diperlukan, yang tercantum di atas.
Peran standar seperti Pengguna Datastore dan Pelihat Datastore menyertakan izin yang diperlukan. Jika Anda membuat peran IAM kustom, Anda mungkin perlu memperbaruinya untuk menyertakan izin di atas.
Jika sebelumnya Anda menentukan peran khusus untuk Datastore, peran tersebut mungkin tidak memiliki izin datastore.databases.getMetadata
. Pastikan akses
terus berlanjut dengan memperbarui peran kustom Anda dengan datastore.databases.getMetadata
atau
menggunakan peran standar.
Mengaktifkan API melalui Terraform
Jika mau, Anda juga dapat mengaktifkan Firestore API melalui Terraform:
resource "google_project_service" "firestore" { project = "project" service = "firestore.googleapis.com" }
Jika memiliki resource google_firestore_database
, Anda dapat menambahkan
dependensi pada resource google_project_service
untuk memastikan bahwa
API diaktifkan sebelum Terraform mencoba membuat database:
resource "google_firestore_database" "database" { // ... depends_on = [google_project_service.firestore] }