Implementar tu servicio web

ID de región

REGION_ID es un código abreviado que Google asigna en función de la región que eliges 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.

En esta sección de la guía, se muestra cómo utilizar la CLI de gcloud para implementar tu servicio web de Node.js en App Engine. Para obtener más información sobre el entorno de tiempo de ejecución de Node.js, consulta Entorno de ejecución de Node.js.

Antes de comenzar

  1. Crea un proyecto de Google Cloud con una app de App Engine.
  2. Escribe un servidor web de Node.js para implementar en App Engine.
  3. Instala Google Cloud CLI, que proporciona la herramienta de línea de comandos de gcloud. Asegúrate de que gcloud esté configurado para usar el proyecto de Google Cloud en el que deseas realizar la implementación.

Puntos clave

Usa gcloud app deploy y gcloud app browse para implementar y ver tu servicio.

Implementa tu servicio

En tu carpeta my-nodejs-service, en la que se encuentra el archivo app.yaml, ejecuta el siguiente comando desde tu terminal:

gcloud app deploy

Tus archivos de origen se suben a Google Cloud Storage. Cloud Build compila tu aplicación y la implementa en App Engine.

Para obtener más información sobre otras maneras de compilar y, luego, implementar tu app, consulta Prueba y, luego, implementa tu app.

Si no tienes uno, se crea un archivo .gcloudignore para garantizar que tu carpeta node_modules no se suba.

Los módulos de Node.js se instalan en la nube como se muestra en tus archivos package.json y package-lock.json, y tu servicio se inicia con npm start.

Implementa varios servicios

Puedes agregar varios servicios a tu proyecto mediante la creación de un archivo app.yaml para cada servicio. Incluye el atributo service en cada archivo app.yaml para especificar el nombre del servicio. A fin de obtener más información para estructurar tu app con varios servicios, consulta Estructura servicios web en App Engine.

Para implementar varios servicios, sigue estas instrucciones. Cada servicio implementado tendrá su propia URL asignada.

Cómo ver tu servicio

Para iniciar el navegador y acceder a tu servicio web en https://PROJECT_ID.REGION_ID.r.appspot.com con rapidez, usa el siguiente comando:

gcloud app browse

Servicios y versiones

Acabas de implementar y crear un servicio en App Engine. Puedes especificar el nombre de tu servicio en el archivo app.yaml. Si omites el nombre, se trata como default. El primer servicio que implementes debe ser el servicio predeterminado.

Puedes actualizar tu servicio en cualquier momento si ejecutas el comando de gcloud app deploy nuevamente. Cada vez que implementas, se crea una versión nueva y el tráfico se enruta automáticamente a la versión más reciente.

Para confirmar que tu servicio se creó y que se implementó una versión, realiza los pasos siguientes:

  1. Visualiza tus servicios de App Engine en la consola de Google Cloud:

    Ver servicios

    Deberías ver un servicio en la lista, llamado default. El servicio predeterminado está disponible a nivel público en la siguiente URL:

    https://PROJECT_ID.REGION_ID.r.appspot.com

  2. Observa tus versiones:

    Ver versiones

    En la lista, deberías ver una versión con marca de tiempo que corresponde a tu implementación.

Para obtener más información sobre cómo enviar solicitudes a servicios y versiones específicas, consulta Cómo se enrutan las solicitudes.

Próximos pasos

Ahora que ya cuentas con un servidor Node.js que se ejecuta en App Engine, aprende cómo realizar actualizaciones a tu servicio web.