使用 CLI (Command Line) 更改设置
可以使用命令行或脚本修改某些设置。这些命令需要根用户权限。
Agent Settings
查看内联 CLI 帮助
/opt/incredibuild/management/get_agent_params.py help
/opt/incredibuild/management/set_agent_params.py help
启用/禁用将 Agents 作为 Helpers
获取状态
在任何 Agent 上运行此选项，可查看 Agent 是否已启用或禁用作为 Helper 参与构建（启用则返回 true，禁用则返回 false）。
/opt/incredibuild/management/get_agent_params.py enable-as-helper
设置状态
在任何 Agent 上运行这些设置，以修改启用或禁用作为 Helper 参与构建的能力。
sudo /opt/incredibuild/management/set_agent_params.py enable-as-helper
sudo /opt/incredibuild/management/set_agent_params.py disable-as-helper
更改 Coordinator
获取 Coordinator
要查看与某个 Helper 关联的 Coordinator，请在任何代理服务主机上运行此命令：
/opt/incredibuild/management/get_agent_params.py coordinator
设置 Coordinator
要更改与某个 Helper 关联的 Coordinator，请在任何代理服务主机上此命令。如果在 Helper 上运行，它将停止任何正在运行的任务，并将其重新分配给可用的 Helper 或启 Initiator。如果运行 Initiator，则由该 Initiator 启动的任何构建都将中止。
如果新 Coordinator 与 Agent 的 Incredibuild 版本不同，Agent 将自动升级或降级。
sudo /opt/incredibuild/management/set_agent_params.py coordinator <hostname/IP of new Coordinator>
完成该操作后，您还需取消订阅原始 Coordinator 上的许可证，并在新 Coordinator 上重新订阅。
例如：
sudo /opt/incredibuild/management/set_agent_params.py coordinator 192.168.10.50
最大 Helper 核心数
获取最大本地 Helper 数
如需查看启动新构建所需的最大可用本地核心数，请在任何代理服务主机上运行此命令：
/opt/incredibuild/management/get_agent_params.py max-helper-cores
设置最大本地 Helper 数
如需更改 Agent 参与构建时可以使用的最大内核数，请在任何代理服务主机上运行以下命令：
sudo /opt/incredibuild/management/set_agent_params.py max-helper-cores <number>
例如：
sudo /opt/incredibuild/management/set_agent_params.py max-helper-cores 64
最小本地 Helper 核心数
获取最小本地 Helper 数
如需查看启动新构建所需的最小可用本地核心数，请在任何代理服务主机上运行此命令：
/opt/incredibuild/management/get_agent_params.py min-local-cores
设置最小本地 Helper 数
如需更改启动新构建所需的最小可用本地内核数，请在任何代理服务主机上运行以下命令：
sudo /opt/incredibuild/management/set_agent_params.py min-local-cores <number>
例如：
sudo /opt/incredibuild/management/set_agent_params.py min-local-cores 8
用于外部出站通信的代理
获取 HTTP 通信的代理服务器
获取用于从 Incredibuild 发送外部 HTTP 通信的代理服务器。
/opt/incredibuild/management/get_agent_params.py http_proxy
设置 HTTP 通信的代理服务器
设置用于从 Incredibuild 发送外部 HTTP 通信的代理服务器。要移除代理服务器，请使用此命令，并将值设置为空：
/opt/incredibuild/management/set_agent_params.py http_proxy <URL or empty value>
获取 HTTPS 通信的代理服务器
获取用于从 Incredibuild 发送外部 HTTPS 通信的代理服务器。
/opt/incredibuild/management/get_agent_params.py https_proxy
设置 HTTPS 通信的代理服务器
设置用于从 Incredibuild 发送外部 HTTPS 通信的代理服务器。要移除代理服务器，请使用此命令，并将值设置为空：
/opt/incredibuild/management/set_agent_params.py https_proxy <URL or empty value>
获取无代理例外情况
要获取绕过您的代理的 IP 地址、主机名和域的列表，请使用以下命令：
sudo /opt/incredibuild/management/get_agent_params.py no_proxy
设置无代理例外情况
要设置绕过您的代理的 IP 地址、主机名和域的列表，请使用以下命令：
sudo /opt/incredibuild/management/set_agent_params.py no_proxy <comma separated list>
例如：
sudo /opt/incredibuild/management/set_agent_params.py no_proxy 192.54.3.22,192.78.54.230
最大 Initiator 核心数
获取最大 Initiator 核心数
要查看作为构建的 Initiator 时 Agent 可使用的最大核心数量，请在任意 Agent 运行以下命令：
/opt/incredibuild/management/get_agent_params.py max-initiator-cores
设置最大 Initiator 核心数
要设置作为构建的 Initiator 时 Agent 可使用的最大核心数量，请在任意 Agent 运行以下命令：
sudo /opt/incredibuild/management/set_agent_params.py max-initiator-cores <number of max initiator cores>
例如：
sudo /opt/incredibuild/management/set_agent_params.py max-initiator-cores 16
Build Cache
这些命令可控制 Initiator 主机上的 Build Cache 设置。
获取本地 Build Cache 信息
返回有关您本地构建缓存位置和大小的信息：
/opt/incredibuild/management/build_avoid_cache.sh <user|shared|group='groupname'> info
设置本地 Build Cache 大小
设置本地构建缓存大小。默认情况下，大小为 100GB：
/opt/incredibuild/management/build_avoid_cache.sh <user|shared|group='groupname'> set_size <size in GB>
获取 Build Cache 服务
您可以检索 Initiator 使用的默认 Build Cache 服务。该服务用于共享 Build Cache。
sudo /opt/incredibuild/management/get_agent_params.py build-cache-service-URL
设置 Build Cache 服务
您可以设置 Initiator 使用的默认 Build Cache 服务。该服务用于共享 Build Cache。
sudo /opt/incredibuild/management/set_agent_params.py build-cache-service-URL http://<agent IP or hostname>:<port>
例如：
sudo /opt/incredibuild/management/set_agent_params.py build-cache-service-URL http://linux_lab_machine2:8080
要取消设置该参数，请使用值 "" 调用它：
sudo /opt/incredibuild/management/set_agent_params.py build-cache-service-URL ""
清除 Build Cache
清除本地构建缓存：
/opt/incredibuild/management/build_avoid_cache.sh <user|shared|group='groupname'> clear
日志位置
这些命令允许您定义一个远程位置，用来存储构建日志。
获取日志位置
用于查看为此 Agent 定义的用于存储构建日志的远程位置：
/opt/incredibuild/management/get_agent_params.py log-mount-directory
设置日志位置
用于设置为此 Agent 定义的用于存储构建日志的远程位置。该位置应已挂载到 Agent 上的文件夹中：
/opt/incredibuild/management/set_agent_params.py log-mount-directory <path to mounted remote location>
Coordinator Settings
Build Groups
创建 Build Group
在您的 Primary Coordinator 上运行它，以创建新的 Build Group。
sudo /opt/incredibuild/ctl/coordinator build-group create [group name]
例如：
sudo /opt/incredibuild/ctl/coordinator build-group create devteam5
删除 Build Group
在您的 Primary Coordinator 上运行它，以删除一个 Build Group。
sudo /opt/incredibuild/ctl/coordinator build-group delete [group name]
例如：
sudo /opt/incredibuild/ctl/coordinator build-group delete devteam5
获取所有 Build Group
在您的 Primary Coordinator 上运行它，将以 JSON 格式返回所有 Build Group 的列表。
sudo /opt/incredibuild/ctl/coordinator build-group list
获取 Build Group 中的 Agent 列表
在您的 Primary Coordinator 上运行此命令，返回分配给指定 Build Group 的所有 Agent 列表（以JSON格式）。
sudo /opt/incredibuild/ctl/coordinator build-group agents [group name]
例如：
sudo /opt/incredibuild/ctl/coordinator build-group agents devteam5
设置 Build Group
在您的 Primary Coordinator 上运行此命令，将 Agent 分配给一个现有的 Build Group。
sudo /opt/incredibuild/ctl/coordinator build-group assign [group name] [agent IP or name]
例如：
sudo /opt/incredibuild/ctl/coordinator build-group assign devteam5 22.33.44.55
获取 Build Group
要查看 Agent 在哪个 Build Group，请在 Agent 上运行此命令：
/opt/incredibuild/management/get_agent_params.py build-group
显示许可证
以 JSON 格式返回许可证信息，包括：GUID、名称、到期日期、服务器核心数和 SUVM 核心数。
/opt/incredibuild/ctl/coordinator license show
获取许可证使用情况
返回每种许可证（服务器／SUVM）的核心总数和可用（未订阅）核心总数。
/opt/incredibuild/ctl/coordinator license usage
创建许可证密钥文件
创建一个密钥文件 (.pk)，用于 Coordinator，放置在指定路径下并使用指定名称（文件名应以.pk扩展名结尾）。这是为了生成首个许可证或更新现有许可证（类似于用户界面中的生成密钥文件选项）。
/opt/incredibuild/ctl/coordinator license key-file <file path with file name>
例如：
/opt/incredibuild/ctl/coordinator license key-file /var/Incredibuild/ib-key.pk
加载许可证
加载指定的许可证文件。如果 Coordinator 已有一个有效许可证，这无需停机时间即可将其替换，不会影响网格和正在运行的构建。如果加载因任何原因失败，CLI 将报告错误并回滚到先前的许可证（如果适用）。
/opt/incredibuild/ctl/coordinator license load
卸载许可证
卸载现有许可证。
/opt/incredibuild/ctl/coordinator license unload
获取 Coordinator 类型和状态
以 JSON 格式返回 Coordinator 类型（primary \ secondary）和状态（脱机、待机、激活）。
/opt/incredibuild/ctl/coordinator status
Secondary Coordinator
获取 Secondary Coordinator IP/名称
在 Primary Coordinator 上运行时，如果已定义 Secondary Coordinator，则返回 Secondary Coordinator 的 IP 地址或机器名。
/opt/incredibuild/ctl/coordinator secondary get
设置 Secondary Coordinator
将指定的机器设置为 Secondary Coordinator 的 Primary Coordinator。
/opt/incredibuild/ctl/coordinator secondary set <machine name or IP>
例如：
/opt/incredibuild/ctl/coordinator secondary set 192.168.10.50
获取 Secondary Coordinator 状态
以 JSON 格式返回 Secondary Coordinator 的状态（可以是未配置、脱机、待机或激活）
/opt/incredibuild/ctl/coordinator secondary status
Build Cache 服务设置
Build Cache 服务
这些命令可控制 Build Cache 服务主机上的 Build Cache 设置。
获取 Build Cache 大小
要查看 Build Cache 服务主机上的 Build Cache 大小（单位：GB）：
sudo /opt/incredibuild/management/build_cache_service.py get-size-limit
设置 Build Cache 大小
要设置 Build Cache 服务主机上的 Build Cache 大小（单位：GB）：
sudo /opt/incredibuild/management/build_cache_service.py set-size-limit <size>
例如：
sudo /opt/incredibuild/management/build_cache_service.py set-size-limit 150
清除 Build Cache
要清除 Build Cache 服务主机上的 Build Cache：
sudo /opt/incredibuild/management/build_cache_service.py clear
查看 Build Cache 位置
要查看 Build Cache 服务主机上 Build Cache 的存储路径：
sudo /opt/incredibuild/management/build_cache_service.py get-path
获取 Build Cache 已使用大小
要查看 Build Cache 服务主机上当前已使用的 Build Cache 大小：
sudo /opt/incredibuild/management/build_cache_service.py get-used-size