安装瞻博网络 BNG CUPS |BNG 杯 |瞻博网络

BNG CUPS 控制器安装要求

要安装 BNG CUPS 控制器，您需要本部分中列出的硬件和软件要求。

BNG CUPS 控制器对单一地理位置设置的要求
BNG CUPS 控制器对多地理位置设置的要求
其他要求

BNG CUPS 控制器对单一地理位置设置的要求

BNG CUPS 控制器安装在单个地理设置上。单个地理位置设置由一个多节点 Kubernetes 群集组成。群集节点可以是物理节点，也可以是虚拟机。为了实现可用性，群集必须具有至少三个节点上运行的 Kubernetes 控制平面功能，并且至少在三个节点上运行工作器功能。为了实现节点经济性，Kubernetes 控制平面和工作器功能可以组合在同一节点（组合节点）上运行。

BNG CUPS 控制器需要 Kubernetes 群集中表 1 中列出的最少资源。

表 1：单个 Kubernetes 群集设置要求
类别	详情
Kubernetes 群集	Kubernetes 群集需要以下内容：节点规格：对 Kubernetes 分发使用以下一项： RedHat OpenShift 容器平台。（有关版本和配置的详细信息，请参阅正在安装的瞻博网络 BNG CUPS 版本的瞻博网络 BNG CUPS 发行说明。（生产群集的选项）。 Rancher Kubernetes 引擎 2 （RKE2）。（有关版本和配置的详细信息，请参阅正在安装的瞻博网络 BNG CUPS 版本的瞻博网络 BNG CUPS 发行说明。（生产群集的选项）。 BBE Cloudsetup 实用程序 — 仅用于概念验证（PoC）或演示群集。 BBE Cloudsetup 实用程序使用 Longhorn CSI、MetalLB、Flannel CNI 和 Docker Container Registry 软件版本构建具有 RKE1 发行版的群集。 CPU：32 核（最多 51.2 万订阅者）或 64 核（最多 200 万订阅者）内存：256 GB （GiB）（最多 512,000 个订阅者）或 512 GiB（最多 200 万个订阅者）存储： 480 GiB（最多 512,000 个订阅者）分区为 240 GiB 根和 240 GiB /var/lib/longhorn 960 GiB（最多 200 万个订阅者）分配给 480 GiB 根和 480 GiB /var/lib/longhorn 网络接口：4x10 GE（根据您的拓扑结构，可能需要更多）集群宽度 — 群集必须至少有 3 个具有 Kubernetes 控制平面、etcd 和工作器功能的组合节点。3 个组合节点支持具有单个控制平面实例的 APM 和 BNG CUPS 控制器。如果要添加其他 BNG CUPS 控制器控制平面实例，则必须为您添加的每对额外的 BNG CUPS 控制器控制平面实例添加另一个工作节点。该规范建立了一个可以同时运行 BNG CUPS 控制器及其配套应用程序（例如 BBE 事件收集和可视化以及地址池管理器（APM））的群集。
跳转主机	跳转主机需要以下内容： CPU：2核内存：8 GB （GiB）存储：128 （GiB）
跳转主机软件	跳转主机需要以下软件：概念验证体系： Ubuntu 22.04 LTS Python 3.12-venv BBE Cloudsetup 实用程序将安装兼容版本的 Kubernetes CLI、Helm、docker-ce 以及编排应用程序所需的其他组件。生产系统： Red Hat Enterprise Linux 9 或 Ubuntu 24.04 LTS。有关所需软件组件的列表，请参阅正在安装的瞻博网络 BNG CUPS 版本的瞻博网络 BNG CUPS 发行说明。
存储	名为 jnpr-bbe-storage 的存储类。
网络负载均衡器地址	最多 2N+2 个地址，其中 N 是控制平面实例的数量：控制平面实例 — TCP 和 UDP 服务各一个地址。管理 — 一个地址用于遥测，一个地址用于 SSH CLI 访问（可选）。
注册表存储	每个 BNG CUPS 控制器版本需要 2.5 GB 的容器映像。

BNG CUPS 控制器对多地理位置设置的要求

