URL padrão para instâncias do Cloud Run

Por padrão, cada instância do Cloud Run recebe um URL padrão run.app quando é criada. Esse URL exclusivo e endereçável tem o seguinte formato:

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

Substitua:

  • INSTANCE_NAME: o nome da instância do Cloud Run.
  • PROJECT_NUMBER: o Google Cloud número do projeto.
  • REGION: o nome da região, como europe-west1.

Se você quiser remover o acesso ao endpoint de URL padrão, desative-o. Para proteger ainda mais sua instância contra acesso público, também é possível configurar as definições de entrada para controlar e restringir o acesso à rede. Consulte as instruções para configurar as definições de entrada para instâncias do Cloud Run.

Quando você desativa o URL padrão, o Cloud Run restringe a entrada a caminhos particulares e da nuvem privada virtual, mantendo um URL individual por instância.

Desativar o URL padrão para instâncias do Cloud Run

Desative o run.app URL padrão de uma instância do Cloud Run para permitir apenas o tráfego dos outros caminhos de entrada da instância: Cloud Load Balancing e qualquer mapeamento de domínio configurado.

gcloud

  • Para uma instância atual, execute o comando gcloud beta run instances update com a flag --no-default-url, por exemplo:

    gcloud beta run instances update INSTANCE --no-default-url
  • Para uma nova instância, execute o comando gcloud beta run instances deploy com a flag --no-default-url, por exemplo:

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

    Substitua INSTANCE pelo nome da instância do Cloud Run.

    Na saída, o URL é exibido como None.

Para restaurar o URL padrão, use a sinalização --default-url.

YAML

  1. Se você estiver criando uma nova instância, pule esta etapa. Se você estiver atualizando uma instância atual, baixe a configuração YAML correspondente:

    gcloud beta run instances describe INSTANCE --format export > instance.yaml
  2. Para desativar o URL padrão, defina a run.googleapis.com/default-url-disabled anotação como '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

    Substitua:

    • INSTANCE: o nome da instância do Cloud Run.
    • CONTAINER_NAME: o nome do contêiner.
    • IMAGE_URL: uma referência à imagem do contêiner, como us-docker.pkg.dev/cloudrun/container/hello:latest.
  3. Crie ou atualize a instância usando o seguinte comando:

    gcloud beta run instances replace instance.yaml

Para restaurar o URL padrão, defina a anotação run.googleapis.com/default-url-disabled como false ou remova-a.

A seguir

Consulte Restringir a entrada do endpoint de rede para mais detalhes e instruções de configuração da instância.