安装


Red Hat Service Interconnect 2.0

安装控制器和 CLI

摘要

本指南论述了如何安装 Red Hat Service Interconnect 2.0。
Red Hat Service Interconnect 是红帽构建的开源 Skupper 项目。

第 1 章 安装概述

Red Hat Service Interconnect v2 可以安装到:

  • Kubernetes (包括 OpenShift)
  • 本地系统(包括 Podman、Docker 和 Linux 主机)

安装后,您可以使用 CLI 或 YAML 来:

  • 创建站点。
  • 链接站点.
  • 公开服务。

1.1. 在 Kubernetes 上安装

Kubernetes 的安装选项有:

安装后,您可以通过应用 YAML 资源来创建应用程序网络。

Kubernetes 用户也可以安装 Skupper CLI,这对于在站点间轻松创建链接非常有用。

1.2. 在本地系统上安装

在 Podman、Docker 和 Linux 主机上,您可以通过安装 CLI 来启动。

安装后,您可以使用 CLI 创建应用程序网络。

第 2 章 安装 CLI

Skupper CLI 提供了创建 Kubernetes 和本地系统站点的方法。

安装 CLI 的方法有两种:

注意

对于 Kubernetes,您必须在创建站点前使用 YAML 或 Operator 安装 CRD 和控制器。

2.1. 下载二进制文件

下载 Skupper CLI 二进制文件是在安装控制器和 CRD 后使用 Red Hat Service Interconnect 的快速方法。考虑在 Linux 中安装 第 2.2 节 “使用红帽软件包”

流程

  1. 下载适用于您的系统架构的二进制文件。

    选择最新的版本 for 2.0 at Software Downloads

    对于 Apple silicon 的 Mac,使用 Rosetta 2Skupper CLI for Mac on x86-64 下载。

  2. 解压下载的文件,并将 Skupper 可执行文件放在 PATH 中。
  3. 验证安装:

    $ skupper version
    client version                 2.0.0
    Copy to Clipboard

2.2. 使用红帽软件包

在 Linux 上安装红帽软件包可确保您收到 Skupper CLI 的最新更新。

先决条件

  • 确定您的订阅已激活,且您的系统已经注册。有关使用客户门户网站激活红帽订阅并为软件包注册您的系统的详情,请参考 第 7 章 使用您的订阅

流程

  1. 使用 subscription-manager 命令订阅所需的软件包存储库。将 <version > 替换为主发行版本流的 2

    Red Hat Enterprise Linux 8
    $ sudo subscription-manager repos --enable=service-interconnect-_<version>_-for-rhel-8-<architecture>-rpms
    Copy to Clipboard
    Red Hat Enterprise Linux 9
    $ sudo subscription-manager repos --enable=service-interconnect-_<version>_-for-rhel-9-<architecture>-rpms
    Copy to Clipboard
    1. 使用 yumdnf 命令安装 skupper 命令:

      $ sudo dnf install skupper-cli
      Copy to Clipboard
注意

您还可以安装 skupper-router,这只适用于 Linux 本地系统站点。

第 3 章 安装 Operator

Red Hat Service Interconnect Operator 在 OpenShift 中创建和管理站点。

注意

安装 Operator 需要集群的管理员特权。

3.1. 使用 CLI 为所有命名空间安装 Operator

本节中的步骤演示了如何使用 kubectl 命令在给定集群中安装和部署 Red Hat Service Interconnect Operator 的最新版本。通过为所有命名空间安装 Operator,您可以在任意命名空间中创建站点。

先决条件

  • 使用 cluster-admin 帐户访问集群。
  • 已安装 Operator Lifecycle Manager。

流程

  1. 您需要以集群管理员身份登录。
  2. 完成 Red Hat Container Registry Authentication 中所述的步骤。
  3. 使用以下内容创建一个名为 subscription-all.yaml 的文件:

    apiVersion: operators.coreos.com/v1alpha1
    kind: Subscription
    metadata:
      name: skupper-operator
      namespace: openshift-operators
    spec:
      channel: stable-2
      installPlanApproval: Automatic
      name: skupper-operator
      source: redhat-operators
      sourceNamespace: openshift-marketplace
      startingCSV: skupper-operator.v2.0.0-rh-11
    Copy to Clipboard
  4. 应用订阅 YAML:

    $ kubectl apply -f subscription-all.yaml
    Copy to Clipboard

其他信息

3.2. 使用 OpenShift 控制台安装 Operator

本节中的步骤演示了如何使用 OpenShift 控制台中的 OperatorHub 来在给定的 OpenShift 命名空间中安装和部署 Red Hat Service Interconnect Operator 的最新版本。

先决条件

  • 使用 cluster-admin 帐户访问 OpenShift 集群。如需支持的 OpenShift 版本,请参阅发行注记

