安排修补作业

除了按需运行修补作业之外，您可能还需要通过创建补丁程序部署，根据设置的时间安排自动运行修补作业。

您可以为每个补丁程序部署设置一次性时间安排，以在一个特定日期和时间运行修补作业，也可以设置周期性时间安排，以按指定的时间间隔运行修补作业。

您可以通过实例过滤条件同时修补多个实例。这些过滤条件会在每个修补作业运行时应用于该作业。这可确保实时捕获项目中的更改。 例如，假设您创建了补丁程序部署，以在两周后开始将补丁程序应用于 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

  如需在本地开发环境中使用本页面上的 REST API 示例，请使用您提供给 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.

  如需了解详情，请参阅 Google Cloud 身份验证文档中的使用 REST 时进行身份验证。

您可以使用 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

后续步骤

• 详细了解修补。
• 创建修补作业。
• 管理您的修补作业。