ジュニパーBNG CUPSのインストール

このセクションの手順を使用して、ジュニパーBNG CUPSコントローラを単一の地理的なセットアップに初めてインストールします。

1. ジュニパーネットワークス のソフトウェアダウンロードページからジュニパーBNG CUPSソフトウェアパッケージをダウンロードし、ジャンプホストに保存します。

   BNG CUPSコントローラは、圧縮TARファイルイメージ(.tgz)として利用できます。ファイル名には、名前の一部としてリリース番号が含まれています。リリース番号の形式は次のとおりです。m.nZb.s

   例えば、ソフトウェアリリース番号23.4R1.5は、以下の形式にマッピングされます。

   • m は、製品のメインリリース番号(例:23)です。

   • n は、製品のマイナーリリース番号(例:4)です。

   • Z は、ソフトウェアリリースのタイプです(たとえば、FRSやメンテナンスリリースのR)。

   • b は、製品のビルド番号です(たとえば、1はメンテナンスリリースではなく、FRSリリースを示します)。

   • s は、製品のスピン番号です(例:5)。

2. ジャンプホスト上のBNG CUPSコントローラTARファイル(.tgz)ファイルを次のように入力して解凍します。
3. TARファイルを解凍した後、ローダースクリプトを実行します。
4. sudo -E dbng link --context context-name --version software-releaseコマンドを使用してクラスターにリンクします。linkコマンドは、セットアップの準備として、ロードされたBNG CUPSコントローラソフトウェアパッケージをクラスターに関連付けます。

   • context context-name—クラスターのKubernetesコンテキスト名。

   • version software-release— dbng_loader 出力から表示されるBNG CUPSコントローラソフトウェアバージョン。

5. Red Hat OpenShift Container PlatformクラスターにBNG CUPSコントローラをインストールする場合は、管理者権限を持つユーザーとしてOpenShift CLIを使用してログインし、次のステップに進みます。
   BNG CUPSコントローラをRancher Kubernetes Engine2またはBBE Cloudsetupが作成したクラスターにインストールする場合は、次のステップに進みます。
6. BNG CUPSコントローラのコンテナイメージをプッシュできるようにするには、コンテナレジストリで認証する必要があります。レジストリへの認証方法は、BNG CUPSコントローラをインストールするのは、Rancher Kubernetes Engine2で作成したクラスター、BBE Cloudsetupで作成したクラスター、またはRed Hat OpenShift Container Platformクラスターのどちらにインストールするのかによって異なります(詳細については、それぞれのドキュメントを参照してください)。

   セキュアなレジストリ(Rancher Kubernetes Engine2またはBBE Cloudsetupで作成されたクラスターで作成)を使用している場合は、システムユーザー(Rancher Kubernetes Engine2またはBBE Cloudsetup構成ファイルで指定されたシステムユーザー)としてクラスターのレジストリトランスポートアドレス(Rancher Kubernetes Engine2またはBBE Cloudsetup構成ファイルのシステムアドレスとして提供されたFQDN)に対してDockerログインを発行することで、レジストリで認証します。

