インストール
CLI、コントローラー、または Operator のインストール
概要
第1章 Skupper CLI のインストール リンクのコピーリンクがクリップボードにコピーされました!
Skupper CLI は、Kubernetes サイトと Podman サイトの両方を作成する方法を提供します。
リリースノート で説明されているように、Podman サイトはテクノロジープレビュー機能です。
前提条件
- サブスクリプションがアクティベートされ、システムが登録されている。カスタマーポータルを使用して Red Hat サブスクリプションをアクティブ化し、システムを登録する方法は、6章サブスクリプションの使用 を参照してください。
手順
subscription-managerコマンドを使用して、必要なパッケージリポジトリーをサブスクライブします。メインリリースストリームの場合は<version>を1に、長期サポートリリースストリームの場合は1.4に置き換えます。- Red Hat Enterprise Linux 8
sudo subscription-manager repos --enable=service-interconnect-_<version>_-for-rhel-8-x86_64-rpms
$ sudo subscription-manager repos --enable=service-interconnect-_<version>_-for-rhel-8-x86_64-rpmsCopy to Clipboard Copied! Toggle word wrap Toggle overflow - Red Hat Enterprise Linux 9
sudo subscription-manager repos --enable=service-interconnect-_<version>_-for-rhel-9-x86_64-rpms
$ sudo subscription-manager repos --enable=service-interconnect-_<version>_-for-rhel-9-x86_64-rpmsCopy to Clipboard Copied! Toggle word wrap Toggle overflow yumコマンドまたはdnfコマンドを使用して、skupperコマンドをインストールします。sudo dnf install skupper-cli
$ sudo dnf install skupper-cliCopy to Clipboard Copied! Toggle word wrap Toggle overflow skupperを実行して RHEL 8 上に Podman サイトを作成する場合、netavarkをまだ設定していないのであれば、Podman を使用するように設定する必要があります。netavarkが Podman ネットワークバックエンドとして設定されているかどうかを確認します。podman info | grep networkBackend
$ podman info | grep networkBackendCopy to Clipboard Copied! Toggle word wrap Toggle overflow netavarkがバックエンドとしてリストされていない場合は、それをインストールします。sudo dnf install netavark
$ sudo dnf install netavarkCopy to Clipboard Copied! Toggle word wrap Toggle overflow /etc/containers/containers.confファイルに次の行が存在することを確認して、netavarkを使用するように Podman を設定します。[network] network_backend = "netavark"
[network] network_backend = "netavark"Copy to Clipboard Copied! Toggle word wrap Toggle overflow - ステップ a を繰り返して、新しい設定を確認します。
関連情報
- サイトの作成手順は、スタートガイド を参照してください。
-
Podman の設定に関する詳細情報を確認するには、
mancontainers.confを使用してください。
第2章 Operator のインストール リンクのコピーリンクがクリップボードにコピーされました!
Red Hat Service Interconnect Operator は、OpenShift でサイトを作成および管理します。
Red Hat Service Interconnect Operator は、OpenShift 4 でのみサポートされます。Operator をインストールするには、クラスターの管理者レベルの権限が必要です。
2.1. CLI を使用したすべての namespace に対する Operator のインストール リンクのコピーリンクがクリップボードにコピーされました!
このセクションの手順では、oc コマンドを使用して、指定の OpenShift クラスターに最新バージョンの Red Hat Service Interconnect Operator をインストールし、デプロイする方法を説明します。すべての namespace に Operator をインストールすると、任意の namespace にサイトを作成できます。oc コマンドの詳細は、OpenShift CLI のスタートガイド を参照してください。
前提条件
-
cluster-adminアカウントを使用した OpenShift クラスターへのアクセス。サポートされている OpenShift のバージョンは、リリースノート を参照してください。
手順
クラスター管理者として OpenShift にログインします。以下に例を示します。
oc login -u system:admin
$ oc login -u system:adminCopy to Clipboard Copied! Toggle word wrap Toggle overflow - Red Hat Container Registry Authentication で説明されている手順を実行します。
以下の内容で、
subscription-all.yamlという名前のファイルを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記startingCSVを指定しない場合、サブスクリプションはデフォルトで最新の Operator のバージョンになります。installPlanApprovalをManualに指定した場合、サイトが Service Interconnect の最新バージョンに自動的にアップグレードされません。サイトを手動でアップグレードする方法については、4章Red Hat Service Interconnect Operator とサイトのアップグレード を参照してください。サブスクリプション YAML を適用します。
oc apply -f subscription-all.yaml
$ oc apply -f subscription-all.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow
関連情報
- サイトの作成手順は、スタートガイド を参照してください。
2.2. CLI を使用した単一の namespace 用の Operator のインストール リンクのコピーリンクがクリップボードにコピーされました!
このセクションの手順では、oc コマンドを使用して、指定の OpenShift クラスターに最新バージョンの Red Hat Service Interconnect Operator をインストールし、デプロイする方法を説明します。単一の namespace 用の Operator をインストールすると、指定した namespace にサイトを作成できます。oc コマンドの詳細は、OpenShift CLI のスタートガイド を参照してください。
前提条件
-
cluster-adminアカウントを使用した OpenShift クラスターへのアクセス。サポートされている OpenShift のバージョンは、リリースノート を参照してください。
手順
クラスター管理者として OpenShift にログインします。以下に例を示します。
oc login -u system:admin
$ oc login -u system:adminCopy to Clipboard Copied! Toggle word wrap Toggle overflow - Red Hat Container Registry Authentication で説明されている手順を実行します。
サイトを作成する namespace に Operator グループを作成します。
以下を実行して
operator-group.yamlという名前のファイルを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow my-namespaceは、サイトを作成する namespace の名前です。Operator グループ YAML を適用します。
oc apply -f operator-group.yaml
$ oc apply -f operator-group.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow
以下の内容で、
subscription-myns.yamlという名前のファイルを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow my-namespaceは、サイトを作成する namespace の名前です。注記startingCSVを指定しない場合、サブスクリプションはデフォルトで最新の Operator のバージョンになります。installPlanApprovalをManualに指定した場合、サイトが Service Interconnect の最新バージョンに自動的にアップグレードされません。サイトを手動でアップグレードする方法については、4章Red Hat Service Interconnect Operator とサイトのアップグレード を参照してください。サブスクリプション YAML を適用します。
oc apply -f subscription-myns.yaml
$ oc apply -f subscription-myns.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow
関連情報
- サイトの作成手順は、スタートガイド を参照してください。
2.3. OpenShift コンソールを使用した Operator のインストール リンクのコピーリンクがクリップボードにコピーされました!
このセクションの手順では、OpenShift コンソールから OperatorHub を使用して、指定の OpenShift namespace に最新バージョンの Red Hat Service Interconnect Operator をインストールし、デプロイする方法を説明します。
前提条件
-
cluster-adminアカウントを使用した OpenShift クラスターへのアクセス。サポートされている OpenShift のバージョンは、リリースノート を参照してください。
手順
- OpenShift Web コンソールで、 → に移動します。
-
利用可能な Operator の一覧から
Red Hat Service Interconnect Operatorを選択し、 をクリックします。 Operator Installation ページでは、2 つの Installation mode オプションを使用できます。
- All namespaces on the cluster
A specific namespace on the cluster
この例では、A specific namespace on the cluster を選択します。
Update approval オプションを選択します。
デフォルトでは、Automatic (自動) 承認が選択されており、サイトは Service Interconnect の最新バージョンにアップグレードされます。Manual (手動) 承認を選択した場合、サイトは Service Interconnect の最新バージョンに自動的にアップグレードされません。サイトを手動でアップグレードする方法については、4章Red Hat Service Interconnect Operator とサイトのアップグレード を参照してください。
Operator をインストールする namespace を選択し、 をクリックします。
Installed Operators ページが表示され、Operator インストールのステータスが表示されます。
- Red Hat Service Interconnect Operator が表示されていることを確認し、Status が Succeeded に変更されるまで待機します。
インストールに成功しない場合は、エラーのトラブルシューティングを行います。
-
Installed Operators ページで
Red Hat Service Interconnect Operatorをクリックします。 - Subscription タブを選択し、エラーを表示します。
-
Installed Operators ページで
Operator のインストールに関する詳細は、OpenShift のドキュメント を参照してください。
関連情報
- サイトの作成手順は、スタートガイド を参照してください。
第3章 Skupper CLI とサイトのアップグレード リンクのコピーリンクがクリップボードにコピーされました!
サイトをアップグレードするには、Skupper CLI の最新バージョンが必要です。
すべてのサイトを更新して、同じバージョンの Service Interconnect がサービスネットワーク全体で実行されるようにします。更新プロセス中に、わずかなダウンタイムが発生することが予想されます。
手順
skupperCLI をアップグレードするには、以下を実行します。dnf upgrade skupper-cli
$ dnf upgrade skupper-cliCopy to Clipboard Copied! Toggle word wrap Toggle overflow 各サイトをアップグレードします。
- アップグレードするサイトにコンテキストを設定します。
アップグレードのコマンドを実行します。
skupper update
$ skupper updateCopy to Clipboard Copied! Toggle word wrap Toggle overflow
第4章 Red Hat Service Interconnect Operator とサイトのアップグレード リンクのコピーリンクがクリップボードにコピーされました!
Red Hat Service Interconnect Operator のインストール時に自動更新を選択した場合、Service Interconnect の新しいバージョンが利用可能になったときにサイトがアップグレードされます。手動更新を選択した場合は、この手順を完了してサイトをアップグレードします。
手順
- OpenShift コンソールにログインします。
- Installed Operators ページに移動します。
- Red Hat Service Interconnect Operator の Status に Upgrade available と表示されている場合は、そのテキストをクリックします。
- InstallPlan details ページで、Preview InstallPlan をクリックします。
- Approve をクリックしてサイトをアップグレードします。
第5章 ポリシーシステムのインストール リンクのコピーリンクがクリップボードにコピーされました!
Skupper ポリシーシステムをクラスターにインストールすると、クラスター上での Skupper の使用方法を制御できるようになります。
特定のポリシールールを指定せずにクラスターにポリシーシステムを適用すると、サイトのリンクとサービスの公開が禁止されます。既存のサイトが存在するクラスターにポリシーシステムをインストールする場合は、中断を避けるために、ポリシーシステムをインストールする前に、ポリシーを作成する必要があります。
前提条件
-
cluster-admin権限で Kubernetes クラスターへアクセスできる。 - Red Hat Service Interconnect Operator がインストールされている。
手順
- クラスターにログインします。
ポリシー CRD をデプロイします。
kubectl apply -f skupper_cluster_policy_crd.yaml customresourcedefinition.apiextensions.k8s.io/skupperclusterpolicies.skupper.io created clusterrole.rbac.authorization.k8s.io/skupper-service-controller created
$ kubectl apply -f skupper_cluster_policy_crd.yaml customresourcedefinition.apiextensions.k8s.io/skupperclusterpolicies.skupper.io created clusterrole.rbac.authorization.k8s.io/skupper-service-controller createdCopy to Clipboard Copied! Toggle word wrap Toggle overflow skupper_cluster_policy_crd.yamlの内容は、付録A Skupper ポリシー CRD の YAML で指定されています。
関連情報
ポリシーの使用に関する詳細は、Securing a service network using policies を参照してください。
第6章 サブスクリプションの使用 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat Service Interconnect は、ソフトウェアサブスクリプションを通じて提供されます。サブスクリプションを管理するには、Red Hat カスタマーポータルでアカウントにアクセスします。
6.1. アカウントへのアクセス リンクのコピーリンクがクリップボードにコピーされました!
手順
- access.redhat.com に移動します。
- アカウントがない場合は作成します。
- アカウントにログインします。
6.2. サブスクリプションのアクティベート リンクのコピーリンクがクリップボードにコピーされました!
手順
- access.redhat.com に移動します。
- My Subscriptions に移動します。
- Activate a subscription に移動し、16 桁のアクティベーション番号を入力します。
6.3. パッケージ用システムの登録 リンクのコピーリンクがクリップボードにコピーされました!
この製品の RPM パッケージを Red Hat Enterprise Linux にインストールするには、システムが登録されている必要があります。ダウンロードしたリリースファイルを使用している場合、この手順は必要ありません。
手順
- access.redhat.com に移動します。
- Registration Assistant に移動します。
- ご使用の OS バージョンを選択し、次のページに進みます。
- システムの端末にリスト表示されたコマンドを使用して、登録を完了します。
システムを登録する方法は、以下のリソースを参照してください。
付録A Skupper ポリシー CRD の YAML リンクのコピーリンクがクリップボードにコピーされました!
ポリシーシステムにより、クラスター管理者はクラスター上での Skupper の使用を制限できます。通常の Skupper の使用には必要ありません。
次の YAML は、Skupper ポリシー CRD をクラスターに適用します。
付録B Service Interconnect のドキュメントについて リンクのコピーリンクがクリップボードにコピーされました!
多様性を受け入れるオープンソースの強化
Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。まずは、マスター (master)、スレーブ (slave)、ブラックリスト (blacklist)、ホワイトリスト (whitelist) の 4 つの用語の置き換えから始めます。この取り組みは膨大な作業を要するため、今後の複数のリリースで段階的に用語の置き換えを実施して参ります。詳細は、Red Hat CTO である Chris Wright のメッセージ をご覧ください。
改訂日時: 2024-10-07