- 产品介绍
- 计费说明
- 快速入门
-
用户指南
- 软件开发生产线(CodeArts)使用前准备
- 效能洞察(CodeArts Board)
- 需求管理(CodeArts Req)
- 软件建模(CodeArts Modeling)
- 代码托管(CodeArts Repo)
- 流水线(CodeArts Pipeline)
- 代码检查(CodeArts Check)
- 编译构建(CodeArts Build)
- 制品仓库(CodeArts Artifact)
- 部署(CodeArts Deploy)
- 测试计划(CodeArts TestPlan)
- 性能测试(CodeArts PerfTest)
- 漏洞管理服务(CodeArts Inspector)
- CodeArts IDE Online
- CodeArts IDE
- CodeArts 盘古助手(Pangu Doer in CodeArts)
- 开源镜像站(Mirrors)
- 开源治理服务(CodeArts Governance)
- 联接(CodeArts Link)
- 最佳实践
- 常见问题
- 视频帮助
- 文档下载
- 通用参考
链接复制成功!
在CodeArts资源池中新建代理
操作场景
通过在主机中安装Agent,并根据需要接入注册到CodeArts服务中,即可作为自定义执行机,供代码检查、构建等任务使用。
约束与限制
- 建议一台主机中只安装一个Agent,如果安装多个Agent可能在执行任务时导致Agent下线。
- 一个Agent同一时间只能执行一个任务。
- 请勿使用临时AK/SK,避免安装失败。
前提条件
- 完成本操作的用户拥有资源池的“所有者”或“管理者”权限。
- 已完成新建CodeArts资源池。
- 拥有满足以下条件的主机。
- 规格:4vCPUs 8GiB或以上、磁盘>80GiB。
- 必须安装Java 8、Git,如果选择的资源池类型为“LINUX_DOCKER”,还须安装Docker。
说明:
- 使用为Linux操作系统主机作为代理机,则页面中提供自动安装功能。您也可以选择手动安装,请使用root账号执行安装命令。
- 如果使用Windows或MAC操作系统主机作为代理机,请使用系统管理员账号手动在服务器中安装。
- 如果使用Windows操作系统主机作为代理机,请安装64位的Java 8。
- 必须有公网访问权限,并且开通以下域名的防火墙白名单、暴露相应端口号。
表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
新建代理
- 进入CodeArts首页。
- 登录CodeArts控制台,单击
,选择区域。
- 单击“前往工作台”。
- 登录CodeArts控制台,单击
- 在导航栏中单击用户名
,选择“租户设置”。
- 单击“资源池管理 > 资源池”,进入“资源池管理”页面。
- 在资源池列表中找到目标资源池,单击资源池名称,进入“代理列表”页面。
- 单击“新建代理”,页面弹出对话框。
- 根据需要完成参数配置。
- 配置主机所需的网络环境。
表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”时显示此配置项。
重启免注册
开启此开关后,代理进程将自动注册为Linux系统服务,当主机重启时,代理进程将会自动重启恢复,无需重新新建。
仅资源池类型为“LINUX”或“LINUX_DOCKER”时显示此配置项。
- 配置身份认证信息。
表4 步骤二配置 配置项
配置说明
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。
- 生成命令。
完成参数配置,勾选“我已阅读并同意”,单击“生成命令”,命令框中自动生成安装代理命令。
单击“复制命令”,复制此命令。
- 配置主机所需的网络环境。
- 登录主机,执行已复制的安装命令。
- Linux主机:使用root账号登录主机,执行安装命令。
- Windows主机:使用管理员身份登录主机,打开Git Bash,执行安装命令。
- MAC主机:使用root账号登录主机,执行安装命令。
当命令终端显示如下提示时,表示安装结束。图1 安装成功回显 - 返回“代理列表”页面,关闭弹窗。
等待10-30秒,刷新页面,在列表中可查看到“状态”列的值为“空闲中”,表示安装成功。
后续操作
完成新建代理后,可完成以下操作。
操作 |
说明 |
---|---|
查看代理列表 |
在“代理列表”页面可查看代理的状态、内存使用率、可用硬盘等信息。 其中,状态包含以下五种:
|
启动/停用代理 |
在“代理列表”页面,单击目标代理的操作列中 |
删除代理 |
|