Command Line Interface(CLI)

/opt/incredibuild/management/get_agent_params.py help

/opt/incredibuild/management/set_agent_params.py help

ステータス取得

エージェントがビルドにヘルパーとして参加することが有効か無効かを表示するために、任意のエージェントに対して実行します(有効な場合は「true」を、無効な場合は「false」を返します)。

/opt/incredibuild/management/get_agent_params.py enable-as-helper

ステータス設定

任意のAgentにこれらを実行し、ビルドのヘルパーとして参加する機能を有効化、無効化に変更します。

sudo /opt/incredibuild/management/set_agent_params.py enable-as-helper

sudo /opt/incredibuild/management/set_agent_params.py disable-as-helper

Get Coordinator

ヘルパーが関連するCoordinatorを表示するには、任意のエージェントマシンでこれを実行します。

/opt/incredibuild/management/get_agent_params.py coordinator

Coordinatorの設定

ヘルパーが関連するCoordinatorを変更するには、任意のエージェントマシンでこれを実行します。ヘルパー上で実行された場合、実行中のタスクを停止し、利用可能なヘルパーまたはイニシエータに再割り当てます。イニシエータを実行した場合、そのイニシエータによって開始されたすべてのビルドは中断されます。

新しい Coordinator がAgentと同じバージョンの Incredibuild でない場合、Agentは自動的にアップグレードまたはダウングレードされます。

sudo /opt/incredibuild/management/set_agent_params.py coordinator <hostname/IP of new Coordinator>

この後、元の Coordinator のライセンス の登録を解除し、新しい Coordinator で登録し直す必要があります。

コマンドの例:

sudo /opt/incredibuild/management/set_agent_params.py coordinator 192.168.10.50

最大数のローカルヘルパーを獲得

新しいビルドを開始するために必要な利用可能なローカルコアの最大数を表示するには、任意のエージェントマシンで次のコマンドを実行します。

/opt/incredibuild/management/get_agent_params.py max-helper-cores

ローカル ヘルパーの最大数を設定する

Agentがビルドに参加する際に使用できる最大コア数を変更するには、任意のエージェントマシンで次のコマンドを実行します。

sudo /opt/incredibuild/management/set_agent_params.py max-helper-cores <number>

コマンドの例:

sudo /opt/incredibuild/management/set_agent_params.py max-helper-cores 64

最小限のローカル ヘルパーを確保する

新しいビルドを開始するために必要な利用可能なローカルコアの最小数を表示するには、任意のエージェントマシンで次のコマンドを実行します。

/opt/incredibuild/management/get_agent_params.py min-local-cores

ローカル ヘルパーの最低人数を設定する

新しいビルドを開始するために必要な利用可能なローカルコアの最小数を変更するには、任意のエージェントマシンで次のコマンドを実行します。

sudo /opt/incredibuild/management/set_agent_params.py min-local-cores <number>

コマンドの例:

sudo /opt/incredibuild/management/set_agent_params.py min-local-cores 8

HTTP通信用プロキシサーバーを取得

Incredibuildから外部へのHTTP通信に使用するプロキシサーバーを取得します。

/opt/incredibuild/management/get_agent_params.py http_proxy

HTTP通信用プロキシサーバーを設定

Incredibuildから外部へのHTTP通信に使用するプロキシサーバーを設定します。プロキシサーバーを削除するには、このコマンドを空の値で使用します。

/opt/incredibuild/management/set_agent_params.py http_proxy <URL or empty value>

HTTPS通信用プロキシサーバーを取得

Incredibuild からの外部 HTTPS 通信に使用するプロキシサーバーを取得します。

/opt/incredibuild/management/get_agent_params.py https_proxy

HTTPS通信用プロキシサーバーの設定

Incredibuildから外部へのHTTPS通信に使用するプロキシサーバーを設定します。プロキシサーバーを削除するには、このコマンドを空の値で使用します。

/opt/incredibuild/management/set_agent_params.py https_proxy <URL or empty value>

プロキシ無しの例外を取得する

プロキシをバイパスするIPアドレス、ホスト名、ドメインのリストを取得するには、以下のコマンドを使用します。