7. setupを実行してインストールを設定します。setupコマンドは、以下を実行します。

   • Kubernetes導入の運用パラメーターを確立します。

     セットアップコマンドで bbecloudsetup オプションまたは template file-name オプションを使用しなかった場合は、セットアップ中に以下のプロンプトを完了する必要があります。

     • Rancher Kubernetes Engine2 または BBE Cloudsetup を使用してクラスターを作成している場合は、次の手順に従います。

       • 外部レジストリアドレス。

       • 外部レジストリポート番号。

     • Red Hat OpenShift Container Platform クラスターを使用している場合:

       • 外部レジストリ(完全修飾ドメイン名)

       • 内部 (Docker) レジストリ アドレス

       • 内部 (Docker) レジストリ ポート番号

   注:

   context context-name は、 setup コマンドにのみ必須オプションです。

   setupコマンドで使用できるオプションを以下に示します。

   • context context-name—クラスターのKubernetesコンテキスト名。

   • h, help—ヘルプメッセージと終了を表示します。

   • l, log [error, warning, info, debug]—ログレベルを調整します。

   • no-color—メッセージを色なしで印刷します。

   • bbecloudsetup—bbecloudsetupが作成したクラスターに一致する運用パラメーターを入力するため、セットアッププロセス中にBNG CUPSコントローラーを操作する必要はありません(クラスターのインストール手順については、 『BBE Cloudsetupインストールガイド 』を参照してください)。

     注:

     bbecloudsetupオプションまたはtemplate file-nameオプションのいずれかのみを使用してください。両方のオプションを使用しないでください。

   • update- 設定中にのみ欠損値を入力するよう求められます。

   • ssh host:port—クラスター(クラスターのノードのいずれか)のホスト名またはIPアドレスと、CLIへのSSHアクセスに使用されるオープンポート。

   • secrets—BNG CUPSコントローラが使用するキー、証明書、およびシークレットを更新します。

   • verbose—プロンプトが提示された各質問の前に詳細な説明を提供します。

   • configfile-name—起動時にBNG CUPSコントローラで使用したい初期設定ファイルの名前。

   • template file-name—セットアップ中に作成される設定ファイルのサブセットを含むYAML形式のファイル。テンプレート ファイルに入力された値は、設定プロセスで自動的に使用されます。 template オプションを使用する場合、設定プロセス中にテンプレートファイルに含まれる情報を手動で入力する必要はありません。 template オプションは、Red Hat OpenShift Container Platform を使用してクラスターを作成する場合、または複数の地理的なクラスターを作成する場合にのみ使用してください。 表3 は、 template 設定ファイルに入力する必要がある情報を示しています。

     注:

     bbecloudsetupオプションまたはtemplate file-nameオプションのいずれかのみを使用してください。両方のオプションを使用しないでください。

   • mandatory—セットアップ中に必要な質問のみします。

   • optional—セットアップ中に不要な質問のみします。

   表3:設定ファイルのフィールドの説明

   フィールド	説明
   外部レジストリアドレス	外部レジストリアドレスは、コンテナイメージがプッシュされるFQDNです。
   APMi TLSシークレット名	アドレスプールマネージャー(APM)のトランスポート層セキュリティ(TLS)シークレット名
   APMi証明書	APM の証明書。
   APMiプライベートキー	APMのプライベートキー。
   APMiルート証明書	APM のルート証明書。
   DTLSシークレット名	データグラム トランスポート レベル セキュリティ (DTLS) シークレット名。
   DTLS証明書	DTLS証明書。
   DTLSプライベートキー	DTLSプライベートキー。
   DTLSルート証明書	DTLSルート証明書。
   k8sのレジストリ	コンテナイメージが取得されるトランスポートアドレスまたは FQDN:port 。
   ロールアウト時にマウントするスタートアップ構成	初期設定に使用する設定ファイル。設定ファイルが提供されていない場合は、工場出荷時のデフォルト設定が使用されます。
   (オプション) CPiコンフィグストレージ名	設定されたCPiストレージクラスの名前。
   (オプション) CPiコンフィグストレージサイズ	設定されたCPiストレージクラスのサイズ(メビバイト(MiB)単位)。
   (オプション) CPi コア ストレージ名	CPiコアストレージクラスの名前。
   (オプション) CPiコアストレージサイズ	CPi コア ストレージ クラスのサイズ(メビバイト(MiB)単位)。
   (オプション) キャッシュコアストレージ名	Scacheコアストレージクラスの名前。
   (オプション) キャッシュコアストレージサイズ	Scacheコアストレージクラスのサイズ(メビバイト(MiB)単位)。

8. dbng-versionコマンドを実行して、BNG CUPSコントローラのインストールを確認します。

   • context context-name—クラスターのKubernetesコンテキスト名。

   • detail—使用可能なすべてのソフトウェアバージョンを表示します。

