安装云助手Agent

RPM和DEB包管理方式

适合Alibaba Cloud Linux、CentOS、RHEL、SUSE Linux、Debian和Ubuntu等操作系统。

1. 以sudo权限的用户远程连接ECS实例。

   具体操作，请参见使用Workbench工具以SSH协议登录Linux实例。

2. 执行如下脚本，完成云助手安装包的下载与安装。

   重要

   以下脚本会默认安装最新版本的Agent，如果您想安装指定版本，请将脚本中 VERSION=latest修改为指定的版本号，例如 VERSION=2.2.3.398，可用的版本有：

   • x86版本：2.2.0.102、2.2.0.106、2.2.2.181、2.2.3.187、2.2.3.221、2.2.3.247、2.2.3.256、2.2.3.269、2.2.3.282、2.2.3.289、2.2.3.326、2.2.3.349、2.2.3.372、2.2.3.398

   • ARM版本：2.4.3.282、2.4.3.326、2.4.3.349、2.4.3.372、2.4.3.398

   内网下载安装脚本

   推荐，适用于ECS实例，默认可以通过内网下载。

   #!/bin/bash
   
   VERSION=latest
   PACKAGE=
   PKG_URI=
   
   REGION=$(curl http://100.100.100.200/latest/meta-data/region-id)
   DOMAIN=aliyun-client-assist-${REGION}.oss-${REGION}-internal.aliyuncs.com
   
   arch=$(uname -m)
   echo "[main] arch = ${arch}"
   case $arch in
       "i386"|"i686"|"x86_64"|"amd64")
           if command -v rpm; then
               PACKAGE="aliyun_assist_${VERSION}.rpm"
           else
               PACKAGE="aliyun_assist_${VERSION}.deb"
           fi
           PKG_URI="https://$DOMAIN/linux/$PACKAGE"
           ;;
       *)
           if command -v rpm; then
               PACKAGE="aliyun-assist-${VERSION}-1.aarch64.rpm"
           else
               PACKAGE="aliyun-assist-${VERSION}-1_arm64.deb"
           fi
           PKG_URI="https://$DOMAIN/arm/$PACKAGE"
   esac
   
   if command -v wget; then
       sudo wget $PKG_URI
   elif command -v curl; then
       curl -o $PACKAGE $PKG_URI
   else
       echo "[WARN] command wget/curl not found, exit"
       exit 1;
   fi;
   
   if command -v rpm; then
       sudo rpm -ivh --force $PACKAGE
   elif command -v dpkg; then
       sudo dpkg -i $PACKAGE
   else
       echo "[WARN] command rpm/dpkg not found, exit"
       exit 2;
   fi
   
   if [[ -e /etc/redhat-release ]]; then
       if sudo systemctl status qemu-guest-agent; then
           sudo systemctl stop qemu-guest-agent
           sudo systemctl disable qemu-guest-agent
           sudo systemctl restart aliyun.service
       fi
   fi
   

   公网下载安装脚本

   适用于非阿里云主机以及可出公网的ECS实例。

   #!/bin/bash
   
   VERSION=latest
   PACKAGE=
   PKG_URI=
   
   DOMAIN=aliyun-client-assist.oss-accelerate.aliyuncs.com
   
   arch=$(uname -m)
   echo "[main] arch = ${arch}"
   case $arch in
       "i386"|"i686"|"x86_64"|"amd64")
           if command -v rpm; then
               PACKAGE="aliyun_assist_${VERSION}.rpm"
           else
               PACKAGE="aliyun_assist_${VERSION}.deb"
           fi
           PKG_URI="https://$DOMAIN/linux/$PACKAGE"
           ;;
       *)
           if command -v rpm; then
               PACKAGE="aliyun-assist-${VERSION}-1.aarch64.rpm"
           else
               PACKAGE="aliyun-assist-${VERSION}-1_arm64.deb"
           fi
           PKG_URI="https://$DOMAIN/arm/$PACKAGE"
   esac
   
   if command -v wget; then
       sudo wget $PKG_URI
   elif command -v curl; then
       curl -o $PACKAGE $PKG_URI
   else
       echo "[WARN] command wget/curl not found, exit"
       exit 1;
   fi;
   
   if command -v rpm; then
       sudo rpm -ivh --force $PACKAGE
   elif command -v dpkg; then
       sudo dpkg -i $PACKAGE
   else
       echo "[WARN] command rpm/dpkg not found, exit"
       exit 2;
   fi
   
   if [[ -e /etc/redhat-release ]]; then
       if sudo systemctl status qemu-guest-agent; then
           sudo systemctl stop qemu-guest-agent
           sudo systemctl disable qemu-guest-agent
           sudo systemctl restart aliyun.service
       fi
   fi

