排定修補工作

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

除了視需要執行修補工作，您可能還想建立修補部署，讓修補工作根據設定的時間表自動執行。

每個修補程式部署可以設定一次性排程，在特定日期和時間執行修補工作，也可以設定週期性排程，在指定的間隔執行修補工作。

執行個體篩選器可讓您同時修補多個執行個體。這些篩選器會在個別修補作業執行時套用。這樣就能確保即時擷取專案中的變更。舉例來說，假設您建立修補程式部署作業，以便從現在起兩週內，將修補程式套用至區域 asia-souteast1-b 中的所有執行個體。在建立修補程式時，您在該區域有 20 個執行個體，但幾天後，有 40 個新執行個體加入該區域。由於篩選器會在修補程式開始時套用，因此會更新所有 60 個執行個體。這樣一來，您就能新增及移除執行個體，而無須更新修補程式部署時程。

事前準備

• 查看 OS Config 配額。
• 如果尚未設定，請先設定驗證機制。驗證是指驗證身分，以便存取 Google Cloud 服務和 API 的程序。如要在本機開發環境中執行程式碼或範例，您可以選取下列任一選項，向 Compute Engine 進行驗證：
  

  Select the tab for how you plan to use the samples on this page:

  Console

  When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

  gcloud

  1. After installing the Google Cloud CLI, initialize it by running the following command:

     gcloud init

     If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  2. Set a default region and zone.

  REST

  To use the REST API samples on this page in a local development environment, you use the credentials you provide to the gcloud CLI.

  After installing the Google Cloud CLI, initialize it by running the following command:

  gcloud init

  If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  For more information, see Authenticate for using REST in the Google Cloud authentication documentation.

您可以使用 Google Cloud 控制台、Google Cloud CLI 或 REST 安排修補工作。

權限

專案擁有者具備建立及管理修補程式部署作業的完整存取權。您必須授予其他使用者權限，您可以授予下列精細角色：

• roles/osconfig.patchDeploymentAdmin：包含建立、刪除、取得及列出修補程式部署作業的權限。
• roles/osconfig.patchDeploymentViewer：包含取得及列出修補程式部署作業的唯讀存取權。

舉例來說，如要授予使用者管理員修補程式部署權限，請執行下列指令：

gcloud projects add-iam-policy-binding project-id \
    --member user:user-id@gmail.com \
    --role roles/osconfig.patchDeploymentAdmin

更改下列內容：

• project-id：專案 ID。
• user-id：使用者的 Google Workspace 使用者名稱。

建立修補程式部署作業

建立修補程式部署作業時，修補程式部署作業的名稱必須符合下列命名規則：

• 每個名稱在專案中不得重複
• 只能包含小寫英文字母、數字和連字號
• 以英文字母開頭
• 結尾須為數字或英文字母
• 長度介於 1 至 63 個字元之間

在 Google Cloud CLI 和 REST 中，修補程式部署作業的名稱稱為 patch-deployment-id。

開始部署修補程式後，您可以使用修補程式資訊主頁監控修補程式。修補工作開始後，系統大約需要 30 分鐘才能在資訊主頁上填入資料。

gcloud compute os-config patch-deployments create patch-deployment-id \
    --file patch-deployment-file

instanceFilter:
  zones:
  - us-west2-b
  - us-west2-c
recurringSchedule:
  frequency: WEEKLY
  weekly:
    dayOfWeek: TUESDAY
  timeOfDay:
    hours: 19
    minutes: 30
  timeZone:
    id: America/Los_Angeles
  startTime: '2019-09-01T12:00:00Z'
  endTime: '2020-09-01T12:00:00Z'

POST https://osconfig.googleapis.com/v1/projects/project-id/patchJobs:execute

{
  "instanceFilter": instance-filter

  // Add one of the following parameters:
  "recurringSchedule": schedule
  "oneTimeSchedule": schedule
}

{
 "instanceFilter":{
   "zones":[
     "us-west2-b",
     "us-west2-c"
   ]
 },
 "oneTimeSchedule": {
   "executeTime": "2020-01-10T00:00:00Z"
 }
}

POST https://osconfig.googleapis.com/v1/projects/project-id/patchDeployments
{
  "instanceFilter":{
    "zones":[
      "us-west2-b",
      "us-west2-c"
    ]
  },
  "recurringSchedule":{
    "frequency":"WEEKLY",
    "weekly":{
      "dayOfWeek":"TUESDAY"
    },
    "timeOfDay":{
      "hours":19,
      "minutes":30
    },
    "timeZone":{
      "id":"America/Los_Angeles"
    },
    "startTime":"2019-09-01T12:00:00Z",
    "endTime":"2020-09-01T12:00:00Z"
  }
}

列出修補程式部署作業

gcloud compute os-config patch-deployments list

NAME              LAST_RUN                  NEXT_RUN              FREQUENCY
first-deployment  2019-12-18T00:07:00.738Z  ---                   Once: Scheduled for 2019-12-18T00:07:00.000Z
my-deployment1    2020-01-05T14:00:00.228Z  2020-01-12T14:00:00Z  Recurring - Weekly
my-deployment2    ---                       2020-01-15T05:30:00Z  Recurring - Monthly on specific date(s)

gcloud compute os-config patch-deployments list --limit 10 --page-size 2

GET https://osconfig.googleapis.com/v1/projects/project-id/patchDeployments

說明修補程式部署作業

gcloud compute os-config patch-deployments describe patch-deployment-id

GET https://osconfig.googleapis.com/v1/projects/project-id/patchDeployments/patch-deployment-id

刪除修補程式部署作業

gcloud compute os-config patch-deployments delete patch-deployment-id

DELETE https://osconfig.googleapis.com/v1/projects/project-id/patchDeployments/patch-deployment-id

後續步驟

• 進一步瞭解Patch。
• 建立修補工作。
• 管理修補工作。