この手順を使用して、BNG CUPSコントローラを単一の地理的な設定で設定および起動します。

1. rolloutを入力して、BNG CUPSコントローラのインストールを開始します。BNG CUPSコントローラユーティリティでは、BNG CUPSコントローラの一部であるすべてのマイクロサービスに対して異なるソフトウェアバージョンを展開できます。root として sudo で rollout コマンドを使用する必要があります。また、rollout コマンドは、新しいリリースに必要なすべての値が存在することを検証し、新しいリリースのコンテナー・イメージをレジストリーに読み込みます。sudo -E dbng rollout --context context-name --version software-release --service service-name を使用して、BNG CUPSコントローラサービスを起動します。次に例を示します。

   • context context-name—クラスターのKubernetesコンテキスト。

   • service service-name—ロールアウトするマイクロサービス名(例: scache 、 cpi)。

   • version software-release—ロールアウトするソフトウェアリリース(デフォルトはクラスターにリンクするリリース)。

   注:

   では、最初のロールアウト -–service は必要ありません。 -–service は、特定のサービスの特定のバージョンをロールアウト(アップグレード)するために –-version とともに使用されます。

   注:

   デフォルトでは、BNG CUPSコントローラは工場出荷時のデフォルトから起動します。設定が初期状態にリセットされます。永続的な状態と永続的なログはすべてクリアされます。

2. dbng status --context context-name --detailを入力して、BNG CUPSコントローラサービスが稼働していることを確認します。次に例を示します。
   注:

   以下のいずれかに該当する場合は、サービスのログを収集し、ジュニパーネットワークス技術支援センター(JTAC)に連絡します。

   • サービスが実行されていません。

   • 他のサービスと比較したサービスのアップタイムは、サービスが再起動したことを示しています。

3. BNG CUPSコントローラにコントロールプレーンインスタンス(CPi)を追加する必要があります。 CPi add コマンドを実行します。

   • context context-name—クラスターのKubernetesコンテキスト名。

   • version software-release—新しいCPiポッドのソフトウェアリリース。リリースを入力します。

   • cpi-label—ラベルは、識別のためにCPiに一意の名前を付けるために使用されます。上記の出力例では、 cpi-label は cpi-example-1です。

4. dbng statusコマンドを使用して、CPi マイクロサービスが実行中であることを確認します。

   • context context-name—クラスターのKubernetesコンテキスト名。

   • detail—詳細情報を表示します。

地理的に異なる場所にある複数のBNG CUPSコントローラで構成されるBNG CUPSコントローラのセットアップには、このセクションのインストール手順を使用します。

1. ジュニパーネットワークス のソフトウェアダウンロードページからジュニパーBNG CUPSソフトウェアパッケージをダウンロードし、ジャンプホストに保存します。

   BNG CUPSコントローラは、圧縮TARファイルイメージ(.tgz)として利用できます。ファイル名には、名前の一部としてリリース番号が含まれています。リリース番号の形式は次のとおりです。m.nZb.s

   例えば、ソフトウェアリリース番号23.4R1.5は、以下の形式にマッピングされます。

   • m は、製品のメインリリース番号(例:23)です。

   • n は、製品のマイナーリリース番号(例:4)です。

   • Z は、ソフトウェアリリースのタイプです(たとえば、FRSやメンテナンスリリースのR)。

   • b は、製品のビルド番号です(たとえば、1はメンテナンスリリースではなく、FRSリリースを示します)。

   • s は、製品のスピン番号です(例:5)。

