关于创建Ubuntu 22.04虚拟机Ops-Agent策略、排查策略生效异常及实例组自动安装方法的技术问询

看起来你遇到了Ops Agent策略配置后没生效，控制台还显示Legacy Agent的问题，咱们一步步来排查和解决：

一、排查当前策略不生效的原因 #

• 检查标签匹配是否正确：你的策略里用了group_labels的env: PROJECT-NAME和product: programs，得确认目标Ubuntu 22.04 VM是否真的带有这两个标签。可以用命令查看VM标签：

  gcloud compute instances describe [VM-NAME] --project=PROJECT-NAME --format="value(labels)"
  

  如果VM没有对应标签，策略根本不会触发安装。
• 验证OS类型与区域范围：策略指定了os_types: ubuntu 22.04和zones: europe-west1-b，要确认你的VM确实在这个区域，且操作系统是标准的Ubuntu 22.04（自定义镜像可能存在OS识别偏差）。
• 检查控制台状态延迟：Cloud Console的Agent状态更新有时会有延迟，建议直接登录VM，用命令确认Agent实际状态：

  sudo systemctl status google-cloud-ops-agent
  

  如果未安装，可手动触发策略应用：

  gcloud compute instances update [VM-NAME] --project=PROJECT-NAME --apply-guest-policies
  

• 清理Legacy Agent干扰：如果VM之前安装过Stackdriver等Legacy Agent，可能导致控制台显示混乱。先卸载Legacy Agent：

  sudo apt-get remove stackdriver-agent
  

  再重新应用Ops Agent策略。

二、实例组自动安装Ops Agent的最佳方法 #

针对Managed Instance Group（MIG），推荐两种可靠的自动安装方式：

• 通过实例模板配置启动脚本：
  1. 创建或修改实例模板时，添加启动脚本自动安装Agent：

     #!/bin/bash
     curl -sSO https://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.sh
     sudo bash add-google-cloud-ops-agent-repo.sh --also-install
     

  2. 更新MIG使用新模板，触发滚动更新后，所有新/旧实例都会自动安装Agent。
• 通过Guest Policy结合实例组标签：
  1. 给目标MIG添加统一标签（比如mig-type: programs-stag）；
  2. 修改Ops Agent策略的匹配规则，确保覆盖MIG所有实例：

     assignment:
       group_labels:
         - mig-type: programs-stag
       os_types:
         - short_name: ubuntu
           version: '22.04'
     

  3. 触发MIG滚动更新，让策略自动应用到所有现有实例，新创建的实例也会自动匹配策略安装Agent。

备注：内容来源于stack exchange，提问作者devops on the road