Red Hat Enterprise Linux への Multinode クラスタのインストール

このディレクトリは、このガイドと呼 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ダッシュボード、Elasticsearch用Open Distro、Fluentd、Reloader、ArangoDB、Argoなどがあります。

• rhel-84-airgap.tar.gz:ベースOSがRed Hat Enterprise Linux(RHEL)のノード にのみ 、air-gap方式で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などのサービスでは、 エクスポート/ローカルボリューム内でパーティション化されたローカルストレージまたはディスク容量を使用します。デフォルトでは、ワーカー ノードはローカル ストレージを使用できます。ここにプライマリノードを追加しない場合、プライマリノードにローカルストレージを必要としないアプリケーションのみを実行できます。 メモ： ローカルストレージは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ワーカー ノードを識別します。と node グループの両方masterで同じIPアドレスを持つことはできません。

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

   2. グループの下のアプリケーションで使用可能なディスク領域を持つノードを local_storage_nodes:children 定義します。

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

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

コマンドは conf インタラクティブなインストールウィザードを実行し、インストールするコンポーネントを選択し、Paragon Automationの基本的な設定を行います。コマンドは、 config.yml ファイルに 入力設定を追加します。高度な設定を行うには、 config.yml ファイルを手動で編集する必要があります。

ウィザードのプロンプトに従って情報を入力します。カーソルキーを使用してカーソルを移動し、スペースキーを使用してオプションを選択し、 または i キーをa使用してすべてのオプションの選択またはクリアを切り替えます。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 ファイルは、ファイルの先頭にある必須セクションで構成され、インストール ウィザードで入力を求める設定オプションに対応します。ファイルには、ファイルに直接複雑な設定値を入力するための不可欠なセクションの下にある広範なセクションのリストもあります。

以下のオプションを設定できます。

• パスワードを opendistro_es_admin_password 設定して、Kibana アプリケーションにログインします。Open Distro を使用して、アプリケーション ログと可視化ツール Kibana を統合およびインデックス化し、キーワードとフィルターを使用してログを検索します。

  デフォルトでは、ユーザー名は admin #opendistro_es_admin_user: admin in として事前設定されており、 install_opendistro_es オプションは Elasticsearch バージョンを Open Distro に置き換えるために true に設定されています。管理者をユーザー名とパスワードとして使用して、Kibanaにログインします。

  デフォルトでは、本番環境でパージされる前に、データが 7 日間ディスクに保持されます。ディスクサイズが小さい場合は、日数をより小さな数に opendistro_es_retain 編集できます。

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

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

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

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

• クラスタ間通信にデフォルトインターフェイス以外のインターフェイスを使用する場合は、 変数を設定します kubernetes_system_interface 。現在の設定は、 "{{ ansible_default_ipv4.interface }}"で、デフォルト ルートが使用するインターフェイスです。この変数は kubernetes_system_interface 、Kubernetes APIサーバーとCalicoを設定します。

  デフォルトのインターフェイスを表示するには、プライマリノードでこのコマンドを実行します。

  この例では、ens3はこのマシンのデフォルトインターフェイスです。

  デフォルトのインターフェイスとは異なるインターフェイスを使用し、同じインターフェイスをすべてのクラスタノードで使用できる場合は、 config.ymlファイルで を設定kubernetes_system_interfaceします。例えば：

  kubernetes_system_interface: ens4

  デフォルトのインターフェイスとは異なるインターフェイスを使用したいが、異なるノードでインターフェイスが異なる場合は、config.ymlファイルから削除kubernetes_system_interfaceする必要があります。代わりに、インベントリ ファイルにインターフェイス名を設定します。例えば：

  は 、 calico_ip_autodetect に "interface={{ kubernetes_system_interface }}"設定されており、デフォルトインターフェイスが変更された場合と同じ値 kubernetes_system_interface を受け取り、明示的に変更する必要があることに注意してください。

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

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

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

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

マルチプライマリノード導入の場合のみ、インストーラはインストールの開始時に1秒あたりのディスク入出力操作(IOPS)を確認します。IOPS値が300未満の場合、インストールは失敗します。ディスクIOPSチェックを無効にするには、 コマンドを# ./run -c config-dir deploy -e ignore_iops_check=yes使用して展開を再実行してください。

既存のKubernetesクラスタにParagon Automationをインストールする場合、コマンドは deploy 、現在導入されているクラスタを最新のKubernetesバージョンにアップグレードします。コマンドはまた、必要に応じてDocker CEバージョンをアップグレードします。Docker EE がすでにノードにインストールされている場合、 deploy コマンドは Docker CE で上書きしません。KubernetesバージョンまたはDockerバージョンをアップグレードする場合、 コマンドは1つのノードで一度に順番にアップグレードを実行します。コマンドは各ノードをオフにして、スケジューリングから削除します。アップグレードを実行し、ノードでKubernetesを再起動し、最終的にノードを修正して、スケジューリングに戻します。

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

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