2. ジャンプホストでBNG CUPSコントローラTAR(.tgz)ファイルを次のように入力して解凍します。
3. TARファイルを解凍した後、ローダースクリプトを実行します。
4. sudo -E dbng linkコマンドを使用してクラスターにリンクします。setupを実行する準備として、linkコマンドはワークロードクラスターコンテキストのリストを取得し、読み込まれたBNG CUPSコントローラソフトウェアパッケージに関連付けます。

   • context multi-cluster-context-name—複数の地理設定のコンテキスト名。 multi-cluster-context-name は、 link コマンドに適用されるユーザー定義の文字列で、2つのワークロードクラスターの共通の参照として機能します。

   • worload-contexts workload-1-context-name workload-2-context-name—2 つのワークロード コンテキスト名。

   • version software-release— dbng_loader 出力から表示されるBNG CUPSコントローラソフトウェアバージョン。

   図1:複数の地域における複数のクラスター
5. RHOCP クラスターを使用する場合、OpenShift CLIを使用して OpenShift クラスター と 3 つの RHOCP クラスター (管理クラスターと 2 つの ワークロード クラスター) を認証した後、RHOCP を操作できます。

   実行するコマンドの例については、以下を参照してください。

6. BNG CUPSコントローラコンテナイメージをプッシュするには、複数のクラスター設定で各クラスターのレジストリで認証する必要があります。 システムユーザー (BBE Cloudsetup設定ファイルに入力された システムユーザー )としてクラスターのレジストリトランスポートアドレス(BBE Cloudsetup設定ファイルでシステムアドレスとして提供されたFQDN)に対してdockerログインを発行することで、レジストリで認証します。
7. setupを実行してインストールを設定します。setupコマンドは、以下を実行します。

   • クラスター環境に関する情報を収集します。収集される情報は以下の通りです。

     • サービスアカウント—マイクロサービスに必要な権限を有効にするKubernetesサービスアカウントの名前。

     • コンテナー イメージ レジストリのプッシュとプル トランスポート アドレス。

     • ストレージクラス(Kubernetes PVC作成用)。

   • BNG CUPSコントローラの導入をカスタマイズする方法に関する情報を収集します。収集される情報は以下の通りです。

     • APMインターフェイス(APMi)のTLSキーと証明書。

     • SCi および CPRi インターフェイス用の DTLS 鍵と証明書。

     • 内部マイクロサービス通信用のSSHシークレット。

     • PVCサイズ(設定やその他の永続データを保存するため)。

     • 優先BNGDクラスター—BNGDマイクロサービスが最初にアクティブにする必要があるクラスター(ワークロードコンテキスト)の名前。

   • BNG CUPSコントローラの設定を初期化します。

   セットアッププロセス中に、情報を入力するよう求められます。設定プロセス中に情報を入力しないようにするには、テンプレート ファイルを使用できます(テンプレート ファイルの説明については、 templateを参照してください)。

   テンプレート ファイルを使用しなかった場合、セットアップ プロセス中に次のプロンプトが表示されることがあります。

   • 管理クラスターの以下の情報:

     • 各クラスターの外部レジストリアドレスとポート番号。各クラスターの情報を入力した後、 Enter キーをクリックします。

     • プル元の管理クラスターのレジストリアドレス。

     • Karmada kubeconfig シークレット名

     • TLSを有効にする(デフォルトはFalse)

     • TLSシークレット名

   • プライマリワークロード(workload-1)クラスターの以下の情報です。情報を入力した後、 Enter キーをクリックしてバックアップワークロードクラスターの情報を入力します。

     • 各クラスターの外部レジストリアドレスとポート番号。各クラスターの情報を入力した後、 Enter キーをクリックします。

   • バックアップ(workload-2)ワークロードクラスターの以下の情報:

     • 各クラスターの外部レジストリアドレスとポート番号。各クラスターの情報を入力した後、 Enter キーをクリックします。

   • バックアップワークロードクラスター—バックアップワークロードクラスターの名前を入力します

   • バックアップ ワークロード レジストリ アドレス

   • プライマリワークロードクラスター—プライマリワークロードクラスターの名前を入力します

   • APMi TLSシークレット名

     注:TLSキーと証明書を含むjnpr-bng-controller名前空間内のKubernetesシークレットオブジェクトの名前。シークレットが存在しない場合、このフィールドを空白のままにすると、証明書、秘密キー、ルート証明書を含むファイルの入力を求めsetupプンプトが表示されます。その後、Kubernetesシークレットが作成されます。シークレットが指定されている場合、証明書、秘密キー、またはルート証明書ファイルの入力を求めsetupません。

   • APMi証明書

   • APMiプライベートキー

   • APMiルート証明書

   • DTLSシークレット名

     注:TLSキーと証明書を含むjnpr-bng-controller名前空間内のKubernetesシークレットオブジェクトの名前。シークレットが存在しない場合、このフィールドを空のままにすると、証明書、プライベートキー、ルート証明書を含むファイルの入力を求めsetupプロンプトが表示されます。その後、Kubernetesシークレットが作成されます。シークレットが指定されている場合、証明書、秘密キー、またはルート証明書ファイルの入力を求めsetupません。

   • DTLS証明書

   • DTLSプライベートキー

   • DTLSルート証明書

   • k8sのレジストリ

   • ロールアウト時にマウントするスタートアップ構成

   • CPi Configストレージクラス名とサイズ

   • CPi Coreストレージクラスの名前とサイズ

   • Scache Core ストレージ名

   • Scacheコアストレージサイズ

   注:

   複数地域の導入でSSH経由のCLIアクセスを設定するには、テンプレートファイルを使用する必要があります(setupコマンドのtemplateオプションを使用)。これにより、2つのワークロードクラスターアドレスを設定できます。

   SSH を設定するには、各ワークロード クラスターの次の情報 (YAML 形式) を、セットアップ プロセス中に提供するテンプレート ファイルに追加します。

   テンプレートファイルのSSH設定の詳細については、以下を参照してください。

   • cluster-vip-address—ジャンプホストからクラスターを管理するために使用するIPアドレス。

   • cluster-name— kubectl get clusters コマンドの出力に表示されるワークロードクラスターの名前。

   • available-port-value—ワークロードクラスターのどのノードでも使用されていないTCPポートである必要があります。例えば、ポート22は使用せず、ポート8200のような大きな番号のポートを使用します。

   • service-name—作成したサービスで使用する名前。ベスト プラクティスは、名前にアプリケーション名、目的、およびワークロード クラスターを含めることです (例: dbng-ssh-workload1)。

   • type—SSHアクセス用に作成する外部サービスのタイプを決定します。使用可能なオプションは、 NodePort または LoadBalancerです。

   setupコマンドで使用できるオプションを以下に示します。

   • context multi-cluster-context-name—複数の地理設定のコンテキスト名。 multi-cluster-context-name は、 link コマンドに適用されるユーザー定義の文字列で、2つのワークロードクラスターの共通参照として機能します。

   • h, help—ヘルプメッセージと終了を表示します。

   • l, log [error, warning, info, debug]—ログレベルを調整します。

   • no-color—メッセージを色なしで印刷します。

   • update- 設定中にのみ欠損値を入力するよう求められます。

   • secrets—BNG CUPSコントローラが使用するキー、証明書、およびシークレットを更新します。

   • verbose—プロンプトが提示された各質問の前に詳細な説明を提供します。

   • configfile-name—起動時にBNG CUPSコントローラで使用する初期設定ファイルの名前。

   • template file-name—セットアップ中に作成される設定ファイルのサブセットを含むYAML形式のファイル。テンプレート ファイルに入力された値は、設定プロセスで自動的に使用されます。 template オプションを使用する場合、設定プロセス中にテンプレートファイルに含まれる情報を手動で入力する必要はありません。 template オプションは、Red Hat OpenShift Container Platform を使用してクラスターを作成する場合、または複数の地理的なクラスターを作成する場合にのみ使用してください。 表3は 、 template 設定ファイルに入力する必要がある情報を示しています。

   • mandatory—セットアップ中に必要な質問のみします。

   • optional—セットアップ中に不要な質問のみします。

