如何使用瞻博网络 BNG CUPS 控制器实用程序命令

安装瞻博网络 BNG CUPS 控制器(BNG CUPS 控制器)后,您可以执行许多管理功能。

访问瞻博网络 BNG CUPS 控制器实用程序命令

您可以使用 BNG CUPS 控制器实用程序脚本 (dbng) 管理应用程序并访问用于配置操作的 CLI。BNG CUPS 控制器安装会将实用程序脚本放在 /usr/local/bin 中。

dbng实用程序脚本执行管理 BNG CUPS 所需的任务,但掩盖了命令的kubectl复杂性。命令的kubectl这种屏蔽可以简化您的管理职责。

dbng实用程序脚本使用 Kubernetes kubectl 实用程序命令执行以下操作:

  • 创建和删除对象。
  • 使用 pod 容器进行交互式会话。
  • 显示 BNG CUPS 控制器对象的状态。

表 1 列出了可以使用 dbng 实用程序脚本调用的命令,并介绍了每个命令启动的操作。

表 1:BNG CUPS 控制器实用程序脚本命令

命令名称

行动

sudo -E dbng clean [--docker] [--release software-release] [--dry-run] [--uninstall]

清理不需要的版本和 Docker 缓存。要运行此命令,您需要 sudo root 权限。

此命令提供以下选项:

  • log [error, warning, info, debug]- 调整日志级别。

  • no-color- 打印不带颜色的邮件。

  • docker—仅清理本地 Docker 缓存,所有其他文件将保留。

  • release software-release- 指定一个释放以清洁或清洁所有可能的释放。

  • dry-run- 标识要删除的版本和 docker 映像,并将其打印到控制台。此命令实际上不会清理任何版本或 Docker 缓存。

  • uninstall— 从磁盘中卸载所有 BNG CUPS 控制器材料。该命令不会影响正在运行的应用程序。

  • clustr-repos- 清理已移除群集的群集存储库。

dbng cli --context context-name [-p|--pipe]

允许您访问可用于配置 BNG CUPS 控制器功能的 CLI。

此命令提供以下选项:

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

  • pipe- 允许您将输入通过管道传输到命令中。

dbng contexts [-o|--output json]

显示使用 BNG CUPS 控制器进行控制的可用上下文。

此命令提供以下选项:

  • contexts- 列出可用上下文。

  • output json- 允许您请求 JSON 格式的输出。

sudo -E dbng cpi add --context context-name -h --log --version software-release --ip-aaa ip-address cpi-label

部署新的控制平面实例 (CPi) 容器。要运行此命令,您需要 sudo root 权限。

此命令提供以下选项:

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

    注意:

    如果在多地理位置设置中使用此命令,则必须输入与管理群集关联的 Karmada 上下文的上下文名称。

  • h, help- 显示帮助消息并退出。

  • l, log [error, warning, info, debug]- 调整日志级别。

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

  • name- 新 CPi 的名称。

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

  • cpi-label- 指定用于标识 CPi 的标签。

sudo -E dbng cpi rm --context context-name cpi-label

移除控制平面实例 (CPi) 容器。要运行此命令,您需要 sudo root 权限。

此命令提供以下选项:

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

    注意:

    如果在多地理位置设置中使用此命令,则必须输入与管理群集关联的 Karmada 上下文的上下文名称。

  • cpi-label- 指定 CPi 的标签。

dbng ip --context context-name [-o| --output json] [--detail]

显示每个服务的外部 IP 地址。

此命令提供以下选项:

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

    注意:

    如果在多地理位置设置中使用此命令,则必须输入与管理群集关联的 Karmada 上下文的上下文名称。

  • output json- 允许您请求 JSON 格式的输出。

  • detail— 显示详细的 IP 信息。

单一地理位置设置用途:sudo -E dbng link --version software-release --context context-name --from-running

多地理位置设置用途:

sudo -E dbng link --context karmada-context-name --from-running --workload-contexts workload-1-context-name workload-2-context-name --observer-context observer-context-name--version software-release

