--- title: Agent管理 description: "已安装部署鲲鹏DevKit。" url: https://www.hikunpeng.com/document/detail/zh/kunpengdevkithistory/devkit_24_t50/usermanual/KunpengDevKit_0057.html sourcePath: /source/zh/kunpengdevkithistory/devkit_24_t50/usermanual/KunpengDevKit_0057.html indexId: 35af88f29a7c1e20ba5c4213b0a200d88c32092d9487f6255909e65789e3d2e180 --- # Agent管理 #### 前提条件 已安装部署鲲鹏DevKit。 #### 操作步骤 - 最多可添加101个节点，包括在Web服务器上默认安装的根节点。 - 以端口映射模式创建的Docker容器不能添加Agent节点，以Host模式创建的Docker容器可以添加Agent节点。 - 若添加本机节点，需确保已开启sshd服务，否则会导致Agent节点添加失败。 - 安装鲲鹏DevKit的节点和Agent节点之间的网络需连通，否则会导致Agent节点添加失败。 - 如果节点添加失败，可在Web服务器上查看“/opt/DevKit/logs/agent_logs/”目录下以IP地址命名的日志文件，出现如下提示信息表示需要在节点服务器上手动关闭SELinux。 1 "The SELinux enforcing mode is enabled on the server, which will cause a tool installation failure". - 工具安装节点和Agent节点网络需要连通，否则会导致Agent节点添加失败。 - 若在VS Code端使用该功能，添加节点时，为方便使用，密码下方会有“记住密码”的选项。但为保证安全性，使用公共网络或公用计算机登录账户时请勿开启“记住密码”选项登录。 1. 在页面右上方选择“ > 通用设置 > Agent管理”，进入Agent节点管理界面。 2. 添加Agent节点主要有以下两种方式： - 批量导入：通过模板表格导入多个节点的节点信息。 a. 在批量导入界面中，单击“模板表格”进行模板下载。 按照模板表格图2填写完成需要批量导入的节点信息后，在图1中上传表格进行节点添加。 图1 批量导入 图2 模板表格 b. 严格完成节点信息的填写后单击“选择文件”阅读“SSH传输须知”，选择已填写节点信息的批量导入文件进行上传。 图3 SSH传输须知 - 添加节点：添加单个节点的节点信息。 在“添加节点”页面，参考表1输入相应信息后，单击“确定”进行节点添加。 若使用普通用户添加节点失败时，可将普通用户添加至wheel组（命令：usermod -G wheel userName）。 **表1 添加节点参数说明** | 参数 | 说明 | | --- | --- | | 节点名称（可选） | 输入节点名称。默认为Node+编号。名称需要满足如下要求： 只能由字母、数字、特殊字符（@\#$%^&\*()[]<>.\_\-!~+空格）组成。 长度为1~32个字符。 | | 安装路径（可选） | 输入安装节点的绝对路径，默认为“/opt”。 说明： 输入的路径不能为“/home”，并且： 如果输入的路径属于root用户组，普通用户对各级路径应有可读（r）可执行（x）权限。 如果输入的路径属于devkit用户组，devkit用户对各级路径应有可读（r）可执行（x）权限。 | | SSH传输须知 | 证书管理使用服务器默认的SSH传输通道，为了保护数据的安全完整，建议使用安全的SSH服务，如使用安全的SSH版本，配置使用安全的加密算法等。 | | 节点IP | 输入待安装节点的服务器IP地址。 | | 端口 | 输入节点服务器SSH端口，默认为“22”。取值范围1~65535。 | | 用户名 | 输入登录节点服务器的用户名，默认为“root”。 说明： 为保证SSH通道安全，建议您使用普通用户进行节点的安装部署。 | | 认证方式 | 选择认证方式。可选择： 密码认证 密钥认证 说明： 选择“密钥认证”时需要在安装鲲鹏DevKit工具的服务器上设置SSH认证信息，详情请参见配置Linux公私钥。 | | 密码 | 输入登录节点服务器的用户密码。 说明： “认证方式”选择“密码认证”时显示该参数。 使用root用户安装的节点需要输入root口令，使用普通用户安装的节点需要输入用户口令和root口令。 | | 私钥文件 | 输入用于登录节点服务器的SSH私钥文件的绝对路径，例如：“/home/devkit/id\_rsa” 说明： “认证方式”选择“密钥认证”时显示该参数。 | | 密码短语（可选） | 输入登录节点服务器的SSH私钥文件的口令。如果未配置SSH私钥口令可省略该参数。 说明： “认证方式”选择“密钥认证”时显示该参数。 | 3. 此处以添加单个节点进行指纹验证为例，工具对导入的节点信息校验完成后，进入节点指纹验证页面，确认节点指纹无误后，单击“继续添加”。 图4 指纹验证提示 若获取指纹异常，则会导致节点添加失败，请在Web服务器安装ssh-keyscan工具。 4. 添加完成后，可在选中节点右侧操作部分对Agent节点进行“修改”、“查看安装日志”或“删除”等操作。