管理客户机政策（旧版）

创建访客政策后，您可以按照以下步骤查看和管理您的政策：

• 更新访客政策：修改访客政策配置。
• 描述访客政策：获取特定访客政策的详细信息。
• 列出访客政策：查看项目中的访客政策列表。
• 删除访客：删除特定访客政策。
• 查看虚拟机实例的配置：查看应用于虚拟机实例的配置。
• 调试访客政策：排查访客政策问题。

由于 OS Config 代理每 10-15 分钟运行一次，因此当您设置政策更新或删除时，大约需要 10-15 分钟才能生效。

您可以使用 Google Cloud CLI 或 REST 来管理访客政策。

准备工作

• 查看 OS Config 配额。
• 设置身份验证（如果尚未设置）。身份验证是通过其进行身份验证以访问 Google Cloud 服务和 API 的过程。如需从本地开发环境运行代码或示例，您可以按如下方式向 Compute Engine 进行身份验证。
  

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

  gcloud

  1. Install the Google Cloud CLI, then initialize it by running the following command:

     gcloud init

  2. Set a default region and zone.

  REST

  如需在本地开发环境中使用本页面上的 REST API 示例，请使用您提供给 gcloud CLI 的凭据。

  Install the Google Cloud CLI, then initialize it by running the following command:

  gcloud init

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

更新访客政策

如需更新访客政策，请完成以下步骤：

1. 更新 YAML 或 JSON 文件。
2. 运行 update 或 patch 命令。更新过程与创建过程类似，只是增加了对用于并发性和一致性控制的 ETag 的支持。

gcloud beta compute os-config guest-policies update POLICY_ID \
     --file=FILE

PATCH https://osconfig.googleapis.com/v1beta/projects/PROJECT_ID/guestPolicies/POLICY_ID

{
  For more information, see Guest policy JSON
}

描述访客政策

gcloud beta compute os-config guest-policies describe POLICY_ID

GET https://osconfig.googleapis.com/v1beta/projects/PROJECT_ID/guestPolicies/POLICY_ID

列出访客政策

gcloud beta compute os-config guest-policies list

GET https://osconfig.googleapis.com/v1beta/projects/PROJECT_ID/guestPolicies

删除访客政策

当 OS Config 代理检测到触发了对某访客政策的删除操作时，系统会保持当前状态，但不会对配置进行进一步维护。例如，假设您设置了访客政策 package-update-zone2b，以在可用区 us-west2-b 中的所有虚拟机上安装软件包 my-package，并保留软件包 UPDATED。

如果您删除 package-update-zone2b 政策，则会发生以下更改：

• us-west2-b 中所有安装了 my-package 的虚拟机会保留 my-package 的安装状态。但当前系统状态不会还原。

• 删除政策后，在以后运行 OS Config 代理时，将发生以下情况：

  • 如果向 us-west2-b 添加了新虚拟机，则 my-package 不会安装到这个新虚拟机上。
  • 对于安装了 my-package 的实例，该软件包不会更新。

gcloud beta compute os-config guest-policies delete POLICY_ID

DELETE https://osconfig.googleapis.com/v1beta/projects/PROJECT_ID/guestPolicies/POLICY_ID

查看虚拟机实例的配置

gcloud beta compute os-config guest-policies lookup VM_NAME \
    --zone=ZONE

POST https://osconfig.googleapis.com/v1beta/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME:lookupEffectiveGuestPolicy

问题排查

检查访客政策

您可以使用 Google Cloud 控制台或 Google Cloud CLI 来检查与项目关联的客机政策。

检查特定虚拟机的访客政策

您可以针对给定虚拟机运行 lookup 命令，以查看哪些配置应用于该虚拟机。

如果虚拟机似乎未遵循预期的访客政策要求，请检查其分配包含该特定虚拟机实例的访客政策列表。这有助于确定访客政策中的 Assignment 字段是否与该特定虚拟机匹配。

使用 os-config guest-policies lookup 命令列出可能针对某个特定虚拟机的访客政策。将 VM_NAME 替换为要检查的虚拟机的名称。

gcloud beta compute os-config guest-policies lookup VM_NAME

如需了解详情，请参阅查看虚拟机实例的配置。

该命令的输出可能会显示访客政策的虚拟机分配属性实际未针对该虚拟机。例如，它可能未列在 Labels 列表或虚拟机名称前缀列表中。

从故障中恢复

系统不会重新尝试安装已安装失败的软件配方。这是因为系统不知道安装失败的软件配方所处的状态。

当调试安装失败的软件配方时，我们建议执行以下步骤：

1. 重命名软件配方。
2. 使用重命名的软件配方删除并重新创建客机政策。

如需了解更多问题排查步骤，请参阅虚拟机管理器问题排查。

后续步骤

• 详细了解操作系统访客政策（旧版）。
• 设置访客政策。