将群集链接到特定软件版本。要运行此命令,您需要 sudo root 权限。

此命令提供以下选项:

  • version software-release- 指定要链接到群集特定存储库的软件版本。

  • context context-name- 要链接到软件版本的 Kubernetes 上下文名称。输入上下文的名称。

  • context karmada-context-name- 在管理群集上安装 Karmada 时创建的 Karmada 上下文的上下文名称。仅用于多地理位置设置。输入上下文的名称。

  • from-running— 尝试匹配正在运行的 BNG CUPS 控制器的软件版本。该 from-running 选项用于从正在运行的应用程序部署中恢复版本和用户设置。这可以帮助您恢复失败的跳转主机或同步跳转主机网络。

  • workload-contexts workload-1-context-name workload-2-context-name- 两个工作负载上下文名称。仅用于多地理位置设置。输入上下文的名称。

  • observer-context management-context-name- 管理群集的上下文名称。仅用于多地理位置设置。输入上下文的名称。

sudo -E dbng multi-cluster add-cluster workload-context-name--context karmada-context-name

将工作负载上下文添加到现有管理上下文。要运行此命令,您需要 sudo root 权限。

此命令提供以下选项:

  • workload-context-name- 要添加的工作负载群集的上下文名称。

  • context karmada-context-name- 与管理群集关联的 Karmada 上下文的上下文名称。输入上下文的名称。

注意:

此命令仅在多地理位置设置中受支持。

sudo -E dbng multi-cluster rm-cluster workload-context-name --context karmada-context-name

从现有管理上下文中删除工作负载上下文。要运行此命令,您需要 sudo root 权限。

此命令提供以下选项:

  • workload-context-name- 要移除的工作负载群集的上下文名称。

  • context karmada-context-name- 与管理群集关联的 Karmada 上下文的上下文名称。输入上下文的名称。

context karmada-context-name- 与管理群集关联的 Karmada 上下文的上下文名称。输入上下文的名称。

注意:

此命令仅在位于多个地理位置的设置中受支持。

dbng multi-cluster status --context karmada-context-name

从应用程序的角度显示工作负载集群的状态。

此命令提供以下选项:

context karmada-context-name- 与管理群集关联的 Karmada 上下文的上下文名称。输入上下文的名称。

注意:

此命令仅在多地理位置设置中受支持。

sudo -E dbng multi-cluster switchover --context karmada-context-name

启动到其他工作负载群集的切换。CPi 移动到另一个工作负载群集。要运行此命令,您需要 sudo root 权限。

此命令提供以下选项:

  • context karmada-context-name- 与管理群集关联的 Karmada 上下文的上下文名称。输入上下文的名称。

注意:此命令仅在多地理位置设置中受支持。

sudo -E dbng rename-context --context context-name --new-name new-name

重命名上下文。该命令不会影响当前在群集上运行的 BNG CUPS 控制器。要运行此命令,您需要 sudo root 权限。

此命令提供以下选项:

  • context context-name- 要重命名的旧 Kubernetes 上下文名称。输入上下文的名称。

  • new-name new-name- Kubernetes 上下文的新名称(群集名称)。输入新名称。

注意:

如果在多地理位置设置中使用此命令,则必须输入与管理群集关联的 Karmada 上下文的上下文名称。

sudo -E dbng restart --context context-name [--force] [--wait] microservice-name

重新启动特定的 BNG CUPS 控制器服务。要运行此命令,您需要 sudo root 权限。

此命令提供以下选项:

  • context context-name- 要在上面重新启动服务的 Kubernetes 上下文名称。输入上下文的名称。

  • force— 强制重启微服务,而不验证其是否可以安全重启。

  • wait—等待新 pod 完全启动。

  • microservice-name- 输入要重新启动的微服务名称。

注意:

如果在多地理位置设置中使用此命令,则必须输入与管理群集关联的 Karmada 上下文的上下文名称。