FreeBSD

1. 以sudo权限的用户远程连接ECS实例。

   具体操作，请参见使用Workbench工具以SSH协议登录Linux实例。

2. 执行如下脚本，完成云助手安装包的下载与安装。

   重要

   • 以下脚本会默认安装最新版本的Agent，如果您想安装指定版本，请将脚本中 VERSION=latest修改为指定的版本号，例如 VERSION=2.2.3.398，可用的版本有：2.3.3.529、2.3.3.704、2.3.3.857。

   • FreeBSD 11仅支持2.3.3.529版本。

   内网下载安装脚本

   推荐，适用于ECS实例，默认可以通过内网下载。

   #!/bin/sh
   
   VERSION=latest
   use_curl=0
   which curl >/dev/null 2>&1 && use_curl=1
   if [ $use_curl -eq 1 ];then
       REGION=$(curl http://100.100.100.200/latest/meta-data/region-id)
   else
       REGION=$(wget -O - http://100.100.100.200/latest/meta-data/region-id)
   fi
   DOMAIN=aliyun-client-assist-${REGION}.oss-${REGION}-internal.aliyuncs.com
   PACKAGE=aliyun_assist_${VERSION}.txz
   PKG_URI="https://$DOMAIN/freebsd/$PACKAGE"
   
   if [ $use_curl -eq 1 ];then
       curl -o $PACKAGE $PKG_URI
   else
       wget -O $PACKAGE $PKG_URI
   fi
   pkg install -U -y $PACKAGE
   service aliyun start

   公网下载安装脚本

   适用于非阿里云主机以及可出公网的ECS实例。

   #!/bin/sh
   
   VERSION=latest
   DOMAIN=aliyun-client-assist.oss-accelerate.aliyuncs.com
   PACKAGE=aliyun_assist_${VERSION}.txz
   PKG_URI="https://$DOMAIN/freebsd/$PACKAGE"
   
   use_curl=0
   which curl >/dev/null 2>&1 && use_curl=1
   if [ $use_curl -eq 1 ];then
       curl -o $PACKAGE $PKG_URI
   else
       wget -O $PACKAGE $PKG_URI
   fi
   pkg install -U -y $PACKAGE
   service aliyun start

Binary安装方式

适合主流Linux操作系统。

1. 以sudo权限的用户远程连接ECS实例。

   具体操作，请参见使用Workbench工具以SSH协议登录Linux实例。

2. 执行如下脚本，完成云助手安装包的下载与安装。

   重要

   以下脚本会默认安装最新版本的Agent，如果您想安装指定版本，请将脚本中 VERSION=latest修改为指定的版本号，例如 VERSION=2.2.3.398，可用的版本有：

   • x86版本：2.2.3.282、2.2.3.289、2.2.3.326、2.2.3.349、2.2.3.372、2.2.3.398

   • ARM版本：2.4.3.282、2.4.3.326、2.4.3.349、2.4.3.372、2.4.3.398

   内网下载安装脚本

   推荐，适用于ECS实例，默认可以通过内网下载。

   #!/bin/bash
   
   VERSION=latest
   PACKAGE=
   PKG_URI=
   
   REGION=$(curl http://100.100.100.200/latest/meta-data/region-id)
   DOMAIN=aliyun-client-assist-${REGION}.oss-${REGION}-internal.aliyuncs.com
   
   arch=$(uname -m)
   echo "[main] arch = ${arch}"
   case $arch in
       "i386"|"i686"|"x86_64"|"amd64")
           PACKAGE="aliyun_assist_${VERSION}.deb"
           PKG_URI="https://$DOMAIN/linux/$PACKAGE"
           ;;
       *)
           PACKAGE="aliyun-assist-${VERSION}-1_arm64.deb"
           PKG_URI="https://$DOMAIN/arm/$PACKAGE"
   esac
   
   if command -v wget; then
       sudo wget $PKG_URI
   elif command -v curl; then
       curl -o $PACKAGE $PKG_URI
   else
       echo "[WARN] command wget/curl not found, exit"
       exit 1
   fi;
   
   TARGET_DIR=/usr/local/share/aliyun-assist
   sudo unzip -o $PACKAGE -d $TARGET_DIR/
   sudo chmod a+x $TARGET_DIR/$VERSION/update_install
   sudo bash $TARGET_DIR/$VERSION/update_install
   

   公网下载安装脚本

   适用于非阿里云主机以及可出公网的ECS实例。

   #!/bin/bash
   
   VERSION=latest
   PACKAGE=
   PKG_URI=
   
   DOMAIN=aliyun-client-assist.oss-accelerate.aliyuncs.com
   
   arch=$(uname -m)
   echo "[main] arch = ${arch}"
   case $arch in
       "i386"|"i686"|"x86_64"|"amd64")
           PACKAGE="aliyun_assist_${VERSION}_update.zip"
           PKG_URI="https://$DOMAIN/linux/$PACKAGE"
           ;;
       *)
           PACKAGE="aliyun-assist-${VERSION}-update_arm.zip"
           PKG_URI="https://$DOMAIN/arm/$PACKAGE"
   esac
   
   if command -v wget; then
       sudo wget $PKG_URI
   elif command -v curl; then
       curl -o $PACKAGE $PKG_URI
   else
       echo "[WARN] command wget/curl not found, exit"
       exit 1
   fi;
   
   TARGET_DIR=/usr/local/share/aliyun-assist
   sudo unzip -o $PACKAGE -d $TARGET_DIR/
   sudo chmod a+x $TARGET_DIR/$VERSION/update_install
   sudo bash $TARGET_DIR/$VERSION/update_install
   

