Membuat instance Private Service Connect Looker (Google Cloud core)

console

1. Buka halaman produk Looker (Google Cloud core) dari project Anda di konsol Google Cloud. Jika Anda telah membuat instance Looker (Google Cloud core) dalam project ini, halaman Instances akan terbuka.

   Buka Looker (Google Cloud core)

2. Klik CREATE INSTANCE.
3. Di bagian Instance name, berikan nama untuk instance Looker (Google Cloud core) Anda. Nama instance tidak dikaitkan dengan URL instance Looker (Google Cloud core) setelah dibuat. Nama instance tidak dapat diubah setelah pembuatan instance.
4. Di bagian OAuth Application Credentials, masukkan client ID OAuth dan secret OAuth yang Anda buat saat menyiapkan klien OAuth.

5. Di bagian Region, pilih opsi yang sesuai dari menu drop-down untuk menghosting instance Looker (Google Cloud core) Anda. Pilih region yang cocok dengan region dalam kontrak langganan, yaitu tempat kuota untuk project Anda dialokasikan. Region yang tersedia tercantum di halaman dokumentasi Lokasi Looker (Google Cloud Core).

   Anda tidak dapat mengubah region setelah instance dibuat.

6. Di bagian Edisi, pilih opsi edisi Enterprise atau Sematkan (produksi atau non-produksi). Jenis edisi memengaruhi beberapa fitur yang tersedia untuk instance. Pastikan Anda memilih jenis edisi yang sama seperti yang tercantum dalam kontrak tahunan dan Anda telah mengalokasikan kuota untuk jenis edisi tersebut.

   • Enterprise: Platform Looker (inti Google Cloud) dengan fitur keamanan yang ditingkatkan untuk menangani berbagai kasus penggunaan BI dan analisis internal
   • Penyematan: Platform Looker (inti Google Cloud) untuk men-deploy dan memelihara analisis eksternal yang andal dan aplikasi kustom dalam skala besar
   • Edisi non-produksi: Jika Anda menginginkan lingkungan penahapan dan pengujian, pilih salah satu edisi non-produksi. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Instance non-produksi.

   Edisi tidak dapat diubah setelah pembuatan instance. Jika ingin mengubah edisi, Anda dapat menggunakan impor dan ekspor untuk memindahkan data instance Looker (Google Cloud core) ke instance baru yang dikonfigurasi dengan edisi yang berbeda.

7. Di bagian Sesuaikan instance Anda, klik TAMPILKAN OPSI KONFIGURASI untuk menampilkan grup setelan tambahan yang dapat Anda sesuaikan untuk instance.

8. Di bagian Koneksi, pada Penetapan IP instance, pilih IP Pribadi saja atau IP Pribadi dan IP Publik. Jenis koneksi jaringan yang Anda pilih memengaruhi fitur Looker yang tersedia untuk instance. Opsi koneksi jaringan berikut tersedia:

   • IP Publik: Menetapkan alamat IP eksternal yang dapat diakses internet.
   • IP Pribadi: Menetapkan alamat IP internal yang ditentukan pelanggan yang dapat diakses di Virtual Private Cloud (VPC) untuk ingress. Untuk berkomunikasi dengan workload VPC dan lokal atau multi-cloud, Anda harus men-deploy lampiran layanan untuk traffic keluar. Jika ingin menggunakan Kontrol Layanan VPC, Anda hanya boleh memilih IP Pribadi.

   • IP Pribadi dan IP Publik: Traffic masuk menggunakan IP publik, dan respons juga bersifat publik. Traffic yang dimulai oleh Looker (Google Cloud core) menggunakan IP pribadi untuk perutean keluar. Instance Looker (Google Cloud core) tidak akan menggunakan IP publik untuk memulai traffic keluar yang terikat ke internet.

9. Di bagian Jenis IP Pribadi, pilih Private Service Connect (PSC).

10. Jika Anda membuat instance yang hanya menggunakan IP pribadi, tetapkan setidaknya satu VPC yang diizinkan yang akan diberi akses ke utara ke dalam instance. Di bagian VPC yang diizinkan, klik Tambahkan Item untuk menambahkan setiap VPC. Di kolom Project, pilih project tempat jaringan dibuat. Di menu drop-down Network, pilih jaringan.

    Jika Anda memilih IP Pribadi dan IP Publik di bagian Koneksi, bagian VPC yang Diizinkan tidak akan muncul. Anda dapat menyiapkan akses ke instance melalui URL web instance.