sudo -E dbng rollout --context context-name [--service service name --version software-release]

升级 BNG CUPS 控制器服务。要运行此命令,您需要 sudo root 权限。

此命令提供以下选项:

  • context context-name—要在其上推出新软件版本的 Kubernetes 上下文名称。输入上下文的名称。

    注意:

    如果在多地理位置设置中使用此命令,则必须输入与管理群集关联的 Karmada 上下文的上下文名称。

  • sevice service name- 要部署的微服务名称。输入微服务的名称。

  • version software-release—要推出的软件版本。输入软件版本号。

sudo -E dbng setup --context context-name [--help] [--log info] [--no color] [--bbecloudsetup] [--update] [--ssh ip-address:port-number] [--secrets] [--verbose] [--config file-name] [--template file-name] [--mandatory] [--optional]

在安装过程中设置 BNG CUPS 控制器应用。要运行此命令,您需要 sudo root 权限。

此命令提供以下选项:

  • context context-name- 要在其上运行启动的 Kubernetes 上下文名称。输入上下文的名称。

    注意:

    如果在多地理位置设置中使用此命令,则必须输入与管理群集关联的 Karmada 上下文的上下文名称。

  • h, help- 显示帮助消息并退出。

  • l, log [error, warning, info, debug]- 调整日志级别。

  • no-color- 打印不带颜色的邮件。

  • bbecloudsetup- 填写与 BBE Cloudsetup 实用程序创建的群集一致的操作参数,这样您就不必在设置过程中与 BNG CUPS 控制器进行交互。(有关群集安装说明,请参阅 BBE Cloudsetup 安装指南 。

    注意:

    仅使用选项 bbecloudsetup 或选项 template file-name 。不要同时使用这两个选项。

  • update- 在设置过程中,系统只会提示您输入缺失值。

  • ssh ip-address:port-number— 启用指向控制平面实例的 SSH。输入控制平面实例侦听 SSH 的 SSH IP 地址和端口号(在配置中启用时)。IP 地址也可以是 DNS 名称。

  • secrets— 更新 BNG CUPS 控制器使用的密钥、证书和密钥。

  • verbose- 在每个提示问题之前提供详细说明。

  • config file-name— 您希望 BNG CUPS 控制器在启动时使用的初始配置文件。

  • template file-name- YAML 格式的文件,其中包含在设置过程中创建的配置文件的子集。设置过程会自动使用在模板文件中输入的值。使用该 template 选项时,无需在设置过程中手动输入模板文件中包含的信息。仅当使用 Red Hat OpenShift Container Platform 创建群集或创建多地理位置群集时,才应使用该 template 选项。 Setuop 文件字段说明 描述了您需要在配置文件中 template 输入的信息。

    注意:

    仅使用选项 bbecloudsetup 或选项 template file-name 。不要同时使用这两个选项。

  • mandatory- 仅在设置过程中询问必填问题。

  • optional- 仅询问设置过程中不需要的问题。

dbng shell --context context-name [-p|--pipe] microservice-name

将您连接到正在运行的微服务。

此命令提供以下选项:

  • microservice-name- 要连接到的微服务的名称。

  • context— Kubernetes 上下文名称。输入上下文的名称。

    注意:

    如果在多地理位置设置中使用此命令,则必须输入与管理群集关联的 Karmada 上下文的上下文名称。

  • pipe- 允许您将输入通过管道传输到命令中。

sudo -E dbng start --context context-name

启动特定的 BNG CUPS 控制器服务。要运行此命令,您需要 sudo root 权限。

此命令提供以下选项:

  • context context-name- 启动 BNG CUPS 控制器的 Kubernetes 上下文名称。输入上下文的名称。

    注意:

    如果在多地理位置设置中使用此命令,则必须输入与管理群集关联的 Karmada 上下文的上下文名称。

dbng status --context context-name [-o|--output json] [--terse] [--detail]

显示 BNG CUPS 控制器服务的当前状态。

此命令提供以下选项:

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

    注意:

    如果在多地理位置设置中使用此命令,则必须输入与管理群集关联的 Karmada 上下文的上下文名称。

  • output- 允许您请求 JSON 格式的输出。

  • terse- 显示系统运行状况的汇总输出。

  • detail- 显示每个容器的信息。

sudo -E dbng stop --context context-name [--now]

停止所有 BNG CUPS 控制器服务。要运行此命令,您需要 sudo root 权限。

此命令提供以下选项:

  • context context-name— 要在其上停止 BNG CUPS 控制器的 Kubernetes 上下文名称。输入上下文的名称。

    注意:

    如果在多地理位置设置中使用此命令,则必须输入与管理群集关联的 Karmada 上下文的上下文名称。

  • now— 立即停止 BNG CUPS 控制器,而不是等待两分钟的延迟。

dbng storage --context context-name [-o|--output json] [--terse]

提供 BNG CUPS 控制器的存储驱动程序状态。

此命令提供以下选项:

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

    注意:

    如果在多地理位置设置中使用此命令,则必须输入与管理群集关联的 Karmada 上下文的上下文名称。

  • output- 允许您请求 JSON 格式的输出。

  • terse- 显示存储运行状况的汇总输出。

sudo -E dbng unlink --context context-name

取消链接与上下文关联的组件。要运行此命令,您需要 sudo root 权限。

此命令提供以下选项:

  • context context-name—要卸载的 Kubernetes 上下文名称。输入上下文的名称。
  • 注意:

    如果在多地理位置设置中使用此命令,则必须输入与管理群集关联的 Karmada 上下文的上下文名称。

dbng version [--context context-name] [-o|--output json] [--detail] [--compare] [--release release-number]

显示以下内容的版本:

  • BNG CUPS 控制器实例中每个正在运行的微服务。

  • BNG CUPS 控制器实用程序。

  • 系统上所有可用的 BNG CUPS 控制器软件版本。

此命令提供以下选项:

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

    注意:

    如果在多地理位置设置中使用此命令,则必须输入与管理群集关联的 Karmada 上下文的上下文名称。

  • output- 允许您请求 JSON 格式的输出。

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

  • compare— 将指定版本与当前运行的 BNG CUPS 控制器版本进行比较。

  • release release-number- 显示请求版本的微服务信息。

使用以下常规语法发出命令:

  • 简短的选项:

  • 对于长期选项:

要显示带有简要说明的可用命令列表,请使用 h 或 help 选项:

要显示特定命令的选项:

启动或停止 BNG CUPS 控制器服务

使用 dbng 实用程序脚本启动或停止所有 BNG CUPS 控制器服务。

  • 要启动所有 BNG CUPS 控制器服务:

  • 要停止所有 BNG CUPS 控制器服务:

检查 BNG CUPS 控制器服务的状态

使用 dbng status 实用程序脚本检查 表 2 中列出的每个 BNG CUPS 控制器服务(功能组件)的状态。状态显示服务是否正在运行、已退出或尚未启动。它还会在 Kubernetes Pod 上显示服务名称。可以比较服务的正常运行时间,以快速查看是否已重启任何服务。

表 2:使用 status 命令显示的服务

服务

描述

cpi-label

BNG CUPS 控制器实例服务 — 实施用户管理控制平面,其中包括控制平面协议;身份验证、授权和计费 (AAA) 以及支持基础架构。

在 label 运行 dbng cpi add 命令时由您定义。

scache

状态缓存服务 — 为服务生成 cp 的用户服务状态提供群集内支持存储。在服务重新启动 cp 时,使用此服务进行状态恢复。

在多个地理位置设置中,你将看到两项 scache 服务。

configserver

配置文件复制。

注意:

此服务仅用于多地理位置设置。

bbe-mirp

多地理 IP 路由优先级 (MIRP) 运算符用于促进将外部 AAA 地址 (NAS-IP-Address) 播发到 iBGP 路由器,以便将入站 AAA 流量引导至活动工作负载群集(请参阅 ip-aaa 命令的 cpi add 选项)。

注意:

此服务仅用于多地理位置设置。

bbe-observer

观察多个群集调度事件以计算代数。

注意:

此服务仅用于多地理位置设置。

要检查控制器服务的状态,请显示服务状态:

例如:

瞻博网络 BNG CUPS 日志记录

瞻博网络 BNG CUPS 使用宽带边缘 (BBE) 事件收集和可视化应用进行记录。

BBE 事件收集和可视化收集系统日志事件并将其记录在时间序列数据库中。您可以通过 BBE 事件收集和可视化仪表板查看记录的事件。BBE 事件收集和可视化仪表板是一个基于 GUI 的可视化工具,使您能够根据定义的过滤器查看记录的事件,该过滤器可以在特定时间范围内。仪表板还提供了强大的搜索和可视化工具,通过这些工具可以关联来自多个来源的重新编码事件。若要安装 BBE 事件收集和可视化,请参阅 宽带边缘事件收集和可视化安装指南。

卸载并移除 BNG CUPS 控制器

使用 dbng 实用程序脚本卸载 BNG CUPS 控制器配置。该 unlink 命令将恢复您在设置 BNG CUPS 控制器时执行的操作。此脚本将 BNG CUPS 控制器返回到安装应用程序后、执行任何设置配置之前的状态。

要卸载 BNG CUPS 控制器:

  1. 在安装 BNG CUPS 控制器的跳转主机上,运行命令stop。
  2. 运行unlink命令。
  3. 运行clean命令。

如何访问 BNG CUPS 控制器配置和操作命令

访问 BNG CUPS 控制器 CLI

您可以使用 BNG CUPS 控制器命令行界面 (CLI) 配置 BNG CUPS 控制器并监控其操作。本节介绍如何访问 CLI。

要访问 BNG CUPS 控制器 CLI 提示符:

  1. 输入以下dbng实用程序脚本命令。
  2. 输入问号以查看可用的顶级 CLI 命令。此命令将生成 Junos OS 顶级命令的子集。

    可用于 BNG CUPS 控制器的 CLI 是 Junos OS CLI 的一个子集。有关 Junos OS CLI 基础知识的概述,请参阅 Day One:探索 Junos CLI。有关更多详细信息,请参阅 CLI 用户指南。

访问和使用 CLI 配置语句

您可以使用配置语句来配置、设置、管理和监控 BNG CUPS 控制器属性。

要配置 BNG CUPS 控制器组件,请执行以下操作:

  1. 使用 BNG CUPS 控制器实用程序命令dbng cli访问顶级 CLI 提示符。
  2. 访问配置模式,以配置 BNG CUPS 控制器以及 BNG CUPS 控制器用于配置托管路由器的信息。
  3. 输入 CLI 语句以配置瞻博网络 BNG CUPS 组件(BNG CUPS 控制器和 BNG 用户平面)。
  4. 保存并激活配置。仅当不存在配置语法错误时,此命令才会成功。
  5. (可选)退出配置模式并返回到顶级 CLI 提示符。

    有关支持的配置语句列表,请参阅 瞻博网络 BNG CUPS 控制器 CLI 配置语句。

访问和使用 CLI 操作命令

您可以使用操作命令显示瞻博网络 BNG CUPS 的当前状态。您可以输入操作命令来监控 BNG CUPS 控制器和 BNG 用户平面并对其进行故障排除。

要监控 BNG CUPS 控制器,请查看 BNG CUPS 控制器配置和统计数据,或手动运行某些操作:

  1. 使用 BNG CUPS 控制器实用程序命令dbng cli访问顶级 CLI 提示符。
  2. 输入特定命令。
    • 使用 show 命令显示统计信息。

    • 使用命令手动 request 启动某些 BNG CUPS 控制器操作。

    有关支持的操作命令列表,请参阅 瞻博网络 BNG CUPS 控制器 CLI 操作命令 。