Ubuntuへのマルチノードクラスタのインストール

このガイドでは、このディレクトリを pa-download-dir と呼びます。

Paragon Automationのセットアップインストールバンドルは、各コンポーネントモジュールをインストールするための以下のスクリプトとTARファイルで構成されています。

• davinci.tar.gz は、プライマリ インストーラー ファイルです。

• infra.tar: Docker や Helm などの Kubernetes インフラストラクチャ コンポーネントがインストールされます。

• ems.tar: 基本プラットフォーム コンポーネントをインストールします。

• northstar.tar: Paragon PathfinderとParagon Plannerのコンポーネントがインストールされます。

• healthbot.tar: Paragon Insightsコンポーネントがインストールされます。

• paragon_ui.tar: Paragon Automation UIコンポーネントがインストールされます。

• addons.tar: Kubernetes の基本インストールに含まれていないインフラストラクチャ コンポーネントをインストールします。インフラストラクチャコンポーネントには、IAM、Kafka、ZooKeeper、cert-manager、Ambassador、Postgres、Metrics、Kubernetesダッシュボード、Open Distro for Elasticsearch、Fluentd、Reloader、ArangoDB、Argoが含まれます。

• helm-charts.tarには、インストールに必要なすべてのヘルムチャートが含まれています。

• rke2-packages.tgz: RKE2ベースのKubernetesコンポーネントをインストールします。
• 3rdparty.tar.gz: 必要なサードパーティユーティリティをインストールします。

• rhel-84-airgap.tar.gz、ベースOSがRed Hat Enterprise Linux(RHEL)のノード にのみ 、エアギャップ方式を使用してParagon Automationをインストールします。RHELベースOSにエアギャップ方式を使用してParagon Automationをインストールしない場合は、このファイルを削除することができます。

• run インストーラー イメージを実行するスクリプト。

ソフトウェアのダウンロードが完了したので、Paragon Automationをインストールする準備が整いました。

config-dir は、特定のインストールの構成情報を含む制御ホスト上のユーザー定義ディレクトリーです。 init コマンドは、ディレクトリーが存在しない場合に自動的に作成します。または、 init コマンドを実行する前にディレクトリを作成することもできます。

runコマンドには必ずドットとスラッシュ(./)を含めてください。

同じ制御ホストを使用してParagon Automationの複数のインストールを管理する場合、異なる名前の設定ディレクトリを使用することで、インストールを区別できます。

SSH クライアント認証の構成で生成した秘密キーをユーザー定義の config-dir ディレクトリにコピーします。インストーラーにより、Docker コンテナーは config-dir ディレクトリにアクセスできます。SSH キーは、制御ホストがクラスタノードに接続するためのディレクトリで使用可能である必要があります。

コピー コマンド (cp) の末尾にドット (.) を入れてください。

1. invコマンドを使用してインベントリ ファイルをカスタマイズします。

   次の表に、 inv コマンドで入力を求める構成オプションを示します。

   表 1: invコマンド オプション

   inv コマンド プロンプトの説明
   Kubernetesマスターノード	Kubernetes プライマリノードの IP アドレスを入力します。
   Kubernetesワーカーノード	KubernetesワーカーノードのIPアドレスを入力します。
   ローカルストレージノード	アプリケーションに使用可能なディスク・スペースがあるノードを定義します。ローカル・ストレージ・ノードには、プライマリ・ノードとワーカー・ノードのIPアドレスがあらかじめ入力されています。これらのアドレスは編集できます。ローカル・ストレージを必要とするアプリケーションを実行するノードの IP アドレスを入力します。 Postgres、ZooKeeper、Kafka などのサービスは、 エクスポート/ローカル ボリューム内にパーティション分割されたローカル ストレージまたはディスク領域を使用します。デフォルトでは、ワーカー・ノードにはローカル・ストレージがあります。ここで 1 次ノードを追加しない場合は、1 次ノードにローカル・ストレージを必要としないアプリケーションのみを実行できます。 手記： ローカルストレージはCephストレージとは異なります。
   Kubernetesノードのユーザー名(rootなど)	ユーザー アカウントと認証方法を構成して、クラスター ノードでインストーラーを認証します。ユーザーアカウントはrootである必要があります。また、root以外のユーザーの場合は、スーパーユーザー(sudo)権限が必要です。
   SSHプライベートキーファイル(オプション)	ssh-key認証を選択した場合は、インストールプロセス中に制御ホストがノードで認証するために、ansible_ssh_private_key_fileが配置されているディレクトリ(config-dir)とid_rsaファイルを「{{ config-dir }}/id_rsa」として設定します。
   Kubernetesノードのパスワード(オプション)	インストール・プロセス中に、制御ホストがノードで認証するためにパスワード認証を選択した場合は、認証パスワードを直接入力します。警告: パスワードはプレーンテキストで記述されています。 このオプションを認証に使用することはお勧め しません 。
   Kubernetes クラスター名 (オプション)	Kubernetes クラスターの名前を入力します。
   インベントリファイルを書き込みますか?	[ Yes ] をクリックして、インベントリ情報を保存します。

   例えば：

