複数のHelixサーバインスタンス

1つのSwarmサーバを複数のHelix Coreサーバ (P4D)インスタンスに接続することができます。 このセクションでは、Swarmを複数のHelixサーバインスタンスに接続する設定方法について説明します。

Swarmを複数のHelixサーバインスタンスに接続するには、以下の手順を完了してください。

• Swarm構成ファイルをHelixサーバ用に設定する
• SwarmトリガトークンとSwarmホスト変数を各Helixサーバ用に設定する
• cronジョブを各Helixサーバインスタンス用に設定する

Swarm構成ファイルをHelixサーバ用に設定する

Swarm Helixサーバの接続の詳細は、<swarm_root>/data/config.php構成ファイル内のp4項目を使用して設定されています。

Swarmが単一のHelixサーバインスタンス用に設定されている場合は、p4項目は以下のようになります。

<?php
    return array(
        'p4' => array(
            'port'      => 'my-helix-core-server:1666',
            'user'      => 'admin_userid',
            'password'  => 'admin user ticket or password',
            'sso_enabled' => false, // defaults to false
         ),
    );

各項目の意味は以下のとおりです。

• port: HelixサーバのP4PORTを意味します。
• user: Helixサーバに対しadmin 権限を持つuserid を意味します。
• password: Helixサーバユーザ用のチケット、またはパスワードを意味します。
• sso_enabled: HelixサーバがHelix認証サービスまたはHelix SAMLに設定されている場合は、trueに設定します。
重要
• Helix認証サービスは、Perforceの優先SSOソリューションです(Helix認証サービスを参照)。
• SwarmでHelix SAMLを使用する場合:
  • Helixサーババージョン2018.2以降が必要です。
  • Helix SAML用のHelixサーバトリガを作成します。 Helix SAML用のHelixサーバトリガの開発手順については、『Helix Coreサーバ管理者ガイド』の「トリガを起動して外部認証を使用する」を参照してください。
  • sso_enabled構成可能変数を使用して、SwarmでHelix SAMLを有効にします。詳細については、「Swarmの構成」を参照してください。
  • Swarm管理者ユーザがチケットベースの認証を使用するように設定する方法については、「Swarmの構成」を参照してください。
  • Helix SAML用にSwarmを設定します。 Helix SAML用のSwarmの設定手順については、「Helix SAML」を参照してください。

複数のHelixサーバインスタンスをconfig.phpのp4項目に追加できます。ただし、各Helixサーバインスタンスは、サーバインスタンスを特定できるラベルを持つ必要があります。 これにより、p4項目でSwarmがHelixサーバに接続することが可能になります。

p4項目の最初のHelixサーバはプライマリHelixサーバです。このインスタンスがグローバルダッシュボードをレンダリングします。 SwarmがプライマリHelixサーバへの接続に失敗すると、SwarmはどのHelixサーバインスタンスもグローバルダッシュボードに表示できなくなります。 各インスタンスのURLにHelixサーバラベルを含めることで、他のP4Dインスタンスに直接接続することはできます。例: https://swarm.company.com/serverA

Swarm構成ファイルを複数のHelixサーバインスタンス用に設定する

各Helixサーバインスタンスのラベルを入力して、サーバラベルの下にサーバ接続の詳細を入力します。

以下に例を示します。

