ID de región
REGION_ID
es un código abreviado que Google asigna en función de la región que seleccionas cuando creas la app. El código no corresponde a un país ni a una provincia, aunque algunos ID de región puedan parecer similares a los códigos de país y provincia que se suelen usar. En el caso de las apps creadas después de febrero de 2020, REGION_ID.r
se incluye en las URL de App Engine. En el caso de las apps existentes creadas antes de esta fecha, el ID de región es opcional en la URL.
Obtén más información acerca de los ID de región.
dispatch.yaml
te permite anular las reglas de enrutamiento.
Puedes usar dispatch.yaml
para enviar solicitudes entrantes a un servicio específico (antes conocido como módulos) según la ruta o el nombre de host en la URL.
Para obtener más información, consulta Cómo se enrutan las solicitudes.
Una app solo puede tener un archivo dispatch.yaml
, y las reglas de enrutamiento de ese archivo se aplican a todos los servicios y las versiones de la app.
Las reglas de enrutamiento también se aplican a las URL que se usan en un archivo cron.
Implementa el archivo de envío
El archivo dispatch.yaml
debe residir en el mismo directorio que el código fuente de Go.
Antes de implementar el archivo de envío, debes asegurarte de que todos los servicios definidos en ese archivo ya se hayan implementado en App Engine. Para implementar el archivo dispatch.yaml
, ejecuta el comando gcloud app deploy
desde el directorio que contiene el dispatch.yaml
:
gcloud app deploy dispatch.yaml
Sintaxis
El elemento raíz en el archivo dispatch.yaml
es dispatch:
y contiene una lista de definiciones de enrutamiento que se especifican mediante los siguientes subelementos.
En las reglas que defines en el archivo de envío, debes usar patrones de URL HTTP que incluyan la notación “.
” para separar los subdominios. Las URL definidas con la notación “-dot-
” de HTTPS no son compatibles.
Las reglas de envío dependen del orden, y solo se aplicará la primera regla que coincida con una URL.
Elemento | Descripción |
---|---|
service |
Especifica el nombre del servicio que procesará las solicitudes que coinciden con el patrón de |
url |
En el elemento
Sugerencia: Puedes incluir patrones glob, como el carácter comodín Un patrón de URL que puede incluir el nombre de host y la ruta de URL. Los caracteres glob se pueden usar para hacer coincidir patrones. Los caracteres glob se pueden especificar solo al principio y al final del patrón.
El archivo de envío no enruta las rutas de URL que comienzan con |
Ejemplo
El siguiente es un archivo de envío de muestra que enruta solicitudes a https://simple-sample.uc.r.appspot.com
y solicitudes como https://simple-sample.uc.r.appspot.com/favicon.ico
al servicio default
. Todo el contenido estático se entrega desde el servicio default
. Las solicitudes para dispositivos móviles, como https://simple-sample.uc.r.appspot.com/mobile/
, se enrutan a un frontend de dispositivo móvil, y las solicitudes de trabajador, como https://simple-sample.uc.r.appspot.com/work/
, se enrutan a un backend estático.
Si prefieres reglas de enrutamiento generales que coincidan con la mayor cantidad de solicitudes posible, puedes definir reglas con alcances más amplios. Por ejemplo:
También puedes escribir expresiones que sean más estrictas:
Límites
El archivo de envío puede contener hasta 20 reglas de enrutamiento. Cuando se especifica la string de la URL, ni el nombre de host ni la ruta pueden tener más de 100 caracteres.
Borra todas las reglas de envío
Para borrar todas las reglas de envío, sigue estos pasos:
Edita el contenido del archivo
dispatch.yaml
de la siguiente manera:dispatch: []
Implementa el archivo
dispatch.yaml
en App Engine.