多地理位置设置由两个独立的多节点 Kubernetes 群集组成。群集节点可以是物理节点，也可以是虚拟机。为了实现可用性，每个群集必须具有至少三个节点上运行的 Kubernetes 控制平面功能，并且至少在三个节点上运行工作器功能。为了实现节点经济性，Kubernetes 控制平面和工作器功能可以组合在同一节点（组合节点）上运行。两个集群中的每一个在地理位置上都是分开的，因此影响一个群集的服务影响事件不会影响另一个集群。

每个群集都是一个工作负载群集。工作负载群集提供了一个冗余平台，BNG CUPS 控制器应用程序可以在其中运行。

对于 PoC 安装，您不能使用 BBE 云设置实用程序来构建多地理位置多群集设置中使用的群集。通过支持，可以使用单独的过程来构建 PoC、多地理位置、多群集设置。

BNG CUPS 控制器需要 Kubernetes 群集中表 2 中列出的最少资源。

表 2：多地理位置 Kubernetes 群集设置要求
类别	详情
群集	多地理位置群集由 2 个工作负载群集组成，每个群集至少由 3 个组合节点组成。注意：确保每个工作负载群集的 Pod 和服务 CIDR 不重叠。每个工作负载群集的群集内部网络通过潜航者 IP 隧道连接。内部 CIDRS 必须是不同的。
工作负载群集	每个工作负载群集都需要以下内容：节点规格：对 Kubernetes 分发使用以下一项： RedHat OpenShift 容器平台。（有关版本和配置的详细信息，请参阅正在安装的瞻博网络 BNG CUPS 版本的瞻博网络 BNG CUPS 发行说明。 Rancher Kubernetes 引擎 2 （RKE2）。（有关版本和配置的详细信息，请参阅正在安装的瞻博网络 BNG CUPS 版本的瞻博网络 BNG CUPS 发行说明。 CPU：32 核（最多 51.2 万订阅者）或 64 核（最多 200 万订阅者）内存：256 GB （GiB）（最多 512,000 个订阅者）或 512 GiB（最多 200 万个订阅者）存储： 480 GiB（最多 512,000 个订阅者）分区为 240 GiB 根和 240 GiB /var/lib/longhorn 960 GiB（最多 200 万个订阅者）划分为 480 GiB 根和 480 GiB /var/lib/longhorn 网络接口：4x10 GE（根据您的拓扑结构，可能需要更多）集群宽度 — 每个群集必须至少有 3 个具有控制平面、etcd 和工作器功能的组合节点。3 个组合节点支持具有单个控制平面实例的 APM 和 BNG CUPS 控制器。如果要添加其他 BNG CUPS 控制器控制平面实例，则必须为您添加的每对额外的 BNG CUPS 控制器控制平面实例添加另一个工作节点。该规范建立了一个可以同时运行 BNG CUPS 控制器及其配套应用程序（如 BBE 事件收集和可视化以及 APM）的群集。
跳转主机	跳转主机需要以下内容： CPU：2核内存：8 GB （GiB）存储：128 （GiB）
跳转主机软件	跳转主机需要以下软件： Red Hat Enterprise Linux 9 或 Ubuntu 24.04 LTS。有关所需软件组件的列表，请参阅正在安装的瞻博网络 BNG CUPS 版本的瞻博网络 BNG CUPS 发行说明。
存储	名为 jnpr-bbe-storage 的存储类
网络负载均衡器地址	每个群集 2N+2 个地址：控制平面实例 — TCP 和 UDP 服务各一个地址。管理 — 一个地址用于遥测，一个地址用于 SSH CLI 访问（可选）。对于 RADIUS 联系人地址，每个控制平面实例（每个多群集）的可选地址将 N 添加到总数中。
注册表存储	每个 BNG CUPS 控制器版本需要 2.5 GB 的容器映像。每个群集都需要。

注意：

在单个地理 BNG CUPS 控制器设置中，您可以对群集的参数做出一些基本假设。您可以使用 BBE Cloudsetup 等快速入门工具创建单个地理 BNG CUPS 控制器。构建具有多个地理位置和多个群集的生产环境 BNG CUPS 控制器设置需要您提供更多的投入来构建。

其他要求

要使用瞻博网络 BNG CUPS，您必须为与瞻博网络 BNG CUPS 控制器关联的瞻博网络 BNG CUPS 控制器（控制平面）和瞻博网络 BNG 用户平面（瞻博网络 BNG CUPS 控制器）购买许可证。有关如何购买软件许可证的信息，请通过 https://www.juniper.net/in/en/contact-us/ 联系您的瞻博网络销售代表。

