Perlu diperhatikan bahwa Anda sedang melihat dokumentasi Looker. Untuk melihat dokumentasi Looker Studio, buka https://support.google.com/looker-studio.

Migrasi mandiri dari Looker (asli) ke Looker (Google Cloud core)

Dokumen ini menguraikan langkah-langkah teknis untuk memigrasikan instance Looker yang ada dari lingkungan Looker (asli) ke Looker (Google Cloud core).

Looker (Google Cloud core) adalah lingkungan deployment yang terintegrasi secara mendalam dengan platform Google Cloud. Looker (Google Cloud core) dihosting di infrastruktur Google Cloud; Anda dapat mengelolanya langsung melalui konsol Google Cloud; dan memiliki integrasi mendalam dengan banyak produk, layanan, dan kemampuan Google Cloud lainnya.

Sebelum memulai

Pahami prinsip-prinsip dan alat Google Cloud dengan meninjau dokumentasi berikut:

Hubungi perwakilan akun Anda untuk menanyakan migrasi dan apakah instance Looker (asli) Anda memenuhi syarat atau tidak. Jika instance Anda memenuhi syarat, dan jika Anda telah mengupgrade kontrak Looker (asli) yang ada untuk mencakup Looker (Google Cloud core), Anda dapat menyelesaikan langkah-langkah dalam dokumen ini untuk memigrasikan instance Anda.
Untuk mendapatkan izin yang Anda perlukan untuk mempersiapkan migrasi, minta administrator Anda untuk memberi Anda peran IAM berikut di project Google Cloud tempat instance Looker (Google Cloud core) akan berada:
- Buat instance Looker (Google Cloud core): Admin Looker (roles/looker.admin).
- Tetapkan peran IAM dalam project Google Cloud Anda: Project IAM Admin (roles/resourcemanager.projectIamAdmin).
- Buat bucket Cloud Storage: Storage Admin (roles/storage.admin).
Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.
Untuk mengelola instance Looker (asli) sebagai persiapan untuk migrasi, Anda harus memiliki peran Looker Admin dalam instance tersebut.
Buat instance Looker "kosong" (inti Google Cloud) yang baru.

Pastikan Anda memilih edisi yang tepat, jenis koneksi jaringan (IP publik atau IP pribadi), dan atribut konfigurasi lainnya (CMEK, VPC-SC) untuk instance Looker (Google Cloud core) baru Anda guna memastikan bahwa instance tersebut memiliki kemampuan yang diperlukan. Beberapa fitur di Looker (Google Cloud core) bergantung pada edisi yang dipilih atau jenis jaringan yang dipilih.

Biarkan instance "kosong"; jangan mengisinya dengan data apa pun seperti file model, pengguna, koneksi, Jelajah, dasbor, atau folder. Selama langkah impor, setelan atau konten apa pun akan dihapus total dan diganti dengan data dari migrasi.

Namun, atribut konfigurasi Looker (Google Cloud core) yang ditentukan melalui Konsol Google Cloud, atau yang hanya dapat ditentukan selama pembuatan instance, tidak akan ditimpa selama proses migrasi.

Ringkasan

Pada tingkat tinggi, proses migrasi terdiri dari langkah-langkah berikut.

Pastikan instance Looker (asli) Anda siap untuk dimigrasikan.
Ekspor data dari instance Looker (asli).
Impor data ke instance Looker (inti Google Cloud) yang "kosong" dan baru.
Selesaikan penyiapan instance Looker (Google Cloud core).
Nonaktifkan instance Looker (asli).

Bagian berikut memberikan detail tentang setiap langkah.

Memastikan instance Looker (asli) Anda siap untuk dimigrasikan

Instance Looker (asli) Anda harus memenuhi prasyarat berikut agar memenuhi syarat untuk migrasi:

Instance Looker (asli) Anda harus dikelola oleh Google (dengan kata lain, tidak dihosting oleh pelanggan) dan dihosting di Google Cloud atau Amazon Web Services.
Instance Looker (asli) Anda harus menggunakan versi dalam satu rilis bulanan dari versi Looker (Google Cloud core) saat ini. Untuk menemukan versi Looker (Google Cloud core) saat ini, lihat catatan rilis Looker dan temukan pengumuman deployment terbaru.

