設定暖機要求以改善效能

在將應用程式的程式碼載入到新建立的執行個體時,您可以使用暖機要求來減少要求及回覆的延遲時間。

App Engine 經常需要將應用程式的程式碼載入至新的執行個體。載入執行個體作業可能會在發生以下情況時進行:

  • 重新部署應用程式的版本時。
  • 因要求的負載超過目前這組運作中執行個體的容量,而建立新的執行個體時。
  • 基礎架構或實體硬體進行維護及修復時。

將應用程式的程式碼載入至新的執行個體時,可能會產生載入要求。載入要求可能會讓使用者面臨的要求延遲時間增加,但可使用「暖機要求」來避免此延遲時間增加情形。暖機要求會在任何即時要求到達該執行個體前,先將您應用程式的程式碼載入至新的執行個體。

如果您的應用程式啟用了暖機要求,App Engine 會嘗試偵測應用程式何時需要新的執行個體,並發出暖機要求來初始化新的執行個體。然而,嘗試偵測的功能並非在每種情況下均能有效運作。因此,即使應用程式已啟用暖機要求,仍可能會產生載入要求。舉例來說,如果您的應用程式沒有提供流量,則向應用程式發出的第一個要求一律為載入要求,而非暖機要求。

如同其他所有向 App Engine 應用程式發出的要求,暖機要求也會計入執行個體時數。在大多數啟用暖機要求的情況下,您不會發現執行個體小時數增加,因為應用程式只會在暖機要求中初始化,而非載入要求。如果您決定執行更多工作,例如在暖機要求期間進行預先快取,則執行個體小時用量可能會增加。如果您將 min_idle_instances 設為大於 0,這些執行個體首次啟動時可能會出現暖機要求,但在該時間過後,這些執行個體仍可供使用。

啟用暖機要求

App Engine 排程器會使用暖機要求,並依據使用者提供的設定,控制執行個體的自動調整資源配置。啟用暖機要求後,App Engine 會向 /_ah/warmup 發出 GET 要求。您可以針對這個要求實作處理常式,以執行應用程式專屬的工作,例如預先快取應用程式資料。

排程器判定需要更多執行個體時,就會啟動執行個體。由於排程器會使用暖機要求啟動執行個體,因此即使停用了暖機要求,這些要求仍可能會出現在記錄檔中。

請注意,系統不保證會呼叫暖機要求,並且在某些狀況下會改為傳送載入要求,例如:該執行個體為首先啟動的執行個體,或是流量發生遽增。然而,如果暖機要求已啟用,系統會「盡可能」嘗試將要求傳送至暖機完成的執行個體。

如要啟用暖機要求,請在 app.yaml 檔案的 inbound_services 指令下方新增 warmup 元素,例如:

inbound_services:
- warmup

註冊處理常式

您可以在專案的 app.yaml 檔案中登錄處理暖機要求的指令碼。例如:

inbound_services:
- warmup

handlers:
- url: /_ah/warmup
  script: main.py
  login: admin

這個範例會註冊處理常式,以監聽透過 main.py 檔案向 /_ah/warmup 要求路徑發出的暖機要求。

建立處理常式

建立處理常式,以便處理傳送至 /_ah/warmup 的要求。處理常式應執行應用程式需要的任何暖機邏輯。 下列範例以前述範例為基礎:

import webapp2

class MyWarmUpCode(webapp2.RequestHandler):
  """
  This class handles the warmup request. You should add any code that you
  need to execute in the `get` method, such as populating caches, and ensure
  that you return a successful HTTP response.
  """

  def get(self):

      # Your warmup logic goes here.

      # Return a successful response to indicate the logic completed.
      self.response.headers['Content-Type'] = 'text/plain'
      self.response.write('Warmup successful')

  # ...

application = webapp2.WSGIApplication(
    [
        ('/_ah/warmup', MyWarmUpCode),
        # Other handlers
        # ...
    ]
)

後續步驟

您可能會希望將資料值儲存於 Memcache 等記憶體內資料儲存庫,讓您的應用程式透過較少查詢迅速存取資料。

舉例來說,假設您想要建立並儲存自有網站的當前熱門文章清單,可以在暖機空間中建立清單,再將清單儲存至 Memcache。使用者要求傳入時,App Engine 不需要執行任何資料儲存庫查詢作業,應用程式也能更快速地處理使用者要求。