Membuat URL kustom

Pratinjau — URL kustom

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Halaman ini menjelaskan cara mengonfigurasi dan mengelola URL kustom, sehingga Anda dapat memperoleh URL yang mudah diketik, mudah diingat, dan tersedia secara global untuk layanan Cloud Run Anda, bukan URL deterministik default:

• Format URL kustom: https://CUSTOM_URL_DOMAIN.cloud.run
• Format URL default: https://SERVICE_NAME-PROJECT_NUMBER.REGION.run.app

Dengan menggunakan URL kustom, Anda dapat membagikan layanan tanpa menyiapkan domain kustom, data DNS, atau load balancer eksternal.

Saat menggunakan URL kustom untuk layanan Cloud Run, Anda akan mendapatkan manfaat berikut:

• URL sederhana: Petakan layanan Anda ke format https://CUSTOM_URL_DOMAIN.cloud.run yang bersih.
• Ketersediaan global: URL kustom dapat diakses dari mana saja, sama seperti URL .run.app standar.
• Siklus proses yang fleksibel: Lampirkan, lepaskan, atau pindahkan URL kustom secara fleksibel antar-layanan tanpa men-deploy revisi baru.
• Beberapa pemetaan: Anda dapat memetakan beberapa URL kustom ke satu layanan.

Sebelum memulai

Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

1. Siapkan lingkungan pengembangan Cloud Run di Google Cloud project Anda.
2. Instal dan lakukan inisialisasi gcloud CLI.

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk mengelola URL kustom, minta administrator untuk memberi Anda peran IAM berikut:

• Untuk membuat, memperbarui, atau menghapus pemetaan URL kustom: Admin Cloud Run (roles/run.admin) di project

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Batasan

• Secara default, Anda dapat memetakan hingga 50 domain per project.
• Subdomain URL kustom harus terdiri dari 6 hingga 63 karakter, mematuhi konvensi penamaan DNS standar yang memungkinkan karakter alfanumerik dan tanda hubung, serta tidak boleh diawali atau diakhiri dengan tanda hubung.
• Subdomain tertentu dibatasi.
• Anda tidak dapat menonaktifkan URL kustom untuk sementara seperti yang dapat Anda lakukan dengan URL .run.appdefault. Untuk menghentikan penayangan traffic dari peta tersebut, Anda harus menghapus pemetaan.
• Layanan Cloud Run yang membatasi ingress ke traffic Internal atau Internal dan Cloud Load Balancing tidak didukung.
• Terraform tidak didukung untuk URL kustom. Untuk menghindari potensi perubahan yang merusak, jangan gunakan resource domain_mapping Preview.
• URL kustom sepenuhnya independen. Jika Anda memilih untuk menonaktifkan URL .run.app default untuk layanan, pemetaan URL kustom Anda tetap aktif sepenuhnya dan dapat diakses.

Penting: Google berhak mengelola domainnya, yang mencakup kemampuan untuk mencabut atau menetapkan ulang subdomain untuk mencegah penyalahgunaan, melindungi merek dagang, mengatasi masalah keamanan, atau memenuhi persyaratan operasional atau hukum lainnya.

Melampirkan atau memetakan URL kustom ke layanan

Anda dapat melampirkan URL kustom ke layanan baru saat men-deploy-nya, atau memetakan URL kustom ke layanan yang ada menggunakan konsol Google Cloud atau gcloud.

Melampirkan URL kustom ke layanan baru

Saat men-deploy layanan Cloud Run baru, Anda dapat melampirkan URL kustom sebagai bagian dari konfigurasi deployment.

1. Di konsol Google Cloud , buka halaman Cloud Run Services.

   Buka Cloud Run

2. Klik Deploy container.

3. Isi detail konfigurasi dasar untuk layanan Anda.

4. Di bagian URL Kustom, klik Tambahkan URL kustom.

5. Masukkan domain URL kustom yang valid.

6. Opsional. Untuk menambahkan beberapa URL kustom, klik Tambahkan URL kustom lagi.

7. Klik Create.

Memetakan URL kustom ke layanan yang ada

Anda dapat memetakan URL kustom ke layanan Cloud Run yang ada menggunakan konsolGoogle Cloud atau gcloud CLI.

Konsol

1. Di konsol Google Cloud , buka halaman Domain mappings.

   Buka Pemetaan domain

2. Klik Tambahkan URL kustom.

3. Dalam daftar Service, pilih layanan yang ingin Anda petakan.

4. Masukkan domain URL kustom Anda.

5. Klik Lanjutkan.

Jika Anda ingin menambahkan beberapa URL kustom, klik Tambahkan URL kustom lagi dan ikuti langkah-langkah sebelumnya.

gcloud

Untuk membuat pemetaan domain URL kustom untuk layanan yang ada, jalankan perintah berikut:

gcloud beta run domain-mappings create \
    --service=SERVICE_NAME \
    --domain=CUSTOM_URL_DOMAIN.cloud.run

Ganti kode berikut:

• SERVICE_NAME: nama layanan yang Anda petakan ke URL kustom.
• CUSTOM_URL_DOMAIN: subdomain yang ingin Anda lampirkan.

Opsional. Untuk memetakan beberapa URL kustom menggunakan gcloud CLI, jalankan perintah pembuatan pemetaan berulang kali untuk setiap URL kustom:

