設定執行個體可用性政策

設定執行個體可用性政策

Google Compute Engine 會定期維護其基礎架構。本頁面說明這些維護事件的類型與大概頻率，以及您可以如何設定執行個體可用性選項，來設定發生這些維護事件時的 VM 執行個體行為。本頁面也將說明如何設定執行個體，讓執行個體在維護作業進行時即時遷移。

事前準備

如要使用本指南中的指令列範例，請完成下列事項：
1. 安裝或更新至最新版 gcloud 指令列工具。
2. 設定預設地區和區域。
如要使用本指南中的 API 範例，請設定 API 存取權。

維護事件

Compute Engine 維護事件需要硬體與軟體更新。其中有些維護事件需要 Google 將 VM 從正在進行維護的主機移出，且 Compute Engine 會自動管理這些執行個體的排程行為。如果您將執行個體的可用性政策設為即時遷移，Compute Engine 就會即時遷移您的 VM 執行個體。這麼做可避免您的應用程式在維護作業期間遭遇服務中斷情形。此外，您也可以選擇在維護作業期間終止您的執行個體，而不要進行即時遷移。

下表將 Compute Engine 維護事件大致分為兩類，每一個分類都以範例說明，並會指出哪個維護事件需要將 VM 即時遷移至其他主機。

維護事件類型	範例	大概頻率 ^*	需要即時遷移至新主機
主機維護	主機核心升級、硬體修復或升級	每月一次	是
輕量	管理程序層級升級、網路堆疊升級	每週 1-2 次	否

^{* 請注意，這些頻率是概略值，而不是保證值。Compute Engine 有時執行維護的頻率可能會比這裡提到的更高一些。}

選擇可用性政策

需要 Google 將 VM 移至不同主機機器的情形發生時，VM 執行個體的可用性政策會影響執行個體的運作方式。舉例來說，您可以選擇讓 VM 執行個體繼續運行，同時讓 Compute Engine 即時遷移執行個體至其他主機；或者，您也可以選擇終止執行個體。您隨時可以更新執行個體的可用性政策，來控管 VM 執行個體的運作方式。

只要設定下列兩項設定，即可變更執行個體的可用性政策：

VM 執行個體的維護行為：決定執行個體在維護作業期間要即時遷移或終止。
執行個體的重新啟動行為：決定執行個體遇到當機情形或遭到終止時是否自動重新啟動。

執行個體的維護行為預設為即時遷移，但您可以進行變更，在維護作業期間終止執行個體。

即時遷移

根據預設，系統會將標準執行個體設為即時遷移，因此 Google Compute Engine 會在基礎架構維護期間自動將執行個體遷離，而您的執行個體在遷移作業期間會繼續執行。一般來說，多數執行個體的效能不會受到影響，然而您的執行個體可能會遇到效能短暫降低情形。這項設定非常適合需要持續運作且容許短期間內效能降低的執行個體。

當 Google Compute Engine 遷移執行個體時，會回報系統事件並發佈至區域作業清單。您可以針對特定區域查看 Compute Engine 作業，來審核這個事件。即時遷移事件具有下列作業類型：

compute.instances.migrateOnHostMaintenance

終止及 (視需要) 重新啟動

如果您不要讓執行個體即時遷移，可以選擇終止並視需要重新啟動執行個體。採用這個選項後，Google Compute Engine 會發出訊號讓您的執行個體在維護活動以外的時間關閉，等候一小段時間讓執行個體關閉乾淨，終止執行個體，然後再重新啟動。如果執行個體需要維持穩定一致的最大效能，以及您的整體應用程式專門用於處理執行個體故障或重新啟動情形，就相當適合使用這個選項。

當 Google Compute Engine 終止並重新啟動您的執行個體時，會回報系統事件並發佈至區域作業清單。您可以針對特定區域查看 Compute Engine 作業，來審核這個事件。終止事件具有下列作業類型：

compute.instances.terminateOnHostMaintenance

執行個體重新啟動時，會使用相同的永久開機磁碟，並重新連接至您所設定的任何次要永久磁牒。系統在遷移及重新啟動執行個體後，仍會保留這些磁碟上的資料。

如果執行個體遭到終止，系統則不會保留本機 SSD 資料。執行個體重新啟動時，會建立新的本機 SSD，而您必須格式化並掛接該本機 SSD。

自動重新啟動

如果您的執行個體已設為在維護作業期間終止，或您的執行個體因底層硬體問題而發生當機情形，您可以設定讓 Google Compute Engine 將 automaticRestart 欄位變更為 true，藉此自動重新啟動執行個體。執行個體因使用者動作 (例如呼叫 sudo shutdown) 或區域服務中斷情形而終止運作時，則不適用這項設定。