2. または、テキストエディタを使用してインベントリファイルを手動でカスタマイズすることもできます。

   インベントリ ファイルで次のグループを編集します。

   1. クラスターの Kubernetes プライマリ ノードとワーカー ノードの IP アドレスを追加します。

      masterグループはプライマリノードを識別し、nodeグループはワーカーノードを識別します。master グループと node グループの両方で同じ IP アドレスを持つことはできません。

      マルチプライマリノード設定を作成するには、 master グループの下にプライマリとして機能するすべてのノードのアドレスまたはホスト名をリストします。ワーカーとして機能するノードのアドレスまたはホスト名を node グループの下に追加します。

   2. local_storage_nodes:children・グループの下のアプリケーションに使用可能なディスク・スペースがあるノードを定義します。

   3. ユーザー アカウントと認証方法を構成して、 vars グループの下のクラスター ノードを使用して Ansible コントロール ホスト内のインストーラーを認証します。

   4. (オプション) kubernetes_cluster_name グループに Kubernetes クラスターの名前を指定します。

confコマンドを使用すると、インタラクティブなインストールウィザードが実行され、インストールするコンポーネントを選択し、Paragon Automationの基本設定を行うことができます。このコマンドは、config.yml ファイルに入力設定を入力します。詳細設定を行うには、config.yml ファイルを手動で編集する必要があります。

ウィザードの指示に従って情報を入力します。カーソル キーを使用してカーソルを移動し、スペース キーを使用してオプションを選択し、 a キーまたは i キーを使用してすべてのオプションの選択と選択の切り替えを行います。Enter キーを押して、次の構成オプションに進みます。ピリオド(.)を入力すると、設定オプションをスキップできます。ウィザードを終了し、最初からやり直すことで、すべての選択肢を再入力できます。インストーラーを使用すると、既に行った選択を保存した後にウィザードを終了したり、最初からやり直すことができます。現在のワークフローで既に行った選択を、ウィザードを終了して再起動しない限り、戻ってやり直すことはできません。

次の表に、 conf コマンドで入力を求める設定オプションを示します。

[edit groups northstar]
root@system# show protocols bgp group northstar
type internal;
family traffic-engineering {
    unicast;
}
export TE;
allow 10.xx.43.0/24;

[edit groups northstar]
root@system# show policy-options policy-statement TE
from family traffic-engineering;
then accept;

[edit protocols bgp group BGP-LS]
root@vmx101# show | display set 
set protocols bgp group BGP-LS family traffic-engineering unicast
set protocols bgp group BGP-LS peer-as 11
set protocols bgp group BGP-LS allow 10.x.43.1
set protocols bgp group BGP-LS allow 10.x.43.2
set protocols bgp group BGP-LS allow 10.x.43.3
set protocols bgp group BGP-LS export TE