Catatan: Instance Looker (asli) dalam program Extended Support Release (ESR) tidak dapat dimigrasikan hingga diupgrade ke versi yang kompatibel.

Selain itu, lakukan aktivitas berikut sebelum migrasi:

Ada serangkaian kecil perbedaan fitur antara Looker (asli) dan Looker (Google Cloud core). Tinjau perbedaan ini untuk memastikan bahwa fitur di Looker (Google Cloud core) memenuhi kebutuhan Anda yang berkelanjutan.

Tips: Sebaiknya nonaktifkan fitur di instance Looker (asli) yang tidak memiliki fitur setara di Looker (Google Cloud core)—misalnya, fitur lama dan fitur Lab—selama beberapa waktu sebelum migrasi, untuk memastikan Anda dapat beroperasi tanpa fitur tersebut.
Migrasi menyalin semua project Mode Produksi dan file model yang ada di dalamnya, tetapi bukan project Mode Pengembangan milik pengguna individu. Untuk memastikan bahwa file Mode Pengembangan ditransfer melalui migrasi, Anda harus meng-commit semua file di semua project Mode Pengembangan ke repositori Git sebelum memulai migrasi.

Catatan: Jika instance Anda menggunakan repositori kosong, repositori ini akan disalin ke instance Looker (Google Cloud core), dan tidak digunakan bersama antara instance Looker (asli) dan Looker (inti Google Cloud).
Looker (Google Cloud core) hanya mendukung metode autentikasi Google OAuth, SAML, dan OpenID Connect.
- Jika instance Looker (asli) Anda menggunakan metode autentikasi yang berbeda (misalnya, email dan sandi, LDAP, dll.), Anda harus mengonversi semua pengguna ke metode autentikasi yang didukung oleh Looker (Google Cloud core).
- Jika instance Looker (asli) Anda sudah menggunakan Google OAuth, semua data pengguna akan ditransfer, tetapi Anda tetap harus membuat izin IAM secara manual untuk pengguna dalam project instance Looker (Google Cloud core) Anda.
- Jika instance Looker (asli) Anda menggunakan SAML, setelan Gabungkan pengguna menggunakan di halaman panel Admin autentikasi SAML harus disetel ke Google atau OIDC untuk menghindari error saat Anda menguji autentikasi SAML.
- Jika instance Looker (asli) Anda menggunakan OIDC, setelan Gabungkan pengguna menggunakan di halaman panel Admin Autentikasi OpenID Connect harus ditetapkan ke Google atau SAML untuk menghindari error saat Anda menguji autentikasi OpenID Connect.
- Jika menggunakan penyedia identitas eksternal, Anda harus memperbarui URL callback di penyedia identitas ke URL Looker (Google Cloud core) untuk mengizinkan autentikasi ke instance Looker (Google Cloud core) baru.
- Jika instance Looker (Google Cloud core) Anda akan menggunakan SAML atau OpenID Connect sebagai metode autentikasi, sebaiknya siapkan juga Google OAuth, yang berfungsi sebagai metode autentikasi cadangan untuk Looker (Google Cloud core).
- Jika Anda akan menggunakan domain kustom dengan instance Looker (Google Cloud core), jangan menyiapkan SAML atau OpenID Connect untuk instance tersebut hingga domain kustom diaktifkan.
Selama migrasi, dua instance Looker—satu Looker (asli), satu Looker (Google Cloud core)—akan berjalan secara paralel selama beberapa periode waktu. Setiap aktivitas otomatis yang berlangsung (seperti pemberitahuan dan laporan terjadwal, serta aktivitas latar belakang yang mengakses database backend) dapat diduplikasi. Untuk menghindari aktivitas duplikat, hapus pemberitahuan dan jadwal otomatis di instance Looker (asli) atau Looker (Google Cloud core).

Mengekspor data dari instance Looker (asli) Anda

Ada dua langkah untuk mengekspor data dari instance Looker (asli) Anda:

Buat tempat untuk menyimpan data migrasi.
Memulai ekspor.

Buat tempat untuk menyimpan data migrasi

Lakukan semua operasi berikut di project Google Cloud yang sama dengan tempat Anda membuat instance Looker (Google Cloud core).

