新建代理

概述

通过在代理机上安装Agent并接入注册到CodeArts，可以实现自定义的执行资源接入。

建议一台代理机上只安装一个Agent，如果安装多个Agent可能在执行任务时导致Agent下线。

前提条件

• 账号需满足以下条件之一。
  • 租户账号。
  • 拥有资源池“所有者”、“管理者”或“使用者”权限的IAM用户。
• 安装代理的主机需满足以下条件。
  • 规格4U8G或以上、磁盘>80GB。
  • 必须安装Java 8、Git，如果选择的资源池类型为LINUX_DOCKER，在代理机还须安装Docker。
    

    • 如果使用为Linux操作系统主机作为代理机，则页面中提供自动安装功能。您也可以选择手动安装，请使用root账号执行安装命令。
    • 如果使用Windows或MAC操作系统主机作为代理机，请手动在服务器中安装。
  • 必须配置VPCEP。

配置VPCEP

1. 登录控制台，在服务列表中选择VPCEP服务。
2. 单击“创建终端节点”，配置以下信息，单击“立即创建”。

   表1 创建VPC终端节点

   配置项	值
   服务类别	选择“按名称查找服务”。
   服务名称	提交工单获取相关信息并输入，单击“验证”。 页面提示“已找到服务”，说明验证成功。
   虚拟私有云	选择已有VPC。如果没有，请在下拉列表中单击“创建虚拟私有云”创建。
   子网	选择已有Subnet。如果没有，请在下拉列表中单击“创建子网”创建。
   IPv4地址	选择“自动创建”。

3. 创建成功，在列表中找到新创建的终端节点，记录“节点IP”的值。
4. 单击页面左上角，在服务列表中单击“云解析服务”。
5. 单击“创建内网域名”，在弹框中配置以下信息，单击“确定”。

   表2 创建内网域名

   配置项	值
   域名	提交工单获取相关信息并输入。
   VPC	选择与2相同的VPC。
   企业项目	选择已有的企业项目。如果没有，请单击“创建企业项目”创建。

6. 创建成功，在列表中找到新创建的内网域名，单击操作列中的“管理解析”。
7. 单击“添加记录集”，将3记录的IP输入“值”文本框中，单击“确定”。

新建代理

1. 完成新建资源池后，在资源池列表中找到目标资源池，单击资源池名称，进入“代理列表”页面。
2. 单击“新建代理”，页面弹出对话框。
3. 根据需要完成参数配置。
   1. 配置主机所需的网络环境。

      表3 步骤一配置

      配置项	配置说明
      自动安装JDK	主机需要具备Java 8环境。 开启此开关后，将为主机自动安装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”时显示此配置项。

   2. 配置身份认证信息。

      表4 步骤二配置

      配置项	配置说明
      AK	Access Key Id。 通过“我的凭证 > 访问密钥”下载的访问密钥文件中获取。获取方式请参考API签名指南的“获取AK/SK”章节。
      SK	Secret Access Key。 通过“我的凭证 > 访问密钥”下载的访问密钥文件中获取。获取方式请参考API签名指南的“获取AK/SK”章节。
      代理名称	代理（Agent）的名称，同一台主机不可以安装相同名称的代理。 请根据实际情况填写。为了方便管理，命名建议清晰，建议关联代理机IP，如：10.10.10.10-agent-01。
      代理工作空间	代理在主机上运行的工作目录，任务执行的工作空间，同一台主机的不同代理不可以使用同样的代理工作空间。 请根据实际情况填写。为了方便管理，建议关联数据盘，例如： Linux：/opt/cloud/agent01。 Windows：C:/opt/cloud/agent01。 MAC：/opt/cloud/agent01。

   3. 生成命令。

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

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

4. 登录主机，执行上一步复制的安装命令。
   • Linux主机：使用root账号登录主机，执行安装命令。
   • Windows主机：使用管理员身份登录主机，打开Git Bash，执行安装命令。
   • MAC主机：使用root账号登录主机，执行安装命令。

   当命令终端显示如下提示时，表示安装结束。

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

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

后续操作

• 查看代理列表

  在资源池列表中找到目标资源池，单击资源池名称，进入“代理列表”页面。

  代理列表可显示代理机状态、内存使用率、可用硬盘等信息。

  代理机有以下五种状态：

  表5 代理机状态说明

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

• 删除代理
  • 单独删除：在“代理列表”页面，单击目标代理的操作列中，可以删除对应代理。
  • 批量删除：在“代理列表”页面，勾选待删除的代理，单击“批量删除”。
    

    “运行中”状态的代理机无法删除。

• 启动/停用代理

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