安装虚拟机Agent

更新时间：2024-12-16 GMT+08:00

查看PDF

本章节指导您为虚拟机类型环境下纳管的单台虚拟机安装虚拟机Agent。

前提条件

虚拟机环境下已经纳管虚拟机资源且未安装虚拟机Agent。为虚拟机环境纳管虚拟机资源，请参考纳管基础资源。

安装虚拟机Agent

登录ServiceStage控制台。
选择“环境管理”，进入“环境管理”页面。
单击待操作虚拟机类型环境名称，进入环境“概览”页面。
选择“计算”资源类型下的“弹性云服务器 ECS”资源名称。
在右侧已纳管的资源列表，找到需要安装Agent的虚拟机，在“Agent 状态”列单击“安装”，弹出Agent安装窗口。
选择“授权模式”。

授权Agent可以使用您的身份认证信息，获取应用的部署、升级、启动、停止等任务，并执行任务。

您可以选择“委托授权”、“AK/SK”模式进行授权，推荐使用“委托授权”。
- “授权模式”选择“委托授权”：
  单击，选择已经创建的委托后单击。
  
  新创建委托，请参考如何创建委托？。
  
  说明：
  
  创建委托时，您需要委托op_svc_ecs账号或者ECS云服务，并且在相应的区域选择Tenant Administrator策略。
  
  如果需要使用OBS存储，则还需要在委托授权时添加OBS Administrator策略。
- “授权模式”选择“AK/SK”：
  安全起见，请获取并使用具有“ServiceStage Development”权限的AK、SK。AK、SK所属账号需和安装虚拟机Agent时使用的账号在同一个用户下。
  
  AK、SK获取请参考访问密钥。
单击“复制命令”，复制窗口下方自动生成的命令，即为Agent安装命令。
“委托授权”模式，命令示例如下：
```
export AGENT_INSTALL_URL=https://${Region_Name}-servicestage-vmapp.obs.${Region_Name}.${Domain_Name}/vmapp/agent/agent-install.sh;if [ -f `which curl` ];then curl -# -O -k ${AGENT_INSTALL_URL};else wget --no-check-certificate ${AGENT_INSTALL_URL};fi;bash agent-install.sh ${Project_ID} ${Version} ${Region_Name} ${Flag}
```
“AK/SK”模式，命令示例如下：
```
export AGENT_INSTALL_URL=https://${Region_Name}-servicestage-vmapp.obs.${Region_Name}.${Domain_Name}/vmapp/agent/agent-install.sh;if [ -f `which curl` ];then curl -# -O -k ${AGENT_INSTALL_URL};else wget --no-check-certificate ${AGENT_INSTALL_URL};fi;bash agent-install.sh ${AK}${SK} ${Project_ID} ${Version} ${Region_Name} ${Flag}
```
- AGENT_INSTALL_URL为Agent安装地址。
- 如果使用“委托授权”模式，ECS节点有权获取用户的临时AK/SK，命令中不需要输入AK/SK。
- ${AK}、${SK}为访问密钥。
- ${Region_Name}为区域名称。
- ${Domain_Name}为全局域名。
- ${Project_ID}为项目ID，如何获取项目ID请参考如何获取项目ID？。
- ${Version}为版本号，使用latest，自动去下载最新版本。
- ${Flag}为布尔值，表示是否自动添加应用访问端口。true表示是；false表示否。
参照界面提示登录虚拟机，执行安装命令。

虚拟机Agent安装成功后，在安装Agent的虚拟机上生成如下目录：
- /opt/application：使用虚拟机部署方式部署组件的业务、配置文件所在目录。请勿对该目录执行增、删、改操作，否则可能会导致已安装的虚拟机Agent离线。
- /opt/servicestage-agent：安装的虚拟机Agent的配置文件所在目录。请勿对该目录执行增、删、改操作，否则可能会导致已安装的虚拟机Agent离线。
- /var/log/servicestage-agent：安装的虚拟机Agent的日志目录，存储了agent日志agent.log、监控脚本日志servicestage-agent-watchdog.log。请勿对该目录执行删、改操作，否则可能会导致已安装的虚拟机Agent离线。
- /var/log/application：组件日志相关目录。请勿对该目录执行删、改操作，否则可能会导致已安装的虚拟机Agent离线。
- /opt/ssa/packages：虚拟机部署方式部署组件业务包的临时存放目录。请勿对该目录执行删、改操作，否则可能会导致已安装的虚拟机Agent离线。
说明：

如果虚拟机Agent安装失败，请参考如何处理虚拟机Agent安装成功但是界面仍然显示缺少Agent？处理。