管理虚拟机Agent

虚拟机Agent状态说明

虚拟机Agent的状态及说明，请参见表1。

虚拟机Agent支持的操作系统说明

虚拟机Agent支持多个操作系统。您需要根据表2制作镜像，使用制作的镜像创建弹性云服务器和安装虚拟机Agent。

安装虚拟机Agent操作视频

安装虚拟机Agent

本操作指导您为“虚拟机”、“虚拟机+Kubernetes”类型环境下纳管的单台虚拟机（弹性云服务器ECS、自定义服务器）安装虚拟机Agent。执行本操作需要满足以下条件：

• 环境下已经纳管虚拟机资源且未安装虚拟机Agent。为环境纳管虚拟机资源，请参考纳管基础资源。
• 虚拟机需要已经安装2.x或以上版本的Python。

1. 登录ServiceStage控制台。
2. 选择“环境管理”，进入“环境管理”页面。
3. 单击待操作虚拟机类型环境名称，进入环境“概览”页面。
4. 选择“计算”资源类型下的“弹性云服务器 ECS”或者“自定义服务器”资源名称。
5. 在右侧已纳管的资源列表，找到需要安装Agent的虚拟机，在“Agent 状态”列单击“安装”，弹出Agent安装窗口。
6. 选择“授权模式”，授权Agent可以使用您的身份认证信息，获取应用的部署、升级、启动、停止等任务，并执行任务。

   授权模式	说明
   委托授权	仅纳管的弹性云服务器支持。 单击，选择已经创建的委托。 新创建委托，请参考如何创建委托？。 创建委托时，您需要委托op_svc_ecs账号或者ECS云服务，并且在相应的区域选择Tenant Administrator策略。 单击。
   AK/SK	安全起见，请获取并使用具有“ServiceStage Development”权限的AK、SK。AK、SK所属账号需和安装虚拟机Agent时使用的账号在同一个用户下。 AK、SK获取请参考访问密钥。 选择“AK/SK填写方式”。 手工方式 在虚拟机Agent安装命令中，会使用{AK} {SK}占位符表示AK、SK，而不会包含AK、SK的真实值。在复制安装命令后登录虚拟机安装Agent的过程中，需要您根据提示手工输入AK、SK的值，保密性更好。 快捷方式 会把AK、SK直接填充到虚拟机Agent安装命令中。在复制安装命令后登录虚拟机，输入安装命令即可执行Agent安装，更加方便。 请在“AK”、“SK”输入框输入已经获取到的“AK”及对应“SK”的值。

7. 单击“复制命令”，复制窗口下方自动生成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”模式、为弹性云服务器安装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 ${AK}${SK} ${Project_ID} ${Version} ${Region_Name} ${Flag}

   • “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 ${AK}${SK} ${Project_ID} ${Version} ${Region_Name} ${Flag} ${Domain_Name} ${Server_ID} ${Server_IP} ${Server_Name}

   命令参数说明如下表所示：

   参数	说明
   AGENT_INSTALL_URL	Agent安装地址。
   {AK}、{SK}	访问密钥。 6选择“手工方式”，{AK} 、{SK}为访问密钥占位符，不会包含AK、SK的真实值。 6选择“快捷方式”，{AK}、 {SK}为访问密钥的真实值。
   ${Region_Name}	区域名称。例如：ap-southeast-1。
   ${Domain_Name}	全局域名。
   ${Project_ID}	项目ID。 如何获取项目ID，请参考如何获取项目ID？。
   ${Version}	版本号。 缺省使用latest，表示自动去下载最新版本。
   ${Flag}	是否自动添加应用访问端口。 true：是。 false：否。
   ${Server_ID}	自定义服务器的唯一标识。
   ${Server_IP}	自定义服务器的IP地址。
   ${Server_Name}	自定义服务器的名称。

8. 参照界面提示登录虚拟机，执行安装命令。

   6选择“手工方式”，输入安装命令回车后请根据提示输入已经获取到的“AK”、“SK”的值。

   当显示“Install agent success!”时，表示安装成功。

   • 虚拟机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？处理。

升级虚拟机Agent版本

已安装的虚拟机Agent状态为“在线”并且有新版本时，可以参考本操作升级其版本。

1. 登录ServiceStage控制台。
2. 选择“环境管理”，进入“环境管理”页面。
3. 单击待操作虚拟机类型环境名称，进入环境“概览”页面。
4. 选择“计算”资源类型下的“弹性云服务器 ECS”或者“自定义服务器”资源名称。
5. 在右侧已纳管的资源列表，勾选待操作的资源，单击“升级agent”。
6. 单击“确定”。

   等待“Agent状态”由“升级中”变为“在线”后，虚拟机Agent升级完成。

重启虚拟机Agent

已安装的虚拟机Agent状态为“在线”时，可以根据实际业务需要重启。

1. 登录ServiceStage控制台。
2. 选择“环境管理”，进入“环境管理”页面。
3. 单击待操作虚拟机类型环境名称，进入环境“概览”页面。
4. 选择“计算”资源类型下的“弹性云服务器 ECS”或者“自定义服务器”资源名称。
5. 在右侧已纳管的资源实例列表，勾选待操作的实例，单击“重启agent”。
6. 单击“确定”。

   等待“Agent状态”由“重启中”变为“在线”后，虚拟机Agent重启完成。