Puppet Enterprise 2017.2

モノリシックインストールでは、すべてのPuppet Enterpriseコンポーネントが1つのノードにインストールされます。 このインストールタイプは、インストール、アップグレード、トラブルシューティングが容易で、コンパイルmasterを追加することで、最大20,000台の管理対象ノードまでインストールを拡張することができます。 モノリシックインストールは、ほとんどのユーザに推奨されるインストールタイプです。

Puppet Enterpriseのインストール: モノリシックインストール

Puppet Enterpriseのモノリシックインストールをテキストモードで実行すると、Puppet master、PuppetDB、Puppet Enterprise Webコンソールコンポーネントがすべて同じマシンにインストールされます。

PEインストーラはべき等性のインストーラです。つまり、結果に影響を与えずに、必要に応じて何度でも実行することができます。 インストール中にエラーが生じた場合は、修正してもう一度インストーラを実行することができます。

インストールを始める前に

  1. tar -xf <TARBALL_FILENAME>を実行してtarballを展開します。この手順を実施するには、/tmpに約1 GBの空き容量が必要です。
  2. インストーラのディレクトリから、インストーラを実行します。 インストール手順は、どの方法を選択するかによって異なります。

    • インストーラでpe.confのコピーを開き、それを編集して使用する場合は、-cフラグを用いずにインストーラを実行します。

      sudo ./puppet-enterprise-installer
      
    • 以前に生成したpe.confファイルを使用する場合は、pe.confファイルを指す-cフラグを用いてインストーラを実行します。

      sudo ./puppet-enterprise-installer -c <FULL PATH TO pe.conf>
      

      警告:事前生成済みのファイルを使用する場合、以下のステップに記載するとおりにパラメータを正しく設定していることを確認してください。 パラメータ値にシングルクォーテーションを使わないでください。 例に示したように、ダブルクォーテーションを使用してください。

  3. -cフラグを使用せずにインストーラを実行した場合、プロンプトが表示されたら[text-mode]を選択します。

    これにより、テキストエディタでpe.confファイルが開きます。このファイルをお使いのインフラに合わせて編集し、必要に応じて任意のテキストモードインストールのオプションを追加することができます。

  4. 以下のパラメータを設定します。

    パラメータ
    "console_admin_password": "<PASSWORD>" Puppet Enterprise Webコンソールのログインに使用したパスワードで、<PASSWORD>を置き換えます。

    ヒント:モノリシックインストールでは、モノリシックサーバーのcertnameがFQDNとマッチする場合には、"%{::trusted.certname}"のデフォルト値を使用できます。

  5. 外部PostgreSQLサーバーがある場合、「pe.confパラメータリファレンスの外部PostgreSQLパラメータ」を参照して、pe.confに追加します。

  6. ファイルを保存し、テキストエディタを終了します。

    これにより、インストールが開始されます。

  7. インストールが完了したら、puppet agent -tを2回実行して、モノリシックPuppet masterで Puppetを2回実行 します。

    インストールの完了後は、更新されたpe.confファイルを/etc/puppetlabs/enterprise/conf.dで見つけることができます。

テキストモードインストールのオプション

テキストモードでインストーラを実行する場合、追加のフラグを渡してインストールを制御することができます。

pe.confファイルを指定したテキストベースインストールのシンタックスは、次のようになります。

sudo ./puppet-enterprise-installer -c <FULL PATH TO pe.conf>

-cオプションを使用する場合、pe.confファイルをフルパスで指定する必要があります。 これを省略すると、コマンドが終了してエラーメッセージが表示されます。

-cオプションを使用する場合は、以下のオプションを用いることもできます。

オプション 定義
-D インストーラによりデバッグ情報が表示されます。
-q インストーラがクワイエットモードで実行されます。インストールプロセスは表示されません。インストール中にエラーが生じた場合には、コマンドが終了してエラーメッセージが表示されます。
-V きわめて詳細なデバッグ情報が表示されます。
-h インストーラによりヘルプ情報が表示されます。

PATHへのPuppet Enterpriseバイナリの追加

Puppet Enterpriseは、ツールおよびサービスと対話するために多数のバイナリをインストールします。 これらのバイナリをデフォルトパスに含める必要があります。

  1. これらのバイナリをデフォルトの$PATHに追加するには、プロファイルに手動で追加するか、または以下を実行します。

    PATH=/opt/puppetlabs/puppet/bin:/opt/puppetlabs/server/bin:$PATH;export PATH
    

Puppet Enterpriseは、ツールおよびサービスと対話するために多数のシンボリックリンクをインストールします。 必要に応じて、 デフォルトのHieraファイルに設定を追加すると、シンボリックリンクを無効化できます。

  1. デフォルトのHieraファイルに以下の設定を追加します。

    puppet_enterprise::manage_symlinks: false
    

関連リンク

Back to top