11. Di bagian Encryption, Anda dapat memilih jenis enkripsi yang akan digunakan di instance Anda. Opsi enkripsi berikut tersedia:

    • Google-managed encryption key: Opsi ini adalah opsi default dan tidak memerlukan konfigurasi tambahan.
    • Kunci enkripsi yang dikelola pelanggan (CMEK): Lihat halaman dokumentasi Menggunakan kunci enkripsi yang dikelola pelanggan dengan Looker (inti Google Cloud) untuk mengetahui informasi selengkapnya tentang CMEK dan cara mengonfigurasinya selama pembuatan instance. Jenis enkripsi tidak dapat diubah setelah pembuatan instance.
    • Mengaktifkan Enkripsi Tervalidasi FIPS 140-2: Lihat halaman dokumentasi Mengaktifkan kepatuhan FIPS 140-2 level 1 di instance Looker (Google Cloud core) untuk mengetahui informasi selengkapnya tentang dukungan FIPS 140-2 di Looker (Google Cloud core).

12. Di bagian Periode Pemeliharaan, Anda dapat menentukan hari dan jam saat Looker (inti Google Cloud) menjadwalkan pemeliharaan. Masa pemeliharaan berlangsung selama satu jam. Secara default, opsi Periode Pilihan di Periode Pemeliharaan ditetapkan ke Periode apa pun.

13. Di bagian Tolak Periode Pemeliharaan, Anda dapat menentukan blok hari saat Looker (inti Google Cloud) tidak menjadwalkan pemeliharaan. Periode pemeliharaan penolakan dapat berlangsung hingga 60 hari. Anda harus memberikan waktu minimal 14 hari dari waktu pemeliharaan di antara 2 periode penolakan pemeliharaan.

14. Di bagian Gemini di Looker, Anda dapat secara opsional menyediakan fitur Gemini di Looker untuk instance Looker (Google Cloud core). Untuk mengaktifkan Gemini di Looker, pilih Gemini, lalu pilih Fitur Penguji Tepercaya. Jika Fitur Penguji Tepercaya diaktifkan, pengguna dapat mengakses kemampuan Penguji Tepercaya Gemini di Looker. Anda dapat meminta akses ke kemampuan Penguji Tepercaya non-publik melalui formulir pratinjau Gemini di Looker untuk tiap-tiap pengguna. Anda harus mengaktifkan setelan ini untuk menggunakan Gemini selama pratinjau pra-GA. Secara opsional, pilih Penggunaan data Penguji Tepercaya. Jika setelan ini diaktifkan, Anda mengizinkan data Anda digunakan oleh Google sebagaimana dijelaskan dalam persyaratan Program Penguji Tepercaya Gemini untuk Google Cloud . Untuk menonaktifkan Gemini untuk instance Looker (Google Cloud core), hapus setelan Gemini.

15. Klik Buat.

gcloud

Untuk membuat instance Private Service Connect, jalankan perintah gcloud looker instances create dengan semua tanda berikut:

gcloud looker instances create INSTANCE_NAME \
--psc-enabled \
--oauth-client-id=OAUTH_CLIENT_ID \
--oauth-client-secret=OAUTH_CLIENT_SECRET \
--region=REGION \
--edition=EDITION \
[--psc-allowed-vpcs=ALLOWED_VPC,ADDITIONAL_ALLOWED_VPCS]
[--no-public-ip-enabled]
[--public-ip-enabled]
--async

Ganti kode berikut:

• INSTANCE_NAME: nama untuk instance Looker (Google Cloud core) Anda; nama ini tidak terkait dengan URL instance.
• OAUTH_CLIENT_ID dan OAUTH_CLIENT_SECRET: client ID OAuth dan secret OAuth yang Anda buat saat menyiapkan klien OAuth. Setelah instance dibuat, masukkan URL instance di bagian Authorized redirect URIs pada klien OAuth.
• REGION: region tempat instance Looker (Google Cloud core) Anda dihosting. Pilih region yang cocok dengan region dalam kontrak langganan. Region yang tersedia tercantum di halaman dokumentasi Lokasi Looker (Google Cloud Core).
• EDITION: edisi dan jenis lingkungan (produksi atau non-produksi) untuk instance. Nilai yang mungkin adalah core-enterprise-annual, core-embed-annual, nonprod-core-enterprise-annual, atau nonprod-core-embed-annual. Edisi tidak dapat diubah setelah pembuatan instance. Jika ingin mengubah edisi, Anda dapat menggunakan impor dan ekspor untuk memindahkan data instance Looker (Google Cloud core) ke instance baru yang dikonfigurasi dengan edisi yang berbeda.