您在瞻博网络 BNG CUPS 环境中使用的 MX 系列设备也需要各自的单独许可证。有关如何购买硬件的信息，请通过 https://www.juniper.net/in/en/contact-us/ 联系您的瞻博网络销售代表。

确认您拥有有权下载 BNG CUPS 控制器软件包的 juniper.net 用户帐户。从不属于 Kubernetes 群集的计算机下载并安装 BNG CUPS 控制器软件。

在单一地理环境中安装瞻博网络 BNG CUPS 控制器

首次使用本部分中的过程在单个地理位置设置中安装瞻博网络 BNG CUPS 控制器。

开始之前，请确认您已满足 BNG CUPS 控制器安装要求（请参阅表 1）。

您可以通过以下两个选项创建可在其上安装 BNG CUPS 控制器的 Kubernetes 群集：

Red Hat OpenShift Container Platform — 有关安装说明，请参阅 Red Hat OpenShift Container Platform 文档。
Rancher Kubernetes Engine2 （RKE2） — 构建 RKE2 群集的方法有多种，包括原生 Rancher 设施。有关版本和配置的详细信息，请参阅正在安装的瞻博网络 BNG CUPS 版本的瞻博网络 BNG CUPS 发行说明。
BBE Cloudsetup—有关安装说明，请参阅 BBE Cloudsetup 安装指南。

注意：
BBE Cloudsetup 是一款实用程序，可用于快速开始使用 BNG CUPS 控制器。它不是群集的生命周期工具。您无法扩展群集的宽度、执行节点维护、升级基础设施组件等。用于生产目的的 Kubernetes 群集应根据生产环境的要求进行设计和构建，并提供适当的支持，以维持其生命周期。

开始安装 BNG CUPS 控制器之前，请确保您已获取以下信息：

必填信息：

容器注册表详细信息：
- 如果您使用的是 Rancher Kubernetes Engine2 或 BBE Cloudsetup 创建的群集：
  - 外部注册表地址
  - 外部注册表端口号（通常为 5000）
- 如果您使用的是 Red Hat OpenShift Container Platform 群集：
  - 外部注册表（FQDN）
  - 内部（Docker）注册表地址
  - 内部（Docker）注册表端口号

可选信息：

用于创建持久卷声明（PVC）的存储类名称（默认值为 jnpr-bbe-storage）。
PVC 大小（默认值为 90 MiB）。
系统日志服务器详细信息 — 如果您计划将 BNG CUPS 控制器日志导出到外部系统日志收集器，则需要系统日志服务器信息。
- 系统日志服务器地址
- Syslog 服务器端口号

安装 BNG CUPS 控制器应用（单一地理位置）

从软件下载页面下载瞻博网络 BNG CUPS 软件包瞻博网络并将其保存到跳转主机。
BNG CUPS 控制器以压缩的 TAR 文件映像（.tgz）形式提供。文件名中包含版本号作为名称的一部分。发行号的格式为：m.nZb.s

例如，软件版本号 23.4R1.5 映射到以下格式：
- m 是产品的主要版本号（例如，23）。
- n 是产品的次要版本号（例如，4）。
- Z 是软件版本的类型（例如，R 表示 FRS 或维护版本）。
- b 是产品的内部版本号（例如，1，表示 FRS 版本，而不是维护版本）。
- s 是乘积的旋转数（例如，5）。

在跳转主机上解压 BNG CUPS 控制器 TAR 文件（.tgz），方法是输入：

解压 TAR 文件后运行加载程序脚本。

使用命令 sudo -E dbng link --context context-name --version software-release 链接到群集。该 link 命令将加载的 BNG CUPS 控制器软件包关联到群集，为设置做准备。
- context context-name- 群集的 Kubernetes 上下文名称。
- version software-release- BNG CUPS 控制器软件版本，如输出显示的 dbng_loader 那样。
如果要在红帽 OpenShift 容器平台群集上安装 BNG CUPS 控制器，请以具有管理员权限的用户身份使用 OpenShift CLI 登录，然后继续下一步。
如果要在 Rancher Kubernetes Engine2 或 BBE Cloudsetup 创建的群集上安装 BNG CUPS 控制器，请继续下一步。
您必须使用容器注册表进行身份验证，才能推送 BNG CUPS 控制器容器映像。向注册表进行身份验证的方式会有所不同，具体取决于您是在 Rancher Kubernetes Engine2 创建的群集、BBE Cloudsetup 创建的群集或 Red Hat OpenShift Container Platform 群集上安装 BNG CUPS 控制器（有关详细信息，请参阅相应的文档）。
如果您使用的是安全注册表（在 Rancher Kubernetes Engine2 或 BBE Cloudsetup 创建的群集上创建），则可以通过以系统用户（Rancher Kubernetes Engine2 或 BBE Cloudsetup 配置文件中提供的系统用户）的身份向群集的注册表传输地址（在 Rancher Kubernetes Engine2 或 BBE Cloudsetup 配置文件中作为系统地址提供的 FQDN）发出 docker 登录名来使用注册表进行身份验证。