源代码安装方式

1. 以sudo权限的用户远程连接ECS实例。

   具体操作，请参见使用Workbench工具以SSH协议登录Linux实例。

2. 安装Git和Go等必要的软件。

   此示例通过yum安装，如果您使用其他Linux版本，请修改为对应的包管理工具。

   • 安装Git：

     sudo yum install git -y

   • 安装Go：

     sudo yum install go -y

3. 下载云助手Agent源码。

   sudo git clone https://github.com/aliyun/aliyun_assist_client

4. 进入源码存放目录。

   cd ./aliyun_assist_client

5. 编译源码。

   sudo go build

   如果返回结果无报错信息，表示安装成功。

6. 如果ECS实例的网络类型为经典网络，执行以下操作。

   在云助手的安装目录下，创建名为region-id的文件，并在region-id文件中填入ECS实例所属地域的ID。以云助手默认安装路径为例，创建region-id文件并添加cn-hangzhou地域ID的命令如下：

   • CoreOS操作系统：

     sudo sh -c 'echo "cn-hangzhou" > /opt/local/share/aliyun-assist/region-id'

   • 其他操作系统（Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等）：

     sudo sh -c 'echo "cn-hangzhou" > /usr/local/share/aliyun-assist/region-id'

   以其他操作系统（Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等）为例，回显如下：

7. 运行云助手Agent。

   aliyun-service -d