<?php
    return array(
        'p4' => array(
            'serverA' => array(
                'port'      => 'p4d-A:1666',
                'user'      => 'admin_userid_serverA',
                'password'  => 'admin user ticket or password for serverA',
                'sso_enabled' => false, // defaults to false
            ),
            'serverB' => array(
                'port'      => 'p4d-B:1666',
                'user'      => 'admin_userid_serverB',
                'password'  => 'admin user ticket or password for serverB',
                'sso_enabled' => true, // defaults to false
            ),		
        );

各項目の意味は以下のとおりです。

• serverAおよびserverBは、個々のHelixサーバを特定するラベルです。
  • ラベルは、URLに適した形式で指定する必要があります。
  • URLエンコードが必要なスペースや文字をラベル内で使用することはできません。
  • サーバラベルの長さとRedis namepaceの長さの合計が127文字を超えないようにしてください。 namespaceのデフォルト値はSwarmです。
• port、user、password、sso_enabledの項目は、それらがネストされているHelixサーバインスタンスに固有です。

SwarmトリガトークンとSwarmホスト変数を各Helixサーバ用に設定する

Helixサーバは、Swarmトリガトークンを使用して、Swarmからのトリガ要求が有効であることを確認します。 各Helixサーバインスタンスは、swarm-trigger.confファイルに有効なSwarmトリガトークンを持つ必要があります。 swarm-trigger.confファイルには、Helixサーバインスタンス用のSwarmホストURLも含まれています。

SwarmトリガトークンとSwarmホスト変数を各Helixサーバ用に設定するには、以下を実行します。

1. インスタンス用のSwarm URLに移動します。

例: https://swarm.company.com/serverA

2. Swarmにsuperユーザとしてログインします。
3. メインツールバーのuseridをクリックして、[バージョン情報]Swarmを選択します。

[バージョン情報]Swarmダイアログがトリガトークン付きで表示されます。 Swarmは、トリガトークンが存在しない場合はトリガトークンを生成します。

4. ダイアログからトリガトークンの値をコピーします。
5. Helixサーバインスタンス用にswarm-trigger.confファイルを開きます。
ヒント

swarm-trigger.confファイルの場所について詳しくは、「WindowsまたはLinuxでホストされるHelixサーバを使用してSwarmを設定する」を参照してください。

6. swarm-trigger.confファイルで、以下を実行します。
   1. SWARM_HOST URLを設定します。
   2. 前述の手順でコピーをしたSwarmトリガトークンを貼り付けて、SWARM_TOKENを設定します。

以下に例を示します。

# SWARM_HOST (required)
# Hostname of your Swarm instance, with leading "http://" or "https://".
SWARM_HOST="https://swarm.company.com/serverA"

# SWARM_TOKEN (required)
# The token used when talking to Swarm to offer some security. To obtain the
# value, log in to Swarm as a super user and select 'About Swarm' to see the
# token value.
SWARM_TOKEN="TRIGGER-TOKEN-FOR-SERVERA"

7. swarm-trigger.confファイルを保存します。
8. 各Helixサーバに対し、これらの手順を繰り返します。

cronジョブを各Helixサーバインスタンス用に設定する

Swarmに接続している各サーバに対してワーカーを自動的に生成するには、各サーバに対してcronジョブを手動で構成する必要があります。

SwarmパッケージのインストールとOVAのインストールのみ

swarm-cron-hosts.confファイルは、Swarmのcronジョブの接続タイプ(HTTPまたはHTTPS)、ホスト名、ポート番号、サーバラベルを指定します。

パッケージを使用してSwarmをインストールした場合、またはSwarm OVAを実行している場合、/opt/perforce/etc/swarm-cron-hosts.conf内ですべてのHelixサーバ URLを指定する必要があります。

1. Swarm用に設定されている実際のSwarmのホスト名、ポート番号、サーバラベルを含めることができるようにswarm-cron-hosts.confファイルを編集します。

1つのHelixサーバに対して以下の構文の各行を使用します。

[http[s]://]<swarm-host>[:<port>][/<base-url>]

値を指定しなかった場合に適用されるデフォルト設定は以下のとおりです。

• [http[s]://]: httpがデフォルト値として使用されます。
• <swarm-host>: Swarmのホスト名を指定する必要があります。
• [:<port>] 80
• [/<base-url>]: サーバラベルです。指定する必要があります。

例えば、デフォルトのポート値80を使用して設定されたhttps://swarm.company.comのSwarmホストのserverAおよびserverBについて考えます。 swarm-cron-hosts.confファイルのエントリは以下のようになります。

https://swarm.company.com/serverA
https://swarm.company.com/serverB

2. swarm-cron-hosts.confファイルを保存します。
3. Swarmが、複数のHelixサーバインスタンスに接続するように設定されました。
ヒント

Swarmワーカーの構成を確認する方法(または変更する方法)については、ワーカーの構成を参照してください。

SwarmTarballを使用したインストールのみ

Swarmをtarballを使用してインストールした場合、またはcronを手動で設定した場合は、helix-swarmというファイルを作成し、Swarmに接続したすべてのHelixサーバインスタンスを追加する必要があります。

1. /etc/cron.dで、helix-swarmという名前のファイルを作成します(まだ存在しない場合)。
2. 以下のコンテンツを含むよう、helix-swarmファイルを編集します。

#
# Cron job to start Swarm workers every minute
#
* * * * * nobody [ -x /opt/perforce/swarm/p4-bin/scripts/swarm-cron.sh ] && /opt/perforce/swarm/p4-bin/scripts/swarm-cron.sh

3. helix-swarmファイルを保存します。
4. Swarm用に設定されている実際のSwarmのホスト名、ポート番号、サーバラベルを含めることができるようにswarm-cron-hosts.confファイルを編集します。

1つのHelixサーバに対して以下の構文の各行を使用します。

[http[s]://]<swarm-host>[:<port>][/<base-url>]

値を指定しなかった場合に適用されるデフォルト設定は以下のとおりです。

• [http[s]://]: httpがデフォルト値として使用されます。
• <swarm-host>: Swarmのホスト名を指定する必要があります。
• :<port> 80
• [/<base-url>]: サーバラベルです。指定する必要があります。

例えば、デフォルトのポート値80を使用して設定されたhttps://swarm.company.comのSwarmホストのserverAおよびserverBについて考えます。 swarm-cron-hosts.confファイルのエントリは以下のようになります。

https://swarm.company.com/serverA
https://swarm.company.com/serverB

5. swarm-cron-hosts.confファイルを保存します。
6. Swarmが、複数のHelixサーバインスタンスに接続するように設定されました。
ヒント

Swarmワーカーの構成を確認する方法(または変更する方法)については、ワーカーの構成を参照してください。

詳細情報

ユーザ

• グローバルダッシュボードにアクセスするには、Helixサーバインスタンス名なしで、基本的なSwarm URLを入力します。例えば、https://swarm.company.comと入力します。
• グローバルダッシュボードを経由せずに、Swarmの特定のHelixサーバインスタンスにアクセスするには、URLにサーバ名を含めます。例えば、https://swarm.company.com/serverAと入力します。

SwarmでHelixサーバを表示すると、Swarmは、標準の単一Helixサーバ Swarmシステムとして動作します。

管理者

Swarmをホストするサーバでは、Swarmは各Helixサーバインスタンスのデータフォルダを<Swarm_root>/data/serversに自動的に作成します。 これは、各Helixサーバのリクエストがフィールドであるためです。

以下に例を示します。

# ls -la /opt/perforce/swarm/data/servers/serverA
total 362296			
drwx------ 6 apache apache    4096 Sep  8 17:15 .
drwx------ 6 apache apache    4096 Sep  6 15:41 ..
drwx------ 2 apache apache    4096 Sep 20 18:08 cache
drwx------ 3 apache apache    4096 Sep  7 13:25 clients
-rw-r--r-- 1 apache apache 3709543 Sep 26 14:19 log
-r-------- 1 apache apache      84 Sep  6 15:41 p4trust
drwx------ 4 apache apache    4096 Sep 20 14:27 queue
drwx------ 2 apache apache    4096 Sep 20 11:18 sessions

開発者

Swarm APIを使用して、serverAのプロジェクトの一覧を取得するには、bashで以下のコマンドを実行します。

• wgetを使用している場合:

  $ wget -u "apiuser:password" https://swarm.company.com/serverA/api/v10/projects

• curlを使用している場合:

  $ curl -u "apiuser:password" https://swarm.company.com/serverA/api/v10/projects