运行 setup 以配置您的安装。该 setup 命令执行以下操作：

建立 Kubernetes 部署的操作参数。

如果未将该选项或template file-name该选项与bbecloudsetup设置命令一起使用，则需要在设置过程中完成以下提示：
- 如果您使用 Rancher Kubernetes Engine2 或 BBE Cloudsetup 创建群集：
  - 外部注册表地址。
  - 外部注册表端口号。
- 如果您使用的是 Red Hat OpenShift Container Platform 群集：
  - 外部注册机构（全限定域名）
  - 内部（Docker）注册表地址
  - 内部（Docker）注册表端口号

注意：

context context-name 是命令的唯一 setup 必需选项。

下面列出了可与命令 setup 一起使用的选项：

context context-name- 群集的 Kubernetes 上下文名称。
h, help- 显示帮助消息并退出。
l, log [error, warning, info, debug]- 调整日志级别。
no-color- 打印不带颜色的邮件。
bbecloudsetup— 填写与 bbecloudsetup 创建的群集一致的操作参数，以便在设置过程中不必与 BNG CUPS 控制器交互（有关群集安装说明，请参阅 BBE Cloudsetup 安装指南）。

注意：
仅使用选项 bbecloudsetup 或选项 template file-name 。不要同时使用这两个选项。
update- 在设置过程中，系统只会提示您输入缺失值。
ssh host:port— 群集的主机名或 IP 地址（群集的任何节点）和用于 SSH 访问 CLI 的开放端口。
secrets— 更新 BNG CUPS 控制器使用的密钥、证书和密钥。
verbose- 在每个提示问题之前提供详细说明。
configfile-name- 您希望 BNG CUPS 控制器在启动期间使用的初始配置文件的名称。
template file-name- YAML 格式的文件，其中包含在设置过程中创建的配置文件的子集。设置过程会自动使用在模板文件中输入的值。使用该 template 选项时，无需在设置过程中手动输入模板文件中包含的信息。仅当使用 Red Hat OpenShift Container Platform 创建群集或创建多地理群集时，才应使用该 template 选项。表 3 介绍了需要在配置文件中 template 输入的信息。

注意：
仅使用选项 bbecloudsetup 或选项 template file-name 。不要同时使用这两个选项。
mandatory- 仅在设置过程中询问必填问题。
optional- 仅询问设置过程中不需要的问题。

表 3：安装文件字段说明
字段	描述
外部注册表地址	外部注册表地址是容器映像推送到的 FQDN。
APMi TLS 密钥名称	地址池管理器（APM）的传输层安全性（TLS）密钥名称。
APMi 证书	APM 的证书。
APMi 私钥	APM 的私钥。
APMi 根证书	APM 的根证书。
DTLS 机密名称	数据报传输级别安全性（DTLS）机密名称。
DTLS 证书	DTLS 证书。
DTLS 私钥	DTLS 私钥。
DTLS 根证书	DTLS 根证书。
k8s 的注册表	传输地址或 `FQDN:port` 从中提取容器映像的地址。
部署时要挂载的启动配置	用于初始配置的配置文件。如果未提供配置文件，则使用出厂默认配置。
（选答） CPi 配置存储名称	配置的 CPi 存储类的名称。
（选答） CPi 配置存储大小	配置的 CPi 存储类的大小，以兆字节（MiB）为单位。
（选答） CPi 核心存储名称	CPi 核心存储类的名称。
（选答） CPi 核心存储大小	CPi 核心存储类的大小，以兆字节（MiB）为单位。
（选答）缓存核心存储名称	Scache 核心存储类的名称。
（选答）缓存核心存储大小	Scache 核心存储类的大小，以兆字节（MiB）为单位。

