安装瞻博网络 BNG CUPS

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

1. 从软件下载页面下载 瞻博网络 BNG CUPS 软件包瞻博网络并将其保存到跳转主机。

   BNG CUPS 控制器以压缩的 TAR 文件映像 （.tgz） 形式提供。文件名中包含版本号作为名称的一部分。发行号的格式为：m.nZb.s

   例如，软件版本号 23.4R1.5 映射到以下格式：

   • m 是产品的主要版本号（例如，23）。

   • n 是产品的次要版本号（例如，4）。

   • Z 是软件版本的类型（例如，R 表示 FRS 或维护版本）。

   • b 是产品的内部版本号 （例如，1，表示 FRS 版本，而不是维护版本） 。

   • s 是乘积的旋转数（例如，5）。

2. 在 跳转主机上解压 BNG CUPS 控制器 TAR 文件 （.tgz），方法是输入：
3. 解压 TAR 文件后运行加载程序脚本。
4. 使用命令sudo -E dbng link --context context-name --version software-release链接到群集。该link命令将加载的 BNG CUPS 控制器软件包关联到群集，为设置做准备。

   • context context-name— Kubernetes 上下文名称。

   • version software-release- BNG CUPS 控制器软件版本，如输出显示的 dbng_loader 那样。

5. 如果要在红帽 OpenShift 容器平台群集上安装 BNG CUPS 控制器，请以具有管理员权限的用户身份使用 OpenShift CLI 登录，然后继续下一步。
   如果要在 BBE Cloudsetup 创建的群集上安装 BNG CUPS 控制器，请继续下一步。
6. 您必须使用容器注册表进行身份验证，才能推送 BNG CUPS 控制器容器映像。向注册表进行身份验证的方式取决于您是在 BBE Cloudsetup 创建的群集上还是在 Red Hat OpenShift Container Platform 群集上安装 BNG CUPS 控制器（有关详细信息，请参阅相应的文档）。

   如果使用安全注册表（在 BBE Cloudsetup 创建的群集上创建），则通过以系统用户（BBE Cloudsetup 配置文件中提供的系统用户）的身份向群集的注册表传输地址（作为 BBE Cloudsetup 配置文件中作为系统地址提供的 FQDN）发出 docker 登录名来向注册表进行身份验证。

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

   • 建立 Kubernetes 部署的作参数。

     如果未将该选项或template file-name该选项与bbecloudsetup设置命令一起使用，则需要在设置过程中完成以下提示：

     • 如果您使用 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。
   APM TLS 密钥名称	地址池管理器 （APM） 的传输层安全性 （TLS） 密钥名称。
   APM 证书	APM 的证书。
   APM 私钥	APM 的私钥。
   APM 根证书	APM 的根证书。
   BBE 观察者连接 TLS 密钥名称	BBE 观察者连接的 TLS 密钥名称。
   BBE 观察者连接证书	BBE 观察者连接的证书。
   BBE 观察者连接私钥	BBE 观察者连接的私钥。
   BBE 观察者连接根证书	BBE 观察者连接的根证书。
   DTLS 机密名称	数据报传输级别安全性 （DTLS） 机密名称。
   DTLS 证书	DTLS 证书。
   DTLS 私钥	DTLS 私钥。
   DTLS 根证书	DTLS 根证书。
   k8s 的注册表	传输地址或 FQDN:port 从中提取容器映像的地址。
   部署时要挂载的启动配置	用于初始配置的配置文件。如果未提供配置文件，则使用出厂默认配置。
   （选答） CPi 配置存储名称	配置的 CPi 存储类的名称。
   （选答） CPi 配置存储大小	配置的 CPi 存储类的大小，以兆字节 （MiB） 为单位。
   （选答） CPi 核心存储名称	CPi 核心存储类的名称。
   （选答） CPi 核心存储大小	CPi 核心存储类的大小，以兆字节 （MiB） 为单位。
   （选答） 缓存核心存储名称	Scache 核心存储类的名称。
   （选答） 缓存核心存储大小	Scache 核心存储类的大小，以兆字节 （MiB） 为单位。

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

   • context context-name— Kubernetes 上下文名称。

   • detail- 显示所有可用的软件版本。

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

