ワーカーを生成する繰り返しタスクをセットアップする

Helixサーバの着信イベントをSwarmで自動的に処理するには、その処理を実行するためのcronジョブを設定する必要があります。 cronジョブをSwarmホストマシン上にインストールすることをお勧めします。

curlまたはwgetのインストール

Swarmワーカーを生成する繰り返しタスクを実行するには、Swarmのサーバマシンにcurlまたはwgetをインストールする必要があります。

• curlをインストールする方法については、curlのインストールを参照してください。
• wgetをインストールする方法については、wgetのインストールを参照してください。

curlのインストール

1. curlをhttps://curl.haxx.se/download.htmlからダウンロードします。
2. curlをインストールします。
3. curlがインストールされていることを検証します。「curlまたはwgetがインストールされているかどうかを確認する」を参照してください。

$ curl -h

Usage: curl [options...] <url>
Options: (H) means HTTP/HTTPS only, (F) means FTP only
     --anyauth       Pick "any" authentication method (H)
 -a, --append        Append to target file when uploading (F/SFTP)
     --cacert FILE   CA certificate to verify peer against (SSL)
     --capath DIR    CA directory to verify peer against (SSL)
...[truncated for brevity]...

$ curl https://www.perforce.com/

wgetのインストール

1. wgetをhttps://ftp.gnu.org/gnu/wget/からダウンロードします。
2. wgetをインストールします。
3. wgetがインストールされていることを検証します。「curlまたはwgetがインストールされているかどうかを確認する」を参照してください。

curlまたはwgetがインストールされているかどうかを確認する

curlまたはwgetがインストールされているかどうかを確認するには、以下の手順を実行します。

1. whichコマンドを実行します。

例えば、curlがインストールされているかどうかを確認するには、以下のコマンドを実行します。

 $ which curl
            

2. 出力が表示されたら、示されているコマンドがインストールされます。

ワーカーを生成するための繰り返しタスクを作成する

helix-swarmのcronファイル

helix-swarmファイルは、/etc/cron.dに配置され、swarm-cron.shスクリプトファイルを指しています。

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ファイルを保存します。

swarm-cron.shスクリプト

/opt/perforce/swarm/p4-bin/scriptsフォルダ内のswarm-cron.shファイルにより、ワーカーが1分間隔で起動します。

構成行「DEFAULT_CONFIG_FILE=」の値はデフォルトで「/opt/perforce/etc/swarm-cron-hosts.conf」に設定されています。 swarm-cron.shスクリプトは、swarm-cron-hosts.confファイルからSwarmのホスト名を取得します。

swarm-cron.shスクリプトファイルに記述されているwgetまたはcurlを使用して、Swarmのインストール環境の正しいコンテンツが保管されます。

• wget 構成行(HTTPとHTTPS用):

  wget --quiet --no-check-certificate --output-document /dev/null --timeout 5 "${SWARM_HOST}/queue/worker"

• curl 構成行(HTTPとHTTPS用):

  curl --silent --insecure --output /dev/null --max-time 5 "${SWARM_HOST}/queue/worker"

上記のwget構成行とcurl構成行では、「--timeout 5」または「--max-time 5」が指定されています。この「5」は、cronタスクがSwarmホストからの応答を待機する秒数です。 cronタスクがSwarmホスト(Swarm OVAなど)にインストールされている場合は、この値を1秒にまで減らすことができます(--timeout 1や--max-time 1などのように指定します)。

swarm-cron-hosts.conf構成ファイル

/opt/perforce/etcフォルダ内のswarm-cron-hosts.confファイルにより、Swarmのcronジョブの接続タイプ(HTTPまたはHTTPS)、ホスト名、ポート番号を指定します。

1. swarm-cron-hosts.confファイルを編集用として開き、Swarmの実際のホスト名と、Swarm用に設定されているポートを指定します(サブフォルダまたはカスタムポートを指定することもできます)。 以下の構文を使用します。

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

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

• [http[s]://]: httpがデフォルト値として使用されます。
• <swarm-host>: Swarmのホスト名を指定する必要があります。
• :<port> 80
2. 編集したファイルを保存します。
ヒント

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

注意
繰り返しタスクが無効になっている場合や、何らかの理由で繰り返しタスクが停止した場合は、ワーカーが稼働していないことがSwarmによって検出されると、ログインしているユーザに対して以下のエラーメッセージが表示されます。


3. これで、Swarmの基本的な構成が完了しました。

   重要

   HelixサーバがHelix認証サービスまたはHelix SAML用に設定されている場合に、すべてのユーザに対してIDプロバイダ(IdP)を使用した認証を強制するには、パスワードのフォールバック機能を無効にします。 Helixサーバでパスワードへのフォールバックを無効にするには、以下のコマンドを実行します。

   p4 configure set auth.sso.allow.passwd=0

4. Swarmのインストール環境をカスタマイズするためのインストール後構成オプションを確認します。詳しくは、「インストール後の構成オプション」を参照してください。