Crear una aplicación Ruby en el entorno estándar de App Engine

Crear una aplicación Ruby en el entorno estándar de App Engine

ID de región

El REGION_ID es un código abreviado que Google asigna en función de la región que selecciones al crear tu aplicación. El código no corresponde a un país o provincia, aunque algunos IDs de región pueden parecerse a los códigos de país y provincia que se usan habitualmente. En las aplicaciones creadas después de febrero del 2020, REGION_ID.r se incluye en las URLs de App Engine. En las aplicaciones creadas antes de esa fecha, el ID de región es opcional en la URL.

Más información sobre los IDs de región

Aceptar

Nota: Si vas a desplegar un nuevo servicio web de Ruby en Google Cloud, te recomendamos que empieces con Cloud Run.

En esta guía de inicio rápido se muestra cómo desplegar una aplicación de ejemplo en App Engine.

Costes

No hay ningún coste asociado a esta guía. Si ejecutas esta aplicación de ejemplo por sí sola, no superarás tu cuota gratuita.

En esta guía de inicio rápido se muestra cómo crear una aplicación pequeña de App Engine que muestre un mensaje breve.

Antes de empezar

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Build API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Install the Google Cloud CLI.

Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

Para inicializar gcloud CLI, ejecuta el siguiente comando:

gcloud init

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Build API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Install the Google Cloud CLI.

Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

Para inicializar gcloud CLI, ejecuta el siguiente comando:

gcloud init

1. Debido a los cambios en el comportamiento predeterminado de cómo usa Cloud Build las cuentas de servicio en los proyectos nuevos y a los cambios en la política de organización de seguridad predeterminada, es posible que tengas que conceder roles adicionales a tu cuenta de servicio de implementación. Para obtener más información sobre cómo conceder roles específicos, consulta la guía de solución de problemas.

Requisitos previos adicionales

1. Inicializa tu aplicación de App Engine con tu proyecto y elige su región:

   gcloud app create --project=[YOUR_PROJECT_ID]
   

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

   Precaución: No puedes cambiar la región de una aplicación una vez que se haya definido.

2. Instala lo siguiente en tu máquina local:

   • Descarga e instala Git.

Ubicaciones de App Engine

App Engine es regional, lo que significa que la infraestructura que ejecuta tus aplicaciones está ubicada en una región concreta y Google la gestiona para que esté disponible de forma redundante en todas las zonas de esa región.

Cumplir con los requisitos de latencia, disponibilidad o durabilidad son factores principales para seleccionar la región donde se ejecutan tus aplicaciones. Por lo general, puedes seleccionar la región más cercana a los usuarios de tu aplicación, pero debes tener en cuenta las ubicaciones en las que está disponible App Engine, así como las ubicaciones de los demásGoogle Cloud productos y servicios que utilice tu aplicación. Usar servicios en varias ubicaciones puede afectar a la latencia de tu aplicación, así como a su precio.

No es posible cambiar la región de una aplicación después de configurarla.

Nota: En los comandos de App Engine y en la Google Cloud consola,us-central se utilizan los nombres europe-west y us-central para dos ubicaciones, que en otras partes de la documentación de Google se denominan europe-west1 y us-central1, respectivamente.

Si ya has creado una aplicación de App Engine, puedes ver su región de una de las siguientes formas:

• Ejecuta el comando gcloud app describe.

• Abre el panel de control de App Engine en la Google Cloud consola. La región aparece cerca de la parte superior de la página.

Aceptar
En esta guía de inicio rápido se muestra una aplicación de Ruby sencilla escrita con el framework web Sinatra que puedes desplegar en App Engine. Aunque en este ejemplo se usa Sinatra, puedes usar otros frameworks, como Ruby on Rails.

Descargar la aplicación Hello World

Hemos creado una aplicación Hello World para App Engine para que puedas familiarizarte rápidamente con el proceso de desplegar una aplicación en Google Cloud.

1. Clona el repositorio de la aplicación de ejemplo Hello World en tu máquina local.

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

   También puedes descargar la muestra como un archivo ZIP y extraerla.