[edit protocols bgp group BGP-LS]
root@vmx101# show | display set
set protocols bgp group BGP-LS family traffic-engineering unicast
set protocols bgp group BGP-LS peer-as 11
set protocols bgp group BGP-LS neighbor 10.xx.43.1
set protocols bgp group BGP-LS neighbor 10.xx.43.2
set protocols bgp group BGP-LS neighbor 10.xx.43.3
set protocols bgp group BGP-LS passive
set protocols bgp group BGP-LS export TE

set protocols rsvp interface interface.unit

set protocols isis interface interface.unit
set protocols isis traffic-engineering igp-topology
Or
set protocols ospf area area interface interface.unit
set protocols ospf traffic-engineering igp-topology

set protocols mpls interface interface.unit
set protocols mpls traffic-engineering database import igp-topology

config.yml ファイルは、インストール・ウィザードから入力を求める構成オプションに対応する、ファイルの先頭にある必須セクションで構成されています。このファイルには、重要なセクションの下に、複雑な構成値をファイルに直接入力できるセクションの広範なリストもあります。

次のオプションを構成できます。

• (オプション) grafana_admin_password パスワードを設定して、Grafana アプリケーションにログインします。Grafana は、ログを含むさまざまなソースからのデータを視覚化および分析するために一般的に使用される視覚化ツールです。

  デフォルトでは、ユーザー名は # grafana_admin_user: admin で admin として事前に設定されています。Grafana にログインするために設定したユーザー名とパスワードとして admin を使用します。

  grafana_admin_password パスワードを設定しない場合、インストーラはランダムなパスワードを生成します。次のコマンドを使用してパスワードを取得できます。

  # kubectl get secret -n kube-system grafana -o jsonpath={..grafana-password} | base64 -d

• ID およびアクセス管理 (IAM) による SMTP を使用しないユーザー管理の場合は、 iam_skip_mail_verification 構成オプションを true に設定します。既定では、SMTP を使用したユーザー管理では、このオプションは false に設定されています。Paragon AutomationでSMTPを設定して、アカウントが作成、アクティブ化、またはロックされたとき、またはアカウントのパスワードが変更されたときにParagon Automationユーザーに通知できるようにする必要があります。

• イングレス コントローラーの仮想 IP(VIP)アドレスとは異なる IP アドレスで callback_vip オプションを設定します。VIP アドレスの MetalLB プールの IP アドレスを使用することができます。この IP アドレスを設定して、管理トラフィックとデータ トラフィックをサウスバウンドとノースバウンドのインターフェイスから分離できるようにします。デフォルトでは、 callback_vip にはイングレスコントローラのアドレスと同じまたはいずれかのアドレスが割り当てられます。

編集が終了したら、ファイルを保存して終了します。

デフォルトでは、アンバサダーは Kubernetes クラスター内部 CA によって署名されたローカルで生成された証明書を使用します。

構成済みのクラスターをインストールするためのインストール時間は、クラスターの複雑さによって異なります。基本的なセットアップのインストールは、完了するまでに少なくとも 45 分かかります。

インストーラは、インストールの開始時に NTP 同期をチェックします。クロックが同期していない場合、インストールは失敗します。

マルチプライマリ ノード展開の場合のみ、インストーラーは個々のサーバー CPU とメモリ、およびクラスターごとに使用可能な CPU とメモリの合計をチェックします。次の要件が満たされていない場合、インストールは失敗します。

• クラスターあたりの最小 CPU: 20 CPU

• クラスターあたりの最小メモリ: 32 GB

• ノードあたりの最小 CPU: 4 CPU

• ノードあたりの最小メモリ: 6 GB

CPU とメモリのチェックを無効にするには、次のコマンドを使用してデプロイを再実行します。

# ./run -c config-dir deploy -e ignore_iops_check=yes

テキストエディタを使用して、 限界.conf および sysctl.conf ファイルでParagon Insightsに関する以下の推奨情報を設定します。これらの値は、流入 DB メモリ要件のソフト メモリとハード メモリの制限を設定します。これらの制限を設定しないと、既定のシステム制限が原因で "メモリ不足" や "開いているファイルが多すぎます" などのエラーが表示される場合があります。

すべてのワーカー・ノードに対してこの手順を繰り返します。