`manage apply-scheduler`

安装或升级调度服务。

必需的角色: 集群管理员您必须是集群管理员才能运行此命令。

扩展描述

scheduling service 是集群范围的资源，每个集群可以 正好安装一次 。

建议您在自己的项目中安装 scheduling service 。

请勿在与 IBM Cloud Pak for Data 操作程序相同的项目中安装 scheduling service 。

apply-scheduler 命令在指定的项目中为 scheduling service 安装或更新以下对象:

目录源
订购
集群服务版本 (CSV)
定制资源

语法

cpd-cli manage apply-scheduler \
--release=<version> \
--license_acceptance=true|false \
--scheduler_ns=<project-name> \
[--case_download=true|false] \
[--from_oci=true|false] \
[--oci_location=<registry-URL>] \
[--catsrc=true|false] \
[--sub=true|false] \
[--preview=true|false]

参数

apply-scheduler 命令没有参数。

选项

表 1：命令选项

选项	描述
`--case_download`	指定是否下载指定组件的 CASE 软件包 (如果在工作目录中未检测到这些组件)。重要信息: 如果 CASE 软件包不在 `work` 目录中，那么该命令将失败。缺省位置如果从任何目录生成了 `cpd-cli` 可执行文件，那么该目录的路径为: `<current-directory>/cpd-cli-workspace/olm-utils-workspace/work` 如果未使 `cpd-cli` 可从任何目录执行，那么该目录的路径为: `<cli-install-directory>/cpd-cli-workspace/olm-utils-workspace/work` 定制位置如果设置 `CPD_CLI_MANAGE_WORKSPACE` 环境变量，那么目录的路径为: `${CPD_CLI_MANAGE_WORKSPACE}/work` 状态可选。语法 `--case_download=true\|false` 缺省值 `true` 如果省略此选项，那么将使用缺省值。有效值 `false` 如果要在下载将失败的受限网络中运行命令，请指定 `false` 。如果指定 `false` 并且 CASE 软件包不在 `work` 目录中，那么该命令将失败。 `true` 指定 `true` 以下载 CASE 软件包。如果不允许从 GitHub下载 CASE 软件包，请确保设置 `--from_oci=true`。
`--catsrc`	指定是否为指定组件创建目录源对象。必须为 scheduling service创建目录源。但是，您可以将其与预订分开创建。状态可选。语法 `--catsrc=true\|false` 缺省值 `true` 如果省略此选项，那么将使用缺省值。有效值 `false` 创建目录源。 `true` 跳过创建目录源。
`--from_oci`	从IBM Cloud Pak®Open Container Initiative (OCI) 注册表而不是GitHub 下载CASE包。建议不允许访问GitHubgithub.com）的环境使用此选项。限制: 仅当设置了 `--case_download=true`时，此设置才适用。状态可选。语法 `--from_oci=true\|false` 缺省值 `false` 如果省略此选项，那么将使用缺省值。有效值 `false` 从 GitHub下载 CASE 软件包。 `true` 从 IBM Cloud Pak Open Container Initiative下载 CASE 软件包。
`--license_acceptance`	指定是否接受许可条款。必须将此选项设置为 true 才能安装软件。状态必需。语法 `--license_acceptance=true\|false` 缺省值 `false` 如果省略此选项，那么将使用缺省值。有效值 `false` 此值指示您不接受许可条款。如果指定 `--license_acceptance=false`，那么将不会安装指定的组件。 `true` 此值指示您接受许可条款。必须指定 `--license_acceptance=true` 才能安装指定的组件。
`--oci_location`	您要下载 CASE 软件包的开放集装箱计划（OCI）注册表的 URL。例如，如果要从私有 OCI 注册表下载CASE软件包，请指定此选项。限制: 仅当设置了 `--from_oci=true`时，此设置才适用。状态可选。语法 `--oci_location=<registry-URL>` 缺省值 `cp.icr.io/cpopen` 如果省略此选项，那么将使用缺省值。有效值您要下载 CASE 软件包的开放集装箱计划（OCI）注册表的 URL。
`--preview`	预览发出此 CLI 命令时运行的命令。该命令发出一系列 `oc` 命令。您可以查看与该命令关联的 `oc` 命令的列表。 `oc` 命令将保存到 `work` 目录中的 `preview.sh` 文件。状态可选。语法 `--preview=true\|false` 缺省值 false 如果省略此选项，那么将使用缺省值。有效值 false 运行命令以将更改应用于集群。 true 预览命令而不运行这些命令。您可以从输出复制 `oc` 命令并自行运行这些命令。但是，不建议使用此方法。手动运行命令时，您无权访问底层 Ansible® playbook中包含的其他帮助程序脚本。
`--release`	要安装或升级到的发行版。如果在集群上安装了多个版本的 IBM Cloud Pak for Data ，那么建议您在集群上安装与最新版本的 IBM Cloud Pak for Data 相同的 scheduling service 版本。状态必需。语法 `--release=<version>` 缺省值 No default. You must specify the release. 有效值 5.0.0 5.0.1 5.0.2 5.0.3
`--scheduler_ns`	调度服务的项目。对于安装，请指定要在其中安装 scheduling service的项目。要进行升级，请指定安装了 scheduling service 的项目。请勿在与 IBM Cloud Pak for Data 操作程序相同的项目中安装 scheduling service 。状态必需。语法 `--scheduler_ns=<project-name>` 缺省值 No default. 有效值对于安装，这是要在其中安装 scheduling service的项目。对于升级，这是安装了 scheduling service 的项目。
`--sub`	指定是否为指定组件创建操作程序预订。您必须为 scheduling service创建预订。但是，您可以从目录源单独创建该目录。状态可选。语法 `--sub=true\|false` 缺省值 `true` 如果省略此选项，那么将使用缺省值。有效值 `false` 创建预订。 `true` 跳过创建预订。

示例

注: 以下示例使用建议的安装环境变量。

强烈建议使用脚本创建环境变量，并根据环境设置正确的值。有关详情，请参阅设置安装环境变量。

在 ${PROJECT_SCHEDULING_SERVICE} 项目中安装 scheduling service

cpd-cli manage apply-scheduler \
--release=${VERSION} \
--license_acceptance=true \
--scheduler_ns=${PROJECT_SCHEDULING_SERVICE}

预览 oc 命令以在 ${PROJECT_SCHEDULING_SERVICE} 项目中安装 scheduling service

cpd-cli manage apply-scheduler \
--release=${VERSION} \
--license_acceptance=true \
--scheduler_ns=${PROJECT_SCHEDULING_SERVICE} \
--preview=true