Implementa y ejecuta un contenedor con Cloud Run en Node.js

1. Antes de comenzar

Cloud Run es una plataforma de procesamiento administrada que te permite ejecutar contenedores sin estado que se pueden invocar a través de solicitudes HTTP. Cloud Run es una plataforma sin servidores, lo que significa que quita la complejidad de la administración de infraestructura, de modo que te puedas enfocar en lo que más importa: compilar apps excelentes. Se basa en Knative, lo que te permite elegir ejecutar tus contenedores con Cloud Run (completamente administrado) o Cloud Run for Anthos. El objetivo de este codelab es que compiles una imagen de contenedor y la implementes en Cloud Run.

Requisitos previos

N/A

2. Configuración y requisitos

Configuración del entorno de autoaprendizaje

1. Accede a la consola de Cloud y crea un proyecto nuevo o reutiliza uno existente. (Si todavía no tienes una cuenta de Gmail o de G Suite, debes crear una).

Nota: Para acceder a la consola de Cloud con facilidad, memoriza su URL, que es console.cloud.google.com.

Recuerde el ID de proyecto, un nombre único en todos los proyectos de Google Cloud (el nombre anterior ya se encuentra en uso y no lo podrá usar). Se mencionará más adelante en este codelab como PROJECT_ID.

Nota: Si usas una cuenta de Gmail, puedes configurar la ubicación predeterminada como Sin organización. Si usas una cuenta de G Suite, elige una ubicación que sea adecuada para tu organización.

2. A continuación, deberás habilitar la facturación en la consola de Cloud para usar los recursos de Google Cloud recursos.

Ejecutar este codelab no debería costar mucho, tal vez nada. Asegúrate de seguir las instrucciones de la sección “Realiza una limpieza”, en la que se aconseja cómo cerrar recursos para que no se te facture más allá de este instructivo. Los usuarios nuevos de Google Cloud son aptos para participar en el programa Prueba gratuita de $300.

Cloud Shell

Si bien Google Cloud se puede operar de manera remota desde tu laptop, usarás Cloud Shell, un entorno de línea de comandos que se ejecuta en Google Cloud.

Esta máquina virtual basada en Debian está cargada con todas las herramientas de desarrollo que necesitarás. Ofrece un directorio principal persistente de 5 GB y se ejecuta en Google Cloud, lo que permite mejorar considerablemente el rendimiento de la red y la autenticación. Esto significa que todo lo que necesitarás para este Codelab es un navegador (sí, funciona en una Chromebook).

1. Para activar Cloud Shell desde la consola de Cloud, solo haz clic en Activar Cloud Shell (el aprovisionamiento y la conexión al entorno debería llevar solo unos minutos).

Una vez conectado a Cloud Shell, debería ver que ya se autenticó y que el proyecto ya se configuró con tu PROJECT_ID:

gcloud auth list

Resultado del comando

Credentialed accounts:
 - <myaccount>@<mydomain>.com (active)

Nota: La herramienta de línea de comandos de gcloud viene preinstalada en Cloud Shell y, sin duda, disfrutarás de su compatibilidad con la finalización de pestañas. Para obtener más información, consulta la descripción general de la herramienta de línea de comandos de gcloud.

gcloud config list project

Resultado del comando

[core]
project = <PROJECT_ID>

Si, por algún motivo, el proyecto no está configurado, solo emite el siguiente comando:

gcloud config set project <PROJECT_ID>

Si no conoce su PROJECT_ID, Observa el ID que usaste en los pasos de configuración o búscalo en el panel de la consola de Cloud:

Cloud Shell también configura algunas variables de entorno de forma predeterminada, lo que puede resultar útil cuando ejecutas comandos futuros.

echo $GOOGLE_CLOUD_PROJECT

Resultado del comando

<PROJECT_ID>

2. Establece la zona predeterminada y la configuración del proyecto.

gcloud config set compute/zone us-central1-f

Puedes elegir una variedad de zonas diferentes. Para obtener más información, consulta Regiones y zonas.

Nota: Cuando ejecutas gcloud en tu propia máquina, la configuración se mantendrá en todas las sesiones. Pero en Cloud Shell, deberás configurarlo en cada nueva sesión o reconexión.