2. Cambia al directorio que contiene el código de ejemplo.

   cd ruby-docs-samples/appengine/standard-hello_world
   

Ejecutar Hello World en tu máquina local

En este ejemplo se usa Bundler para ejecutar la aplicación Hello World en tu ordenador local:

1. Si aún no tienes instalado el lenguaje de programación de tu tiempo de ejecución, descarga e instala Ruby.

   Descargar e instalar Ruby

2. Instala Bundler:

   gem install bundler
   

3. Instala las dependencias de este proyecto:

   bundle install
   

4. Inicia un servidor web local.

   bundle exec ruby app.rb -p 8080
   

5. En tu navegador web, introduce lo siguiente:

   http://localhost:8080

El mensaje Hello World de la aplicación de ejemplo se muestra en la página. En la ventana de la terminal, pulsa Ctrl+C para salir del servidor web.

Desplegar y ejecutar Hello World en App Engine

Para desplegar tu aplicación en el entorno estándar de App Engine, sigue estos pasos:

1. Despliega la aplicación Hello World ejecutando el siguiente comando desde el directorio standard-hello_world:

   gcloud app deploy

   Consulta información sobre las marcas opcionales.

   Marcas de comandos gcloud habituales

   • Incluya la marca --version para especificar un ID que identifique de forma única esa versión de su aplicación. De lo contrario, se generará uno automáticamente. Ejemplo: --version [YOUR_VERSION_ID]
   • Incluye la marca --project para especificar un ID de proyecto alternativo Google Cloud al que has inicializado como predeterminado en la herramienta gcloud. Ejemplo: --project [YOUR_PROJECT_ID]

   Ejemplo:

   gcloud app deploy --version pre-prod-5 --project my-sample-app

   Para obtener más información sobre el despliegue de tu aplicación desde la línea de comandos, consulta el apartado sobre cómo probar y desplegar tu aplicación. Para ver una lista de todas las marcas de comandos, consulta la gcloud app deploy referencia.

   Aceptar

2. Abre el navegador para ver la aplicación en https://PROJECT_ID.REGION_ID.r.appspot.com

   gcloud app browse

   , donde PROJECT_ID representa el ID de tu Google Cloud proyecto.

Esta vez, la página que muestra el mensaje "Hello World" la entrega un servidor web que se ejecuta en una instancia de App Engine.

¡Enhorabuena! Has desplegado tu primera aplicación de App Engine en el entorno estándar de App Engine.

En las siguientes secciones encontrará información sobre cómo limpiar los datos, así como enlaces a los posibles pasos que puede seguir.

Limpieza

Para evitar que se te apliquen cargos, puedes eliminar tu Google Cloud proyecto para detener la facturación de todos los recursos utilizados en él.

Nota: No puedes eliminar la aplicación predeterminada.

Precaución: Eliminar un proyecto tiene los siguientes efectos:
• Se elimina todo el contenido del proyecto. Si has usado un proyecto que ya existía para las tareas de este documento, cuando lo elimines, también se eliminará cualquier otro trabajo que hayas realizado en él.
• Se pierden los IDs de proyecto personalizados. Cuando creaste este proyecto, es posible que hayas creado un ID de proyecto personalizado que quieras usar en el futuro. Para conservar las URLs que usan el ID del proyecto, como una URL appspot.com, elimina los recursos seleccionados dentro del proyecto en lugar de eliminar todo el proyecto.
1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

Siguientes pasos

Conocer toda la plataforma

Ahora que ya sabes cómo es desarrollar y desplegar aplicaciones de App Engine, puedes explorar el resto de la Google Cloud. Ya tienes instalada la CLI de Google Cloud, que te proporciona las herramientas para interactuar con productos como Cloud SQL, Cloud Storage y Firestore, entre otros.

Información sobre el entorno estándar de App Engine

Estos son algunos temas que te ayudarán a seguir aprendiendo sobre App Engine:

• Información general sobre App Engine
• Enrutamiento de solicitudes
• Gestión de solicitudes
• Gestionar instancias