CLI(コマンドライン)を使った設定変更
一部の設定は、コマンドラインやスクリプトを使って変更できます。これらのコマンドを実行するには、ルートユーザー権限が必要です。
[Agent Settings] の項目
/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>
Coordinator の設定
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 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