更新时间:2024-11-14 GMT+08:00

在CodeArts资源池中新建代理

操作场景

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

  • 建议一台主机中只安装一个Agent,如果安装多个Agent可能在执行任务时导致Agent下线。
  • 一个Agent同一时间只能执行一个任务。

前提条件

  • 完成本操作的用户拥有资源池的“所有者”或“管理者”权限。

    如果使用IIC用户(即通过IAM身份中心创建的用户)在“拉美-圣保罗一”“拉美-圣地亚哥”区域新建代理,则该用户需要使用IAM用户的AK/SK,且该IAM用户至少拥有“管理者”权限。

  • 已完成新建CodeArts资源池
  • 拥有满足以下条件的主机。
    • 规格:4vCPUs 8GiB或以上、磁盘>80GiB。
    • 必须安装Java 8、Git,如果选择的资源池类型为LINUX_DOCKER,还须安装Docker。
      • 如果使用为Linux操作系统主机作为代理机,则页面中提供自动安装功能。您也可以选择手动安装,请使用root账号执行安装命令。
      • 如果使用Windows或MAC操作系统主机作为代理机,请使用系统管理员账号手动在服务器中安装。
      • 如果使用Windows操作系统主机作为代理机,请安装64位的Java 8。
    • 必须有公网访问权限。

新建代理

  1. 进入CodeArts首页。

    1. 登录CodeArts控制台,单击,选择区域。
    2. 单击“立即使用”。

  2. 在导航栏中单击用户名,选择“租户设置”。
  3. 单击“资源池管理 > 资源池”,进入“资源池管理”页面。
  4. 在资源池列表中找到目标资源池,单击资源池名称,进入“代理列表”页面。
  5. 单击“新建代理”,页面弹出对话框。
  6. 根据需要完成参数配置。

    1. 配置主机所需的网络环境。
      表1 步骤一配置

      配置项

      配置说明

      自动安装JDK

      主机需要具备JAVA8+环境。

      开启此开关后,将为主机自动安装JDK至“/usr/local”目录中。

      如果关闭此开关,则需手动安装。如何安装Java 8?

      说明:

      仅资源池类型为“LINUX”或“LINUX_DOCKER”时显示此配置项。

      自动安装Git

      主机需要具备Git环境。

      开启此开关后,将为主机自动安装Git。

      如果关闭此开关,则需手动安装。如何安装Git?

      说明:

      仅资源池类型为“LINUX”或“LINUX_DOCKER”时显示此配置项。

      自动安装Docker

      主机需要具备Docker环境。

      开启此开关后,将为主机自动安装Docker至“/usr/bin”目录中。安装完成后将自动注册服务并启动docker服务。

      如果关闭此开关,则需手动安装。如何安装Docker?

      说明:

      仅资源池类型为“LINUX”或“LINUX_DOCKER”时显示此配置项。

      重启免注册

      开启此开关后,代理进程将自动注册为Linux系统服务,当主机重启时,代理进程将会自动重启恢复,无需重新新建。

      说明:

      仅资源池类型为“LINUX”或“LINUX_DOCKER”时显示此配置项。

    2. 配置身份认证信息。
      表2 步骤二配置

      配置项

      配置说明

      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。

      请勿使用临时AK/SK,避免安装失败。

    3. 生成命令。

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

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

  7. 登录主机,执行已复制的安装命令。

    • Linux主机:使用root账号登录主机,执行安装命令。
    • Windows主机:使用管理员身份登录主机,打开Git Bash,执行安装命令。
    • MAC主机:使用root账号登录主机,执行安装命令。
    当命令终端显示如下提示时,表示安装结束。
    图1 安装成功回显

  8. 返回“代理列表”页面,关闭弹窗。

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

后续操作

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

表3 管理代理

操作

说明

查看代理列表

在“代理列表”页面可查看代理的状态、内存使用率、可用硬盘等信息。

其中,状态包含以下五种:

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

启动/停用代理

在“代理列表”页面,单击目标代理的操作列中,可停用对应代理,停用后,状态列显示为“停用”;单击,可以重新启用代理,状态列恢复为“空闲中”。

删除代理

  • 单独删除:在“代理列表”页面,单击目标代理的操作列中,可以删除对应代理。
  • 批量删除:在“代理列表”页面,勾选待删除的代理,单击“批量删除”
说明:
  • “运行中”状态的代理无法删除。