Satellite (リセラー用)

ハイブリッドクラウドまたは分散型クラウドのリセラーとして、 Satellite のロケーションを設定し、ハイブリッドおよびマルチクラウド環境全体にわたって顧客向けに Red Hat OpenShift on IBM Cloud クラスターを展開することができます。

アカウントの概要

このモデルでは、エンタープライズ・アカウントを作成し、クライアントごとに別個のクライアント・アカウントを作成します。各クライアント・アカウント内で、Satellite ロケーションを作成し、Red Hat OpenShift on IBM Cloud クラスターをデプロイします。

の概念概要

クライアント・ロケーションとクラスターの管理

クライアント・ロケーションとクラスターを管理するためのベスト・プラクティスを確認します。

お客様の要件とユース・ケースを理解します。: お客様のロケーションとクラスターを作成する前に、お客様のユース・ケースの要件を収集します。お客様がロケーションで実行する必要があるワークロードのタイプと、ユース・ケースに沿ったコンピュート、ストレージ、およびその他の要件について説明します。
ロケーションで追加のホストを使用可能にし、未割り当てのままにします: スケールアップを高速化するには、追加のホストを使用できるようにし、ロケーション内のクラスターおよびサービスに割り当てる準備を整えることを計画します。

企業とお客様の責任について

企業とお客様の責任マトリックスを作成します。以下の例は、目的に合わせて調整できる責任マトリックスを示しています。

リセラーの責任マトリックスの例。
企業	クライアント・クラスター管理者	クライアント・クラスター・オペレーター	クライアント開発者
要件テンプレートを作成します。& クライアント要件を確認します。見積もりを準備します。クライアント・アカウント、ロケーション、クラスター、および API キーを作成します。	要件評価を実行します。要件テンプレートを完了します。見積もりを確認して承認します。環境セットアップを確認して確認します。クラスター・オペレーターと開発者の役割を割り当てます。	クラスター・オペレーターの権限を確認してください	クラスター開発者権限の確認

アカウントのセットアップ

Satellite を再販する前に、IBM Cloud エンタープライズ・アカウントとクライアント・アカウントをセットアップします。

エンタープライズ・アカウントの作成

組織のエンタープライズ・アカウントの作成。このアカウントは親アカウントとして機能します。エンタープライズ・アカウントを作成した後、顧客ごとにクライアント・アカウントのセットアップできます。

クライアント・アカウントのセットアップ

リソース・グループ、ロケーション、ロギングとモニタリングのインスタンス、および Satellite ロケーションを使用してクライアント・アカウントをセットアップするには、以下の手順を実行します。

このステップを自動化しますか? アカウントを作成した後、IBM Terraform プロバイダー・プラグインを使用して、IBM Cloud サービス・インスタンスをプロビジョンできます。

エンタープライズへのクライアント・アカウントの追加。
クライアントアカウントで、 IBM Cloud Logs インスタンスをプロビジョニングしてください。
クライアント・アカウントで、 IBM Cloud Object Storage インスタンスをプロビジョンします。

エンタープライズに追加するクライアントごとに、クライアント・アカウントを作成するためのステップを繰り返します。次に、以下のステップを続行して、ロケーションとクラスターをセットアップします。

クライアント・ロケーションのセットアップ

エンタープライズ・アカウントをセットアップし、少なくとも 1 つのクライアント・アカウントを作成した後、Satellite ロケーション要件を収集し、お客様のロケーションを作成します。

クライアント・ロケーションのサイズ設定と作成

クライアントの要件を収集し、ロケーション・サイズ、ホスト・フレーバー、およびストレージを決定します。また、コントロール・プレーン・ホストの数と、クラスターなどのサービスに必要なホストの数も決定します。ロケーション計画のヘルプについては、Satellite のロケーションについておよび Satellite の環境の計画を参照してください。
仮想マシンをプロビジョンするか、ロケーションで使用するオンプレミス・ホストを決定します。ホストが以下の要件を満たしていることを確認します。

始める前に