Buat bucket Cloud Storage baru (misalnya, <bucket-name>).
- Bucket ini akan digunakan untuk menyimpan data migrasi.
- Ikuti petunjuk di halaman dokumentasi Membuat bucket.
- Perhatikan bahwa <bucket-name> harus unik di seluruh Google Cloud. Sebaiknya awali nama bucket dengan ID unik, seperti project ID Anda.
Tentukan nama untuk folder di dalam bucket Cloud Storage (misalnya, <folder-name>). Jangan buat folder sekarang. Tentukan nama folder selama permintaan ekspor. URL akan dibuat secara otomatis selama proses ekspor.
Buat key ring dan kunci di Cloud KMS (misalnya, <kms_keyring_id> dan <kms-key-id>).
- Kunci ini akan digunakan untuk mengenkripsi data migrasi. Karena kunci ini adalah kunci KMS, Anda hanya perlu mengungkapkan nama kunci, bukan kunci itu sendiri, ke halaman Export di panel Admin Looker (asli).
- Ikuti petunjuk di halaman dokumentasi Membuat key ring dan Membuat kunci.
Buat akun layanan baru khusus untuk migrasi (misalnya, <export-service-account>).
- Akun ini bukan akun layanan yang sama dengan akun layanan Looker.
- Ikuti petunjuk di halaman dokumentasi Membuat akun layanan.
Berikan dua peran IAM spesifik kepada <export-service-account>:
- Storage Object Creator di bucket Cloud Storage
- Cloud KMS CryptoKey Encrypter di kunci KMS
- Ikuti petunjuk di halaman dokumentasi Menggunakan izin IAM (Cloud Storage) dan Kontrol akses dengan IAM (KMS).
Catatan: Peran yang baru saja dijelaskan memberikan izin minimum yang diperlukan untuk mengekspor data.
Buat kunci akun layanan yang terkait dengan <export-service-account>, lalu download file kunci JSON.
- Ikuti petunjuk di halaman dokumentasi Membuat dan menghapus kunci akun layanan.
Perhatian: Lindungi file kunci JSON dengan cermat. File ini berisi kunci cleartext yang memungkinkan siapa saja yang memiliki file ini untuk menggunakan semua izin yang terkait dengan akun layanan.

Meminta ekspor

Setelah memastikan bahwa instance Anda siap untuk dimigrasikan, membuat instance Looker (inti Google Cloud) yang "kosong", dan membuat tempat untuk menyimpan data migrasi, masukkan informasi berikut ke halaman Ekspor di panel Admin instance Looker (asli):

Nama bucket Cloud Storage yang Anda buat.
Nama folder Cloud Storage - folder dengan nama ini akan dibuat otomatis selama ekspor. Setelah ekspor selesai, file ekspor akan muncul di subfolder yang diberi stempel waktu dalam folder ini di bucket Cloud Storage yang Anda buat.
Nama kunci KMS.
Teks JSON yang berisi kunci akun layanan.

Setelah memasukkan informasi di halaman Ekspor, klik Minta Ekspor untuk memulai ekspor.

Proses ekspor memerlukan waktu beberapa menit hingga jam. Setelah ekspor selesai, Anda akan melihat beberapa file ekspor (dalam format yang tidak dapat dibaca manusia) di bucket dan folder Cloud Storage Anda. File ini adalah input untuk langkah impor berikut.

Mengimpor data ke instance Looker (inti Google Cloud) yang "kosong" dan baru

Setelah data instance diekspor, Anda dapat mengimpornya ke instance Looker (Google Cloud core).

Ikuti petunjuk di halaman Mengimpor data dari Cloud Storage ke instance Looker (Google Cloud core), dengan mengarahkan perintah ke bucket dan folder tempat file ekspor ditempatkan.

Secara ringkas, hal ini mencakup:

Memberikan peran berikut untuk akses ke bucket dan kunci KMS ke akun layanan Looker (bukan <export-service-account>):
- Storage Object User di bucket Cloud Storage
- Cloud KMS CryptoKey Decrypter di kunci KMS
Memicu impor melalui Konsol Google Cloud atau gcloud CLI

Operasi impor memerlukan waktu beberapa menit hingga jam. Setelah selesai, instance Looker (Google Cloud core) Anda akan dimulai ulang, dengan semua data yang dimigrasikan.

