Environnement d'exécution Ruby

L'environnement d'exécution Ruby est la pile logicielle chargée d'installer le code et les dépendances de votre application, puis d'exécuter cette application dans l'environnement flexible.

Versions Ruby

Ruby 4.0 utilise des buildpacks. Pour obtenir la liste complète des versions Ruby compatibles, ainsi que la version d'Ubuntu correspondante, consultez la page Programmation de la compatibilité avec l'environnement d'exécution.

Pour utiliser une version compatible de Ruby, vous devez effectuer les opérations suivantes :

• Spécifiez une version de Ruby dans Gemfile.

  RUBY VERSION
    ruby "4.0.x"
  

• Installez gcloud CLI version 420.0.0 ou ultérieure. Vous pouvez mettre à jour les outils de la CLI en exécutant la commande gcloud components update. Pour afficher la version installée, vous pouvez exécuter la commande gcloud version.

• Spécifiez le paramètre operating_system dans votre fichier app.yaml :

    runtime: ruby
    env: flex
  
    runtime_config:
        operating_system: "ubuntu24"
  

• Vous pouvez éventuellement spécifier une version de l'interpréteur Ruby à l'aide d'un fichier .ruby-version situé dans le répertoire de votre application. Par exemple, 4.0.x.

Versions précédentes

Pour utiliser l'environnement d'exécution Ruby version 3.1 et antérieure, spécifiez une version de l'interpréteur Ruby à l'aide d'un fichier .ruby-version dans le répertoire de votre application.

Lorsque ce fichier est présent, l'environnement d'exécution installe la version de Ruby demandée à l'aide de rbenv lors du déploiement de votre application. Si la version demandée ne peut pas être installée, App Engine affiche un message d'erreur au moment du déploiement.

Si vous ne fournissez pas de fichier .ruby-version, l'environnement d'exécution Ruby utilise par défaut la version 2.7. Notez que la valeur par défaut peut changer à tout moment. Il est donc recommandé que votre application spécifie une version de Ruby.

Compatibilité avec d'autres environnements d'exécution Ruby

Si vous devez utiliser une version de Ruby non compatible, vous pouvez créer un environnement d'exécution personnalisé et sélectionner une image de base valide avec la version de Ruby dont vous avez besoin.

Pour les images de base fournies par Google ou les images de base Ruby Docker, consultez la section Créer des environnements d'exécution personnalisés.

Dépendances

L'environnement d'exécution recherche un fichier Gemfile dans le répertoire source de votre application et, avant de démarrer cette dernière, il utilise Bundler pour installer les dépendances. Pour en savoir plus sur la déclaration et la gestion des packages, consultez la page Utiliser les bibliothèques Ruby.

Utiliser les bibliothèques C avec Ruby

Pour les bibliothèques Ruby nécessitant des extensions C, les en-têtes correspondant à la version actuelle de Ruby ainsi que les packages Ubuntu suivants sont préinstallés sur le système :

• autoconf
• build-essential
• ca-certificates
• cmake
• curl