ロケーションとホストについて詳しくは、こちらを参照してください。
インフラストラクチャーを計画します。
ホストのセットアップを確認します。
ロケーションを作成できる適切な権限を持っていることを確認します。詳しくは、ユーザー許可の確認を参照してください。
Satellite は、Object Storage を使用して、ロケーションに関するデータおよびロケーションのクラスターのバックアップを保管します。ロケーションの作成時にバケットを自動的に作成するか、既存のバケットを指定するかを選択できます。既存のバケットを使用する場合は、クロスリージョン・レジリエンシーが必要です。

ロケーションを作成するには、 Satellite コンソールを開き、 「ロケーションの作成」 を選択します。

入門オプション

以下のオプションによって、インストール・プロセスが決まります。

インフラストラクチャーがオンプレミスまたはエッジにある場合は、 「オンプレミスとエッジ (On prem and Edge)」 オプションを選択します。このオプションを使用して、ロケーションを作成し、ゾーンを選択し、ホスト上で実行するホスト接続スクリプトをダウンロードします。

インフラストラクチャーがクラウド・プロバイダーであり、RHEL を実行するホストのみを使用する場合は、使用するクラウド・プロバイダーを選択し、資格情報を入力して、ロケーションを作成します。また、実行する前に、 Terraform テンプレートをダウンロードして編集することもできます。

インフラストラクチャーがクラウド・プロバイダーであり、RHCOS を実行しているホストを使用する場合、またはホスト作成をより詳細に制御する場合は、 「拡張構成」 を選択します。このオプションでは、ロケーションを作成し、ゾーンを選択し、クラウド・プロバイダー資格情報を含めて、ホストで実行するホスト接続スクリプト (RHEL) またはイグニッション・スクリプト (RHCOS) をダウンロードします。

「オンプレミスとエッジ (On prem and Edge)」 を選択した場合は、 「編集」 をクリックしてロケーション・オプションを変更できます。

Satellite のロケーション・オプション

以下のオプションでロケーションを定義します。

名前：「 Satellite 」の場所名は、アルファベットで始まる必要があり、アルファベット、数字、ピリオド (.)、ハイフン (-) を含めることができ、35文字以内である必要があります。同じ名前を複数のロケーションに繰り返し使用することはできず、同じ名前の別のロケーションを削除した場合でも同様です。

リソースグループ ：リソースグループを使用すると、アカウントのリソースをカスタマイズ可能なグループに整理できるため、ユーザーに対して一度に複数のリソースへのアクセス権を迅速に割り当てることができます。この値は、デフォルトでは default に設定されています。

実在住所: オンプレミスの場所の場合は、オンプレミスのリソースをSatellite位置。

説明およびタグ: 説明とタグは、 IBM Cloud リソースの編成に役立ちます。

管理元 ：そのロケーションの管理に使用する IBM Cloud リージョン。 IBM Cloud リージョンを選択する必要がある理由について詳しくは、IBM Cloud の Satellite リージョンについてを参照してください。 Satellite ロケーションと Satellite の間のネットワーク待ち時間を短くするために、IBM Cloud ロケーションに接続する予定のホスト・マシンが物理的に存在する場所に最も近いリージョンを選択してください。

ゾーン ：ゾーン名は、ホストを作成する予定のインフラストラクチャプロバイダー（クラウドプロバイダーのゾーンやオンプレミスのラックなど）における対応するゾーン名と完全に一致している必要があります。他のクラウド・プロバイダーのゾーンの名前を取得するには、インフラストラクチャー・プロバイダーにお問い合わせください。
- us-east-1a や us-east-1b などのアリババの地域およびゾーン。
- AWS 地域およびゾーン、例えば us-east-1a、 us-east-1b、 us-east-1c など。
- Azure topology.kubernetes.io/zone ラベル、例えば eastus-1、 eastus-2、 eastus-3 などです。場所名（eastus ）やゾーン番号（1 ）のみを使用しないでください。
- GCP 地域およびゾーン、例えば us-west1-a、 us-west1-b、 us-west1-c など。