當 Google Compute Engine 自動重新啟動執行個體時，會回報系統事件並發佈至區域作業清單。您可以針對特定區域查看 Compute Engine 作業，來審核這個事件。自動重新啟動事件具有下列作業類型：

compute.instances.automaticRestart

查看 Compute Engine 作業

您可以透過 Google Cloud Platform 主控台、gcloud 指令列工具或 Compute Engine API，查看完整作業清單。

主控台

如要查看專案的作業清單，請前往「Operations」(作業) 頁面。

前往「Operations」(作業) 頁面
如要進一步瞭解作業，請按一下作業摘要。例如，如要查看 my-instance 執行個體的遷移詳細資料，請按一下 [Automatically migrate an instance] (自動遷移執行個體) 作業。

gcloud

如要使用 gcloud compute 查看專案的作業清單，請使用 operations list 子指令。

如要查看指定區域中的作業清單，請新增 --filter 標記。

gcloud compute operations list --filter="zone:(ZONE)"

例如，如要查看 us-cental1-c 中的作業清單，請執行下列指令：

gcloud compute operations list --filter="zone:(us-central1-c)"

NAME                            TYPE                                        TARGET                                HTTP_STATUS  STATUS  TIMESTAMP
systemevent-1543845145000...    compute.instances.migrateOnHostMaintenance  us-central1-c/instances/my-instance   200          DONE    2018-12-03T05:52:25.000-08:00

API

您必須在全球、地區或區域層級指定作業的 API 要求。即時遷移、執行個體終止與自動重新啟動都是區域層級作業。

針對區域作業，請對 zoneOperations.list 方法提出 GET 要求。

GET https://www.googleapis.com/compute/v1/projects/[PROJECT_ID]/zones/[ZONE]/operations

其中：

[PROJECT_ID] 是這項要求的專案 ID。
[ZONE] 是此要求的區域名稱。

將要求主體保留空白。

以下是區域作業要求的輸出範例。在此輸出中，會顯示主機遷移的詳細資料。

{
 "kind": "compute#operation",
 "id": "3216798767364213712",
 "name": "systemevent-1543845145000-57c1e7574b840-a195b637-5ff74d9b",
 "zone": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-c",
 "operationType": "compute.instances.migrateOnHostMaintenance",
 "targetLink": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-c/instances/my-instance",
 "targetId": "3070988523247098025",
 "status": "DONE",
 "statusMessage": "Instance migrated during Compute Engine maintenance.",
 "user": "system",
 "progress": 100,
 "insertTime": "2018-12-03T05:52:25.000-08:00",
 "startTime": "2018-12-03T05:52:25.000-08:00",
 "endTime": "2018-12-03T05:52:25.000-08:00",
 "selfLink": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-c/operations/systemevent-1543845145000-57c1e7574b840-a195b637-5ff74d9b"
}

設定可用性政策

您可以使用 onHostMaintenance 和 automaticRestart 屬性，藉此調整執行個體的維護行為和自動重新啟動設定。除非您明確指定，否則系統會將預設值套用至所有的執行個體。

onHostMaintenance：在可能導致執行個體重新啟動的維護作業期間，決定執行個體的行為。
- [預設值] migrate：讓 Compute Engine 在維護作業期間即時遷移執行個體。
- terminate：終止執行個體，而不進行遷移。
automaticRestart：決定執行個體在發生當機情形或遭到系統終止時的行為。
- [預設值] true：如果執行個體發生當機情形或遭到終止，Compute Engine 會重新啟動執行個體。
- false：如果執行個體發生當機情形或遭到終止，Compute Engine 不會重新啟動執行個體。

無論您是初次建立執行個體或已完成建立執行個體，都可以使用 setScheduling 方法變更執行個體的可用性政策。

執行個體建立期間的設定選項

主控台

在 GCP 主控台中，前往「VM Instances」(VM 執行個體) 頁面。
前往 VM 執行個體頁面
按一下 [建立執行個體]。
在「Create a new instance」 (建立新執行個體) 頁面上，填入您要為執行個體設定的屬性。

展開 [Management, security, disks, networking, sole tenancy] (管理、安全性、磁碟、網路、單獨租用) 選項。
在「Availability policy」(適用政策) 底下，設定「Automatic restart」(自動重新啟動) 和「On host maintenance」(在主機維護期間) 選項。
按一下 [Create] (建立) 來建立執行個體。

