安装
安装控制器和 CLI
第 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 节 “使用红帽软件包”。
流程
下载适用于您的系统架构的二进制文件。
选择最新的版本 for 2.0 at Software Downloads。
对于 Apple silicon 的 Mac,使用 Rosetta 2 和 Skupper CLI for Mac on x86-64 下载。
- 解压下载的文件,并将 Skupper 可执行文件放在 PATH 中。
验证安装:
skupper version
$ skupper version client version 2.0.0
Copy to Clipboard Copied!
2.2. 使用红帽软件包
在 Linux 上安装红帽软件包可确保您收到 Skupper CLI 的最新更新。
先决条件
- 确定您的订阅已激活,且您的系统已经注册。有关使用客户门户网站激活红帽订阅并为软件包注册您的系统的详情,请参考 第 7 章 使用您的订阅。
流程
使用
subscription-manager
命令订阅所需的软件包存储库。将<version
> 替换为主发行版本流的2
。- Red Hat Enterprise Linux 8
sudo subscription-manager repos --enable=service-interconnect-_<version>_-for-rhel-8-<architecture>-rpms
$ sudo subscription-manager repos --enable=service-interconnect-_<version>_-for-rhel-8-<architecture>-rpms
Copy to Clipboard Copied! - Red Hat Enterprise Linux 9
sudo subscription-manager repos --enable=service-interconnect-_<version>_-for-rhel-9-<architecture>-rpms
$ sudo subscription-manager repos --enable=service-interconnect-_<version>_-for-rhel-9-<architecture>-rpms
Copy to Clipboard Copied! 使用
yum
或dnf
命令安装skupper
命令:sudo dnf install skupper-cli
$ sudo dnf install skupper-cli
Copy to Clipboard Copied!
您还可以安装 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。
流程
- 您需要以集群管理员身份登录。
- 完成 Red Hat Container Registry Authentication 中所述的步骤。
使用以下内容创建一个名为
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
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 Copied! 应用订阅 YAML:
kubectl apply -f subscription-all.yaml
$ kubectl apply -f subscription-all.yaml
Copy to Clipboard Copied!
其他信息
- 有关使用 YAML 创建站点的说明,请参阅使用 Skupper。
3.2. 使用 OpenShift 控制台安装 Operator
本节中的步骤演示了如何使用 OpenShift 控制台中的 OperatorHub 来在给定的 OpenShift 命名空间中安装和部署 Red Hat Service Interconnect Operator 的最新版本。
先决条件
-
使用
cluster-admin
帐户访问 OpenShift 集群。如需支持的 OpenShift 版本,请参阅发行注记。
流程
- 在 OpenShift Web 控制台中,进入到 → 。
-
从可用的 Operator 列表中选择
Red Hat Service Interconnect Operator
,然后点 。 在 Operator 安装 页面中,有两个 安装模式 选项:
- 集群中的所有命名空间
集群中的特定命名空间
在本例中,选择 A specific namespace on the cluster。
选择一个 Update approval 选项。
默认情况下,选择 Automatic 批准,站点将升级到最新版本的 Service Interconnect。如果您选择 Manual approval,则站点不会自动升级到 Service Interconnect 的最新版本。
选择您要在其中安装 Operator 的命名空间,然后点
。Installed Operators 页会出现,并显示 Operator 安装的状态。
- 验证 Red Hat Service Interconnect Operator 是否已显示并等待 Status 变为 Succeeded。
如果安装不成功,请排除错误:
-
在 Installed Operators 页中点
Red Hat Service Interconnect Operator
。 - 选择 Subscription 标签页并查看所有失败或错误。
-
在 Installed Operators 页中点
有关安装 Operator 的更多信息,请参阅 OpenShift 文档
其他信息
- 有关使用 YAML 创建站点的说明,请参阅使用 Skupper。
第 4 章 使用 YAML 安装 CRD 和控制器
作为 Red Hat Service Interconnect Operator 的替代选择,您可以使用 YAML 安装 CRD 和控制器。
先决条件
-
对集群的
cluster-admin
访问权限。
流程
- 下载 YAML 文件,在 软件下载 时选择 2.0 的最新版本并下载 Skupper 部署(yaml)。https://access.redhat.com/jbossnetwork/restricted/listSoftware.html?product=redhat.service.interconnect&downloadType=distributions
确定安装范围:
-
Cluster - 您可以在任何命名空间中创建站点(
skupper-cluster-scope-2.0.0-rh.yaml
)。 -
namespace - 您只能在部署了 YAML 的命名空间中创建站点(
skupper-namespace-scope-2.0.0-rh.yaml
)。
-
Cluster - 您可以在任何命名空间中创建站点(
要安装 Red Hat Service Interconnect 集群 wide,请应用 YAML:
kubectl apply -f skupper-cluster-scope-2.0.0-rh.yaml
$ kubectl apply -f skupper-cluster-scope-2.0.0-rh.yaml
Copy to Clipboard Copied!
此 YAML 在 skupper
命名空间中安装控制器和支持资源。
在特定命名空间中安装 Red Hat Service Interconnect:
创建命名空间,例如:
kubectl create namespace west kubectl config set-context --current --namespace west
$ kubectl create namespace west $ kubectl config set-context --current --namespace west
Copy to Clipboard Copied! 应用命名空间范围 YAML:
kubectl apply -f skupper-namespace-scope-2.0.0-rh.yaml
$ kubectl apply -f skupper-namespace-scope-2.0.0-rh.yaml
Copy to Clipboard Copied!
第 5 章 安装 Network controller 来启用控制台
先决条件
-
对集群的
cluster-admin
访问权限。
流程
- 下载 YAML 文件,在 软件下载 时选择 2.0 的最新版本并下载 Skupper 部署(yaml)。https://access.redhat.com/jbossnetwork/restricted/listSoftware.html?product=redhat.service.interconnect&downloadType=distributions
创建一个站点,例如:
skupper site create west
$ skupper site create west
Copy to Clipboard Copied! 应用 Network controller YAML:
kubectl apply -f skupper-network-observer-openshift-2.0.0-rh.yaml
$ kubectl apply -f skupper-network-observer-openshift-2.0.0-rh.yaml
Copy to Clipboard Copied! 导航到控制台。
在 OpenShift 中:
oc get routes
$ oc get routes
Copy to Clipboard Copied! 该路由前缀为
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/'
$ 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 Copied!
第 6 章 升级 CLI 和站点
不支持升级版本 1 CLI 和站点。要迁移到版本 2,您必须重新创建站点、链接和服务。
第 7 章 使用您的订阅
Red Hat Service Interconnect 通过软件订阅提供。要管理您的订阅,请访问红帽客户门户中的帐户。
7.1. 访问您的帐户
流程
- 转至 access.redhat.com。
- 如果您还没有帐户,请创建一个帐户。
- 登录到您的帐户。
7.2. 激活订阅
流程
- 转至 access.redhat.com。
- 导航到 My Subscriptions。
- 导航到 激活订阅 并输入您的 16 位激活号。
7.3. 为系统注册软件包
要在 Red Hat Enterprise Linux 上安装此产品的 RPM 软件包,必须注册您的系统。如果您使用下载的发行文件,则不需要这一步。
流程
- 转至 access.redhat.com。
- 进入 Registration Assistant。
- 选择您的操作系统版本,再继续到下一页。
- 使用您的系统终端中列出的命令完成注册。
有关注册您的系统的更多信息,请参阅以下资源之一:
附录 A. 关于 Service Interconnect 文档
使开源包含更多
红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。我们从这四个术语开始:master、slave、黑名单和白名单。由于此项工作十分艰巨,这些更改将在即将推出的几个发行版本中逐步实施。详情请查看 CTO Chris Wright 的信息。
更新于 2025-04-28