Red Hat CoreOS サポート: Satellite は、 RHEL または RHCOS のいずれかを実行するホストをサポートします。詳しくは、オペレーティング・システムの計画を参照してください。

Object Storage: Satellite ロケーション・コントロール・プレーン・データをバックアップするために使用する既存の IBM Cloud Object Storage バケットの正確な名前。入力しない場合は、アカウント内の Object Storage インスタンスに新しいバケットが自動的に作成されます。 Object Storage のインスタンスやこのバケットを削除しないでください。サービス・インスタンスまたはバケットを削除すると、Satellite ロケーション・コントロール・プレーン・データをバックアップできません。

「作成」 をクリックした後、ホストを自分のロケーションに接続し、 Satellite ロケーション・コントロール・プレーンのセットアップを完了することができます。添付スクリプト内のトークンは API キーであり、機密情報として扱われ、保護される必要があることに注意してください。

ロケーションのホスト接続スクリプトは、作成日から 1 年後に期限切れになります。ご使用のロケーションのホストに認証の問題がないことを確認するには、ホスト接続スクリプトの新規コピーを少なくとも 1 年に 1 回ダウンロードし、未割り当てのホストを更新します。詳しくは、割り当てられていないホストの状況が Unresponsive になっているのはなぜですか? を参照してください。

自分のロケーションで Red Hat CoreOS が有効になっているかどうかを確認しますか? 自分のロケーションで Red Hat CoreOSが有効になっていますか?を参照してください。

ロケーションへのホストの接続

ロケーションを作成した後、ホストをロケーションに接続するの手順に従います。

コントロール・プレーンへのホストの割り当て

ホストをロケーションに接続した後、ホストをコントロール・プレーンに割り当てます。

一部のホストは、クラスターなどのサービスで使用するために、必ず未割り当てのままにしておいてください。

開始前に

Satellite コントロール・プレーンのロケーションに必要な数のホストを接続します。サイズ設定の要件について詳しくは、 Satellite のロケーションのサイズ設定を参照してください。クラウド・プロバイダー固有の構成については、クラウド・インフラストラクチャー・プロバイダーを参照してください。
ロケーションが**「アクションが必要」**状態であることを確認します。

ホストをワーカー・ノードとしてコントロール・プレーンに接続するには、以下のようにします。

Satellite の**「ロケーション」**ダッシュボードでコントロール・プレーンのセットアップを終了するロケーションを選択します。
「ホスト」 タブで、ワーカー・ノードとしてコントロール・プレーンに割り当てるホストを選択します。すべてのホストは、未割り当て状況でなければなりません。
各ホストのアクション・メニューの**「ホストの割り当て」**をクリックします。
クラスターとして**「コントロール・プレーン」**を選択します。
3 台のホストから成るグループをコントロール・プレーン・クラスターに均等に割り当てます。高可用性のために、ホストがインフラストラクチャー・プロバイダー内の物理的に分離されたゾーンに対応していることを確認してください。例えば、インフラストラクチャー・プロバイダーに us-east-1a、us-east-1b、および us-east-1c がある場合、これらの名前を Satellite ゾーンとして入力します。次に、インフラストラクチャー・プロバイダーの us-east-1a の 2 台のホストを Satellite コントロール・プレーンの us-east-1a に割り当て、以下同様に割り当てていきます。ホストをコントロール・プレーンに割り当てると、IBM はマシンをブートストラップします。このプロセスが完了するまでに数分かかることがあります。ブートストラッピング・プロセス中に、マシンの**「正常性」**が Ready から Provisioning に変わります。
**「ホスト」タブでホストが Satellite ロケーション・コントロール・プレーンに正常に割り当てられていることを確認します。割り当てが成功していると、IP アドレスがホストに追加され、「正常性」**状況が Normal に変わります。
ロケーションの状況が Normal に変わったことを確認します。ブートストラップ処理が完了するまで、そのロケーションには十分なホストがないことを示すメッセージが表示される場合があります。