通过运行dbng-version命令验证 BNG CUPS 控制器安装。

context context-name- 群集的 Kubernetes 上下文名称。
detail- 显示所有可用的软件版本。

在单一地理位置设置中启动 BNG CUPS 控制器

使用此过程可在单个地理位置设置中配置和启动 BNG CUPS 控制器。

进入 rollout 以开始 BNG CUPS 控制器安装。BNG CUPS 控制器实用程序允许您为属于 BNG CUPS 控制器的所有微服务推出不同的软件版本。您需要将命令 rollout 与 sudo 作为 root 一起使用。该 rollout 命令还验证新版本所需的所有值是否存在，并将新版本容器映像加载到注册表。用于 sudo -E dbng rollout --context context-name --version software-release --service service-name 启动 BNG CUPS 控制器服务。例如：

context context-name—群集的 Kubernetes 上下文。
service service-name- 要部署的微服务名称（例如， scache 或 cpi）。
version software-release- 要部署的软件版本（默认为链接到群集的版本）。

注意：

上，不需要首次部署 -–service。用于-–service–-version推出（升级）特定服务的特定版本。

注意：

默认情况下，BNG CUPS 控制器从出厂默认设置开始。配置将重置为其初始状态。清除任何持久状态和任何持久日志。

输入以 dbng status --context context-name --detail 验证 BNG CUPS 控制器服务是否已启动并正在运行。例如：

注意：

收集服务日志，并在出现以下任一情况时联系瞻博网络技术援助中心（JTAC）：

服务未运行。
与其他服务相比，服务的正常运行时间表明它已重新启动。

您必须将控制平面实例（CPi）添加到 BNG CUPS 控制器。运行 CPi add 命令。

context context-name- 群集的 Kubernetes 上下文名称。
version software-release- 新 CPi Pod 的软件版本。输入版本。
cpi-label- 标签用于对 CPi 进行唯一命名，以便进行识别。在上面的示例中，输出是 cpi-label cpi-example-1。

使用 dbng status 命令验证 CPi 微服务是否正在运行。

context context-name- 群集的 Kubernetes 上下文名称。
detail- 显示详细信息。

在多地理位置环境中安装瞻博网络 BNG CUPS 控制器

对于由位于不同地理位置的多个 BNG CUPS 控制器组成的 BNG CUPS 控制器设置，请使用本部分中的安装过程。

开始之前，请确认您已满足 BNG CUPS 控制器安装要求（请参阅表 2）。

开始安装 BNG CUPS 控制器之前，请确保您已获取以下信息：

注意：

您必须为所有三个群集收集下面列出的信息。

工作负载群集的群集上下文名称、管理群集的 karmada 上下文和管理群集的工作上下文
Karmada kubeconfig 密钥名称 — 管理群集上 Karmada 上下文的 kubeconfig 文件。您可以从 karmada-system 命名空间中的管理群集上下文中提取 Karmada 上下文的 kubeconfig 文件。

有关要运行的命令的示例，请参阅以下内容：
每个群集的容器注册表详细信息：
- 外部注册表地址
- 外部注册表端口号（通常为 5000）
系统日志服务器详细信息 — 如果您计划将 BNG CUPS 控制器日志导出到外部系统日志收集器，则需要系统日志服务器信息。
- 系统日志服务器地址
- Syslog 服务器端口号
Kubeconfig 用于管理群集。

安装 BNG CUPS 控制器应用（多地理位置设置）

从软件下载页面下载瞻博网络 BNG CUPS 软件包瞻博网络并将其保存到跳转主机。
BNG CUPS 控制器以压缩的 TAR 文件映像（.tgz）形式提供。文件名中包含版本号作为名称的一部分。发行号的格式为：m.nZb.s

例如，软件版本号 23.4R1.5 映射到以下格式：
- m 是产品的主要版本号（例如，23）。
- n 是产品的次要版本号（例如，4）。
- Z 是软件版本的类型（例如，R 表示 FRS 或维护版本）。
- b 是产品的内部版本号（例如，1，表示 FRS 版本，而不是维护版本）。
- s 是乘积的旋转数（例如，5）。

在跳转主机上解压 BNG CUPS 控制器 TAR （.tgz）文件，方法是输入：

