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コンポーネントをインストールします。

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

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

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

• rhel-84-airgap.tar.gz、ベースOSがRed Hat Enterprise Linux(RHEL)のノード にのみ 、エアギャップ方式を使用してParagon Automationをインストールします。

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

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

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

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

copy コマンドには必ずドット "." を含めてください。

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

   次の表に、 inv コマンドでプロンプトが表示される構成オプションを示します。

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

   inv コマンド プロンプトの説明
   Kubernetesマスターノード	1 つの Kubernetes クラスター ノードの IP アドレスを入力します。
   Kubernetesワーカーノード	単一ノードクラスターの場合は、このフィールドを空のままにします。
   ローカルストレージノード	ローカルストレージノードには、単一クラスタノードのIPアドレスがあらかじめ入力されています。 このフィールドは、ローカル・ストレージを必要とするアプリケーションに使用可能なディスク・スペースがあるノードを定義します。Postgres、ZooKeeper、Kafka などのサービスは、 エクスポート/ローカル ボリューム内にパーティション分割されたローカル ストレージまたはディスク領域を使用します。 これは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. 1 つの Kubernetes ノードの IP アドレスを master グループのみに追加します。

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

      単一プライマリノード設定を作成するには、masterグループの下にプライマリとワーカーの両方として機能するノードのIPアドレスまたはホスト名を含めます。nodeグループの下にIPアドレスやホスト名を追加しないでください。

   2. [master] の下の [local_storage_nodes:children] グループの下に、単一の Kubernetes ノードのアドレスまたはホスト名を追加します。[node] の下の [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 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 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 ファイルは、インストール・ウィザードから入力を求める構成オプションに対応する、ファイルの先頭にある必須セクションで構成されています。このファイルには、重要なセクションの下に、複雑な構成値をファイルに直接入力できるセクションの広範なリストもあります。

次のオプションを使用できます。

• アプリケーション ログの統合とインデックス作成に使用される Open ディストリビューションを構成します。Open ディストリビューションを構成するには、[ install_opendistro_es ] と [ install_fluentd ] を [ true] に設定します。

• Kibanaアプリケーションにログインするための opendistro_es_admin_password パスワードを設定します。Kibanaは、キーワードとフィルターを使用してログを検索するために使用される視覚化ツールです。

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

  既定では、データは運用展開で消去される前に 7 日間ディスクに保持されます。ディスク サイズが小さい場合は、日数を opendistro_es_retain でより小さい数に編集できます。

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

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

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

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

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

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

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

NTP 同期は、導入の開始時にチェックされます。クロックが同期していない場合、デプロイは失敗します。既存のKubernetesクラスタにParagon Automationをインストールする場合、 deploy コマンドは、現在導入されているクラスタを最新のKubernetesバージョンにアップグレードします。このコマンドは、必要に応じて Docker CE バージョンもアップグレードします。Docker EE が既にノードにインストールされている場合、デプロイ・コマンドはそれを Docker CE で上書きしません。Kubernetes バージョンまたは Docker バージョンをアップグレードする場合、コマンドは一度に 1 つのノードでアップグレードを順番に実行します。各ノードは切断されてスケジューリングから削除され、アップグレードが実行され、ノード上でKubernetesが再起動され、最終的にノードは切断されてスケジューリングに戻されます。

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