Membuat URL kustom

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.

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.

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.

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.

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

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

Mencantumkan dan melihat URL kustom

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

gcloud beta run domain-mappings list

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

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

Anda dapat menghapus pemetaan URL kustom jika tidak lagi diperlukan.

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

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.