Habilita la API de Cloud Run

En Cloud Shell, habilita la API de Cloud Run.

gcloud services enable run.googleapis.com

Si se realizó correctamente, se mostrará un mensaje similar a este:

Operation "operations/acf.cc11852d-40af-47ad-9d59-477a12847c9e" finished successfully.

3. Escribe la app de ejemplo

Compilarás una app sencilla de Node.js basada en Express que responda a las solicitudes HTTP.

Nota: Si no tienes mucho tiempo y quieres implementar un contenedor de muestra compilado previamente, avanza hasta Implementación en Cloud Run y usa gcr.io/cloudrun/hello como imagen de contenedor.

También te recomendamos que pruebes Cloud Run con la imagen que elijas y que cumpla con el contrato de entorno de ejecución de contenedores. Sin embargo, primero debes enviar la imagen a Container Registry.

Para compilar tu app, usa Cloud Shell para crear un directorio nuevo llamado helloworld-nodejs y cambiar a ese directorio.

mkdir helloworld-nodejs
cd helloworld-nodejs

Crea un archivo package.json con el siguiente contenido:

{
  "name": "cloudrun-helloworld",
  "version": "1.0.0",
  "description": "Simple hello world sample in Node",
  "main": "index.js",
  "scripts": {
    "start": "node index.js"
  },
  "author": "",
  "license": "Apache-2.0",
  "dependencies": {
    "express": "^4.17.1"
  }
}

Lo más importante es que el archivo anterior contiene una secuencia de comandos de inicio y una dependencia del framework de aplicaciones web Express.

Nota: Para editar archivos, usa vi, Emacs, nano o el editor de código de Cloud Shell. Para ello, haz clic en Iniciar editor de código .

A continuación, en el mismo directorio, crea un archivo index.js y cópiale el siguiente contenido:

const express = require('express');
const app = express();

app.get('/', (req, res) => {
  console.log('Hello world received a request.');

  const target = process.env.TARGET || 'World';
  res.send(`Hello ${target}!`);
});

const port = process.env.PORT || 8080;
app.listen(port, () => {
  console.log('Hello world listening on port', port);
});

Con ese código, se crea un servidor web básico que escucha en el puerto definido por la variable de entorno PORT. Ahora, tu app está lista para alojarla en contenedores, probarla y subirla a Container Registry.

Nota: Hay muchos otros lenguajes documentados para comenzar a usar Cloud Run.Para encontrar instrucciones para Go, Python, Java, PHP, Ruby, secuencias de comandos de shell y otros, consulta Guía de inicio rápido: Compila e implementa.

4. Organice su aplicación en contenedores y súbala a Container Registry

Si quieres crear contenedores para la app de ejemplo, crea un archivo nuevo llamado Dockerfile en el mismo directorio que los archivos fuente y copia el siguiente contenido:

# Use the official lightweight Node.js 12 image.
# https://hub.docker.com/_/node
FROM node:12-slim

# Create and change to the app directory.
WORKDIR /usr/src/app

# Copy application dependency manifests to the container image.
# A wildcard is used to ensure both package.json AND package-lock.json are copied.
# Copying this separately prevents re-running npm install on every code change.
COPY package*.json ./

# Install production dependencies.
RUN npm install --only=production

# Copy local code to the container image.
COPY . ./

# Run the web service on container startup.
CMD [ "npm", "start" ]

Ahora, usa Cloud Build para compilar la imagen de contenedor. Para ello, ejecuta el siguiente comando desde el directorio que contiene el Dockerfile:

gcloud builds submit --tag gcr.io/$GOOGLE_CLOUD_PROJECT/helloworld

$GOOGLE_CLOUD_PROJECT es una variable de entorno que contiene tu ID del proyecto de Google Cloud cuando se ejecuta en Cloud Shell. También puedes obtenerlo si ejecutas gcloud config get-value project.

Nota: Cloud Build es un servicio que ejecuta tus compilaciones en Google Cloud. Ejecuta una serie de pasos de compilación, cada uno en un contenedor de Docker, para producir tu contenedor de aplicaciones (o demás artefactos) y enviarlo a Cloud Registry, todo en un solo comando.