1. 进入 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-name— Kubernetes 上下文

   • service service-name- 要部署的微服务名称（例如， scache 或 cpi）。

   • version software-release- 要部署的软件版本（默认为链接到群集的版本）。

   注意：

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

   注意：

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

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

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

   • 服务未运行。

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

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

   • context-name— Kubernetes 上下文名称。

   • version software-release- 新 CPi Pod 的软件版本。输入版本。

   • cpi-label- 标签用于对 CPi 进行唯一命名，以便进行识别。在上面的示例中，输出 是 cpi-label cpi-example-1。

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

   • context-name— Kubernetes 上下文名称。

   • detail- 显示详细信息。

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

1. 在管理上下文中创建 jnpr-bng-controller 命名空间/项目。

   • context management-context-name- 管理群集的上下文名称。请注意，此上下文与与管理群集关联的 Karmada 上下文名称不同。

2. 创建 karmada-kconf 密钥。使用管理群集的 kubeconfig 在 BNG CUPS 控制器命名空间的管理群集上创建密钥。
   注意：

   karmada-kconf 密钥包含观察者用来监视 CPi 状态的 kubeconfig。如果未创建密钥，观察者（和 BNG CUPS 控制器）将无法正常运行。

   运行以下命令：

   • management-context-name- 管理群集的上下文名称。请注意，此上下文与与管理群集关联的 Karmada 上下文名称不同。

   • karmada-secret-file- 管理群集的 kubeconfig 文件。

3. 通过 运行以下命令验证是否已创建密钥：
   注意：

   根据您的设置，列出的字节数可能非常多。

4. 从软件下载页面下载 瞻博网络 BNG CUPS 软件包瞻博网络并将其保存到跳转主机。

   BNG CUPS 控制器以压缩的 TAR 文件映像 （.tgz） 形式提供。文件名中包含版本号作为名称的一部分。发行号的格式为：m.nZb.s

   例如，软件版本号 23.4R1.5 映射到以下格式：

   • m 是产品的主要版本号（例如，23）。

   • n 是产品的次要版本号（例如，4）。

   • Z 是软件版本的类型（例如，R 表示 FRS 或维护版本）。

   • b 是产品的内部版本号 （例如，1，表示 FRS 版本，而不是维护版本） 。

   • s 是乘积的旋转数（例如，5）。

5. 在 跳转主机上解压 BNG CUPS 控制器 TAR （.tgz） 文件，方法是输入：
6. 解压 TAR 文件后运行加载程序脚本。
7. 使用命令sudo -E dbng link链接到群集。在准备运行setup时，该link命令获取工作负载群集上下文列表和观察者上下文，并将它们关联到加载的 BNG CUPS 控制器软件包，

   • context karmada-context-name- 在管理群集上安装 Karmada 时创建的 Karmada 上下文的上下文名称。

   • worload-contexts workload-1-context-name workload-2-context-name- 两个工作负载上下文名称。

   • observer-context management-context-name- 管理群集的上下文名称。请注意，此上下文与与管理群集关联的 Karmada 上下文名称不同。

   • version software-release- BNG CUPS 控制器软件版本，如输出显示的 dbng_loader 那样。

   注意：

   在安装过程中，Karmada 将安装在管理群集上，并且 Karmada 会在管理群集上创建自己的上下文。Karmada 上下文用于定位涉及工作负载集群的任何作。管理群集还具有自己的上下文，用于运行非关键集中式工作负载（例如， BBE 事件收集和可视化）。您可以将此管理群集上下文用于 observer-context.

   图 1 显示了不同上下文在多群集设置中的位置。

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

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

