Azure CLI下Linux VM Agent(waagent)安装位置及CLI安装方法

我之前也碰到过一模一样的情况——用--attach-os-disk选项创建VM时，因为跳过了常规的VM初始化流程，系统不会自动预装Azure VM Agent，这直接导致没法通过SSH连接，毕竟Agent是负责管理SSH凭据、扩展部署这些关键功能的核心组件。下面给你详细说下waagent的安装位置和CLI环境下的完整安装步骤：

waagent的默认安装位置 #

• Linux系统：
  • 主程序路径：/usr/sbin/waagent
  • 配置文件路径：/etc/waagent.conf
• Windows系统：
  • 安装目录：C:\WindowsAzure\WaAgent
  • 核心服务名称：WindowsAzureGuestAgent

CLI环境下的waagent安装步骤 #

因为此时没法通过SSH连接VM，首先得通过Azure串行控制台登录到系统：

1. 启用并连接串行控制台（通用步骤） #

先用CLI启用启动诊断（串行控制台依赖该功能）：

az vm boot-diagnostics enable --name <你的VM名称> --resource-group <资源组名称> --storage <存储账户名称>

然后连接到串行控制台：

az vm serial-console connect --name <你的VM名称> --resource-group <资源组名称>

进入控制台后，使用自定义磁盘中原有的系统账户登录即可。

2. Linux系统安装waagent #

根据你的Linux发行版执行对应的安装命令：

• Ubuntu/Debian：

  apt update && apt install walinuxagent -y
  

• RHEL/CentOS：

  yum install WALinuxAgent -y
  

• SUSE：

  zypper install walinuxagent -y
  

安装完成后重启服务并验证状态：

systemctl restart waagent
systemctl status waagent

3. Windows系统安装waagent #

在串行控制台的PowerShell窗口中，执行以下步骤：

1. 从Azure官方渠道获取最新的VM Agent安装包下载地址，通过PowerShell下载：

   Invoke-WebRequest -Uri <官方获取的下载地址> -OutFile AzureVmAgent.msi
   

2. 执行静默安装：

   msiexec /i AzureVmAgent.msi /quiet
   

3. 验证服务是否正常运行：

   Get-Service WindowsAzureGuestAgent
   

安装后的关键操作：配置SSH访问凭据 #

安装完Agent后，还需要给VM设置可用于SSH的用户名和密码（或SSH密钥）：

# 设置用户名和密码
az vm user update --name <你的VM名称> --resource-group <资源组名称> --username <自定义用户名> --password <安全密码>

# 或者设置SSH密钥（更推荐）
az vm user update --name <你的VM名称> --resource-group <资源组名称> --username <自定义用户名> --ssh-key-value <本地公钥文件路径>

最后重启VM让配置生效：

az vm restart --name <你的VM名称> --resource-group <资源组名称>

等VM重启完成后，就可以正常通过SSH连接了！

内容的提问来源于stack exchange，提问作者Piyush Doke