sudo /opt/incredibuild/management/get_agent_params.py no_proxy

プロキシ例外なしを設定する

プロキシをバイパスするIPアドレス、ホスト名、ドメインのリストを設定するには、以下のコマンドを使用してください。

sudo /opt/incredibuild/management/set_agent_params.py no_proxy <comma separated list>

コマンドの例:

sudo /opt/incredibuild/management/set_agent_params.py no_proxy 192.54.3.22,192.78.54.230

最大イニシエータコアを取得する

ビルドの Initiator として動作するときにエージェントが使用できる最大コア数を表示するには、任意のエージェントでこれを実行します。

/opt/incredibuild/management/get_agent_params.py max-initiator-cores

最大イニシエータコアを設定する

ビルドのイニシエータとして動作するときにエージェントが使用できる最大コア数を設定するには、任意のエージェントでこれを実行します。

sudo /opt/incredibuild/management/set_agent_params.py max-initiator-cores <number of max initiator cores>

コマンドの例:

sudo /opt/incredibuild/management/set_agent_params.py max-initiator-cores 16

これらのコマンドは、Initiator マシンの Build Cache 設定をコントロールします。

ローカルのBuild Cache情報を取得する

ローカルのBuild Cachにおける場所とサイズに関する情報を返します。

/opt/incredibuild/management/build_avoid_cache.sh <user|shared|group='groupname'> info

ローカルのBuild Cacheサイズを設定する

ローカルビルドキャッシュのサイズを設定します。デフォルトでは、キャッシュのサイズは100GBです。

/opt/incredibuild/management/build_avoid_cache.sh <user|shared|group='groupname'> set_size <size in GB>

Build Cacheサービスを取得

Initiator が使用するデフォルトの Build Cache Service を取得できます。このサービスはBuild Cacheの共有に使用されます。

sudo /opt/incredibuild/management/get_agent_params.py build-cache-service-URL

Build Cacheサービスを設定

Initiator が使用するデフォルトの Build Cache Service を設定できます。このサービスはBuild Cacheの共有に使用されます。

sudo /opt/incredibuild/management/set_agent_params.py build-cache-service-URL http://<agent IP or hostname>:<port>

コマンドの例:

sudo /opt/incredibuild/management/set_agent_params.py build-cache-service-URL http://linux_lab_machine2:8080

このパラメーターの設定を解除するには、""を指定して呼び出します。

sudo /opt/incredibuild/management/set_agent_params.py build-cache-service-URL ""

Build Cacheを削除

ローカルのBuild Cacheを削除します。

/opt/incredibuild/management/build_avoid_cache.sh <user|shared|group='groupname'> clear

これらのコマンドにより、構築ログを保存するリモートの場所を定義できます。

ログの場所を取得する

このエージェントからのビルドログを保存するために定義されたリモートロケーションを表示します。

/opt/incredibuild/management/get_agent_params.py log-mount-directory

ログの場所を設定する

このエージェントからのビルドログを保存するリモートロケーションを設定します。その場所はすでにエージェント上のフォルダにマウント済みとなっているはずです。

/opt/incredibuild/management/set_agent_params.py log-mount-directory <path to mounted remote location>

Build Groupを作成

これを Primary Coordinator で実行し、新しい Build Group を作成します。

sudo /opt/incredibuild/ctl/coordinator build-group create [group name]

コマンドの例:

sudo /opt/incredibuild/ctl/coordinator build-group create devteam5

Build Groupの削除

Primary Coordinatorでこれを実行して、Build Groupを削除します。

sudo /opt/incredibuild/ctl/coordinator build-group delete [group name]

コマンドの例:

sudo /opt/incredibuild/ctl/coordinator build-group delete devteam5

すべての Build Groupを取得する

Primary Coordinatorでこれを実行すると、すべてのBuild Groupのリストが JSON 形式で返されます。

sudo /opt/incredibuild/ctl/coordinator build-group list

Build GroupのAgent Listを取得する

Primary Coordinatorでこれを実行すると、指定したBuild Groupに割り当てられている全Agentのリスト(JSON 形式)が返されます。

sudo /opt/incredibuild/ctl/coordinator build-group agents [group name]