解压 TAR 文件后运行加载程序脚本。

使用命令 sudo -E dbng link 链接到群集。在准备运行 setup时，该 link 命令获取工作负载群集上下文列表，并将其关联到加载的 BNG CUPS 控制器软件包，
- context multi-cluster-context-name- 多地理位置设置的上下文名称。是 multi-cluster-context-name 应用于 link 命令的用户定义字符串，用作两个工作负载群集的通用参考。
- worload-contexts workload-1-context-name workload-2-context-name- 两个工作负载上下文名称。
- version software-release- BNG CUPS 控制器软件版本，如输出显示的 dbng_loader 那样。
图 1：多地理位置多集群

使用 RHOCP 群集时，您可以在使用 OpenShift CLI 对 OpenShift 群集和三个 RHOCP 群集（管理和两个工作负载群集）进行身份验证后与其交互。

有关要运行的命令的示例，请参阅以下内容：

为了推送 BNG CUPS 控制器容器映像，您必须在多群集设置中向每个群集上的注册表进行身份验证。通过以系统用户（在 BBE Cloudsetup 配置文件中输入的系统用户）的身份向群集的注册表传输地址（作为 BBE Cloudsetup 配置文件中作为系统地址提供的 FQDN）发出 docker 登录名，向注册表进行身份验证。
运行 setup 以配置您的安装。该 setup 命令执行以下操作：
- 收集有关群集环境的信息。收集的信息包括以下内容：
  - 服务帐户 — 为微服务启用所需权限的 Kubernetes 服务帐户的名称。
  - 容器映像注册表推送和拉取传输地址。
  - 存储类（用于 Kubernetes PVC 创建）。
- 收集有关如何自定义 BNG CUPS 控制器部署的信息。收集的信息包括以下内容：
  - APM 接口（APMi）的 TLS 密钥和证书。
  - SCi 和 CPRi 接口的 DTLS 密钥和证书。
  - 用于内部微服务通信的 SSH 密钥。
  - PVC 大小（用于存储配置和其他持久性数据）。
  - 首选 BNGD 群集 — BNGD 微服务最初应处于活动状态的群集（工作负载上下文）的名称。
- 初始化 BNG CUPS 控制器配置。
在设置过程中，系统将提示您提供信息。为避免在设置过程中输入信息，可以使用模板文件（有关模板文件的说明，请参阅 template）。

如果未使用模板文件，则在设置过程中可能会出现以下提示：
- 管理群集的以下信息：
  - 每个群集的外部注册表地址和端口号。输入各群集信息后，单击 Enter 键。
  - 要从中提取的管理群集的注册表地址。
  - Karmada kubeconfig 密钥名称
  - 启用 TLS（默认为 False）
  - TLS 密钥名称
- 主工作负载（workload-1）群集的以下信息。输入信息后，单击 Enter 键，输入备份工作负载群集的信息：
  - 每个群集的外部注册表地址和端口号。输入各群集信息后，单击 Enter 键。
- 备份（workload-2）工作负载群集的以下信息：
  - 每个群集的外部注册表地址和端口号。输入各群集信息后，单击 Enter 键。
- 备份工作负载群集 - 输入备份工作负载群集的名称
- 备份工作负载注册表地址
- 主工作负载群集 - 输入主工作负载群集的名称
- APMi TLS 密钥名称
  
  注意：jnpr-bng-controller 命名空间中包含 TLS 密钥和证书的 Kubernetes 密钥对象的名称。如果密钥不存在，请将此字段留空，并setup提示您输入包含证书、私钥和根证书的文件。然后将为您创建 Kubernetes 密钥。如果提供了密钥，setup则不会提示您输入证书、私钥或根证书文件。
- APMi 证书
- APMi 私钥
- APMi 根证书
- DTLS 机密名称
  
  注意：jnpr-bng-controller 命名空间中包含 TLS 密钥和证书的 Kubernetes 密钥对象的名称。如果密钥不存在，请将此字段留空，并setup提示您输入包含证书、私钥和根证书的文件。然后将为您创建 Kubernetes 密钥。如果提供了密钥，setup则不会提示您输入证书、私钥或根证书文件。
