GSP1089
Descripción general
Cloud Run Functions es la
oferta de funciones como servicio de Google Cloud. Incluye un conjunto de
funciones avanzadas y está potenciada por
Cloud Run y
Eventarc, lo que permite
ejercer un control más avanzado sobre el rendimiento y la escalabilidad, y
mayor control sobre el entorno de ejecución de las funciones y los activadores
de más de 90 fuentes de eventos.
En este lab, crearás funciones de Cloud Run que respondan a llamadas HTTP y se
activen con eventos de Cloud Storage y Registros de auditoría de Cloud.
También implementarás múltiples revisiones de funciones de Cloud Run y
explorarás los nuevos parámetros de configuración.
Novedades
Esta nueva versión de Cloud Run Functions ofrece una experiencia de FaaS
mejorada con la tecnología de Cloud Run, Cloud Build, Artifact Registry y
Eventarc.
Infraestructura mejorada
-
Procesamiento más largo de solicitudes: Ejecuta tus
funciones de Cloud Run por más de 5 minutos (el valor predeterminado), lo
que facilita ejecutar cargas de trabajo basadas en solicitudes más largas,
como procesar grandes flujos de datos desde Cloud Storage o BigQuery. El
límite es de 60 minutos para las funciones de HTTP. Para las funciones
controladas por eventos, actualmente es de hasta 10 minutos.
-
Instancias más grandes: Aprovecha hasta 16 GB de RAM y 4
CPU virtuales en funciones de Cloud Run, lo que permite cargas de trabajo
más paralelas, de mayor tamaño en la memoria y de cómputo intensivo.
-
Simultaneidad: Procesa hasta 1,000 solicitudes simultáneas
con una sola instancia de función, lo que minimiza los inicios en frío y
mejora la latencia durante el escalamiento.
-
Instancias mínimas: Proporciona instancias preparadas con
anterioridad para minimizar los inicios en frío y asegúrate de que el tiempo
de arranque de la aplicación no afecte su rendimiento.
-
División del tráfico: Admite múltiples versiones de tus
funciones, divide el tráfico entre ellas y reviértelas a una versión
anterior.
Amplia cobertura de eventos y compatibilidad con CloudEvents
-
Integración de Eventarc: Cloud Run Functions ahora incluye
compatibilidad nativa con Eventarc, que aporta
más de 125 fuentes de eventos
con Registros de auditoría de Cloud (BigQuery, Cloud SQL, Cloud Storage,
etc.). Por supuesto, Cloud Run Functions sigue admitiendo eventos de fuentes
personalizadas con la publicación directa en Cloud Pub/Sub.
-
Formato de CloudEvent: Todas las funciones controladas por
eventos cumplen con CloudEvents (cloudevents.io), el estándar de la industria, sin importar la fuente, para garantizar que
los desarrolladores tengan una experiencia coherente. Las cargas útiles se
envían a través de un CloudEvent estructurado con una
carga útil de cloudevent.data
y se implementan con el estándar de CloudEvent.
Objetivos
En este lab, aprenderás a realizar las siguientes tareas:
- Escribir una función que responda a llamadas HTTP
- Escribir una función que responda a eventos de Cloud Storage
- Escribir una función que responda a Registros de auditoría de Cloud
- Implementar múltiples revisiones de una función de Cloud Run
- Eliminar los inicios en frío con instancias mínimas
- Configurar la simultaneidad
Configuración y requisitos
Antes de hacer clic en el botón Comenzar lab
Lee estas instrucciones. Los labs cuentan con un temporizador que no se puede pausar. El temporizador, que comienza a funcionar cuando haces clic en Comenzar lab, indica por cuánto tiempo tendrás a tu disposición los recursos de Google Cloud.
Este lab práctico te permitirá realizar las actividades correspondientes en un entorno de nube real, no en uno de simulación o demostración. Para ello, se te proporcionan credenciales temporales nuevas que utilizarás para acceder a Google Cloud durante todo el lab.
Para completar este lab, necesitarás lo siguiente:
- Acceso a un navegador de Internet estándar. Se recomienda el navegador Chrome.
Nota: Usa una ventana del navegador privada o de incógnito (opción recomendada) para ejecutar el lab. Así evitarás conflictos entre tu cuenta personal y la cuenta de estudiante, lo que podría generar cargos adicionales en tu cuenta personal.
- Tiempo para completar el lab (recuerda que, una vez que comienzas un lab, no puedes pausarlo).
Nota: Usa solo la cuenta de estudiante para este lab. Si usas otra cuenta de Google Cloud, es posible que se apliquen cargos a esa cuenta.
Cómo iniciar tu lab y acceder a la consola de Google Cloud
-
Haz clic en el botón Comenzar lab. Si debes pagar por el lab, se abrirá un diálogo para que selecciones la forma de pago.
A la derecha, se encuentra el panel Configuración del lab y acceso, que tiene los siguientes elementos:
- El botón Abrir la consola de Google Cloud
- Las credenciales temporales (nombre de usuario y contraseña) que debes usar para este lab
- Otra información para completar el lab (si es necesaria)
Ten en cuenta que el cronómetro del lab se encuentra cerca de la parte superior de la página y muestra el tiempo restante.
-
Haz clic en Abrir la consola de Google Cloud (o haz clic con el botón derecho y selecciona Abrir el vínculo en una ventana de incógnito si ejecutas el navegador Chrome).
El lab inicia los recursos y abre otra pestaña, en la que se muestra la página de acceso.
Sugerencia: Ordena las pestañas en ventanas separadas, una junto a la otra.
Nota: Si ves el diálogo Elegir una cuenta, haz clic en Usa otra cuenta.
-
De ser necesario, copia el nombre de usuario a continuación y pégalo en el diálogo Acceder.
{{{user_0.username | "Username"}}}
También puedes encontrar el nombre de usuario en el panel Configuración del lab y acceso.
-
Haz clic en Siguiente.
-
Copia la contraseña que aparece a continuación y pégala en el diálogo Te damos la bienvenida.
{{{user_0.password | "Password"}}}
También puedes encontrar la contraseña en el panel Configuración del lab y acceso.
-
Haz clic en Siguiente.
Importante: Debes usar las credenciales que te proporciona el lab. No uses las credenciales de tu cuenta de Google Cloud.
Nota: Usar tu propia cuenta de Google Cloud para este lab podría generar cargos adicionales.
-
Haz clic para avanzar por las páginas siguientes:
- Acepta los Términos y Condiciones.
- No agregues opciones de recuperación ni autenticación de dos factores, ya que esta cuenta es temporal.
- No te registres para obtener pruebas gratuitas.
Después de un momento, se abrirá la consola de Google Cloud en esta pestaña.
Nota: Para acceder a los productos y servicios de Google Cloud, haz clic en el menú de navegación o escribe el nombre del servicio o producto en el campo Buscar.
Activa Cloud Shell
Cloud Shell es una máquina virtual que cuenta con herramientas para desarrolladores. Ofrece un directorio principal persistente de 5 GB y se ejecuta en Google Cloud. Cloud Shell proporciona acceso de línea de comandos a tus recursos de Google Cloud.
-
Haz clic en Activar Cloud Shell
en la parte superior de la consola de Google Cloud.
-
Haz clic para avanzar por las siguientes ventanas:
- Continúa en la ventana de información de Cloud Shell.
- Autoriza a Cloud Shell para que use tus credenciales para realizar llamadas a la API de Google Cloud.
Cuando te conectes, habrás completado la autenticación, y el proyecto estará configurado con tu Project_ID, . El resultado contiene una línea que declara el Project_ID para esta sesión:
Your Cloud Platform project in this session is set to {{{project_0.project_id | "PROJECT_ID"}}}
gcloud es la herramienta de línea de comandos de Google Cloud. Viene preinstalada en Cloud Shell y es compatible con la función de autocompletado con tabulador.
- Puedes solicitar el nombre de la cuenta activa con este comando (opcional):
gcloud auth list
- Haz clic en Autorizar.
Resultado:
ACTIVE: *
ACCOUNT: {{{user_0.username | "ACCOUNT"}}}
To set the active account, run:
$ gcloud config set account `ACCOUNT`
- Puedes solicitar el ID del proyecto con este comando (opcional):
gcloud config list project
Resultado:
[core]
project = {{{project_0.project_id | "PROJECT_ID"}}}
Nota: Para obtener toda la documentación de gcloud, en Google Cloud, consulta la guía con la descripción general de gcloud CLI.
Tarea 1: Habilita las APIs
Antes de crear funciones de Cloud Run, debes habilitar las APIs
correspondientes.
-
Ejecuta el siguiente comando para habilitar todos los servicios necesarios.
gcloud services enable \
artifactregistry.googleapis.com \
cloudfunctions.googleapis.com \
cloudbuild.googleapis.com \
eventarc.googleapis.com \
run.googleapis.com \
logging.googleapis.com \
pubsub.googleapis.com \
cloudquotas.googleapis.com \
monitoring.googleapis.com
Tarea 2: Crea una función de HTTP
La primera función que crearás será una función de Node.js (requiere
autenticación) que responda a solicitudes HTTP y usarás un
tiempo de espera de 10 minutos con el objetivo de demostrar cómo una función
puede tener más tiempo para responder a dichas solicitudes.
Creación
-
En la terminal de Cloud Shell, ejecuta el siguiente comando para crear la
carpeta y los archivos de la aplicación, y navegar a la carpeta:
mkdir ~/hello-http && cd $_
touch index.js && touch package.json
-
Haz clic en el botón Abrir editor de la barra de
herramientas de Cloud Shell.
-
Agrega el siguiente código al archivo hello-http/index.js que
simplemente responde a las solicitudes HTTP:
const functions = require('@google-cloud/functions-framework');
functions.http('helloWorld', (req, res) => {
res.status(200).send('HTTP with Node.js in GCF 2nd gen!');
});
-
Agrega el siguiente contenido al archivo
hello-http/package.json para especificar las dependencias.
{
"name": "nodejs-functions-gen2-codelab",
"version": "0.0.1",
"main": "index.js",
"dependencies": {
"@google-cloud/functions-framework": "^2.0.0"
}
}
Implementación
-
En la terminal de Cloud Shell, ejecuta el siguiente comando para implementar
la función:
gcloud run deploy nodejs-http-function \
--source . \
--function helloWorld \
--base-image {{{project_0.startup_script.node_gcp_runtime | node_gcp_runtime}}} \
--region {{{project_0.default_region|Region}}} \
--timeout 600s \
--max-instances 1 \
--no-allow-unauthenticated
Nota: Si ves un mensaje de error de permisos (permissions error), espera unos minutos y vuelve a realizar la implementación. Las APIs tardan unos minutos en habilitarse.
Las marcas que se usan en este comando incluyen las siguientes:
-
--source .: Indica a Cloud Run que compile la función en una
imagen de contenedor con buildpacks.
-
--function helloWorld: Establece el punto de entrada de la
función que se invocará.
-
--base-image {{{project_0.startup_script.node_gcp_runtime |
node_gcp_runtime}}}: Especifica la imagen base del entorno de ejecución y habilita las
actualizaciones automáticas de la imagen base para las correcciones de
seguridad.
-
--timeout 600s: Permite que la función tenga un tiempo de
espera más largo (600 segundos) para responder a las solicitudes HTTP.
-
--max-instances 1: Establece la cantidad máxima de instancias
en 1.
-
--no-allow-unauthenticated: Garantiza que la función requiera
autenticación.
-
Una vez que se implemente la función, en el menú de navegación de la consola
de Google Cloud, ve a Cloud Run y verifica que
nodejs-http-function aparezca en la lista.
Prueba
-
En Cloud Shell, recupera la URL del servicio de tu función y almacénala en
una variable de entorno:
SERVICE_URL="$(gcloud run services describe nodejs-http-function --region {{{project_0.default_region|Region}}} --format 'value(status.url)')"
-
Pasa tu token de identidad en el encabezado de autorización para
autenticarte y probar la función de HTTP:
curl -H "Authorization: Bearer $(gcloud auth print-identity-token)" $SERVICE_URL
Deberías ver el siguiente mensaje como respuesta:
HTTP with Node.js in GCF 2nd gen!
Haz clic en Revisar mi progreso para verificar el objetivo.
Crea una función de HTTP
Tarea 3: Crea una función de Cloud Storage
En esta sección, crearás una función de Node.js que responda a eventos de un
bucket de Cloud Storage con un activador de Eventarc.
Configuración
-
Ejecuta los siguientes comandos para otorgar los roles de IAM necesarios a
las cuentas de servicio de Cloud Storage y Compute Engine:
PROJECT_NUMBER=$(gcloud projects list --filter="project_id:{{{ project_0.project_id | PROJECT_ID }}}" --format='value(project_number)')
SERVICE_ACCOUNT=$(gcloud storage service-agent --project="$PROJECT_NUMBER" | xargs)
gcloud projects add-iam-policy-binding {{{ project_0.project_id | PROJECT_ID }}} \
--member serviceAccount:$SERVICE_ACCOUNT \
--role roles/pubsub.publisher
gcloud projects add-iam-policy-binding {{{ project_0.project_id | PROJECT_ID }}} \
--member serviceAccount:$PROJECT_NUMBER-compute@developer.gserviceaccount.com \
--role roles/eventarc.eventReceiver
Creación
-
Ejecuta el siguiente comando para crear la carpeta y los archivos de la
aplicación, y navegar a la carpeta:
mkdir ~/hello-storage && cd $_
touch index.js && touch package.json
-
Haz clic en el botón Abrir editor de la barra de
herramientas de Cloud Shell.
-
Agrega el siguiente código al archivo hello-storage/index.js,
que simplemente responde a los eventos de Cloud Storage:
const functions = require('@google-cloud/functions-framework');
functions.cloudEvent('helloStorage', (cloudevent) => {
console.log('Cloud Storage event with Node.js in GCF 2nd gen!');
console.log(cloudevent);
});
-
Agrega el siguiente contenido al archivo
hello-storage/package.json para especificar las dependencias:
{
"name": "nodejs-functions-gen2-codelab",
"version": "0.0.1",
"main": "index.js",
"dependencies": {
"@google-cloud/functions-framework": "^2.0.0"
}
}
Implementación
-
Primero, ejecuta el siguiente comando y crea un bucket de Cloud Storage que
se usará para generar eventos:
export BUCKET_NAME="gcf-gen2-storage-{{{ project_0.project_id | PROJECT_ID }}}"
gcloud storage buckets create gs://$BUCKET_NAME --location={{{project_0.default_region|Region}}}
-
Ejecuta el siguiente comando para implementar la función de Cloud Run:
gcloud run deploy nodejs-storage-function \
--source . \
--function helloStorage \
--base-image {{{project_0.startup_script.node_gcp_runtime | node_gcp_runtime}}} \
--region {{{project_0.default_region|Region}}} \
--max-instances 1 \
--no-allow-unauthenticated
Nota: Como antes, si ves un mensaje de error de permisos (permissions error), espera unos minutos y vuelve a realizar la implementación. Las APIs pueden tardar unos minutos en habilitarse.
-
Ahora, crea el activador de Eventarc para enrutar los eventos de creación de
objetos de Cloud Storage a tu función implementada:
gcloud eventarc triggers create nodejs-storage-function-trigger \
--location={{{project_0.default_region|Region}}} \
--destination-run-service=nodejs-storage-function \
--destination-run-region={{{project_0.default_region|Region}}} \
--event-filters="type=google.cloud.storage.object.v1.finalized" \
--event-filters="bucket=$BUCKET_NAME" \
--service-account=$PROJECT_NUMBER-compute@developer.gserviceaccount.com
-
Una vez que se implementen la función y el activador, verifica que puedas
ver
nodejs-storage-function en la consola de
Cloud Run.

Prueba
-
Ejecuta el siguiente comando para subir un archivo al bucket y probar la
función:
echo "Hello World" > random.txt
gcloud storage cp random.txt gs://$BUCKET_NAME/random.txt
-
Ejecuta el siguiente comando para leer los registros del servicio. Deberías
ver el CloudEvent recibido en los registros:
gcloud run services logs read nodejs-storage-function \
--region {{{project_0.default_region|Region}}} --limit=100
Nota: Los registros pueden tardar un minuto en generarse.
Deberías ver un resultado similar al siguiente.
Resultado:
}
traceparent: '00-c74cb472d1e78f7225b6f617a31d9c08-96f0380bb62be2c1-01'
},
etag: 'CKOx1L3wofoCEAE='
crc32c: 'R1jUOQ==',
mediaLink: 'https://storage.googleapis.com/download/storage/v1/b/gcf-gen2-storage-qwiklabs-gcp-00-101b4b9ca9bb/o/random.txt?generation=1663625646643363&alt=media',
md5Hash: '5Z/5eUEET4XfUpfhwwLSYA==',
size: '12',
timeStorageClassUpdated: '2022-09-19T22:14:06.657Z',
storageClass: 'STANDARD',
updated: '2022-09-19T22:14:06.657Z',
timeCreated: '2022-09-19T22:14:06.657Z',
contentType: 'text/plain',
metageneration: '1',
generation: '1663625646643363',
bucket: 'gcf-gen2-storage-qwiklabs-gcp-00-101b4b9ca9bb',
name: 'random.txt',
selfLink: 'https://www.googleapis.com/storage/v1/b/gcf-gen2-storage-qwiklabs-gcp-00-101b4b9ca9bb/o/random.txt',
id: 'gcf-gen2-storage-qwiklabs-gcp-00-101b4b9ca9bb/random.txt/1663625646643363',
kind: 'storage#object',
data: {
bucket: 'gcf-gen2-storage-qwiklabs-gcp-00-101b4b9ca9bb',
time: '2022-09-19T22:14:06.657124Z',
subject: 'objects/random.txt',
type: 'google.cloud.storage.object.v1.finalized',
specversion: '1.0',
source: '//storage.googleapis.com/projects/_/buckets/gcf-gen2-storage-qwiklabs-gcp-00-101b4b9ca9bb',
id: '5693030851428996',
{
Cloud Storage event with Node.js in GCF 2nd gen!
Haz clic en Revisar mi progreso para verificar el objetivo.
Crea una función de Cloud Storage
Tarea 4: Crea una función de Registros de auditoría de Cloud
En esta sección, crearás una función de Node.js que recibirá un evento de
Registros de auditoría de Cloud
cuando se cree una instancia de VM de Compute Engine. Como respuesta, agregará
una etiqueta a la VM recién creada, en la que se especifica el creador de la
VM.
Determina las VMs de Compute Engine recién creadas
Compute Engine emite 2 registros de auditoría cuando se crea una VM.
El primero se emite al principio de la creación de la VM y se ve así:

El segundo se emite después de la creación de la VM y se ve así:

Observa el campo operation con los valores first: true y
last: true. El segundo registro de auditoría contiene toda la
información que necesitas para etiquetar una instancia, por lo que debes usar
la marca last: true con el objetivo de detectarla en Cloud Run
Functions.
Configuración
Si deseas usar las funciones de Registros de auditoría de Cloud, debes
habilitar los registros de auditoría para Eventarc. También debes usar una
cuenta de servicio con el rol eventarc.eventReceiver.
-
En el menú de navegación, ve a IAM y administración >
Registros de auditoría.
Nota: Puedes pasar por alto la advertencia sobre el permiso faltante resourcemanager.folders.getIamPolicy.
-
Busca la API de Compute Engine y haz clic en la casilla
de verificación junto a ella. Si no puedes encontrarla, búscala en la
página siguiente.
-
En el panel de información de la derecha, selecciona las casillas de
verificación de los tipos de registro
Lectura de administración,
Lectura de datos y Escritura de datos.
Luego, haz clic en Guardar.
-
Otórgale a la cuenta de servicio predeterminada de Compute Engine el rol de
IAM
eventarc.eventReceiver:
gcloud projects add-iam-policy-binding {{{ project_0.project_id | PROJECT_ID }}} \
--member serviceAccount:$PROJECT_NUMBER-compute@developer.gserviceaccount.com \
--role roles/eventarc.eventReceiver
Obtención del código
-
Ejecuta el siguiente código para clonar el repo que contiene la aplicación:
cd ~
git clone https://github.com/GoogleCloudPlatform/eventarc-samples.git
-
Haz clic en el botón Abrir editor de la barra de
herramientas de Cloud Shell.
-
En el Explorador de archivos, navega a
eventarc-samples > gce-vm-labeler > gcf > nodejs y abre
index.js.
El archivo
index.js
contiene el código de la aplicación que recibe el registro de auditoría
envuelto en un CloudEvent. Luego, extrae los detalles de la instancia de VM de
Compute Engine y establece una etiqueta en la instancia de VM. Puedes estudiar
index.js
con más detalle por tu cuenta.
Implementación
-
En la terminal de Cloud Shell, ejecuta el siguiente comando para navegar al
directorio de la aplicación:
cd ~/eventarc-samples/gce-vm-labeler/gcf/nodejs
-
Ejecuta el siguiente comando para implementar la función de Cloud Run:
gcloud run deploy gce-vm-labeler \
--source . \
--function labelVmCreation \
--base-image {{{project_0.startup_script.node_gcp_runtime | node_gcp_runtime}}} \
--region {{{project_0.default_region|Region}}} \
--max-instances 1 \
--no-allow-unauthenticated
-
Crea el activador de Eventarc para filtrar en los registros de auditoría las
inserciones de instancias de Compute Engine:
gcloud eventarc triggers create gce-vm-labeler-trigger \
--location={{{project_0.default_region|Region}}} \
--destination-run-service=gce-vm-labeler \
--destination-run-region={{{project_0.default_region|Region}}} \
--event-filters="type=google.cloud.audit.log.v1.written" \
--event-filters="serviceName=compute.googleapis.com" \
--event-filters="methodName=beta.compute.instances.insert" \
--service-account=$PROJECT_NUMBER-compute@developer.gserviceaccount.com
Nota: Aunque el activador de la función de registro de auditoría se crea de inmediato, los activadores pueden tardar hasta 10 minutos en ser completamente funcionales.
Haz clic en Revisar mi progreso para verificar el objetivo.
Crea una función de Registros de auditoría de Cloud
Prueba
Para probar tu función de registro de auditoría, debes crear una VM de Compute
Engine en la consola de Cloud (también puedes crear VMs con
gcloud, pero no parece generar registros de auditoría).
-
En el menú de navegación, ve a
Compute Engine > Instancias de VM.
-
Haz clic en Crear instancia y establece el
Nombre de la instancia como instance-1 y
la Zona como
.
-
Deja todos los otros campos con sus valores predeterminados y haz clic en
Crear.
Una vez que se complete la creación de la VM, deberías ver la etiqueta
creator agregada en la VM en la consola de Cloud en la sección
Información básica.

- Verifica la creación de la instancia con el siguiente comando:
gcloud compute instances describe instance-1 --zone {{{project_0.default_zone | "Zone"}}}
Deberías ver la etiqueta en el resultado como en el siguiente ejemplo.
Ejemplo del resultado:
...
labelFingerprint: ULU6pAy2C7s=
labels:
creator: student-02-19b599a0f901
...
Haz clic en Revisar mi progreso para verificar el objetivo.
Crea una instancia de VM
-
Ejecuta el siguiente comando para borrar la VM: Cuando se te solicite,
escribe
Y para confirmar.
gcloud compute instances delete instance-1 --zone {{{project_0.default_zone | "Zone"}}}
Tarea 5: Implementa diferentes revisiones
Cloud Run Functions admite múltiples revisiones de tus funciones, lo que
permite dividir el tráfico entre ellas o revertir funciones a una versión
anterior. En esta sección, implementarás dos revisiones de tu función de Cloud
Run.
Creación
-
Ejecuta el siguiente comando para crear la carpeta y los archivos de la
aplicación, y navegar a la carpeta:
mkdir ~/hello-world-colored && cd $_
touch main.py
touch requirements.txt
-
Agrega el siguiente código al archivo
hello-world-colored/main.py con una función de Python que lee
una variable de entorno de color y responde con Hello World en
ese color de fondo:
import os
color = os.environ.get('COLOR')
def hello_world(request):
return f'<body style="background-color:{color}"><h1>Hello World!</h1></body>'
Implementación
-
Ejecuta el siguiente comando para implementar la primera revisión de la
función con un fondo naranja:
COLOR=orange
gcloud run deploy hello-world-colored \
--source . \
--function hello_world \
--base-image python311 \
--region {{{project_0.default_region|Region}}} \
--allow-unauthenticated \
--update-env-vars COLOR=$COLOR \
--max-instances 1
En este punto, si pruebas la función abriendo la URL del servicio (el URI que
se generó con el comando de implementación que ejecutaste antes) en tu
navegador, deberías ver Hello World con un fondo naranja:

-
Navega a la página de Cloud Run en la consola y haz clic
en el servicio hello-world-colored.
-
Haz clic en Editar e implementar una nueva revisión.
-
Deja todo con sus valores predeterminados, desplázate hacia abajo y
selecciona la pestaña Variables y secretos. En la sección
Variables de entorno, actualiza COLOR a
yellow (amarillo).
- Haz clic en Implementar.
Como esta es la revisión más reciente, si pruebas la función abriendo la URL
del servicio en tu navegador, deberías ver Hello World con un
fondo amarillo:

Haz clic en Revisar mi progreso para verificar el objetivo.
Implementa diferentes revisiones
Tarea 6: Configura una cantidad mínima de instancias
En Cloud Run Functions, se puede especificar una cantidad mínima de instancias
de función que se deben mantener en espera y listas para entregar solicitudes.
Esto es útil para limitar la cantidad de inicios en frío. En esta sección,
implementarás una función con una inicialización lenta. Observarás el problema
de inicio en frío. Luego, implementarás la función con el valor de instancia
mínimo establecido en 1 para deshacerte del inicio en frío.
Creación
-
Ejecuta el siguiente comando para crear la carpeta y los archivos de la
aplicación, y navegar a la carpeta:
mkdir ~/min-instances && cd $_
touch main.go
touch go.mod
-
Agrega el siguiente código al archivo
min-instances/main.go.
Este servicio de Go tiene una función init que provoca una
suspensión durante 10 segundos para simular una inicialización larga.
También tiene una función HelloWorld que responde a las
llamadas HTTP:
package p
import (
"fmt"
"net/http"
"time"
)
func init() {
time.Sleep(10 * time.Second)
}
func HelloWorld(w http.ResponseWriter, r *http.Request) {
fmt.Fprint(w, "Slow HTTP Go in GCF 2nd gen!")
}
-
Agrega el siguiente código al archivo
min-instances/go.mod para
especificar la ruta de acceso al módulo y la versión del lenguaje Go:
module example.com/mod
go {{{project_0.startup_script.go_version | 1.26}}}
Implementación
-
Ejecuta el siguiente comando para implementar la primera revisión de la
función con el valor de instancia mínimo predeterminado de cero:
gcloud run deploy slow-function \
--source . \
--function HelloWorld \
--base-image {{{project_0.startup_script.go_gcp_runtime | go126}}} \
--region {{{project_0.default_region|Region}}} \
--allow-unauthenticated \
--max-instances 4
- Prueba la función con estos comandos:
SLOW_URL="$(gcloud run services describe slow-function --region {{{project_0.default_region|Region}}} --format 'value(status.url)')"
curl $SLOW_URL
Deberías observar un retraso de 10 segundos (inicio en frío) en la primera
llamada y, luego, ver el mensaje. Las llamadas posteriores deberían devolverse
de inmediato:
Slow HTTP Go in GCF 2nd gen!
Establecimiento del mínimo de instancias
Para deshacerte del inicio en frío en la primera solicitud, vuelve a
implementar la función con la marca --min-instances establecida
en 1 de la siguiente manera:
-
Navega a la página Cloud Run en la consola y haz clic en
el servicio slow-function.
-
Haz clic en Editar e implementar una nueva revisión.
-
En la sección Escalamiento de revisión, establece
Cantidad mínima de instancias en 1 y
Cantidad máxima de instancias en 4.
-
Deja el resto de los campos con los valores predeterminados y haz clic en
Implementar.
Prueba
- Ejecuta el siguiente comando para probar la función nuevamente:
curl $SLOW_URL
Ya no deberías ver la demora de 10 segundos en la primera solicitud. El
problema de inicio en frío para la primera invocación (después de mucho tiempo
sin invocar) desapareció gracias a la cantidad mínima de instancias. Consulta
la documentación sobre
cómo usar una cantidad mínima de instancias
para obtener más información.
Haz clic en Revisar mi progreso para verificar el objetivo.
Configura una cantidad mínima de instancias
Tarea 7: Crea una función con simultaneidad
En Cloud Run Functions, una instancia de función maneja una solicitud
simultánea de forma predeterminada, pero puedes especificar la cantidad de
solicitudes simultáneas que una instancia puede procesar de forma simultánea.
También puede resultar útil para evitar los inicios en frío, ya que no es
necesario crear una nueva instancia de función para cada solicitud paralela.
En esta sección, usarás la función con inicialización lenta del paso anterior.
Enviarás 10 solicitudes y observarás el problema de inicio en frío nuevamente,
ya que se deben crear nuevas instancias de función para controlar las
solicitudes.
Para solucionar el problema de inicio en frío, implementarás otra función con
un valor de simultaneidad de 100. Notarás que las 10 solicitudes ahora no
causan el problema de inicio en frío y una sola instancia de función puede
controlar todas las solicitudes.
Prueba sin simultaneidad
-
Usa el siguiente comando para instalar
hey en Cloud Shell:
sudo apt install hey
-
Ejecuta el siguiente comando para obtener la URL de la función y guardarla
como una variable de entorno:
SLOW_URL=$(gcloud run services describe slow-function --region {{{project_0.default_region|Region}}} --format="value(status.url)")
-
Usa una herramienta de comparativa de código abierto llamada
hey para enviar 10
solicitudes simultáneas a la función lenta:
hey -n 10 -c 10 $SLOW_URL
Deberías ver en el resultado de hey que algunas solicitudes
tardan mucho.
Resultado:
Summary:
Total: 10.9053 secs
Slowest: 10.9048 secs
Fastest: 0.4439 secs
Average: 9.7930 secs
Requests/sec: 0.9170
Total data: 310 bytes
Size/request: 31 bytes
Response time histogram:
0.444 [1] |■■■■
1.490 [0] |
2.536 [0] |
3.582 [0] |
4.628 [0] |
5.674 [0] |
6.720 [0] |
7.767 [0] |
8.813 [0] |
9.859 [0] |
10.905 [9] |■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■
La tardanza se debe a que se están creando más instancias de funciones para
manejar las solicitudes. Si verificas el número de instancias activas de la
función, también deberías notar que se creó más de una instancia en algún
momento y que estas causan el problema de inicio en frío.

-
Ejecuta el siguiente comando para borrar la función. Cuando se te solicite,
escribe
Y para confirmar:
gcloud run services delete slow-function --region {{{project_0.default_region | "Region"}}}
Implementación
-
Ejecuta el siguiente comando para implementar una nueva función idéntica a
la anterior. Una vez implementada, aumenta su simultaneidad:
gcloud run deploy slow-concurrent-function \
--source . \
--function HelloWorld \
--base-image {{{project_0.startup_script.go_gcp_runtime | go126}}} \
--region {{{project_0.default_region|Region}}} \
--allow-unauthenticated \
--min-instances 1 \
--max-instances 4
Configuración de la simultaneidad
Ahora, establece la simultaneidad del servicio subyacente de Cloud Run para la
función en 100 (puede ser un máximo de 1,000). Así, garantizarás
que una sola instancia de función pueda controlar al menos 100 solicitudes.
-
En el menú de navegación, ve a Cloud Run.
-
Haz clic en el servicio slow-concurrent-function.
-
Haz clic en Editar e implementar una nueva revisión.
-
En la sección Recursos, establece la
CPU en 1.
-
En Solicitudes, establece la
Cantidad máxima de solicitudes simultáneas por instancia
en 100.
-
En Escalamiento de revisión, establece la
Cantidad máxima de instancias en 4.
-
Deja el resto de los campos con los valores predeterminados y haz clic en
Implementar.
Prueba con simultaneidad
-
Una vez que se implemente tu función, ejecuta el siguiente comando para
obtener la URL de la nueva función y guardarla como una variable de entorno:
SLOW_CONCURRENT_URL=$(gcloud run services describe slow-concurrent-function --region {{{project_0.default_region|Region}}} --format="value(status.url)")
-
Ahora usa
hey para
enviar 10 solicitudes simultáneas:
hey -n 10 -c 10 $SLOW_CONCURRENT_URL
Deberías ver en el resultado de hey que todas las solicitudes se
procesan rápidamente.
Resultado:
Summary:
Total: 0.0652 secs
Slowest: 0.0651 secs
Fastest: 0.0619 secs
Average: 0.0636 secs
Requests/sec: 153.3751
Total data: 280 bytes
Size/request: 28 bytes
Response time histogram:
0.062 [1] |■■■■■■■■■■■■■■■■■■■■
0.062 [1] |■■■■■■■■■■■■■■■■■■■■
0.063 [0] |
0.063 [0] |
0.063 [0] |
0.063 [1] |■■■■■■■■■■■■■■■■■■■■
0.064 [2] |■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■
0.064 [2] |■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■
0.064 [2] |■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■
0.065 [0] |
0.065 [1] |■■■■■■■■■■■■■■■■■■■■
Una sola instancia de función pudo manejar todas las solicitudes y el problema
de inicio en frío desapareció gracias al aumento de la simultaneidad. Consulta
la documentación sobre
simultaneidad
para obtener más información.
Haz clic en Revisar mi progreso para verificar el objetivo.
Crea una función con simultaneidad
¡Felicitaciones!
En este lab, implementaste varias funciones de Cloud Run que respondieron a
llamadas HTTP, eventos de Cloud Storage y Registros de auditoría de Cloud.
Luego, implementaste varias revisiones de los servicios de Cloud Run que
ejecutan las funciones y estableciste valores de simultaneidad, además de
deshacerte de los inicios en frío con instancias mínimas.
Próximos pasos y más información
Para obtener más información sobre Cloud Run Functions, explora los siguientes
recursos:
Capacitación y certificación de Google Cloud
Recibe la formación que necesitas para aprovechar al máximo las tecnologías de Google Cloud. Nuestras clases incluyen habilidades técnicas y recomendaciones para ayudarte a avanzar rápidamente y a seguir aprendiendo. Para que puedas realizar nuestros cursos cuando más te convenga, ofrecemos distintos tipos de capacitación de nivel básico a avanzado: a pedido, presenciales y virtuales. Las certificaciones te ayudan a validar y demostrar tus habilidades y tu conocimiento técnico respecto a las tecnologías de Google Cloud.
Última actualización del manual: 19 de agosto de 2026
Prueba más reciente del lab: 19 de agosto de 2026
Copyright 2026 Google LLC. All rights reserved. Google y el logotipo de Google son marcas de Google LLC. Los demás nombres de productos y empresas pueden ser marcas de las respectivas empresas a las que estén asociados.