管理自動配置器

請運用本文提供的操作說明來執行自動配置器的管理工作，例如建立、描述、更新、停止和刪除自動配置器。

事前準備

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

建立自動配置器

隨著您想要使用的自動調度資源政策不同，建立自動配置器的方式也會略有差異。如需建立自動配置器的操作說明，請參閱：

• 根據 CPU 或負載平衡服務規模調度資源
• 根據 Stackdriver Monitoring 指標調度資源

取得自動配置器相關資訊

如要取得某個自動配置器的詳細資訊，或確認自動配置器已成功建立，請使用 Console、gcloud compute instance-groups managed describe 子指令、或是 API 中區域或地區自動配置器資源的 get 方法。

這項工作需要的權限

如要執行這項工作，您必須具備下列權限。

• 專案的 compute.autoscalers.get

Console

1. 前往 GCP Console 的「Instance Groups」(執行個體群組) 頁面。

   前往「Instance Groups」(執行個體群組) 頁面

2. 在清單中按一下執行個體群組名稱，即可開啟執行個體群組詳細資料頁面。
3. 按一下 [Details] (詳細資料) 即可查看群組的詳細資料，包括群組的自動調度資源設定。

gcloud

在 gcloud 指令列工具中，使用 describe 子指令：

gcloud compute instance-groups managed describe GROUP

API

如要擷取區域代管執行個體群組的自動配置器資源詳細資料，請使用 get 方法。如果是地區代管執行個體群組，請使用 regionAutoscaler 的 get 方法。

GET https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/autoscalers/example-autoscaler

200 OK

{

 "kind": "compute#autoscaler",
 "name": "",
 "target": "https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/instanceGroupManagers/test-managed-group",
 "autoscalingPolicy": {
  "minNumReplicas": 2,
  "maxNumReplicas": 10,
  "coolDownPeriodSec": 60,
  "cpuUtilization": {
   "utilizationTarget": 0.8
  }
 },
 "id": "14869149674555507326",
 "creationTimestamp": "2015-03-25T01:56:56.084711335+00:00",
 "selfLink": "https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/autoscalers/example-autoscaler"
}

更新自動配置器

如要更新自動配置器，請使用 Console、gcloud 工具或 API。

更新自動配置器後，變更可能需要一段時間才會生效，新的自動配置器設定可能需要數分鐘，才會反映在系統上。

這項工作需要的權限

如要執行這項工作，您必須具備下列權限。

• 專案的 compute.autoscalers.get
• 專案的 compute.autoscalers.update
• 專案的 compute.instanceGroupManagers.use

Console

1. 前往 GCP Console 的「Instance Groups」(執行個體群組) 頁面。

   前往「Instance Groups」(執行個體群組) 頁面

2. 在清單中按一下執行個體群組名稱，即可開啟執行個體群組詳細資料頁面。
3. 按一下 [Edit group] (編輯群組) 即可查看及更新群組目前的設定，包括群組的自動調度資源設定。
4. 完成時請按一下 [Save] (儲存)。

gcloud

使用 set-autoscaling 子命令。

您必須在要求中設定自動配置器的所有配置設定，就像第一次建立自動配置器一般。否則未在要求中明確定義的設定，均會重設為預設值。

gcloud compute instance-groups managed set-autoscaling GROUP \
    --max-num-replicas MAX_NUM ...

如需建立自動配置器的操作說明，請參閱根據 Stackdriver Monitoring 指標調度資源，或是根據 CPU 或負載平衡服務規模調度資源的相關說明。

API

如要更新區域代管執行個體群組的自動配置器資源，請使用區域自動配置器的 patch 方法。如果是地區代管執行個體群組，請使用 regionAutoscaler 的 patch 方法。提供要求主體，並在其中包含新的設定。

PATCH https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/autoscalers/example-autoscaler

{
 "autoscalingPolicy": {
  "maxNumReplicas": 20
 }
}

200 OK

{
 "kind": "compute#operation",
 "id": "4244494732310423322",
 "name": "operation-1556912627871-58800f8216ed7-74ab1720-7d360603",
 "zone": "https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f",
 "operationType": "compute.autoscalers.patch",
 "targetLink": "https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/autoscalers/example-autoscaler",
 "targetId": "340775527929467142",
 "status": "RUNNING",
 ...
}

執行任何會修改資料的要求時，系統均會傳回 zoneOperations 資源，您可查詢作業來檢查變更的狀態。

關閉或限制自動配置器 (Beta 版)

Beta 版

本產品或功能目前處於預先發布版階段，因此內容可能會有所變更，或是只提供部分支援。詳情請參閱產品推出階段。

關閉自動配置器來暫時避免自動配置器為執行個體群組進行資源調度，或限制自動配置器，使其只能為執行個體群組進行向上擴充的資源調度。要進行下列事項時，此功能非常實用。

• 在不受資源規模縮減干擾的情況下調查執行個體。
• 重新設定代管執行個體群組的多個屬性，且進行部分重新設定期間，系統不會觸發資源調度動作。
• 維持執行個體群組容量，以在將工作負載重新導向至新的執行個體群組時，可快速復原。

如果重新啟用自動配置器，自動配置器會自動恢復正常運作狀態。

在 Console、gcloud 工具或 API 中，將自動配置器的 mode 設定為：

• OFF：暫時停用自動調度資源功能。使用此模式可防止系統自動變更執行個體群組的大小。自動調度資源設定會保持不變，以供日後重新啟用自動調度資源功能。
• ONLY_UP：將自動資源調度限制為僅限新增執行個體。使用此模式可避免群組縮小，並讓群組可在負載增加時佈建額外的 VM。
• ON：根據政策啟用所有自動調度資源作業。

注意事項：無論本身的模式為何，自動配置器均會計算建議的群組大小。您可以透過讀取自動配置器或 regionAutoscaler 資源的 recommendedSize 屬性來查看建議的大小。

這項工作需要的權限

如要執行這項工作，您必須具備下列權限。

• 專案的 compute.autoscalers.get
• 專案的 compute.autoscalers.update
• 專案的 compute.instanceGroupManagers.use

Console

1. 前往 GCP Console 的「Instance Groups」(執行個體群組) 頁面。

   前往「Instance Groups」(執行個體群組) 頁面

2. 在清單中按一下執行個體群組名稱，即可開啟執行個體群組詳細資料頁面。
3. 按一下 [Edit group] (編輯群組) 即可查看群組目前的設定，包括群組的自動調度資源設定。
4. 在「Autoscaling」(自動調度資源) 下，設定「Autoscaing mode」(自動調度資源模式) 來停用或限制自動調度資源，或重新開啟自動配置器。

gcloud

使用 Beta 版 set-autoscaling 子指令搭配 --mode 旗標來關閉、限制或開啟自動配置器。

您必須在要求中設定自動配置器的所有配置設定，就像第一次建立自動配置器一般。否則未在要求中明確定義的設定，均會重設為預設值。

gcloud beta compute instance-groups managed set-autoscaling GROUP \
    --mode [MODE] ...

其中：

• [MODE] 是：
  • OFF 會停用自動配置器，但會保持其設定。
  • ONLY_UP 會將自動配置器限制為只能新增執行個體。
  • ON 會根據本身的政策重新啟用所有自動配置器活動。

API

如要更新區域代管執行個體群組的自動配置器資源模式，請使用自動配置器的 patch 方法。如果是地區代管執行個體群組，請使用 regionAutoscaler 的 patch 方法。提供要求主體，並在其中包含 autoscalingPolicy.mode 屬性。

PATCH https://www.googleapis.com/compute/beta/projects/my-project/regions/us-central1-f/autoscalers?autoscaler=my-autoscaler

{
  "autoscalingPolicy": {
    "mode":"[MODE]"
  }
}

其中：

• [MODE] 是：
  • OFF 會停用自動配置器，但會保持其設定。
  • ONLY_UP 會將自動配置器限制為只能新增執行個體。
  • ON 會根據本身的政策重新啟用所有自動配置器活動。

刪除自動配置器

您可以使用 Console、gcloud 工具或 API 永久刪除自動配置器資源。如果您想要暫時停止自動調度資源並保留自動配置器資源及其設定，請改為關閉自動配置器。

這項工作需要的權限

如要執行這項工作，您必須具備下列權限。

• 專案的 compute.autoscalers.delete

Console

1. 前往 GCP Console 的「Instance Groups」(執行個體群組) 頁面。

   前往「Instance Groups」(執行個體群組) 頁面

2. 在清單中按一下執行個體群組名稱，即可開啟執行個體群組詳細資料頁面。
3. 按一下 [Edit group] (編輯群組) 即可查看群組目前的設定，包括群組的自動調度資源設定。
4. 在「Autoscaling」(自動調度資源) 下，按一下 [Delete autoscaling configuration] (刪除自動調度資源設定) 來停止自動配置器並刪除其設定。

gcloud

使用 stop-autoscaling 子指令來停止自動配置器，並刪除其設定。

gcloud compute instance-groups managed stop-autoscaling GROUP

若停止自動配置器，即會將自動配置器從代管執行個體群組中刪除。如要重新啟動自動配置器，則必須使用 set-autoscaling 指令重新建立自動配置器。

如果您使用 gcloud 工具刪除代管執行個體群組，所有連結至代管執行個體群組的自動配置器也會遭到刪除。

API

如要停止自動配置器並刪除其設定，請在 API 中使用 DELETE 方法發出要求：

 DELETE https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/autoscalers/example-autoscaler