5.4.3. Pipeline ビルドの環境変数の使用
環境変数を Pipeline ビルドプロセスで利用可能にするには、環境変数を BuildConfig の jenkinsPipelineStrategy 定義に追加できます。
定義した後に、環境変数は BuildConfig に関連する Jenkins ジョブのパラメーターとして設定されます。
手順
ビルド時に使用される環境変数を定義するには、以下を実行します。
jenkinsPipelineStrategy:
...
env:
- name: "FOO"
value: "BAR"
oc set env コマンドで、BuildConfig に定義した環境変数を管理することも可能です。
5.4.3.1. BuildConfig 環境変数と Jenkins ジョブパラメーター間のマッピング
Pipeline ストラテジーの BuildConfig への変更に従い、Jenkins ジョブが作成/更新されると、BuildConfig の環境変数は Jenkins ジョブパラメーターの定義にマッピングされます。 Jenkins ジョブパラメーター定義のデフォルト値は、関連する環境変数の現在の値になります。
Jenkins ジョブの初回作成後に、パラメーターを Jenkins コンソールからジョブに追加できます。パラメーター名は、BuildConfig の環境変数名とは異なります。上記の Jenkins ジョブ用にビルドを開始すると、これらのパラメーターが使用されます。
Jenkins ジョブのビルドを開始する方法により、パラメーターの設定方法が決まります。
-
oc start-buildで開始された場合には、BuildConfigの環境変数の値は対応するジョブインスタンスに設定するパラメーターになります。Jenkins コンソールからパラメーターのデフォルト値に変更を加えても無視されます。BuildConfigの値が優先されます。 oc start-build -eで開始する場合、-eオプションで指定される環境変数の値が優先されます。-
BuildConfigに一覧表示されていない環境変数を指定する場合、それらは Jenkins ジョブパラメーター定義として追加されます。 -
Jenkins コンソールから環境変数に対応するパラメーターに加える変更は無視されます。
BuildConfigおよびoc start-build -eて指定する内容が優先されます。
-
- Jenkins コンソールで Jenkins ジョブを開始した場合には、ジョブのビルドを開始する操作の一環として、Jenkins コンソールを使用してパラメーターの設定を制御できます。
ジョブパラメーターに関連付けられる可能性のあるすべての環境変数を、BuildConfig に指定することが推奨されます。これにより、ディスク I/O が減り、Jenkins 処理時のパフォーマンスが向上します。
