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

En esta guía de inicio rápido, se muestra cómo implementar una aplicación 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.

Costos

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

Antes de comenzar

Antes de ejecutar y de implementar esta guía de inicio rápido, instala el SDK de Cloud y configura un proyecto de GCP para App Engine:

  1. Descarga y, luego, instala el SDK de Cloud:

    Descargar el SDK

    Nota: Si ya tienes instalado el SDK de Cloud, ejecuta el siguiente comando para actualizarlo:

    gcloud components update
    
  2. Crea un proyecto nuevo:

    gcloud projects create [YOUR_PROJECT_ID] --set-as-default
    

    Verifica si se creó el proyecto:

    gcloud projects describe [YOUR_PROJECT_ID]
    

    Verás los detalles del proyecto, que deberían ser similares a los siguientes:

    createTime: year-month-hour
    lifecycleState: ACTIVE
    name: project-name
    parent:
    id: '433637338589'
    type: organization
    projectId: project-name-id
    projectNumber: 499227785679
    
  3. Inicializa tu aplicación 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 que se ubique tu aplicación de App Engine.

  4. Asegúrate de tener habilitada la facturación para tu proyecto. Debes tener una cuenta de facturación vinculada a tu proyecto para que la aplicación se pueda implementar en App Engine.

    Habilitar facturación

  5. Instala los siguientes requisitos previos:

Ubicaciones de App Engine

App Engine es regional. Esto significa que la infraestructura que ejecuta las aplicaciones se ubica en una región específica, y que Google la administra para que esté disponible de manera redundante en todas las zonas de esa región.

El cumplimiento de los requisitos de latencia, disponibilidad o durabilidad debe ser un factor principal para seleccionar la región donde se ejecutan tus aplicaciones. En general, puedes seleccionar la región más cercana a los usuarios de tu aplicación, pero debes tener en cuenta la ubicación del resto de los productos y servicios de GCP que usa tu aplicación. El uso de servicios en varias ubicaciones puede afectar la latencia y los precios de tu aplicación.

App Engine está disponible en las siguientes regiones:

  • northamerica-northeast1 (Montreal)
  • us-central (Iowa)
  • us-west2 (Los Ángeles)
  • us-east1 (Carolina del Sur)
  • us-east4 (Virginia del Norte)
  • southamerica-east1 (São Paulo)
  • europe-west (Bélgica)
  • europe-west2 (Londres)
  • europe-west3 (Fráncfort)
  • europe-west6 (Zúrich)
  • asia-northeast1 (Tokio)
  • asia-northeast2 (Osaka)
  • asia-east2 (Hong Kong)
  • asia-south1 (Bombay)
  • australia-southeast1 (Sídney)

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

Si ya creaste una aplicación de App Engine, puedes ejecutar el comando gcloud app describe o abrir el panel de App Engine en GCP Console para ver la región. La región de tu aplicación de App Engine se detalla en http://[YOUR_PROJECT_ID].appspot.com.

En esta guía de inicio rápido, se 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 aplicaciones de muestra de Node.js:

    Cloud Shell

    Clona el repositorio de Git:

    git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples

    Máquina local

    Descarga el repositorio como archivo ZIP y extráelo.

    Si usas Git, también puedes clonar el repositorio con el siguiente comando:

    git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples
  2. Cambia al directorio que contiene la aplicación 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 aplicación 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 Vista previa en el puerto 8080.

    Máquina local

    Dirige tu navegador web a http://localhost:8080

    Puedes ver el mensaje Hello, world! que se muestra 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 aplicación de Hello World en App Engine, ejecuta el siguiente comando desde el directorio hello-world/standard:

    gcloud app deploy
    
  2. Mira la aplicación en vivo en https://YOUR_PROJECT_ID.appspot.com:

    gcloud app browse
    

Un servidor web, que se ejecuta en una instancia de App Engine, muestra el mensaje Hello, world!.

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

Limpia

Si deseas aprender más sobre App Engine, puedes conservar tu proyecto de GCP y continuar con la información sobre cómo compilar una aplicación.

De manera alternativa, puedes borrar tu proyecto de GCP para detener la facturación de todos los recursos usados en él.

  1. En la GCP Console, dirígete a la página Proyectos.

    Ir a la página Proyectos

  2. En la lista de proyectos, selecciona el proyecto que deseas borrar y haz clic en Borrar.
  3. En el cuadro de 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.

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Documentación del entorno estándar de App Engine para Node.js