複数の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'      => 'disabled', // ['disabled'|'optional'|'enabled'] default value is 'disabled' 
         ),
    );

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

• port: HelixサーバのP4PORTを意味します。
• user: Helixサーバに対しadmin 権限を持つuserid を意味します。
• password: Helixサーバユーザ用のチケット、またはパスワードを意味します。
• sso: HelixサーバがHelix認証サービス用に設定されている場合は、以下のいずれかの値を設定します。

  • enabled: すべてのユーザがHelix認証サービスを使用してSwarmにログインする必要があります。

  • optional: Helix認証サービスを使用してSwarmにログインできますが、必ず使用しなければならないわけではありません。

  • disabled: Helix認証サービスを使用してSwarmにログインすることはできません。これがデフォルト値です。

重要

Swarm 2021.1以降、sso_enabled構成可能変数は非推奨になりました(ただし、引き続き使用できます)。代わりに、より柔軟性の高いsso構成可能変数が導入されました。sso_enabled構成可能変数とsso構成可能変数の両方をp4構成ブロック内に指定した場合、Swarmではsso構成可能変数が使用されます。

複数の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'      => 'disabled', // ['disabled'|'optional'|'enabled'] default value is 'disabled' 
            ),
            'serverB' => array(
                'port'     => 'p4d-B:1666',
                'user'     => 'admin_userid_serverB',
                'password' => 'admin user ticket or password for serverB',
                'sso'      => 'disabled', // ['disabled'|'optional'|'enabled'] default value is 'disabled' 
            ),		
        );

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

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