9. 为了推送 BNG CUPS 控制器容器映像，您必须在多群集设置中向每个群集上的注册表进行身份验证。通过以系统用户（在 BBE Cloudsetup 配置文件中输入的系统用户）的身份向群集的注册表传输地址（作为 BBE Cloudsetup 配置文件中作为系统地址提供的 FQDN）发出 docker 登录名，向注册表进行身份验证。
10. 运行 setup 以配置您的安装。该 setup 命令执行以下作：

    • 收集有关群集环境的信息 - 收集的信息包括以下内容：

      • 存储类或持久卷的名称

      • 容器注册表的位置

      • 注册表的容器和 Pod 名称

      • TLS 密钥

      • 有关支持 BNG CUPS 控制器功能的相关信息。

    • 初始化 BNG CUPS 控制器配置。

    在设置过程中，系统将提示您提供信息。为避免在设置过程中输入信息，可以使用模板文件（有关模板文件的说明，请参阅 template）。

    如果未使用模板文件，则在设置过程中可能会出现以下提示：

    • 管理群集上的观察者提供以下信息：

      • 每个群集的外部注册表地址和端口号。输入各群集信息后，单击 Enter 键。

      • 要从中提取的观察者（管理群集）的注册表地址。

      • Karmada kubeconfig 密钥名称

      • 启用 TLS（默认为 False）

      • TLS 密钥名称

    • 主工作负载 （workload-1） 群集的以下信息。输入信息后，单击 Enter 键，输入备份工作负载群集的信息：

      • 每个群集的外部注册表地址和端口号。输入各群集信息后，单击 Enter 键。

      • 观察者 TLS 证书颁发机构密钥名称

    • 备份 （workload-2） 工作负载群集的以下信息：

      • 每个群集的外部注册表地址和端口号。输入各群集信息后，单击 Enter 键。

      • 观察者 TLS 证书颁发机构密钥名称

    • 备份工作负载群集 - 输入备份工作负载群集的名称

    • 备份工作负载注册表地址

    • 主工作负载群集 - 输入主工作负载群集的名称

    • APM TLS 密钥名称

      注意：jnpr-bng-controller 命名空间中包含 TLS 密钥和证书的 Kubernetes 密钥对象的名称。如果密钥不存在，请将此字段留空，并 setup提示您输入包含证书、私钥和根证书的文件。然后将为您创建 Kubernetes 密钥。如果提供了密钥， setup则不会提示您输入证书、私钥或根证书文件。

    • APM 证书

    • APM 私钥

    • APM 根证书

    • BBE 观察者连接 TLS 密钥名称

    • BBE 观察者连接证书

    • BBE 观察者连接私钥

    • BBE 观察者连接根证书

    • 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 karmada-context-name- 在管理群集上安装 Karmada 时创建的 Karmada 上下文的上下文名称。

    • 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- 仅询问设置过程中不需要的问题。

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

    • context context-name— Kubernetes 上下文名称。

    • detail- 显示所有可用的软件版本。

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

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

   • karmada-context-name- 在管理群集上安装 Karmada 时创建的 Karmada 上下文的上下文名称。

   • service service-name- 要部署的微服务名称（例如， scache 或 cpi）。

   • version software-release- 要部署的软件版本（默认为链接到群集的版本）。

   注意：

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

   注意：

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

2. 输入以dbng status --context karmada-context-name验证 BNG CUPS 控制器服务是否已启动并正在运行。例如：
   注意：如需详细输出，可以使用命令 dbng status --context karmada-context-name --detail。

   • karmada-context-name- 在管理群集上安装 Karmada 时创建的 Karmada 上下文的上下文名称。

   • detail- 显示详细信息。

   注意：

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

   • 服务未运行。

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

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

   • context karmada-context-name- 在管理群集上安装 Karmada 时创建的 Karmada 上下文的上下文名称。

   • version software-release- 新 CPi Pod 的软件版本。输入版本。

   • ip-aaa ip-address— 要为 CPi AAA作部署的 IP 地址。您可以使用该 ip-aaa 选项指定要用于 CPi 上的 RADIUS 侦听器端口的单个外部 IP 地址。在多个地理位置切换后，地址保持不变。该 ip-aaa 选项需要启用 L3 的 MetalLB 实例。MetalLB BGP 对等互连用于将流量定向到活动工作负载群集上的 CPi。

   • label- 指定新 CPi 的名称。

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