URL default untuk instance Cloud Run

Secara default, setiap instance Cloud Run menerima default run.app URL default saat dibuat. URL unik yang dapat dialamatkan ini memiliki format berikut:

https://INSTANCE_NAME-PROJECT_NUMBER.REGION.run.app

Ganti kode berikut:

  • INSTANCE_NAME: nama instance Cloud Run.
  • PROJECT_NUMBER: nomor Google Cloud project.
  • REGION: nama region, seperti europe-west1.

Jika ingin menghapus akses ke endpoint URL default, Anda dapat menonaktifkannya. Untuk lebih mengamankan instance dari akses publik, Anda juga dapat mengonfigurasi setelan ingress untuk mengontrol dan membatasi akses jaringan. Lihat petunjuk untuk mengonfigurasi setelan ingress untuk instance Cloud Run.

Saat Anda menonaktifkan URL default, Cloud Run akan membatasi ingress ke jalur pribadi dan Virtual Private Cloud, sekaligus mempertahankan URL individual per instance.

Menonaktifkan URL default untuk instance Cloud Run

Nonaktifkan run.app URL default instance Cloud Run untuk hanya mengizinkan traffic dari jalur ingress instance lainnya: Cloud Load Balancing dan setiap pemetaan domain yang dikonfigurasi.

gcloud

  • Untuk instance yang ada, jalankan perintah gcloud beta run instances update dengan flag --no-default-url, misalnya:

    gcloud beta run instances update INSTANCE --no-default-url
  • Untuk instance baru, jalankan perintah gcloud beta run instances deploy dengan flag --no-default-url, misalnya:

    gcloud beta run instances deploy INSTANCE \
        --image IMAGE_URL \
        --no-default-url

    Ganti INSTANCE dengan nama instance Cloud Run Anda.

    Dalam output, URL akan ditampilkan sebagai None.

Untuk memulihkan URL default, gunakan flag --default-url.

YAML

  1. Jika Anda membuat instance baru, lewati langkah ini. Jika Anda memperbarui instance yang ada, download konfigurasi YAML-nya:

    gcloud beta run instances describe INSTANCE --format export > instance.yaml
  2. Untuk menonaktifkan URL default, tetapkan anotasi run.googleapis.com/default-url-disabled ke 'true':

    apiVersion: run.googleapis.com/v1
    kind: Instance
    metadata:
      name: INSTANCE
      annotations:
        run.googleapis.com/default-url-disabled: 'true'
        run.googleapis.com/launch-stage: BETA
    spec:
      containers:
      - name: CONTAINER_NAME
        image: IMAGE_URL

    Ganti kode berikut:

    • INSTANCE: nama instance Cloud Run Anda.
    • CONTAINER_NAME: nama container.
    • IMAGE_URL: referensi ke image container, seperti us-docker.pkg.dev/cloudrun/container/hello:latest.
  3. Buat atau perbarui instance menggunakan perintah berikut:

    gcloud beta run instances replace instance.yaml

Untuk memulihkan URL default, tetapkan anotasi run.googleapis.com/default-url-disabled ke false atau hapus.

Langkah Berikutnya

Lihat Membatasi ingress endpoint jaringan untuk mengetahui detail selengkapnya dan petunjuk konfigurasi instance.