Menyelesaikan penyiapan instance Looker (Google Cloud core)

Pada tahap ini, admin Looker dapat membuka URL instance dan login ke instance untuk menyelesaikan penyiapan.

Proses migrasi akan menyalin sebanyak mungkin konfigurasi instance Looker (asli). Namun, beberapa item tidak dapat dimigrasikan, atau berfungsi agak berbeda di Looker (Google Cloud core), dan harus disesuaikan.

Beberapa item yang diketahui memerlukan perhatian khusus antara lain sebagai berikut:

Setelan Umum (di panel Looker Admin)	Sebagian besar Setelan Umum (dan setelan lain di seluruh panel Admin) tidak disalin secara otomatis, karena cenderung berbeda atau tidak ada dalam formulir yang sama di Looker (Google Cloud core). Anda harus meninjau dan mengonfigurasi semua setelan dengan cermat dalam konteks konfigurasi Looker (inti Google Cloud) yang Anda pilih. Lihat halaman dokumentasi Mengelola instance Looker (Google Cloud core) dari Looker dan halaman dokumentasi Mengelola instance Looker (Google Cloud core) dari Konsol Google Cloud untuk mengetahui informasi selengkapnya tentang setelan di Looker (Google Cloud core).
Pengguna	Looker (Google Cloud core) hanya mendukung metode autentikasi Google OAuth, SAML, dan OpenID Connect. Jika instance Looker (asli) juga dikonfigurasi untuk Google OAuth, data pengguna dan atributnya akan disalin (selama terkait dengan ID dan alamat email Google yang sama di kedua kasus tersebut). Admin Project IAM harus memberikan peran IAM Pengguna Looker atau Looker Instance User kepada setiap pengguna di project Google Cloud tempat instance berada. Jika instance Looker (asli) dikonfigurasi untuk SAML atau OpenID Connect, pastikan kolom Gabungkan pengguna menggunakan untuk metode autentikasi hanya menunjukkan metode autentikasi yang didukung oleh Looker (Google Cloud core). Jika beberapa pengguna instance Looker (asli) melakukan autentikasi melalui mekanisme yang tidak didukung di Looker (Google Cloud core) (seperti LDAP atau email/sandi), akun pengguna tersebut harus dibuat ulang dan dikonversi ke metode autentikasi yang didukung.
Koneksi database	Looker (Google Cloud core) mendukung kumpulan dialek database yang sedikit berbeda dengan Looker (asli). Semua properti konfigurasi untuk koneksi database (termasuk string koneksi dan sandi, jika ada) akan disalin. Namun, topologi jaringan yang berbeda di Looker (Google Cloud core) dapat menyebabkan koneksi database tidak langsung berfungsi. Misalnya, jika database diakses melalui firewall atau tunnel yang khusus untuk instance Looker (asli), Anda mungkin perlu mengonfigurasi ulang firewall atau tunnel. Anda harus menguji setiap koneksi dan membuatnya kembali jika perlu.
Koneksi repositori Git	Jika instance menggunakan repositori Git kosong, instance tersebut akan berfungsi tanpa modifikasi (disalin, tetapi tidak dibagikan). Namun, jika instance terhubung ke repositori jarak jauh, koneksi tersebut mungkin perlu diverifikasi dan diaktifkan kembali, mirip dengan koneksi database.
Konfigurasi jaringan lainnya	Instance Looker dapat memiliki jenis koneksi jaringan lain, baik masuk maupun keluar (misalnya, dalam konteks IP pribadi, Action Hub, Marketplace, email, dll.). Koneksi jaringan ini juga harus diverifikasi.
URL untuk mengakses instance Looker (Google Cloud core)	Instance Looker (Google Cloud core) dilengkapi dengan URL utama yang ditetapkan secara acak. Jika instance perlu diakses melalui URL tertentu, Anda dapat mengonfigurasi domain kustom.
Jadwal dan Pemberitahuan	Jika instance Looker (asli) dan Looker (Google Cloud core) aktif secara bersamaan, keduanya dapat membuat pemberitahuan dan tindakan terjadwal duplikat, serta melakukan operasi latar belakang duplikat yang mengakses database yang terhubung. Aktivitas ini harus dinonaktifkan di salah satu instance segera setelah dapat dilakukan.
Masa pemeliharaan	Tidak seperti di Looker (asli), kebijakan pemeliharaan dapat ditentukan untuk Looker (Google Cloud core).
Aktivitas Sistem Elit	Data Aktivitas Sistem Elite tidak disalin sebagai bagian dari migrasi. Instance Looker (Google Cloud core) akan dimulai dengan histori baru.
Domain kustom	Anda dapat membuat domain kustom untuk instance Looker (Google Cloud core). Anda harus menetapkan data DNS untuk memastikan deployment sertifikat SSL. Selain itu, pastikan untuk memperbarui URL callback di klien autentikasi Anda menjadi domain kustom setelah domain kustom Anda diaktifkan dan metode autentikasi Anda disiapkan. Domain kustom tidak dapat dibuat untuk Looker (Google Cloud core) menggunakan domain `looker.com`. Jika Anda ingin membuat domain kustom untuk instance Looker (Google Cloud core) menggunakan URL kustom dari instance Looker (asli), domain kustom harus disiapkan setelah migrasi selesai dan setelah Anda mengonfirmasi bahwa instance Looker (Google Cloud core) siap digunakan. Setelah domain kustom diaktifkan, pengguna akan melihat instance Looker (Google Cloud core) dan bukan instance Looker (asli) saat mengunjungi URL instance. Jangan menyiapkan SAML atau OpenID Connect untuk instance Looker (Google Cloud core) hingga instance siap digunakan, data DNS telah diperbarui, dan domain kustom telah diaktifkan.
Bookmark	Jika Anda menggunakan URL kustom di instance Looker (asli) (yang tidak menggunakan domain `looker.com`), proses migrasi ini akan mempertahankan bookmark pengguna jika Anda membuat domain kustom untuk instance Looker (Google Cloud core) menggunakan URL yang sama dengan instance Looker (asli). Setelah domain kustom diaktifkan, bookmark ke konten Looker (asli) seperti `https://www.yourcustomdomain.com/dashboard/123` akan mengarah ke konten dalam instance Looker (Google Cloud core). (Catatan: Edisi Enterprise dan Embed dari Looker (Google Cloud core) menggunakan slug konten alfanumerik di URL-nya, bukan ID konten numerik, tetapi bookmark dengan ID konten akan tetap dialihkan dengan benar ke konten yang sama.) Proses ini tidak dapat digunakan dengan URL Looker (asli) yang menggunakan domain `looker.com`.