- DTLS 证书
- DTLS 私钥
- DTLS 根证书
- k8s 的注册表
- 部署时要挂载的启动配置
- CPi Config 存储类名称和大小
- CPi Core 存储类名称和大小
- 缓存核心存储名称
- 缓存核心存储大小
注意：
要在多地理位置部署中通过 SSH 设置 CLI 访问，必须使用模板文件（使用 template 命令中的 setup 选项）。这使您能够配置两个工作负载群集地址。

要配置 SSH，请将每个工作负载群集的以下信息（YAML 格式）添加到您在设置过程中提供的模板文件中：
有关模板文件中的 SSH 配置的更多信息，请参阅以下内容：
- cluster-vip-address- 用于从跳转主机管理群集的 IP 地址。
- cluster-name- 命令输出 kubectl get clusters 中显示的工作负载群集的名称。
- available-port-value- 必须是未在任何工作负载群集节点上使用的 TCP 端口。例如，不要使用端口 22，而是使用大编号端口，如端口 8200。
- service-name- 您希望创建的服务使用的名称。最佳做法是在名称中包含应用程序名称、用途和工作负载群集（例如 dbng-ssh-workload1）。
- type— 确定要为 SSH 访问创建的外部服务类型。可用选项包括或 NodePort LoadBalancer。
下面列出了可与命令 setup 一起使用的选项：
- context multi-cluster-context-name- 多地理位置设置的上下文名称。是 multi-cluster-context-name 应用于 link 命令的用户定义字符串，用作两个工作负载群集的通用参考。
- h, help- 显示帮助消息并退出。
- l, log [error, warning, info, debug]- 调整日志级别。
- no-color- 打印不带颜色的邮件。
- update- 在设置过程中，系统只会提示您输入缺失值。
- secrets— 更新 BNG CUPS 控制器使用的密钥、证书和密钥。
- verbose- 在每个提示问题之前提供详细说明。
- configfile-name- 您希望 BNG CUPS 控制器在启动期间使用的初始配置文件的名称。
- template file-name- YAML 格式的文件，其中包含在设置过程中创建的配置文件的子集。设置过程会自动使用在模板文件中输入的值。使用该 template 选项时，无需在设置过程中手动输入模板文件中包含的信息。仅当使用 Red Hat OpenShift Container Platform 创建群集或创建多地理群集时，才应使用该 template 选项。表 3 介绍了需要在配置文件中 template 输入的信息。
- mandatory- 仅在设置过程中询问必填问题。
- optional- 仅询问设置过程中不需要的问题。

通过运行dbng-version命令验证 BNG CUPS 控制器安装。

context multi-cluster-context-name- 多地理位置设置的上下文名称。是 multi-cluster-context-name 应用于 link 命令的用户定义字符串，用作两个工作负载群集的通用参考。
detail- 显示所有可用的软件版本。

在多地理位置设置中启动 BNG CUPS 控制器

使用此过程可在多地理位置设置中配置和启动 BNG CUPS 控制器。

进入 rollout 以开始 BNG CUPS 控制器安装。BNG CUPS 控制器实用程序允许您为 BNG CUPS 控制器多地理位置设置中的所有微服务推出不同的软件版本。您需要将命令 rollout 与 sudo 作为 root 一起使用。该 rollout 命令还验证新版本所需的所有值是否存在，并将新版本容器映像加载到注册表。用于 sudo -E dbng rollout --context multi-cluster-context-name --version software-release --service service-name 启动 BNG CUPS 控制器服务。例如：

context multi-cluster-context-name- 多地理位置设置的上下文名称。是 multi-cluster-context-name 应用于 link 命令的用户定义字符串，用作两个工作负载群集的通用参考。
service service-name- 要部署的微服务名称（例如， scache 或 cpi）。
version software-release- 要部署的软件版本（默认为链接到群集的版本）。

注意：

上，不需要首次部署 -–service。用于-–service–-version推出（升级）特定服务的特定版本。

注意：

默认情况下，BNG CUPS 控制器从出厂默认设置开始。配置将重置为其初始状态。清除任何持久状态和任何持久日志。

输入以 dbng status --context multi-cluster-context-name 验证 BNG CUPS 控制器服务是否已启动并正在运行。例如：

注意：如需详细输出，可以使用命令dbng status --context multi-cluster-context-name --detail。

context multi-cluster-context-name- 多地理位置设置的上下文名称。是 multi-cluster-context-name 应用于 link 命令的用户定义字符串，用作两个工作负载群集的通用参考。
detail- 显示详细信息。

注意：