Il runtime Ruby

Il runtime Ruby è lo stack software responsabile dell'installazione del codice e delle dipendenze dell'applicazione e della sua esecuzione nell'ambiente flessibile.

Versioni di Ruby

Ruby 3.4 utilizza buildpack. Per l'elenco completo delle versioni di Ruby supportate e della versione di Ubuntu corrispondente, consulta la pianificazione del supporto dei runtime.

Per utilizzare una versione di Ruby supportata, devi:

  • Specifica una versione di Ruby nel file Gemfile.

    RUBY VERSION
      ruby 3.4.x
    
  • Installa gcloud CLI versione 420.0.0 o successive. Puoi aggiornare gli strumenti CLI eseguendo il comando gcloud components update. Per visualizzare la versione installata, puoi eseguire il comando gcloud version.

  • Specifica l'impostazione operating_system nel file app.yaml:

      runtime: ruby
      env: flex
    
      runtime_config:
          operating_system: "ubuntu22"
    
  • Se vuoi, puoi specificare una versione dell'interprete Ruby utilizzando un file .ruby-version nella directory dell'applicazione. Ad esempio, 3.4.x

Versioni precedenti

Per utilizzare la versione 3.1 e precedenti del runtime Ruby, specifica una versione dell'interprete Ruby utilizzando un file .ruby-version nella directory dell'applicazione.

Quando questo file è presente, il runtime installa la versione richiesta di Ruby quando esegui il deployment dell'applicazione utilizzando rbenv. Se non è possibile installare la versione richiesta, App Engine mostra un messaggio di errore durante il deployment.

Se non fornisci un file .ruby-version, il runtime Ruby utilizza per impostazione predefinita la versione 2.7. Tieni presente che l'impostazione predefinita può cambiare in qualsiasi momento, quindi è consigliabile che la tua app specifichi una versione di Ruby.

Supporto di altri runtime Ruby

Se devi utilizzare una versione di Ruby non supportata, puoi creare un runtime personalizzato e selezionare un'immagine di base valida con la versione di Ruby che ti serve.

Per le immagini di base fornite da Google o le immagini di base Docker Ruby, vedi Creazione di runtime personalizzati.

Dipendenze

Il runtime cerca un file Gemfile nella directory di origine dell'applicazione e utilizza Bundler per installare eventuali dipendenze prima di avviare l'applicazione. Per ulteriori informazioni sulla dichiarazione e sulla gestione dei pacchetti, consulta Utilizzare le librerie Ruby.

Utilizzo delle librerie C con Ruby

Per le librerie Ruby che richiedono estensioni C, le intestazioni per la versione corrente di Ruby e i seguenti pacchetti Ubuntu sono preinstallati sul 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

Questi pacchetti consentono l'installazione delle librerie Ruby più popolari. Se la tua applicazione richiede dipendenze aggiuntive a livello di sistema operativo, dovrai utilizzare un runtime personalizzato basato su questo runtime per installare i pacchetti appropriati.

Avvio dell'applicazione

Il runtime avvia l'applicazione utilizzando entrypoint definito in app.yaml. Il punto di ingresso deve avviare un processo che risponde alle richieste HTTP sulla porta definita dalla variabile di ambiente PORT. Ad esempio:

entrypoint: bundle exec rails server -p $PORT

La maggior parte delle applicazioni web utilizza un server web supportato da Rack, ad esempio Puma, Unicorn o Thin.

Devi aggiungere il server come dipendenza nel file di configurazione Gemfile della tua applicazione. Il runtime installerà tutte le dipendenze prima che venga chiamato il punto di ingresso.

source "https://rubygems.org"

gem "rack"
gem "puma"

Un esempio di punto di ingresso che utilizza Puma per un'applicazione Rails:

entrypoint: bundle exec rails server Puma -p $PORT

Un punto di ingresso di esempio che utilizza Puma per qualsiasi applicazione Rack:

entrypoint: bundle exec rackup -s Puma -p $PORT

Per le applicazioni che possono gestire le richieste senza un server Rack, puoi semplicemente eseguire uno script Ruby:

entrypoint: bundle exec ruby app.rb

Variabili di ambiente

Le seguenti variabili di ambiente sono impostate dall'ambiente di runtime:

Variabile di ambiente Descrizione
GAE_INSTANCE Il nome dell'istanza corrente.
GAE_MEMORY_MB La quantità di memoria disponibile per il processo dell'applicazione.
GAE_SERVICE Il nome del servizio specificato nel file app.yaml dell'applicazione o, se non è specificato alcun nome del servizio, è impostato su default.
GAE_VERSION L'etichetta della versione dell'applicazione attuale.
GOOGLE_CLOUD_PROJECT L'ID progetto associato alla tua applicazione, visibile nella console Google Cloud
PORT La porta che riceverà le richieste HTTP.
RACK_ENV Imposta su production.
RAILS_ENV Imposta su production.
RAILS_SERVE_STATIC_FILES Imposta su true.

Puoi impostare variabili di ambiente aggiuntive con app.yaml.

Server di metadati

Ogni istanza della tua applicazione può utilizzare il server di metadati di Compute Engine per interrogare le informazioni sull'istanza, inclusi nome host, indirizzo IP esterno, ID istanza, metadati personalizzati e informazioni sull'account di servizio. App Engine non consente di impostare metadati personalizzati per ogni istanza, ma puoi impostare metadati personalizzati a livello di progetto e leggerli dalle istanze App Engine e Compute Engine.

Questa funzione di esempio utilizza il server dei metadati per ottenere un indirizzo IP esterno di un'istanza.

require "sinatra"
require "net/http"

get "/" do
  uri = URI.parse(
    "http://metadata.google.internal/computeMetadata/v1" +
    "/instance/network-interfaces/0/access-configs/0/external-ip"
  )

  request = Net::HTTP::Get.new uri.path
  request.add_field "Metadata-Flavor", "Google"

  http = Net::HTTP.new uri.host, uri.port

  response = http.request request

  "External IP: #{response.body}"
end