Ubuntuにマルチノードクラスターをインストールする

このガイドでは、このディレクトリをpa-download-dirとして参照します。

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

• プライマリインストーラーファイルである davinci.tar.gz。

• DockerやHelmなどのKubernetesインフラストラクチャコンポーネントをインストールする infra.tar。

• ベースプラットフォームコンポーネントをインストールする 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 Dashboard、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 などのサービスは、ローカルストレージまたは export/local-volumes 内でパーティション分割されたディスク領域を使用します。デフォルトでは、ワーカーノードには使用できるローカルストレージがあります。ここでプライマリ ノードを追加しない場合、プライマリ ノードでローカル ストレージを必要としないアプリケーションのみを実行できます。 注: ローカルストレージは Ceph ストレージとは異なります。
   Kubernetesノードのユーザー名(ルートなど)	ユーザーアカウントと認証方法を設定して、クラスターノードでインストーラーを認証します。ユーザーアカウントは 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 アプリケーションにログインするための grafana_admin_password パスワードを設定します。Grafana は、ログを含むさまざまなソースからのデータを視覚化および分析するために一般的に使用される視覚化ツールです。

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

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

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

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

• callback_vipオプションを、イングレスコントローラの仮想IP(VIP)アドレスとは異なるIPアドレスで設定します。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

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

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