Ini bukan merupakan daftar lengkap. Uji semua aspek instance yang paling penting bagi Anda, sebelum mempertimbangkan bahwa migrasi selesai.

Setelah migrasi selesai dan Anda yakin tidak akan memerlukan ekspor lagi, Anda dapat menghapus <export-service-account> yang telah dibuat sebelumnya, yang akan merender kunci JSON yang dibagikan untuknya menjadi tidak berguna.

Menonaktifkan instance Looker (asli)

Setelah instance Looker (Google Cloud core) yang dimigrasikan berfungsi dengan baik, Anda dapat mengirimi pengguna URL untuk instance tersebut dan meminta mereka untuk mulai mengaksesnya dan berhenti mengakses instance Looker (asli).

Pemecahan masalah

Bagian berikut dapat membantu Anda menyelesaikan masalah selama proses impor atau ekspor.

Masalah selama ekspor

Jika ada masalah dengan ekspor data Looker (asli), status ERROR akan muncul di halaman Export di panel Admin. Mengklik status ERROR akan menampilkan pesan error.

Sumber error umum adalah sebagai berikut:

Bucket Cloud Storage, kunci KMS, atau <export-service-account> tidak valid.
<export-service-account> tidak memiliki izin yang diperlukan.

Sebaiknya konfirmasi status objek ini sebelum mengirimkan permintaan ekspor.

Masalah saat mengimpor

Jika operasi impor tidak selesai setelah empat jam (atau mungkin lebih jika instance sumbernya sangat besar), atau jika terjadi error, Anda mungkin perlu membuka tiket dengan Cloud Customer Care untuk mengatasi masalah tersebut. Relatif terdapat sedikit diagnostik yang langsung terlihat oleh pelanggan untuk operasi ini.