Satellite ロケーション・コントロール・プレーンのセットアップ

ロケーション・コントロール・プレーンは、ロケーションに接続するホスト、クラスター、およびその他のリソースの管理を支援するために、Satellite によって管理されるリソースを実行します。

Satellite ロケーション・コントロール・プレーンをセットアップする際には、以下のホストの考慮事項に留意してください。

コンピュートホストは、6、9、12など、3の倍数で接続してください。
正しいロケーションのサイズを判別してください。
ご使用のコントロール・プレーンが、ネットワークの冗長性、物理ロケーション間の分散などのために推奨される高可用性構成を満たしていることを確認します。
ホストが待ち時間の要件を満たしていることを確認します。

コンソールでのコントロール・プレーンのセットアップ

Satellite コンソールを使用して、ロケーションのコントロール・プレーンをセットアップします。

開始前に

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 ロケーション・コントロール・プレーンへの容量の追加を参照してください。

CLI でのコントロール・プレーンのセットアップ

Satellite コマンド・ラインを使用して、ロケーションのコントロール・プレーンをセットアップします。

開始前に

Satellite コントロール・プレーンのワーカー・ノードとして使用する少なくとも 6 台のホスト (またはデモンストレーション目的の場合のみ 3 台のホスト) を自分のロケーションに接続します。クラウド・プロバイダー固有の構成については、クラウド・インフラストラクチャー・プロバイダーを参照してください。
ロケーションが**「アクションが必要」**状態であることを確認します。

コントロール・プレーンを作成するには、以下のようにします。

Satellite コントロール・プレーンのワーカー・ノードとして使用するホストを特定します。すべてのホストは、unassigned 状態でなければなりません。

ibmcloud sat host ls --location LOCATION_NAME_OR_ID

出力例

Name             ID                     State        Status   Cluster   Worker ID   Worker IP   
machine-name-1   aaaaa1a11aaaaaa111aa   unassigned   -        -         -           -   
machine-name-2   bbbbbbb22bb2bbb222b2   unassigned   -        -         -           -   
machine-name-3   ccccc3c33ccccc3333cc   unassigned   -        -         -           -

オプション: ホスト・ラベルを使用してコントロール・プレーンにホストを割り当てる場合は、ホストの詳細を取得します。使用可能なラベルは、CLI 出力の Labels セクションにリストされます。

ibmcloud sat host get --location LOCATION_NAME_OR_ID --host HOST_ID

出力例

Retrieving host details...
Name:     mymachine1   
ID:       brjrgp920bg4u254brr0   
State:    unassigned  
Status:   -   
Labels      
cpu      4   
memory   32774980  
use      satloc
Assignment        
Cluster:       -  
Worker Pool:   -  
Zone:          -  
Worker ID:     -
Worker IP:     -   
Date:          -   
OK

ホスト・マシンを Satellite ロケーション・コントロール・プレーンに割り当てます。お客様がホストをコントロール・プレーンに割り当てると、IBM がお客様のマシンをブートストラップします。このプロセスは、完了するまで数分かかります。ホスト ID を使用してホストを割り当てることも、ホストをロケーションに割り当てるために必要なラベルを定義することもできます。

ホスト ID を使用したホストの割り当ての例。
```
ibmcloud sat host assign --location LOCATION_NAME_OR_ID  --cluster LOCATION_ID --host HOST_ID  --zone ZONE
```
use:satloc ラベルを使用したホストの割り当ての例。
```
ibmcloud sat host assign --location LOCATION_NAME_OR_ID --cluster LOCATION_ID --host-label "use:satloc" --zone ZONE
```
--location <location_name_or_ID>

Satellite ロケーションの名前または ID を入力します。ロケーションの名前または ID を確認するには、ibmcloud sat location ls を実行します。

--cluster <location_ID>

Satellite ロケーション・コントロール・プレーンを実行するホストを割り当てる Satellite ロケーションの ID を入力します。ロケーション ID を表示するには、ibmcloud sat location ls を実行します。

--host <host_ID>

Satellite ロケーション・コントロール・プレーンに割り当てるホスト ID を入力します。ホスト ID を表示するには、ibmcloud sat host ls --location <location_name> を実行します。 --host-label オプションを使用すると、コントロール・プレーンに割り当てるホストを特定できます。

