IBM Cloud Pak® for Data 4.7 版本将于 2025 年 7 月 31 日结束支持(EOS)。 欲了解更多信息,请参阅 IBM Cloud Pak for Data 版本 4.X 的停止服务公告。
在 IBM Cloud Pak for Data 4.7 版本支持结束之前,升级到 IBM Software Hub 5.1 版本。 更多信息,请参阅 IBM Software Hub 版本 5.1 文档中的升级 IBM Software Hub。
上载定制配置
注册定制映像后,您需要修改下载的 JSON 配置文件,然后以新名称将其上载到 Cloud Pak for Data 集群。
要通过定制配置上载图像,请执行以下操作:
将下载的 JSON 配置文件重命名,以开始使用该定制映像。 您使用的名称应该类似于
custom-def-name.json,其中custom-def-name是在 Cloud Pak for Data 实例的所有运行时定义中唯一的名称。 创建环境模板时,您提供的唯一名称将在 软件版本 下拉列表中列出。打开您在编辑器中重命名的 JSON 配置文件。
查找包含 "image" 属性的行。 它具有以下格式
"image":"<image registry>/<image name>:<image tag>和值,例如"image": "<private-registry>/wslocal-runtime-py39main@sha256:fce1b04fcbf5272756693e170ebe7ae870abab724c7b6e30c4c4021790b36b79"。将
name,display_name,description和author替换为您自己的数据。使用注册自定义图像时使用的注册表 URL。
将
<image name>:<image tag>更改为注册该定制映像时使用的值。可选: 设置用户定义的变量。 请参阅 设置用户定义的变量。
保存该文件。
使用 Cloud Pak for Data API 使用 JSON 文件中的设置创建运行时定义。
获取授权令牌。 有关更多信息,请参阅 生成授权令牌或 API 密钥。
使用 JSON 文件中的设置创建运行时定义:
curl -k -X POST -H "Authorization: Bearer ${MY_TOKEN}" -H "Content-Type:application/json" "${CPD_URL}/v2/runtime_definitions" -d @</path/to/runtime/def/><custom-def-name>.json如果成功创建运行时定义,那么您将收到响应,其中包含可用于检索,更新或删除运行时定义的 UUID。
</path/to/runtime/def/>是本地计算机上运行时定义 JSON 文件的路径。 请注意,使用@符号是必需的。
确保将新的定制映像预先提取到每个计算节点。 请参阅映像下载优化。
更新和删除运行时定义
要更新或删除运行时定义,您需要知道其 GUID。 您可以通过运行以下命令来获取可用运行时定义及其 GUID 的列表:
curl -k -X GET -H "Authorization: Bearer ${MY_TOKEN}" "${CPD_URL}/v2/runtime_definitions" | jq -r '.resources[] | "\(.entity.name) -- \(.metadata.guid)"'
要更新现有运行时定义,请使用现有运行时定义的名称来调用更新端点:
myRuntimeDefinitionID=<runtime-definition-name>; curl -kX PUT "${CPD_URL}/v2/runtime_definitions/$myRuntimeDefinitionID" --header "Authorization: Bearer ${MY_TOKEN}" -d @${myRuntimeDefinition}.json
要删除不再使用的运行时定义,请调用删除端点:
curl -kX DELETE \
"${CPD_URL}/v2/runtime_definitions/${myRuntimeDefinitionID}" \
--header "Authorization: Bearer ${MY_TOKEN}"
设置用户定义的变量
您可以向运行时添加任意环境变量,例如,如果您希望用户能够通过代理访问 Web。
您添加的变量必须以 _userdefined_作为前缀。 如果要设置 http_proxy 变量,那么该变量必须命名为 _userdefined_http_proxy。 如果缺少此前缀,那么将过滤掉该变量,并且该变量在运行时中将不可用。
要将环境变量设置为运行时配置文件,请将 env 部分添加到 JSON 配置文件的顶级,如下所示:
"env": [
{
"name": "_userdefined_http_proxy",
"value": "http://proxy:3129"
},
{
"name": "_userdefined_https_proxy",
"value": "http://proxy:3129"
}
],
您可以通过启动运行时并运行以下命令来检索当前值:
!printenv LD_LIBRARY_PATH
父主题: 构建定制映像