管理 OS 政策指派

建立 OS 政策指派項目後，請按照下列程序查看及管理指派項目：

• 更新 OS 政策指派作業：修改 OS 政策指派作業的設定
• 描述 OS 政策指派作業：取得特定 OS 政策指派作業的詳細資料
• 列出 OS 政策指派作業：查看特定區域中的 OS 政策指派作業清單
• 列出 OS 政策指派作業修訂版本：查看特定 OS 政策指派作業可用的修訂版本清單
• 刪除 OS 政策指派作業：刪除特定 OS 政策指派作業
• 偵錯 OS 政策指派作業：排解 OS 政策指派作業問題

您可以使用 Google Cloud 控制台、Google Cloud CLI 或 OS Config API 管理 OS 政策指派作業。

事前準備

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

  選取這個頁面上的分頁，瞭解如何使用範例：

  控制台

  使用 Google Cloud 控制台存取 Google Cloud 服務和 API 時，無須設定驗證。

  gcloud

  1. 安裝 Google Cloud CLI。 完成後，執行下列指令來初始化 Google Cloud CLI：

     gcloud init

     若您採用的是外部識別資訊提供者 (IdP)，請先使用聯合身分登入 gcloud CLI。

• 設定預設地區和區域。

REST

如要在本機開發環境中使用本頁的 REST API 範例，請使用您提供給 gcloud CLI 的憑證。

安裝 Google Cloud CLI。

若您採用的是外部識別資訊提供者 (IdP)，請先使用聯合身分登入 gcloud CLI。

詳情請參閱 Google Cloud 驗證說明文件中的「使用 REST 進行驗證」。

權限

專案擁有者有權管理 OS 政策指派作業。 如要讓其他使用者存取，您必須授予權限。如要管理 OS 政策指派作業，您可以授予下列其中一個精細角色：

• OSPolicyAssignment 管理員 (roles/osconfig.osPolicyAssignmentAdmin)。 包含建立、刪除、更新、取得及列出 OS 政策指派作業的權限。
• OSPolicyAssignment 編輯者 (roles/osconfig.osPolicyAssignmentEditor)。 包含更新、取得及列出 OS 政策指派作業的權限。
• OSPolicyAssignment 檢視者 (roles/osconfig.osPolicyAssignmentViewer)。 包含唯讀存取權，可取得及列出 OS 政策指派作業。

    gcloud projects add-iam-policy-binding PROJECT_ID \
        --member user:USER_ID@gmail.com \
        --role roles/osconfig.osPolicyAssignmentAdmin

更新 OS 政策指派作業

如要更新 OS 政策指派項目，請完成下列步驟：

1. 更新含有 OS 政策指派項目的 YAML 或 JSON 檔案。

   更新要求支援欄位遮罩。您可能只需要更新 OS 政策指派作業中的特定欄位，其他欄位則維持不變。更新或修補程式指令會使用欄位遮罩，告知 API 哪些欄位已變更。更新或修補要求會忽略欄位遮罩中未指定的任何欄位，並保留這些欄位的目前值。如要進一步瞭解欄位遮罩，請參閱 FieldMask。

2. 使用 Google Cloud 控制台、Google Cloud CLI 或 OS Config API 更新 OS 政策指派作業。

   更新 OS 政策指派作業時，系統會建立推出作業。您可以監控推出作業，查看更新進度。詳情請參閱「取得推出作業的詳細資料」。

   控制台

   1. 在 Google Cloud 控制台，依序前往「OS policies」(作業系統政策)>「Assignments」(指派) 頁面。

      前往 Google Cloud 控制台

   2. 找到要編輯的 OS 政策指派項目，然後依序點選「動作」圖示 more_vert>「編輯指派項目」。

   3. 視需要更新。舉例來說，您可以上傳更新後的 OS 政策檔案。

   4. 按一下「開始推出」。

   gcloud

   使用 os-config os-policy-assignments update 指令更新 OS 政策指派項目。

   gcloud compute os-config os-policy-assignments update OS_POLICY_ASSIGNMENT_ID \
       --location=ZONE \
       --file=FILE
   

   更改下列內容：

   • OS_POLICY_ASSIGNMENT_ID：要更新的 OS 政策指派項目名稱
   • ZONE：OS 政策指派所在的可用區

   • FILE：包含更新後 OS 政策指派規格的 JSON 或 YAML 檔案絕對路徑

     如果 OS 政策指派不存在，且您指定 --allow-missing 旗標，VM 管理員會使用指定的 ID 和規格建立 OS 政策指派。

   REST

   在 API 中，建立目標為 projects.locations.osPolicyAssignments.patch 方法的 PATCH 要求。

   PATCH https://osconfig.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/osPolicyAssignments/OS_POLICY_ASSIGNMENT_ID
   
   {
    JSON_OS_POLICY
   }
   

   更改下列內容：

   • PROJECT_ID：專案 ID
   • OS_POLICY_ASSIGNMENT_ID：要更新的 OS 政策指派項目名稱
   • JSON_OS_POLICY：在上一個步驟中建立的 OS 政策指派作業規格。必須採用 JSON 格式。 如要進一步瞭解參數和格式，請參閱 Resource: OSPolicyAssignment。
   • ZONE：OS 政策指派所在的可用區

列出 OS 政策指派作業

 gcloud compute os-config os-policy-assignments list \
     --location=ZONE

GET https://osconfig.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/osPolicyAssignments

描述 OS 政策指派作業

gcloud compute os-config os-policy-assignments describe OS_POLICY_ASSIGNMENT_ID \
     --location=ZONE

GET https://osconfig.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/osPolicyAssignments/OS_POLICY_ASSIGNMENT_ID

列出 OS 政策指派作業修訂版本

gcloud compute os-config os-policy-assignments list-revisions OS_POLICY_ASSIGNMENT_ID \
    --location=ZONE

GET https://osconfig.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/osPolicyAssignments/OS_POLICY_ASSIGNMENT_ID:listRevisions

刪除 OS 政策指派作業

刪除 OS 政策指派作業時，系統會建立推出作業。您可以監控推出作業，查看刪除進度。詳情請參閱「取得推出作業的詳細資料」。

gcloud compute os-config os-policy-assignments delete OS_POLICY_ASSIGNMENT_ID \
    --location=ZONE

DELETE https://osconfig.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/osPolicyAssignments/OS_POLICY_ASSIGNMENT_ID

疑難排解

如要排解 OS 政策指派作業問題，請參閱「排解 VM 管理員問題」。

後續步驟

• 進一步瞭解作業系統政策。
• 建立 OS 政策指派作業。