--host-label <label>

割り当てるホストを識別するために使用するラベルを入力します。ラベルはキーと値のペアで、ホスト・マシンに存在している必要があります。 label オプションを指定してこのコマンドを実行すると、ラベルと一致し、unassigned 状態の最初のホストがコントロール・プレーンに割り当てられます。

--zone <zone>

ホストを割り当てるゾーンを入力します。これは、インフラストラクチャー・プロバイダー内の物理的に別個のゾーンに対応します。自分のロケーションのゾーン名を確認するには、ibmcloud sat location get --location <location_name_or_ID> を実行して、ホスト・ゾーン フィールドを確認します。
前のステップを繰り返して、Satellite ロケーション・コントロール・プレーンに他のホストを接続します。高可用性のために、ホストがインフラストラクチャー・プロバイダー内の物理的に分離されたゾーンに均等に割り当てられていることを確認してください。例えば、インフラストラクチャー・プロバイダーに us-east-1a、us-east-1b、および us-east-1c がある場合、これらの名前を Satellite ゾーンとして入力できます。次に、インフラストラクチャー・プロバイダーの us-east-1a の 2 台のホストを Satellite コントロール・プレーンの us-east-1a に割り当て、us-east-1b の 2 台のホスト、us-east-1c の 2 台のホストと併せて合計 6 台のホストをこのコントロール・プレーンに割り当てます。

ホストがロケーションに正常に割り当てられていることを確認します。すべてのホストが assigned 状態および Ready 状況になり、IP アドレスがホストに割り当てられている場合、割り当てが成功しています。マシンの Status に - が表示されている場合は、ブートストラッピング・プロセスがまだ完了しておらず、ヘルス状況を取得できません。数分待ってから、再試行してください。

ibmcloud sat host ls --location <location_name>

出力例

Retrieving hosts...
OK
Name              ID                     State      Status   Cluster          Worker ID                                                 Worker IP   
machine-name-1    aaaaa1a11aaaaaa111aa   assigned   Ready    infrastructure   sat-virtualser-4d7fa07cd3446b1f9d8131420f7011e60d372ca2   169.xx.xxx.xxx   
machine-name-2    bbbbbbb22bb2bbb222b2   assigned   Ready    infrastructure   sat-virtualser-9826f0927254b12b4018a95327bd0b45d0513f59   169.xx.xxx.xxx   
machine-name-3    ccccc3c33ccccc3333cc   assigned   Ready    infrastructure   sat-virtualser-948b454ea091bd9aeb8f0542c2e8c19b82c5bf7a   169.xx.xxx.xxx

ロケーションの状況が 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 などの偶発的なエラーが表示される場合があります。
```
ibmcloud sat location ls
```
出力例
```
OK
Name         ID                     Status      Ready   Created      Hosts (used/total)   Managed From   
mylocation   brhtfum2015a6mgqj16g   normal      yes     4 days ago   3 / 3                Washington DC   
```

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 ロケーション・コントロール・プレーンへの容量の追加を参照してください。

Satellite ロケーションを作成しました。次は何ですか?

Satellite ロケーションがセットアップされたので、IBM Cloud サービスの使用を開始する準備ができました。

Satellite 対応 IBM Cloud サービスを実行できるように、ロケーションへの追加ホストの接続によってコンピュート容量をロケーションに追加します。
Red Hat OpenShift クラスターなどの Satellite 対応 IBM Cloud サービスを作成します。事前に接続した追加のホストをワーカー・ノードとして割り当てて、クラスターにコンピュート能力を提供します。既存の Red Hat OpenShift クラスターを自分のロケーションに登録するをデプロイメント・ターゲットとして使用することもできます。
Satellite の構成を使用してアプリケーションを管理します。
Satellite クラスター・ストレージ・テンプレートを作成します。
Satellite Link コンポーネントについて学習し、ロケーションと IBM Cloud の間のネットワーク・トラフィックを管理するエンドポイントの使用方法を理解します。

お困りですか? 「サポートの利用方法」をご覧ください。ここでは、 IBM Cloud プラットフォームに関するクラウドのステータス、問題、ログに関する情報、サポートへの連絡方法、およびメール通知設定についてご確認いただけます。