在codearts资源池中新建代理-九游平台

操作场景

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

前提条件

• 完成本操作的用户需要满足以下条件之一：
  • 拥有tenant administrator角色权限。
  • 拥有资源池的“所有者”、“管理者”或“使用者”权限。
• 已完成新建codearts资源池。
• 拥有满足以下条件的主机。
  • 规格：4u8g或以上、磁盘>80gb。
  • 必须安装java 8、git，如果选择的资源池类型为“linux_docker”，还须安装docker。
    • 使用为linux操作系统主机作为代理机，则页面中提供自动安装功能。您也可以选择手动安装，请使用root账号执行安装命令。
    • 如果使用windows或mac操作系统主机作为代理机，请使用系统管理员账号手动在服务器中安装。
  • 必须有公网访问权限，并且开通以下域名的防火墙白名单、暴露相应端口号。

    表1 区域域名对应关系

    区域名称	域名
    北京一（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

    通过代理机接入服务所需要暴露的端口号范围如下：

    表2 服务端口号映射关系

    服务名称	端口号范围
    代码检查（codearts check）	1200~1299
    编译构建（codearts build）	1300~1399
    部署（codearts deploy）	1400~1499
    测试计划（codearts testplan）	1500~1599

    可以通过如下命令检查是否已经加入白名单，如：

    telnet cloudoctopus-agent.cn-north-1.myhuaweicloud.com 1211
    telnet cloudoctopus-agent.cn-north-1.myhuaweicloud.com 1420

新建代理

1. 进入codearts九游平台首页。
   1. 登录控制台，单击，选择区域。
   2. 单击，在服务列表中选择“开发与运维 > 软件开发生产线”。
   3. 单击“立即使用”。
2. 在导航栏中单击用户名，选择“租户设置”。
3. 单击“资源池管理 > 资源池”，进入“资源池管理”页面。
4. 在资源池列表中找到目标资源池，单击资源池名称，进入“代理列表”页面。
5. 单击“新建代理”，页面弹出对话框。
6. 根据需要完成参数配置。
   1. 配置主机所需的网络环境。

      表3 步骤一配置

      配置项	配置说明
      自动安装jdk	主机需要具备java8 环境。 开启此开关后，将为主机自动安装jdk至“/usr/local”目录中。 如果关闭此开关，则需手动安装。 说明： 仅资源池类型为“linux”或“linux_docker”时显示此配置项。
      自动安装git	主机需要具备git环境。 开启此开关后，将为主机自动安装git。 如果关闭此开关，则需手动安装。 说明： 仅资源池类型为“linux”或“linux_docker”时显示此配置项。
      自动安装docker	主机需要具备docker环境。 开启此开关后，将为主机自动安装docker至“/usr/bin”目录中。安装完成后将自动注册服务并启动docker服务。 如果关闭此开关，则需手动安装。 说明： 仅资源池类型为“linux”或“linux_docker”时显示此配置项。

   2. 配置身份认证信息。

      表4 步骤二配置

      配置项	配置说明
      ak	access key id。 在通过下载的访问密钥文件中获取。
      sk	secret access key。 在通过下载的访问密钥文件中获取。
      代理名称	代理（agent）的名称，同一台主机不可以安装相同名称的代理。 请根据实际情况填写。为了方便管理，命名建议清晰，建议关联代理机ip，如：10.10.10.10-agent-01。
      代理工作空间	代理在主机上运行的工作目录，任务执行的工作空间，同一台主机的不同代理不可以使用同样的代理工作空间。 请根据实际情况填写。为了方便管理，建议关联数据盘，例如： linux：/opt/cloud/agent01。 windows：c:/opt/cloud/agent01。 mac：/opt/cloud/agent01。

   3. 生成命令。

      完成参数配置，勾选“我已阅读并同意”，单击“生成命令”，命令框中自动生成安装代理命令。

      单击“复制命令”，复制此命令。

7. 登录主机，执行上一步复制的安装命令。
   • linux主机：使用root账号登录主机，执行安装命令。
   • windows主机：使用管理员身份登录主机，打开git bash，执行安装命令。
   • mac主机：使用root账号登录主机，执行安装命令。
   当命令终端显示如下提示时，表示安装结束。

   图1 安装成功回显
   
8. 返回“代理列表”页面，关闭弹窗。

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

后续操作

完成新建代理后，可完成以下操作。