gcloud

如要指定 gcloud compute 中新執行個體的可用性政策，請使用 --maintenance-policy 標記指定要讓執行個體遷移或終止。根據預設，除非您提供 --no-restart-on-failure 標記，否則系統會自動將執行個體設為重新啟動。

gcloud compute instances create INSTANCE .. \
    [--maintenance-policy MAINTENANCE_POLICY] \
    [--no-restart-on-failure]

API

在 API 中，對下列網址提出 POST 要求，將專案和區域分別替換成您的專案 ID 和執行個體所在區域：

https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/instances

同時將 onHostMaintenance 和 automaticRestart 參數納入要求內容的一部分：

{
  "name": "example-instance",
  "description": "Front-end for real-time ingest; don't migrate.",
  ...
  // User options for influencing this Instance’s life cycle.
  "scheduling": {
    "onHostMaintenance": "migrate",
    "automaticRestart": "true" # specifies that Google Compute Engine should automatically restart your instance
  }
}

詳情請參閱執行個體參考說明文件。

更新執行個體的選項

主控台

前往 Google Cloud Platform 主控台的「VM 執行個體」頁面。
前往「VM 執行個體」頁面。
按一下您要更新設定的執行個體。
在「Availability policies」(適用政策) 底下，按一下 [Edit] (編輯) 按鈕即可變更可用性政策。

gcloud

如要更新執行個體的可用性政策，請使用 instances set-scheduling 指令，並指定上述執行個體建立指令中相同的參數和標記：

gcloud compute instances set-scheduling INSTANCE \
    [--maintenance-policy BEHAVIOR] \
    [--no-restart-on-failure | --restart-on-failure]

API

在 API 中，對下列網址提出要求，將專案和區域分別替換成您自己的專案 ID 和執行個體所在區域：

https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-f/instances/setScheduling

您的要求本文必須包含可用性政策的新值：

{
  "onHostMaintenance": "migrate"
  "automaticRestart": "true" # specifies that Google Compute Engine should automatically restart your instance
}

詳情請參閱 instances().setScheduling 參考說明文件。

測試您的可用性政策

您可以在設定可用性政策後模擬維護作業，測試這些可用性政策對應用程式的影響。舉例來說，您可以模擬下列其中一項情境中維護作業對執行個體的影響：

您已設定讓執行個體在維護作業期間即時遷移，並且需要測試即時遷移作業對應用程式的影響。
您有在先佔 VM 執行個體上執行的批次作業，並且需要測試應用程式如何執行一或多個執行個體的先佔和關閉作業。
您已設定讓執行個體在維護作業期間終止及重新啟動，而不執行即時遷移作業，並且需要測試應用程式如何執行這個關閉和重新啟動程序。

模擬維護作業有特定 API 頻率限制。

您可以透過 gcloud 指令列工具或 API 要求，在執行個體上模擬維護作業。

gcloud

執行 instances simulate-maintenance-event 指令，強制執行個體啟用所設定的維護政策動作：

gcloud compute instances simulate-maintenance-event [INSTANCE_NAME] \
    --zone [ZONE]

其中：

[INSTANCE_NAME] 是您要模擬維護作業的執行個體名稱。您可以指定多個執行個體名稱，即可在位於相同區域的多個執行個體上模擬維護作業。
[ZONE] 是執行個體所在的區域。

API

在 API 中，對 Compute Engine API 中的 compute.instances.simulateMaintenanceEvent 方法提出要求：

POST https://www.googleapis.com/compute/v1/projects/[PROJECT_ID]/zones/[ZONE]/instances/[INSTANCE_NAME]/simulateMaintenanceEvent

其中：

[INSTANCE_NAME] 是您要模擬維護作業的執行個體名稱。
[ZONE] 是執行個體所在的區域。

如要進一步瞭解此方法，請參閱 instances().simulateMaintenanceEvent 參考說明文件。

後續步驟

進一步瞭解即時遷移作業。
瞭解如何偵測即時遷移作業。

本頁內容對您是否有任何幫助？請提供意見：

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see our Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

上次更新：五月 23, 2019。

事前準備

維護事件

選擇可用性政策

即時遷移

終止及 (視需要) 重新啟動

自動重新啟動

查看 Compute Engine 作業

主控台

gcloud

API

設定可用性政策

執行個體建立期間的設定選項

主控台

gcloud

API

更新執行個體的選項

主控台

gcloud

API

測試您的可用性政策

gcloud

API

後續步驟

傳送您對下列選項的寶貴意見...