8. dbng-versionコマンドを実行して、BNG CUPSコントローラのインストールを確認します。

   • context multi-cluster-context-name—複数の地理設定のコンテキスト名。 multi-cluster-context-name は、 link コマンドに適用されるユーザー定義の文字列で、2つのワークロードクラスターの共通の参照として機能します。

   • detail—使用可能なすべてのソフトウェアバージョンを表示します。

この手順を使用して、複数の地域設定でBNG CUPSコントローラを設定し、起動します。

1. rolloutを入力して、BNG CUPSコントローラのインストールを開始します。BNG CUPSコントローラユーティリティを使用すると、BNG CUPSコントローラの複数地域設定の一部であるすべてのマイクロサービスに対して異なるソフトウェアバージョンを展開できます。root として sudo で rollout コマンドを使用する必要があります。また、rollout コマンドは、新しいリリースに必要なすべての値が存在することを検証し、新しいリリースのコンテナー・イメージをレジストリーに読み込みます。sudo -E dbng rollout --context multi-cluster-context-name --version software-release --service service-name を使用して、BNG CUPSコントローラサービスを起動します。次に例を示します。

   • context multi-cluster-context-name—複数の地理設定のコンテキスト名。 multi-cluster-context-name は、 link コマンドに適用されるユーザー定義の文字列で、2つのワークロードクラスターの共通参照として機能します。

   • service service-name—ロールアウトするマイクロサービス名(例: scache 、 cpi)。

   • version software-release—ロールアウトするソフトウェアリリース(デフォルトはクラスターにリンクするリリース)。

   注:

   では、最初のロールアウト -–service は必須ではありません。 -–service は、特定のサービスの特定のバージョンをロールアウト(アップグレード)するために –-version とともに使用されます。

   注:

   デフォルトでは、BNG CUPSコントローラは工場出荷時のデフォルトから起動します。設定が初期状態にリセットされます。永続的な状態と永続的なログはすべてクリアされます。