Es posible que se te solicite que habilites la API de Cloud Build en el proceso antes de volver a intentar la compilación. Solo tienes que ingresar y, y el proceso de compilación habilitará la API y continuará.

Una vez que se envíe al registro, verás un mensaje de SUCCESS que contiene el nombre de la imagen (gcr.io/$GOOGLE_CLOUD_PROJECT/helloworld). La imagen se almacena en Container Registry y se puede volver a usar si lo deseas.

Puedes enumerar todas las imágenes de contenedores asociadas a tu proyecto actual con el siguiente comando:

gcloud container images list

Si quieres ejecutar y probar la app de manera local desde Cloud Shell, puedes iniciarla con el siguiente comando estándar de docker:

docker run -d -p 8080:8080 gcr.io/$GOOGLE_CLOUD_PROJECT/helloworld

En Cloud Shell, haz clic en Vista previa en la Web y selecciona Vista previa en el puerto 8080.

Se abrirá una ventana del navegador que dice Hello World!.

También puedes usar curl localhost:8080.

Nota: Si el comando docker no puede extraer la imagen remota del contenedor, intenta ejecutar

gcloud auth configure-docker.

5. Realiza una implementación en Cloud Run

Para implementar tu app alojada en contenedores en Cloud Run, usa el siguiente comando (asegúrate de ajustarlo al nombre de imagen correcto para la app que compilaste o usa la imagen prediseñada gcr.io/cloudrun/hello):

gcloud run deploy helloworld \
  --image gcr.io/$GOOGLE_CLOUD_PROJECT/helloworld \
  --platform managed \
  --region us-central1 \
  --allow-unauthenticated

La opción de implementación --allow-unauthenticated te permite acceder a la app sin autenticación. La opción de implementación --platform managed \ significa que solicitas el entorno completamente administrado (no la infraestructura de Kubernetes a través de Anthos).

Espera un momento a que finalice la implementación. Cuando termine, la línea de comandos mostrará la URL de servicio.

Service [helloworld] revision [helloworld-00001] has been deployed
and is serving traffic at https://helloworld-wdl7fdwaaa-uc.a.run.app

Ahora puedes abrir la URL de servicio en un navegador web para visitar el contenedor implementado:

Cloud Run aumenta la escala de la imagen de contenedor de forma automática y horizontal para controlar las solicitudes que se reciben y, luego, reduce la escala cuando disminuye la demanda. Solo debes pagar por la CPU, la memoria y las herramientas de redes que se utilicen durante la administración de la solicitud.

Nota: Si bien este lab breve se realizó con la herramienta de línea de comandos de gcloud, Cloud Run está disponible a través de Google Cloud Console. Simplemente navega a Compute > Cloud Run y deberías ver el servicio helloworld en la lista.

También puedes usar la consola de Cloud para realizar implementaciones en Cloud Run.

6. Limpia

Si bien Cloud Run no cobra cuando el servicio no se usa, es posible que se te cobre por el almacenamiento de la imagen de contenedor compilada.

Para evitar esto, puedes borrar el proyecto de Google Cloud, lo que detendrá la facturación de todos los recursos usados en ese proyecto, o puedes borrar la imagen de helloworld con el siguiente comando:

gcloud container images delete gcr.io/$GOOGLE_CLOUD_PROJECT/helloworld

Para borrar el servicio de Cloud Run, use el siguiente comando:

gcloud run services delete helloworld \
  --platform managed \
  --region us-central1

7. Felicitaciones

¡Felicitaciones! Implementaste una app empaquetada en una imagen de contenedor en Cloud Run.

Más información

Un buen próximo paso sería consultar la Guía de inicio rápido: Implementa en Cloud Run for Anthos en Google Cloud.

Si quieres obtener más información para compilar un contenedor HTTP sin estado adecuado para Cloud Run a partir de código fuente y enviarlo a Container Registry, consulta los siguientes recursos:

• Desarrolla el servicio
• Compila contenedores

Para obtener más información sobre Knative, el proyecto de código abierto subyacente, consulta Knative.