División del tráfico

Cloud Functions (2nd gen) admite varias revisiones de cada función, lo que te permite dividir el tráfico entre diferentes revisiones o revertir la función a una revisión anterior.

Cada vez que implementas o vuelves a implementar una función, se crea una revisión nueva del servicio subyacente de Cloud Run automáticamente. Las revisiones son inmutables y no se pueden modificar una vez que se crean. Para realizar cambios en una función, debes volver a implementarla.

De forma predeterminada, el tráfico a una función se enruta a su última revisión. Puedes cambiar este comportamiento si estableces una configuración de tráfico personalizada, como se muestra en la siguiente sección.

Establece una configuración de tráfico

Puedes administrar cómo se enruta el tráfico entre las revisiones de funciones a través del servicio subyacente de Cloud Run de la función.

gcloud

Para administrar el tráfico mediante la CLI de gcloud, sigue estos pasos:

  1. Implementa tu función más de una vez para crear varias revisiones. Asegúrate de usar Cloud Functions (2nd gen).

  2. Busca los ID de revisión del servicio de Cloud Run subyacente a tu función:

    gcloud run revisions list --service YOUR_FUNCTION_NAME \
    --region YOUR_FUNCTION_REGION \
    --format 'value(REVISION)'
    

    El resultado debería ser similar al siguiente ejemplo:

    YOUR_FUNCTION_NAME-00002-xyz
    YOUR_FUNCTION_NAME-00001-abc
    
  3. Usa el comando gcloud run services update-traffic con tus ID de revisión para cambiar la configuración del tráfico. Por ejemplo, el siguiente comando divide el tráfico 50/50 entre dos revisiones:

    gcloud run services update-traffic YOUR_FUNCTION_NAME \
    --region YOUR_FUNCTION_REGION \
    --to-revisions YOUR_FUNCTION_NAME-00001-abc=50,YOUR_FUNCTION_NAME-00002-xyz=50
    

Consola

Para administrar el tráfico con la consola de Google Cloud, sigue estos pasos:

  1. Implementa tu función más de una vez para crear varias revisiones. Asegúrate de usar Cloud Functions (2nd gen).
  2. Ve a la página Descripción general de Cloud Functions en la consola de Google Cloud.
  3. Haz clic en el nombre de tu función para ir a la página Detalles de la función.
  4. En el panel Con la tecnología de Cloud Run, haz clic en el nombre de tu función para ir a la página Detalles del servicio del servicio subyacente de Cloud Run.
  5. Hacer clic en la pestaña Revisiones para ver la lista de revisiones.
  6. En la pestaña Revisiones, haz clic en Administrar tráfico.
  7. Ingresa la configuración de tráfico que desees y haz clic en Guardar.

Consulta Reversiones, lanzamientos graduales y migración de tráfico en la documentación de Cloud Run para obtener más detalles sobre la administración del tráfico entre revisiones de Cloud Run.