2. dbng status --context multi-cluster-context-nameを入力して、BNG CUPSコントローラサービスが稼働していることを確認します。次に例を示します。
   注:詳細な出力には、dbng status --context multi-cluster-context-name --detailコマンドを使用できます。

   • context multi-cluster-context-name—複数の地理設定のコンテキスト名。 multi-cluster-context-name は、 link コマンドに適用されるユーザー定義の文字列で、2つのワークロードクラスターの共通参照として機能します。

   • detail—詳細情報を表示します。

   注:

   以下のいずれかに該当する場合は、サービスのログを収集し、ジュニパーネットワークス技術支援センター(JTAC)に連絡します。

   • サービスが実行されていません。

   • 他のサービスと比較したサービスのアップタイムは、サービスが再起動したことを示しています。

3. BNG CUPSコントローラにコントロールプレーンインスタンス(CPi)を追加する必要があります。 CPi add コマンドを実行します。

   • context multi-cluster-context-name—複数の地理設定のコンテキスト名。 multi-cluster-context-name は、 link コマンドに適用されるユーザー定義の文字列で、2つのワークロードクラスターの共通の参照として機能します。

   • version software-release—新しいCPiポッドのソフトウェアリリース。リリースを入力します。

   • ip-aaa ip-address—CPi AAAアクション用に展開するIPアドレス。 ip-aaa オプションを使用して、CPiのRADIUSリスナーポートに使用する単一の外部IPアドレスを指定します。このアドレスは、複数の地理スイッチオーバー間で同じままです。 ip-aaa オプションには、L3対応のMetalLBインスタンスが必要です。MetalLB BGPピアリングは、アクティブなワークロードクラスター上のCPiにトラフィックを送信するために使用されます。

   • label—新しいCPiの名前を指定します。

4. dbng statusコマンドを使用して、CPi マイクロサービスが実行されていることを確認します。