El entorno de ejecución de Ruby es la pila de software encargada de instalar el código y las dependencias de tu aplicación y, luego, ejecutarla en el entorno flexible.
Versiones de Ruby
Ruby 3.3 (vista previa) usa paquetes de compilación. Para obtener la lista completa de las versiones de Ruby compatibles y la versión correspondiente de Ubuntu, consulta el programa de asistencia del entorno de ejecución.
Para usar una versión de Ruby compatible, debes hacer lo siguiente:
Especifica una versión de Ruby en tu
Gemfile
.RUBY VERSION ruby 3.3.x
Instala la versión 420.0.0 o posterior de la CLI de gcloud. Puedes actualizar las herramientas de la CLI si ejecutas el comando
gcloud components update
. Para ver la versión instalada, puedes ejecutar el comandogcloud version
.Especifica la configuración
operating_system
en el archivoapp.yaml
:runtime: ruby env: flex runtime_config: operating_system: "ubuntu22"
De manera opcional, puedes especificar una versión del intérprete de Ruby con un archivo
.ruby-version
en el directorio de tu aplicación. Por ejemplo,3.3.x
Versiones anteriores
Para usar la versión 3.1 y anteriores del entorno de ejecución de Ruby, especifica una versión del intérprete de Ruby con un archivo .ruby-version
en el directorio de tu aplicación.
Cuando este archivo está presente, el entorno de ejecución instala la versión solicitada de Ruby durante la implementación de tu app mediante rbenv. Si la versión solicitada no se puede instalar, App Engine muestra un mensaje de error durante la implementación.
Si no proporcionas un archivo .ruby-version
, el entorno de ejecución de Ruby se establece de forma predeterminada en versión 2.7. Ten en cuenta que el valor predeterminado puede cambiar en cualquier momento, por lo que se recomienda que tu app especifique una versión de Ruby.
Compatibilidad con otros entornos de ejecución de Ruby
Si necesitas usar una versión de Ruby que no es compatible, puedes crear un entorno de ejecución personalizado y seleccionar una imagen base válida con la versión de Ruby que necesites.
Para las imágenes base proporcionadas por Google o las imágenes base de Docker para Ruby, consulta Compila entornos de ejecución personalizados.
Dependencias
El entorno de ejecución busca un archivo Gemfile
en el directorio fuente de tu aplicación y usa Bundler
para instalar cualquier dependencia antes de iniciar la aplicación. Para obtener más información acerca de cómo declarar y administrar los paquetes, consulta Usa bibliotecas de Ruby.
Cómo usar bibliotecas de C con Ruby
Para las bibliotecas de Ruby que requieren extensiones de C, los encabezados de la versión de Ruby actual y los siguientes paquetes de Ubuntu se instalan previamente en el sistema.
autoconf
build-essential
ca-certificates
cmake
curl
file
git
imagemagick
libcurl3
libcurl3-gnutls
libcurl4-openssl-dev
libffi-dev
libgdbm-dev
libgit2-dev
libgmp-dev
libicu-dev
libjemalloc-dev
libjemalloc1
libmagickwand-dev
libmysqlclient-dev
libncurses5-dev
libpq-dev
libqdbm-dev
libreadline6-dev
libsqlite3-dev
libssl-dev
libxml2-dev
libxslt-dev
libyaml-dev
libz-dev
systemtap
tzdata
Estos paquetes permiten la instalación de las bibliotecas más populares de Ruby. Si la aplicación requiere otras dependencias del nivel del sistema operativo, deberás usar un entorno de ejecución personalizado basado en este entorno de ejecución para instalar los paquetes adecuados.
Inicio de la aplicación
El entorno de ejecución inicia la aplicación mediante el entrypoint
definido en app.yaml
. El punto de entrada debería iniciar un proceso que responda a solicitudes HTTP en el puerto definido por la variable de entorno PORT
.
Por ejemplo:
entrypoint: bundle exec rails server -p $PORT
La mayoría de las aplicaciones web usan un servidor web compatible con Rack, como Puma, Unicorn o Thin.
Debes agregar el servidor como una dependencia en el archivo de configuración Gemfile
de tu aplicación. El entorno de ejecución instalará todas las dependencias antes de que se llame al punto de entrada.
source "https://rubygems.org"
gem "rack"
gem "puma"
Este es un ejemplo de un punto de entrada que usa Puma para una aplicación Rails:
entrypoint: bundle exec rails server Puma -p $PORT
Este es un ejemplo de un entrypoint que usa puma para cualquier aplicación Rack:
entrypoint: bundle exec rackup -s Puma -p $PORT
Para las aplicaciones que pueden controlar solicitudes sin un servidor de Rack, solo puedes ejecutar una secuencia de comandos de Ruby:
entrypoint: bundle exec ruby app.rb
Variables de entorno
Las siguientes variables del entorno se configuran mediante el entorno de ejecución:
Variable del entorno | Descripción |
---|---|
GAE_INSTANCE |
El nombre de la instancia actual. |
GAE_MEMORY_MB |
La cantidad de memoria disponible para el proceso de la aplicación. |
GAE_SERVICE |
El nombre del servicio especificado en el archivo app.yaml de la aplicación; si no se especifica ningún nombre, se configura como default . |
GAE_VERSION |
La etiqueta de versión de la aplicación actual. |
GOOGLE_CLOUD_PROJECT |
El ID del proyecto asociado con la aplicación, que se puede ver en la consola de Google Cloud. |
PORT |
El puerto que recibirá las solicitudes HTTP. |
RACK_ENV |
Se define en production . |
RAILS_ENV |
Se define en production . |
RAILS_SERVE_STATIC_FILES |
Se define en true . |
Puedes definir variables de entorno adicionales con app.yaml
.
Servidor de metadatos
Cada instancia de tu aplicación puede usar el servidor de metadatos de Compute Engine para consultar información sobre la instancia, incluidos el nombre del host, la dirección IP externa, el ID de instancia, los metadatos personalizados y la información de la cuenta de servicio. App Engine no permite definir metadatos personalizados para cada instancia, pero puedes definir los metadatos personalizados de todo el proyecto y leerlos desde tus instancias de App Engine y Compute Engine.
Esta función de ejemplo usa el servidor de metadatos para obtener una dirección IP externa de una instancia.