在CodeArts资源池中新建代理

操作场景

通过在主机中安装Agent，并根据需要接入注册到CodeArts服务中，即可作为自定义执行机，供代码检查、构建等任务使用。

资源池支持接入以下类型操作系统的主机操作为自定义执行机。

约束与限制

• 建议一台主机中只安装一个Agent，如果安装多个Agent可能在执行任务时导致Agent下线。
• 一个Agent同一时间只能执行一个任务。
• 请勿使用临时AK/SK，避免安装失败。
• 如果使用的资源池的类型为“LINUX_DOCKER”，机器须关闭“SELinux”，否则无法启动容器。

  关闭方式如下：

  1. 登录主机，执行以下命令，打开配置文件。

     vi /etc/selinux/config

  2. 将“SELINUX=enforcing”修改为“SELINUX=permissive”或“SELINUX=disabled”。
  3. 完成修改后保存。
  4. 执行以下命令，使修改内容立即生效。

     sudo setenforce 0

前提条件

• 已完成新建资源池。
• 用户需要拥有资源池所有者或管理者权限。

  如果使用IIC用户（即通过IAM身份中心创建的用户）新建代理，则该用户需要使用IAM用户的AK/SK，且该IAM用户至少拥有“管理者”权限。

• 已拥有满足以下条件的主机。
  • 规格：4vCPUs 8GiB或以上、磁盘>80GiB。
  • 必须有公网访问权限。
  • 已开通以下域名的防火墙白名单、并开放端口号1200~1699。

    表2 区域域名对应关系

    区域名称	域名
    北京一（cn-north-1）	cloudoctopus-agent.cn-north-1.myhuaweicloud.com
    北京四（cn-north-4）	cloudoctopus-agent.cn-north-4.myhuaweicloud.com
    上海一（cn-east-3）	cloudoctopus-agent.cn-east-3.myhuaweicloud.com
    上海二（cn-east-2）	cloudoctopus-agent.cn-east-2.myhuaweicloud.com
    广州（cn-south-1）	cloudoctopus-agent.cn-south-1.myhuaweicloud.com
    深圳（cn-south-2）	cloudoctopus-agent.cn-south-2.myhuaweicloud.com
    大连（cn-northeast-1）	cloudoctopus-agent.cn-northeast-1.myhuaweicloud.com
    贵阳一（cn-southwest-2 ）	cloudoctopus-agent.cn-southwest-2.myhuaweicloud.com

• 如果主机的操作系统为Linux，CodeArts提供自动安装Java、Git、Docker功能，用户也可以使用root账号手动安装。

  安装方式参考Java官网、Git官网、Docker官网。

• 如果主机的操作系统为Windows或MAC，请使用系统管理员账号手动在服务器中安装Java 8、Git。

  如果主机的操作系统为Windows，请安装64位的Java 8。

新建代理

1. 进入CodeArts首页。
   1. 登录CodeArts控制台，单击，根据需要选择已开通CodeArts的区域。
   2. 单击“前往工作台”。

      如果当前账号采用的是历史计费模式（详情请参见历史计费模式说明），则单击“立即使用”。

2. 在导航栏中单击用户名，选择“租户设置”。
3. 单击“资源池管理 > 资源池”，进入“资源池管理”页面。
4. 在资源池列表中找到目标资源池，单击资源池名称，进入“代理列表”页面。
5. 单击“新建代理”，页面弹出对话框。
   图1 新建代理
   