ホストがコントロール・プレーンに正常に割り当てられた後、IBM モニターがご使用のロケーション用に適切にセットアップされるまで、20 分から 30 分かかります。また、ロケーションの DNS レコードが作成され、ご使用のホストの IP アドレスが自動的に登録されて DNS レコードに追加されると、ロケーションのロード・バランシングとヘルス・チェックが可能になります。このプロセスは、完了するまでに最長で 30 分かかることがあります。このプロセス中、ロケーション状況には引き続き**「アクションが必要」**状態が表示され、Satellite is attempting to recover や Verify that the Satellite location has a DNS record for load balancing requests to the location control plane などの偶発的なエラーが表示される場合があります。

すべてのホストの IP アドレスが登録され、ロケーションの DNS レコードに追加されたことを確認します。証明書の状況が created であり、レコードにサブドメインが取り込まれていることを確認します。

ibmcloud sat location dns ls --location LOCATION_ID_OR_NAME

出力例

Retrieving location subdomains...
OK
Hostname                                                                                              Records                                                                                               Health Monitor   SSL Cert Status   SSL Cert Secret Name                                          Secret Namespace   
ne1d37313068166254bcb-edfc0a8ba65085c5081eced6816c5b9c-c000.us-east.satellite.appdomain.cloud   169.62.196.20,169.62.196.23,169.62.196.30                                                             None             created           ne1d37313068166254bcb-edfc0a8ba65085c5081eced6816c5b9c-c000   default   
ne1d37313068166254bcb-edfc0a8ba65085c5081eced6816c5b9c-c001.us-east.satellite.appdomain.cloud   169.62.196.30                                                                                         None             created           ne1d37313068166254bcb-edfc0a8ba65085c5081eced6816c5b9c-c001   default   
ne1d37313068166254bcb-edfc0a8ba65085c5081eced6816c5b9c-c002.us-east.satellite.appdomain.cloud   169.62.196.20                                                                                         None             created           ne1d37313068166254bcb-edfc0a8ba65085c5081eced6816c5b9c-c002   default   
ne1d37313068166254bcb-edfc0a8ba65085c5081eced6816c5b9c-c003.us-east.satellite.appdomain.cloud   169.62.196.23                                                                                         None             created           ne1d37313068166254bcb-edfc0a8ba65085c5081eced6816c5b9c-c003   default   
ne1d37313068166254bcb-edfc0a8ba65085c5081eced6816c5b9c-ce00.us-east.satellite.appdomain.cloud   ne1d37313068166254bcb-edfc0a8ba65085c5081eced6816c5b9c-c000.us-east.satellite.appdomain.cloud        None             created           ne1d37313068166254bcb-edfc0a8ba65085c5081eced6816c5b9c-ce00   default

実動ワークロードにこのロケーションを引き続き使用するには、これらのステップを繰り返して、3 の倍数 (6、9、12 など) の数の追加のホストをロケーション・コントロール・プレーンに接続します。詳しくは、Satellite ロケーション・コントロール・プレーンへの容量の追加を参照してください。

クラスター、API キー、およびクラスター役割の作成

ロケーションとコントロール・プレーンをセットアップした後、クラスターと API キーを作成します。

Satellite クラスターの作成

