本頁面由 Cloud Translation API 翻譯而成。

Ruby 執行階段

Ruby 執行階段是軟體堆疊，負責安裝應用程式的程式碼和依附元件，然後在彈性環境中執行該應用程式。

Ruby 版本

Ruby 3.4 使用建構套件。如需支援的 Ruby 版本完整清單，以及對應的 Ubuntu 版本，請參閱「執行階段支援時間表」。

如要使用支援的 Ruby 版本，請完成下列步驟：

在 Gemfile 中指定 Ruby 版本。
```
RUBY VERSION
  ruby 3.4.x
```
安裝 420.0.0 以上版本的 gcloud CLI。您可以執行 gcloud components update 指令，更新 CLI 工具。如要查看已安裝的版本，可以執行 gcloud version 指令。

在 app.yaml 檔案中指定 operating_system 設定：

  runtime: ruby
  env: flex

  runtime_config:
      operating_system: "ubuntu22"

您也可以在應用程式目錄中使用 .ruby-version 檔案，指定 Ruby 解譯器版本。例如：3.4.x

舊版本

如要使用 3.1 版和更早版本的 Ruby 執行階段，請在應用程式目錄中使用 .ruby-version 檔案指定 Ruby 解譯器版本。

如果這個檔案存在，當您使用 rbenv 部署應用程式時，執行階段會安裝要求的 Ruby 版本。如果要求的版本無法安裝，App Engine 會在部署過程中顯示錯誤訊息。

如果您未提供 .ruby-version 檔案，Ruby 執行階段會預設為 2.7 版。請注意，預設設定隨時可能變更，因此建議您為應用程式指定 Ruby 版本。

支援其他 Ruby 執行階段

如需使用不支援的 Ruby 版本，可以建立自訂執行階段，並選取包含所需 Ruby 版本的有效基本映像檔。

如要瞭解 Google 提供的基本映像檔或 Docker Ruby 基本映像檔，請參閱「建構自訂執行階段」。

依附元件

執行階段會在應用程式的來源目錄中尋找 Gemfile 檔案，並在啟動應用程式前使用 Bundler 安裝任何依附元件。如要進一步瞭解如何宣告及管理套件，請參閱「使用 Ruby 資料庫」。

搭配使用 C 資料庫與 Ruby

針對需要 C 擴充功能的 Ruby 程式庫，當前 Ruby 版本的標頭和下列 Ubuntu 套件都已預先安裝在系統中。

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

這些套件可允許安裝最熱門的 Ruby 資料庫。如果您的應用程式需要額外的作業系統層級依附元件，您需要以此執行階段為基礎，使用自訂執行階段，才能安裝適當套件。

啟動應用程式

執行階段會使用 app.yaml 中定義的 entrypoint 啟動應用程式。進入點應啟動程序，在環境變數 PORT 定義的通訊埠回應 HTTP 要求。例如：

entrypoint: bundle exec rails server -p $PORT

大多數網頁應用程式均使用支援 Rack 的網路伺服器，例如 Puma、Unicorn 或 Thin。

您必須在應用程式的 Gemfile 設定檔中，將伺服器新增為依附元件。執行階段會在呼叫進入點之前，安裝所有依附元件。

source "https://rubygems.org"

gem "rack"
gem "puma"

針對 Rails 應用程式使用 Puma 的進入點範例如下：

entrypoint: bundle exec rails server Puma -p $PORT

針對任何 Rack 應用程式使用 Puma 的進入點範例如下：

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

如果應用程式不需要 Rack 伺服器即可處理要求，您可以直接執行 Ruby 指令碼：

entrypoint: bundle exec ruby app.rb

環境變數

執行階段環境會設定下列環境變數：

環境變數	說明
`GAE_INSTANCE`	目前執行個體的名稱。
`GAE_MEMORY_MB`	應用程式程序可用的記憶體量。
`GAE_SERVICE`	應用程式的 `app.yaml` 檔案中指定的服務名稱；如果未指定服務名稱，則設為 `default`。
`GAE_VERSION`	目前應用程式的版本標籤。
`GOOGLE_CLOUD_PROJECT`	與應用程式相關聯的專案 ID，會在 Google Cloud 控制台上顯示。
`PORT`	接收 HTTP 要求的通訊埠。
`RACK_ENV`	設為 `production`。
`RAILS_ENV`	設為 `production`。
`RAILS_SERVE_STATIC_FILES`	設為 `true`。

您可以使用 app.yaml 設定其他環境變數。

中繼資料伺服器

您應用程式中的每個執行個體都可以使用 Compute Engine 中繼資料伺服器查詢與該執行個體相關的資訊，包括主機名稱、外部 IP 位址、執行個體 ID、自訂中繼資料，以及服務帳戶資訊。雖然 App Engine 不允許您為每個執行個體設定自訂中繼資料，但是您可以設定全專案的自訂中繼資料，並從您的 App Engine 及 Compute Engine 執行個體讀取該資料。

這個函式範例使用中繼資料伺服器，取得執行個體的外部 IP 位址。

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