Guía de inicio rápido para Node.js en el entorno estándar

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.

En esta guía de inicio rápido, se muestra cómo implementar una app de muestra en App Engine. Si deseas obtener información sobre cómo codificar una aplicación para App Engine, consulta Compila una aplicación.

¿App Engine es la opción de procesamiento adecuada para ti? Consulta otras opciones para alojar la aplicación en Google Cloud.

Costos

No hay costos asociados por usar esta guía. Ejecutar esta app de muestra por sí sola no supera tu cuota gratuita.

Antes de comenzar

  1. Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
  2. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  3. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

  4. Habilita Cloud Build API.

    Habilita la API

  5. Instala Google Cloud CLI.
  6. Para inicializar la CLI de gcloud, ejecuta el siguiente comando:

    gcloud init
  7. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  8. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

  9. Habilita Cloud Build API.

    Habilita la API

  10. Instala Google Cloud CLI.
  11. Para inicializar la CLI de gcloud, ejecuta el siguiente comando:

    gcloud init

Requisitos previos adicionales

  1. Inicializa tu app de App Engine con el proyecto y selecciona su región:

    gcloud app create --project=[YOUR_PROJECT_ID]
    

    Cuando se te solicite, selecciona la región en la que deseas ubicar tu aplicación de App Engine.

  2. Instala los siguientes requisitos:

Ubicaciones de App Engine

App Engine es regional, lo que significa que la infraestructura que ejecuta las apps se encuentra en una región específica, y Google la administra para que esté disponible de forma redundante en todas las zonas dentro de esa región.

El cumplimiento de tus requisitos de latencia, disponibilidad o durabilidad debe ser un factor principal para seleccionar la región en la que se ejecutan las apps. Por lo general, puedes seleccionar la región más cercana a la de los usuarios de la app, pero debes considerar las ubicaciones en las que App Engine está disponible y las ubicaciones de los otros productos y servicios de Google Cloud que usa la app. Usar servicios en varias ubicaciones puede afectar la latencia de la app y sus precios.

No puedes cambiar la región de una app una vez configurada.

Si ya creaste una aplicación de App Engine, puedes ver su región mediante una de las siguientes opciones:

Esta guía de inicio rápido muestra una aplicación de Node.js simple que se escribió con el marco de trabajo Express.js.

Descarga el código de muestra

Utiliza nuestra aplicación simple Hello World para acceder a una descripción general sobre cómo implementar un servicio web en App Engine. Sigue estos pasos para descargar el código del entorno de desarrollo:

  1. Descarga el repositorio de apps de muestra de Node.js:

    Cloud Shell

    Abre el repositorio en Cloud Shell:

    Abre en Cloud Shell

    Máquina local

    Descarga el repositorio como archivo ZIP y extráelo.

    De manera alternativa, clona el repositorio con git:

    git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples
    
  2. Cambia al directorio que contiene la app de Hello World:

    cd nodejs-docs-samples/appengine/hello-world/standard
    

Ejecuta Hello World de forma local

  1. Instala dependencias para el proyecto:

    npm install
    
  2. Inicia el servidor HTTP:

    npm start
    
  3. Visualiza la app en el navegador web:

    Cloud Shell

    En la barra de herramientas de Cloud Shell, haz clic en Vista previa en la Web Vista previa en la Web y selecciona Preview on port 8080.

    Máquina local

    Dirige tu navegador web hacia http://localhost:8080.

    Puedes ver el mensaje “¡Hello, world!” en la página.

  4. Para detener el servidor HTTP, presiona Ctrl+C en la ventana de la terminal.

Implementa y ejecuta Hello World en App Engine

  1. Para implementar la app de Hello World en App Engine, ejecuta el siguiente comando desde el directorio hello-world/standard:

    gcloud app deploy
    
  2. Mira la app en vivo en https://PROJECT_ID.REGION_ID.r.appspot.com:

    gcloud app browse
    

El mensaje “Hello, World!” ahora se entrega mediante un servidor web que se ejecuta en una instancia de App Engine.

¡Felicitaciones! Implementaste con éxito un servicio web de Node.js en App Engine.

Limpia

Si deseas seguir aprendiendo sobre App Engine, puedes conservar tu proyecto de Cloud y seguir las instrucciones para compilar una app.

Como alternativa, puedes borrar el proyecto de Cloud para detener la facturación de todos los recursos que se usaron en él.

  1. En la consola de Google Cloud, ve a la página Administrar recursos.

    Ir a Administrar recursos

  2. En la lista de proyectos, elige el proyecto que quieres borrar y haz clic en Borrar.
  3. En el diálogo, escribe el ID del proyecto y, luego, haz clic en Cerrar para borrar el proyecto.

¿Qué sigue?

Ahora que tienes experiencia en la implementación de un servicio web en App Engine, lee la sección Compila una aplicación para obtener una explicación más detallada sobre Node.js en App Engine.

Si deseas obtener más información sobre el entorno de ejecución de Node.js en el entorno estándar de App Engine, consulta la página Entorno de ejecución de Node.js.