6. 根据需要完成参数配置。

   表3 新建代理

   参数	配置说明
   自动安装JDK	当资源池类型为“LINUX”或“LINUX_DOCKER”时显示此参数，默认开启。 此参数为可选参数，请根据需要配置。开启此开关后，CodeArts将为主机安装JDK。
   自动安装Git	当资源池类型为“LINUX”或“LINUX_DOCKER”时显示此参数，默认开启。 此参数为可选参数，请根据需要配置。开启此开关后，CodeArts将为主机自动安装Git。
   是否安装Docker	当资源池类型为“LINUX”或“LINUX_DOCKER”时显示此参数。 当资源池类型为“LINUX_DOCKER”时，默认勾选。 此参数为可选参数，请根据需要配置。
   自动安装Docker	当资源池类型为“LINUX”或“LINUX_DOCKER”时显示此参数。 当资源池类型为“LINUX_DOCKER”时，默认开启。 此参数为可选参数，请根据需要配置。开启此开关后，CodeArts将为主机安装Docker、注册服务并启动Docker服务。
   重启免注册	当资源池类型为“LINUX”或“LINUX_DOCKER”时显示此参数。 开启此开关后，代理进程将自动注册为Linux系统服务。当主机重启时，代理进程将会自动重启恢复，无需重新新建。
   AK	当前用户的Access Key Id。获取方式请参考获取AK/SK。
   SK	当前用户的Secret Access Key。获取方式请参考获取AK/SK。
   代理名称	代理（Agent）的名称，同一台主机不可以安装相同名称的代理。 为了方便管理，命名建议清晰，建议关联代理机IP，如：10.10.10.10-agent-01。
   代理工作空间	代理在主机上运行的工作目录，任务执行的工作空间，同一台主机的不同代理不可以使用同样的代理工作空间。 例如： Linux：/opt/cloud/agent01。 Windows：C:/opt/cloud/agent01。 MAC：/opt/cloud/agent01。

7. 完成参数配置后，勾选“代理工作空间”下方的复选框。
8. 单击“生成命令”，命令框中自动生成安装代理命令。
9. 单击“复制命令”，复制此命令。
10. 登录主机，执行已复制的安装命令。
    • Linux主机：使用root账号登录主机，执行安装命令。
    • Windows主机：使用管理员身份登录主机，打开Git Bash，执行安装命令。
    • MAC主机：使用root账号登录主机，执行安装命令。
    当命令终端显示如下提示时，表示安装结束。

    图2 安装结束回显
    

11. 返回“代理列表”页面。

    等待10-30秒，刷新页面，当“状态”列的值为“空闲中”时，表示安装成功。

    

    代理的状态有以下五种：

    • 运行中：代理机正在执行任务。处于此状态的代理无法被删除。
    • 空闲中：代理机处于连接状态，未运行任务。
    • 停用：代理机处于连接状态，但被停用无法执行任务。
    • 下线：代理机处于掉线断开状态，如需上线请登录代理机重新注册，否则删除即可。
    • 删除中：代理机正在被删除中。

管理代理

1. 进入CodeArts首页。
   1. 登录CodeArts控制台，单击，根据需要选择已开通CodeArts的区域。
   2. 单击“前往工作台”。

      如果当前账号采用的是历史计费模式（详情请参见历史计费模式说明），则单击“立即使用”。

2. 在导航栏中单击用户名，选择“租户设置”。
3. 单击“资源池管理 > 资源池”，进入“资源池管理”页面。
4. 在资源池列表中找到目标资源池，单击资源池名称，进入“代理列表”页面。
5. 找到目标代理，根据需要完成以下操作。

   表4 管理代理

   操作	说明
   启动/停用代理	单击“操作”列中的，可停用对应代理。停用后，“状态”列显示为“停用”。 单击“操作”列中的，可以重新启用代理。启动后，“状态”列恢复为“空闲中”。
   删除代理	警告： 删除后，将无法恢复，请谨慎操作。 如果在新建代理时开启“重启免注册”开关，请参照页面提示，在删除代理前需登录对应主机执行卸载命令。否则，主机重启后，已删除代理会自动重新注册。 单独删除：在“代理列表”页面，单击目标代理的操作列中，可以删除对应代理。 批量删除：在“代理列表”页面，勾选待删除的代理，单击“批量删除”。