• ALLOWED_VPC: Jika Anda membuat instance yang hanya menggunakan IP pribadi, cantumkan VPC yang akan diizinkan akses northbound (ingress) ke Looker (inti Google Cloud). Untuk mengakses instance dari luar VPC tempat instance berada, Anda harus mencantumkan setidaknya satu VPC. Tentukan VPC menggunakan salah satu format berikut:

  • projects/{project}/global/networks/{network}
  • https://www.googleapis.com/compute/v1/projects/{project}/global/networks/{network}

  Jika Anda membuat instance yang menggunakan IP pribadi dan IP publik, Anda tidak perlu menyetel VPC yang diizinkan.

• ADDITIONAL_ALLOWED_VPCS: VPC tambahan yang akan diizinkan akses ke Looker (inti Google Cloud) dapat ditambahkan ke flag --psc-allowed-vpcs dalam daftar yang dipisahkan koma.

Anda juga harus menyertakan salah satu tanda berikut untuk mengaktifkan atau menonaktifkan IP publik:

• --public-ip-enabled mengaktifkan IP publik. Jika Anda mengaktifkan IP publik untuk instance, traffic masuk akan dirutekan melalui IP publik, dan traffic keluar akan dirutekan melalui Private Service Connect.
• --no-public-ip-enabled menonaktifkan IP publik.

Jika mau, Anda dapat menambahkan parameter lainnya untuk menerapkan setelan instance lainnya:

  [--maintenance-window-day=MAINTENANCE_WINDOW_DAY
          --maintenance-window-time=MAINTENANCE_WINDOW_TIME]
  [--deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE
          --deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE
          --deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME]
  --kms-key=KMS_KEY_ID
  [--fips-enabled]
  

• MAINTENANCE_WINDOW_DAY: harus berupa salah satu dari berikut: friday, monday, saturday, sunday, thursday, tuesday, wednesday. Lihat halaman dokumentasi Mengelola kebijakan pemeliharaan untuk Looker (inti Google Cloud) untuk mengetahui informasi selengkapnya tentang setelan periode pemeliharaan.
• MAINTENANCE_WINDOW_TIME dan DENY_MAINTENANCE_PERIOD_TIME: harus dalam UTC dengan format 24 jam (misalnya, 13:00, 17:45).
• DENY_MAINTENANCE_PERIOD_START_DATE dan DENY_MAINTENANCE_PERIOD_END_DATE: harus dalam format YYYY-MM-DD.
• KMS_KEY_ID: harus berupa kunci yang dibuat saat menyiapkan kunci enkripsi yang dikelola pelanggan (CMEK).

Anda dapat menyertakan tanda --fips-enabled untuk mengaktifkan kepatuhan terhadap FIPS 140-2 level 1.

Proses pembuatan instance Private Service Connect berbeda dengan proses pembuatan instance Looker (Google Cloud core) (akses layanan pribadi) dengan cara berikut:

• Dengan penyiapan Private Service Connect, flag --consumer-network dan --reserved-range tidak diperlukan.
• Instance Private Service Connect memerlukan tanda tambahan: --psc-enabled.

• Tanda --psc-allowed-vpcs adalah daftar VPC yang dipisahkan koma. Anda dapat menentukan VPC sebanyak yang Anda inginkan dalam daftar.

console

Saat instance dibuat, Anda dapat melihat statusnya di halaman Instances dalam konsol. Anda juga dapat melihat aktivitas pembuatan instance dengan mengklik ikon notifikasi di menu konsol Google Cloud . Di halaman Details untuk instance, statusnya akan menampilkan Active setelah dibuat.

gcloud

Untuk memeriksa status, gunakan perintah gcloud looker instances describe:

gcloud looker instances describe INSTANCE_NAME --region=REGION

Ganti kode berikut:

• INSTANCE_NAME: nama instance Looker (Google Cloud core) Anda.
• REGION: region tempat instance Looker (Google Cloud core) Anda dihosting.

Instance siap setelah mencapai status ACTIVE.

console

1. Di halaman Instances, klik nama instance yang ingin Anda aktifkan koneksi southbound (keluar).
2. Klik Edit.
3. Luaskan bagian Connections.
4. Untuk mengedit lampiran layanan yang ada, perbarui nama domain yang sepenuhnya memenuhi syarat dari layanan di kolom FQDN Lokal dan URI lampiran layanan di kolom URI Lampiran Layanan Target.
5. Untuk menambahkan lampiran layanan baru, klik Tambahkan Item. Kemudian, masukkan nama domain yang sepenuhnya memenuhi syarat dari layanan di kolom Local FQDN dan URI lampiran layanan di kolom Target Service Attachment URI.
6. Klik Simpan.