gcloud beta run domain-mappings create \
    --service=SERVICE_NAME \
    --domain=CUSTOM_URL_DOMAIN_1.cloud.run

gcloud beta run domain-mappings create \
    --service=SERVICE_NAME \
    --domain=CUSTOM_URL_DOMAIN_2.cloud.run

Ganti kode berikut:

• SERVICE_NAME: nama layanan yang Anda deploy.
• CUSTOM_URL_DOMAIN_1: subdomain pertama yang akan dilampirkan.
• CUSTOM_URL_DOMAIN_2: subdomain kedua yang akan dilampirkan.

Jika subdomain yang diminta sudah digunakan oleh pengguna atau layanan lain di seluruh Google Cloud, Anda akan menerima error dan harus memilih target yang unik.

Mencantumkan dan melihat URL kustom

Anda dapat mencantumkan semua URL kustom dan melihat detail pemetaan untuk lingkungan Anda.

Konsol

1. Di konsol Google Cloud , buka halaman Cloud Run.

   Buka Cloud Run

2. Klik nama layanan.

3. Buka tab Networking.

4. Temukan URL terlampir Anda di bagian Domain kustom di bawah label Endpoint.

gcloud

Untuk mencantumkan semua URL kustom dan pemetaan domain dalam project, jalankan perintah berikut:

gcloud beta run domain-mappings list

Untuk melihat detail pemetaan domain URL kustom tertentu, jalankan:

gcloud beta run domain-mappings describe \
    --domain=CUSTOM_URL_DOMAIN.cloud.run

Ganti CUSTOM_URL_DOMAIN dengan subdomain yang ingin Anda deskripsikan.

Mengamankan dengan audiens kustom

Anda dapat melampirkan audiens kustom ke URL kustom untuk membatasi akses.

gcloud beta run services update SERVICE_NAME \
    --add-custom-audiences=CUSTOM_URL_DOMAIN.cloud.run

Ganti kode berikut:

• SERVICE_NAME: nama layanan Anda.
• CUSTOM_URL_DOMAIN: subdomain yang berfungsi sebagai audiens kustom Anda.

Menghapus URL kustom

Peringatan: Jika Anda menghapus pemetaan domain, subdomain akan langsung tersedia untuk diklaim oleh pengguna lain. Sangat disarankan untuk TIDAK menghapus pemetaan domain ini terlalu sering karena risiko pembajakan domain. Anda bertanggung jawab untuk mengelola siklus proses domain ini.

Anda dapat menghapus pemetaan URL kustom jika tidak lagi diperlukan.

Konsol

1. Di konsol Google Cloud , buka halaman Domain mappings.

   Buka Pemetaan domain

2. Centang kotak di samping URL kustom yang ingin Anda hapus.

3. Klik Hapus.

gcloud

Untuk menghapus pemetaan domain URL kustom dari layanan Cloud Run, jalankan perintah berikut:

gcloud beta run domain-mappings delete \
    --domain=CUSTOM_URL_DOMAIN.cloud.run

Ganti CUSTOM_URL_DOMAIN dengan subdomain yang ingin Anda hapus.

Penting: Jika Anda menghapus layanan Cloud Run yang mendasarinya, pemetaan URL kustom tidak akan dilepaskan secara otomatis. Anda harus menghapus pemetaan URL kustom secara eksplisit untuk melepaskan klaim Anda.

Masalah umum

• Latensi propagasi: Mungkin perlu waktu beberapa detik setelah membuat URL kustom sebelum URL tersebut beroperasi sepenuhnya. Mengakses URL segera setelah dibuat dapat menyebabkan error perutean sementara.

• Memperbarui atau memindahkan URL kustom: Tidak ada perintah pembaruan langsung untuk URL kustom. Untuk memindahkan URL kustom terlampir dari satu layanan ke layanan lain, Anda harus mengikuti alur hapus dan buat ulang.

  Konsol

  1. Di konsol Google Cloud , buka halaman Domain mappings.

     Buka Pemetaan domain

  2. Centang kotak di samping URL kustom yang ingin Anda pindahkan.

  3. Klik Hapus.

  4. Klik Tambahkan URL kustom.

  5. Dalam daftar Service, pilih layanan target baru.

  6. Masukkan domain URL kustom yang sebelumnya Anda klaim.

  7. Klik Create untuk mengalihkan traffic ke layanan baru.

  gcloud

  1. Hapus pemetaan yang ada dari layanan lama:

     gcloud beta run domain-mappings delete \
         --domain=CUSTOM_URL_DOMAIN.cloud.run

     Ganti CUSTOM_URL_DOMAIN dengan subdomain yang sebelumnya Anda klaim.

  2. Klaim ulang dan petakan URL ke layanan baru:

     gcloud beta run domain-mappings create \
         --service=NEW_SERVICE_NAME \
         --domain=CUSTOM_URL_DOMAIN.cloud.run

     Ganti kode berikut:

     • NEW_SERVICE_NAME: nama layanan yang menjadi tujuan pemindahan URL kustom Anda.
     • CUSTOM_URL_DOMAIN: subdomain yang ingin Anda lampirkan.

Langkah berikutnya

• Pelajari lebih lanjut Memetakan domain kustom.
• Pelajari Menayangkan aset statis dengan CDN.