Red Hat OpenShift クラスター・コンソールから、 「作成」 をクリックします。
**「インフラストラクチャー」セクションで、「Satellite」**を選択します。
「 OCPの権利 」セクションでは、 Red Hat® アカウントプルシークレットをファイルまたは生のJSON形式で指定し、このクラスターのワーカーノードに対して既存のOCP利用権を指定してください。このプル・シークレットは、クラスターが Red Hat OpenShift アカウントから Red Hat イメージをダウンロードするときにも使用されます。
「ロケーション」セクションで、クラスターを作成する Satellite ロケーションを選択します。選択したロケーションが正常状態であることを確認します。
**「オペレーティング・システム」**セクションで、クラスターのデフォルト・ワーカー・プールで使用するホストのオペレーティング・システムを選択します。 Red Hat CoreOS 対応のロケーションでは、RHCOS ホストまたは RHEL ホストのいずれかを使用できます。 RHCOS が有効なロケーションでは、ワーカー・プールをクラスターに追加するときに、RHCOS ホストまたは RHEL ホストを使用できます。ワーカー・プールに割り当てる前に、使用するオペレーティング・システムにホストを接続していることを確認してください。
**「ワーカー・プール」**セクションで、デフォルトのワーカー・プールの詳細を構成します。
1. 複数のゾーン (基盤インフラストラクチャー・プロバイダーのゾーンに相当) にホストを均等に割り当てるために Satellite で使用する Satellite ゾーンを選択します。一般には、高可用性を確保するために、3 つのゾーンにまたがるワーカー・プールを作成します。
2. ワーカー・プールを作成する vCPU、メモリー (GB)、および ゾーンごとのワーカー・ノード数 を要求します。Satellite は、要求を満たすために、使用可能なホストをワーカー・プールに自動的に割り当てることができます。一般には、1 ゾーンあたりのワーカー・ノード数として少なくとも 1 を選択します (クラスターの合計ワーカー・ノード数 3 に相当)。
**「Satellite Config」**セクションで、Satellite Config のクラスター管理者アクセス権限を有効にするかどうかを決定します。 Satellite Config アクセス権限を付与しない場合は、後で Satellite Config 機能を使用してクラスターの Kubernetes リソースを表示またはデプロイすることはできません。後でアクセス権限を有効にする場合は、Satellite Config のカスタム RBAC 役割の作成を行うことができます。
**「リソース詳細」**で、クラスター名と、クラウド・リソースに関連付ける IBM Cloud タグを入力します。クラスター名は先頭が文字でなければならず、文字、数字、およびハイフン (-) を使用できます。35 文字以内でなければなりません。
「作成」 をクリックします。クラスターを作成すると、クラスターのマスターが Satellite ロケーション・コントロール・プレーンに自動的に作成されます。また、指定したワーカー・ノード要求に合わせて、空きホストがワーカー・プールに自動的に割り当てられます。
クラスターが**「正常 (Normal)」**状態になるまで待ちます。

Satellite ロケーションに使用可能な一致するホストがない場合でも、クラスターは作成されますが、警告状態になります。ホストを Satellite ロケーションに接続します。これにより、ワーカー・プールにワーカー・ノードとしてホストを割り当てることができます。ホストが自動的に割り当てられなかった場合に、手動で Satellite ホストをクラスターに割り当てることもできます。デフォルトのワーカー・プールの各ゾーンに、ホストがワーカー・ノードとして割り当てられるようにしてください。
Red Hat OpenShift クラスター・コンソールから、クラスターが 「正常」 状態になっていることを確認します。
クラスターにアクセスして Red Hat OpenShift Web コンソールにアクセスするか、CLI から oc コマンドおよび kubectl コマンドを実行します。 Satellite Config のアクセス権限を有効にした場合は、この手順を実行して許可を同期する必要があります。

ロケーションのホストにプライベート・ネットワーク接続しかない場合や、Amazon Web Services、Google Cloud Platform、または Microsoft Azure のホストを使用する場合は、VPN アクセスなどを使用してホストのプライベート・ネットワークに接続してから、クラスターに接続して Red Hat OpenShift Web コンソールにアクセスする必要があります。あるいは、ホストにパブリック・ネットワーク接続がある場合は、ホストのパブリック IP アドレスを使用するようにクラスターとロケーションの DNS レコードを変更することで、クラスターへのアクセスをテストできます。
オプション: 内部コンテナー・イメージ・レジストリーをセットアップします。詳しくは、Red Hat OpenShift on IBM Cloud 資料の内部コンテナー・イメージ・レジストリーのセットアップを参照してください。
Satellite 構成のセットアップ。

API キーの作成

クライアント・アカウントで使用できる API を作成しますの手順に従います。

クラスター管理者および開発者の役割のセットアップ

手順に従って、クライアントが必要とするクラスター役割をセットアップします。