コマンドの例:

sudo /opt/incredibuild/ctl/coordinator build-group agents devteam5

Build Groupを設定する

Agentを既存のBuild Groupに割り当てるために、Primary Coordinatorでこれを実行します。

sudo /opt/incredibuild/ctl/coordinator build-group assign [group name] [agent IP or name]

コマンドの例:

sudo /opt/incredibuild/ctl/coordinator build-group assign devteam5 22.33.44.55

Build Groupを取得する

エージェントがどの Build Group に属しているかを見るには、エージェント上でこれを実行します。

/opt/incredibuild/management/get_agent_params.py build-group

以下のようなライセンス情報を、GUID、名前、有効期限、サーバーコア数、SUVMコア数を含め、JSON形式で返します。

/opt/incredibuild/ctl/coordinator license show

ライセンスの種類(サーバ¥SUVM)ごとに、総コア数と利用可能な(未契約の)コア数の合計を返します。

/opt/incredibuild/ctl/coordinator license usage

指定されたパスに、指定された名前のコーディネーターのキーファイル (.pk) を作成します (拡張子は .pk である必要があります)。これは、最初のライセンスの生成または既存のライセンスの更新に必要です（キーファイルを生成するUIオプションに類似）。

/opt/incredibuild/ctl/coordinator license key-file <file path with file name>

コマンドの例:

/opt/incredibuild/ctl/coordinator license key-file /var/Incredibuild/ib-key.pk

指定されたライセンスファイルをロードします。コーディネータにすでに有効なライセンスがある場合、グリッドと実行中のビルドにダウンタイムを与えることなく、ライセンスを置き換えられます。何らかの理由でロードに失敗した場合、CLIはエラーを表示し、以前のライセンス（該当する場合）に戻ります。

/opt/incredibuild/ctl/coordinator license load

既存のライセンスをアンロードします。

/opt/incredibuild/ctl/coordinator license unload

コーディネーターの種類（プライマリ、セカンダリ）とステータス（オフライン、 スタンバイ、アクティブ）をJSON形式で返します。

/opt/incredibuild/ctl/coordinator status

Secondary CoordinatorのIP/名前を取得する

Primary Coordinatorで実行すると、Secondary Coordinatorが定義されている場合、Secondary CoordinatorのIPアドレスまたはマシン名が返されます。

/opt/incredibuild/ctl/coordinator secondary get

Secondary Coordinatorを設定する

指定したマシンを、このPrimary CoordinatorのSecondary Coordinatorとして設定します。

/opt/incredibuild/ctl/coordinator secondary set <machine name or IP>

コマンドの例:

/opt/incredibuild/ctl/coordinator secondary set 192.168.10.50

Secondary Coordinatorのステータスを取得する

Secondary Coordinatorのステータスを JSON 形式で返します (未設定、オフライン、スタンバイ、アクティブのいずれか)。

/opt/incredibuild/ctl/coordinator secondary status

これらのコマンドは、Build Cache ServiceマシンのBuild Cache設定をコントロールします。

Build Cacheのサイズを取得する

Build Cache ServiceマシンのBuild Cacheサイズ（GB）を表示します。

sudo /opt/incredibuild/management/build_cache_service.py get-size-limit

Build Cacheのサイズを設定する

Build Cache ServiceマシンのBuild Cacheサイズ（GB）を設定します。

sudo /opt/incredibuild/management/build_cache_service.py set-size-limit <size>

コマンドの例:

sudo /opt/incredibuild/management/build_cache_service.py set-size-limit 150

Build Cacheを削除

Build Cache ServiceマシンのBuild Cacheを削除するには、以下を実行します。

sudo /opt/incredibuild/management/build_cache_service.py clear

Build Cacheの場所を表示する

Build Cache Serviceマシン上のBuild Cacheが保存されているパスを表示するには、以下を実行します。

sudo /opt/incredibuild/management/build_cache_service.py get-path

Build Cacheの使用サイズを取得する

Build Cache Serviceマシンで現在使用されているBuild Cacheのサイズを表示するには、以下を実行します。

sudo /opt/incredibuild/management/build_cache_service.py get-used-size