流程

  1. 在 OpenShift Web 控制台中,进入到 OperatorsOperatorHub
  2. 从可用的 Operator 列表中选择 Red Hat Service Interconnect Operator,然后点 Install
  3. Operator 安装 页面中,有两个 安装模式 选项:

    • 集群中的所有命名空间
    • 集群中的特定命名空间

      在本例中,选择 A specific namespace on the cluster

  4. 选择一个 Update approval 选项。

    默认情况下,选择 Automatic 批准,站点将升级到最新版本的 Service Interconnect。如果您选择 Manual approval,则站点不会自动升级到 Service Interconnect 的最新版本。

  5. 选择您要在其中安装 Operator 的命名空间,然后点 Install

    Installed Operators 页会出现,并显示 Operator 安装的状态。

  6. 验证 Red Hat Service Interconnect Operator 是否已显示并等待 Status 变为 Succeeded
  7. 如果安装不成功,请排除错误:

    1. Installed Operators 页中点 Red Hat Service Interconnect Operator
    2. 选择 Subscription 标签页并查看所有失败或错误。

有关安装 Operator 的更多信息,请参阅 OpenShift 文档

其他信息

第 4 章 使用 YAML 安装 CRD 和控制器

作为 Red Hat Service Interconnect Operator 的替代选择,您可以使用 YAML 安装 CRD 和控制器。

先决条件

  • 对集群的 cluster-admin 访问权限。

流程

  1. 下载 YAML 文件,在 软件下载 时选择 2.0 的最新版本并下载 Skupper 部署(yaml)https://access.redhat.com/jbossnetwork/restricted/listSoftware.html?product=redhat.service.interconnect&downloadType=distributions
  2. 确定安装范围:

    • Cluster - 您可以在任何命名空间中创建站点(skupper-cluster-scope-2.0.0-rh.yaml)。
    • namespace - 您只能在部署了 YAML 的命名空间中创建站点(skupper-namespace-scope-2.0.0-rh.yaml)。
  3. 要安装 Red Hat Service Interconnect 集群 wide,请应用 YAML:

    $ kubectl apply -f skupper-cluster-scope-2.0.0-rh.yaml
    Copy to Clipboard
注意

此 YAML 在 skupper 命名空间中安装控制器和支持资源。

  1. 在特定命名空间中安装 Red Hat Service Interconnect:

    1. 创建命名空间,例如:

      $ kubectl create namespace west
      $ kubectl config set-context --current --namespace west
      Copy to Clipboard
    2. 应用命名空间范围 YAML:

      $ kubectl apply -f skupper-namespace-scope-2.0.0-rh.yaml
      Copy to Clipboard

第 5 章 安装 Network controller 来启用控制台

先决条件

  • 对集群的 cluster-admin 访问权限。

流程

  1. 下载 YAML 文件,在 软件下载 时选择 2.0 的最新版本并下载 Skupper 部署(yaml)https://access.redhat.com/jbossnetwork/restricted/listSoftware.html?product=redhat.service.interconnect&downloadType=distributions
  2. 创建一个站点,例如:

    $ skupper site create west
    Copy to Clipboard
  3. 应用 Network controller YAML:

    $ kubectl apply -f skupper-network-observer-openshift-2.0.0-rh.yaml
    Copy to Clipboard
  4. 导航到控制台。

    在 OpenShift 中:

    $ oc get routes
    Copy to Clipboard

    该路由前缀为 skupper-network-observer-<site-namespace >。您可以使用 OpenShift 凭据登录。

    在其他 Kubernetes 上,公开 skupper-network-observer 服务。skupper 用户会被创建,您可以使用以下内容获取密码:

    $ kubectl --namespace <site-namespace> \
          get secret skupper-network-observer-auth \
          -o jsonpath='{.data.htpasswd}' | base64 -d | sed 's/\(.*\):{PLAIN}\(.*\)/\1 \2\n/'
    Copy to Clipboard

第 6 章 升级 CLI 和站点

不支持升级版本 1 CLI 和站点。要迁移到版本 2,您必须重新创建站点、链接和服务。

第 7 章 使用您的订阅

Red Hat Service Interconnect 通过软件订阅提供。要管理您的订阅,请访问红帽客户门户中的帐户。

7.1. 访问您的帐户

流程

  1. 转至 access.redhat.com
  2. 如果您还没有帐户,请创建一个帐户。
  3. 登录到您的帐户。

7.2. 激活订阅

流程

  1. 转至 access.redhat.com
  2. 导航到 My Subscriptions
  3. 导航到 激活订阅 并输入您的 16 位激活号。

7.3. 为系统注册软件包

要在 Red Hat Enterprise Linux 上安装此产品的 RPM 软件包,必须注册您的系统。如果您使用下载的发行文件,则不需要这一步。

流程

  1. 转至 access.redhat.com
  2. 进入 Registration Assistant
  3. 选择您的操作系统版本,再继续到下一页。
  4. 使用您的系统终端中列出的命令完成注册。

有关注册您的系统的更多信息,请参阅以下资源之一:

附录 A. 关于 Service Interconnect 文档

使开源包含更多

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。我们从这四个术语开始:master、slave、黑名单和白名单。由于此项工作十分艰巨,这些更改将在即将推出的几个发行版本中逐步实施。详情请查看 CTO Chris Wright 的信息

更新于 2025-04-28

法律通告

Copyright © 2025 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat