管理自動配置器

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

事前準備

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

建立自動配置器

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

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

取得自動配置器的相關資訊

若要取得特定自動配置器的詳細資訊，或是確認是否成功建立自動配置器，請在 API 中使用 instance-groups managed describe 子指令或 get() 方法。

gcloud

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

gcloud compute instance-groups managed describe GROUP

API

在 API 中，發出 GET 要求：

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

200 OK

{

 "kind": "compute#autoscaler",
 "name": "",
 "target": "https://www.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://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/autoscalers/example-autoscaler"
}

更新自動配置器

若要更新自動配置器，可使用 gcloud 指令列工具中的 set-autoscaling 指令，或是使用 API 中的 PUT 方法。

更新自動配置器時，就和首次建立自動配置器時相同，必須替您要求中的自動配置器完成所有配置設定。否則未在要求中明確定義的設定，均會重設為預設值。

舉例而言，如果您想要更新備用資源的上限值和下限值，但不想明確定義其他設定參數 (例如目標 CPU 使用率、等待期等)，則系統會將所有未定義的參數重設為預設值。

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

gcloud

所有更新要求的必填欄位，和建立自動配置器的必填欄位相同：

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

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

API

如要更新自動配置器，請使用 PUT 方法提供更新的要求主體：

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

{
 "name": "example-autoscaler",
 "autoscalingPolicy": {
  "cpuUtilization": {
   "utilizationTarget": 0.5
  },
  "maxNumReplicas": 20
 },
 "target": "https://www.googleapis.com/replicapool/v1beta2/projects/myproject/zones/us-central1-f/instanceGroupManagers/test-managed-group"
}

200 OK

{
 "kind": "autoscaler#operation",
 "name": "example-autoscaler",
 "operationType": "update",
 "targetLink": "https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/autoscalers/example-autoscaler",
 "targetId": "2335397567958752451",
 "status": "DONE",
 "progress": 100
}

執行任何會修改資料要求時，均會傳回區域作業資源，且可查詢作業以檢查變更的狀態。

停止自動配置器

gcloud

使用 stop-autoscaling 子指令可停止自動配置器。

gcloud compute instance-groups managed stop-autoscaling GROUP

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

若是使用 gcloud 工具刪除代管執行個體群組，也會刪除連接到該代管執行個體群組的自動配置器。

API

在 API 中使用 DELETE 方法發出要求，即可刪除自動配置器：

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