gcloud

Gunakan flag --psc-service-attachment untuk mengaktifkan koneksi southbound (keluar) ke layanan eksternal yang telah Anda siapkan Private Service Connect-nya:

gcloud looker instances update INSTANCE_NAME \
--psc-service-attachment  domain=DOMAIN_1,attachment=SERVICE_ATTACHMENT_URI_1 \
--psc-service-attachment domain=DOMAIN_2,attachment=SERVICE_ATTACHMENT_URI_2 \
--region=REGION

Ganti kode berikut:

• INSTANCE_NAME: nama instance Looker (Google Cloud core) Anda.

• DOMAIN_1 dan DOMAIN_2: Jika Anda terhubung ke layanan publik, gunakan nama domain layanan. Jika Anda terhubung ke layanan pribadi, gunakan nama domain yang sepenuhnya memenuhi syarat pilihan Anda. Batasan berikut berlaku untuk nama domain:

• Setiap koneksi ke selatan mendukung satu domain.

• Nama domain harus terdiri dari minimal tiga bagian. Misalnya, mydomain.github.com dapat diterima, tetapi github.com tidak dapat diterima.

• Bagian terakhir nama tidak boleh berupa salah satu dari berikut:

  • googleapis.com
  • google.com
  • gcr.io
  • pkg.dev

  Saat menyiapkan koneksi ke layanan dari dalam instance Looker (inti Google Cloud), gunakan domain ini sebagai alias untuk layanan Anda.

• SERVICE_ATTACHMENT_1 dan SERVICE_ATTACHMENT_2: URI lampiran layanan lengkap untuk layanan yang dipublikasikan yang Anda hubungkan. Setiap URI lampiran layanan dapat diakses oleh satu domain.

• REGION: region tempat instance Looker (Google Cloud core) Anda dihosting.

Jika Anda terhubung ke layanan terkelola non-Google di region selain region tempat instance Looker (inti Google Cloud) Anda berada, aktifkan akses global di load balancer produsen.

console

Lihat status koneksi di tab Detail pada halaman konfigurasi instance di konsol. Kolom Status Koneksi menampilkan status untuk setiap lampiran layanan target.

gcloud

Jalankan perintah gcloud looker instances describe --format=json untuk memeriksa status koneksi southbound. Setiap lampiran layanan harus diisi dengan kolom connection_status.

console

1. Di halaman Instances, klik nama instance yang ingin Anda perbarui VPC yang diizinkan untuk mengakses instance dari utara.
2. Klik Edit.
3. Luaskan bagian Connections.
4. Untuk menambahkan VPC baru, klik Tambahkan Item. Kemudian, pilih project yang berisi VPC di kolom Project, dan pilih jaringan dari menu drop-down Network.
5. Untuk menghapus VPC, klik ikon tempat sampah Hapus item yang muncul saat Anda mengarahkan kursor ke jaringan.
6. Klik Simpan.

gcloud

Gunakan flag --psc-allowed-vpcs untuk memperbarui daftar VPC yang telah diberi otorisasi akses ke utara ke instance.

Saat memperbarui VPC yang diizinkan, Anda harus menentukan seluruh daftar yang ingin diberlakukan setelah pembaruan. Misalnya, anggaplah VPC ALLOWED_VPC_1 sudah diizinkan, dan Anda ingin menambahkan VPC ALLOWED_VPC_2. Untuk menambahkan VPC ALLOWED_VPC_1 sambil memastikan bahwa VPC ALLOWED_VPC_2 terus diizinkan, tambahkan flag --psc-allowed-vpcs sebagai berikut:

gcloud looker instances update INSTANCE_NAME \
--psc-allowed-vpcs=ALLOWED_VPC_1,ALLOWED_VPC_2 --region=REGION

Ganti kode berikut:

• INSTANCE_NAME: nama instance Looker (Google Cloud core) Anda.
• ALLOWED_VPC_1 dan ALLOWED_VPC_2: VPC yang akan diizinkan untuk masuk ke Looker (Google Cloud core). Tentukan setiap VPC yang diizinkan menggunakan salah satu format berikut:
  • projects/{project}/global/networks/{network}
  • https://www.googleapis.com/compute/v1/projects/{project}/global/networks/{network}
• REGION: region tempat instance Looker (Google Cloud core) Anda dihosting.