URL predefinito per le istanze Cloud Run

Per impostazione predefinita, ogni istanza Cloud Run riceve un URL predefinito run.app al momento della creazione. Questo URL univoco e indirizzabile ha il seguente formato:

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

Sostituisci quanto segue:

  • INSTANCE_NAME: il nome dell'istanza Cloud Run.
  • PROJECT_NUMBER: il Google Cloud numero del progetto.
  • REGION: il nome della regione, ad esempio europe-west1.

Se vuoi rimuovere l'accesso all'endpoint URL predefinito, puoi disattivarlo. Per proteggere ulteriormente l'istanza dall'accesso pubblico, puoi anche configurare le impostazioni del traffico in entrata per controllare e limitare l'accesso alla rete. Consulta le istruzioni per configurare le impostazioni del traffico in entrata per le istanze Cloud Run.

Quando disattivi l'URL predefinito, Cloud Run limita il traffico in entrata ai percorsi privati e Virtual Private Cloud, mantenendo un URL individuale per istanza.

Disattivare l'URL predefinito per le istanze Cloud Run

Disattiva l'URL run.app predefinito di un'istanza Cloud Run per consentire solo il traffico proveniente dagli altri percorsi di traffico in entrata dell'istanza: Cloud Load Balancing e qualsiasi mapping di dominio configurato.

gcloud

  • Per un'istanza esistente, esegui il comando gcloud beta run instances update con il flag --no-default-url, ad esempio:

    gcloud beta run instances update INSTANCE --no-default-url

  • Per una nuova istanza, esegui il comando gcloud beta run instances deploy con il flag --no-default-url, ad esempio:

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

    Sostituisci INSTANCE con il nome dell'istanza Cloud Run.

    Nell'output, l'URL viene visualizzato come None.

Per ripristinare l'URL predefinito, utilizza il flag --default-url.

YAML

  1. Se stai creando una nuova istanza, salta questo passaggio. Se stai aggiornando un'istanza esistente, scarica la relativa configurazione YAML:

    gcloud beta run instances describe INSTANCE --format export > instance.yaml

  2. Per disattivare l'URL predefinito, imposta l' run.googleapis.com/default-url-disabled annotazione su '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

    Sostituisci quanto segue:

    • INSTANCE: il nome dell'istanza Cloud Run.
    • CONTAINER_NAME: il nome del container.
    • IMAGE_URL: un riferimento all'immagine del container, ad esempio us-docker.pkg.dev/cloudrun/container/hello:latest.

  3. Crea o aggiorna l'istanza utilizzando il seguente comando:

    gcloud beta run instances replace instance.yaml

Per ripristinare l'URL predefinito, imposta l'annotazione run.googleapis.com/default-url-disabled su false o rimuovila.

Passaggi successivi

Per ulteriori dettagli e istruzioni di configurazione dell'istanza, consulta Limitare il traffico in entrata dell'endpoint di rete.