Cloud Manager のパイプライン変数 configuring-pipeline-variables

ビルドプロセスが、Git リポジトリに保存すべきではない特定の設定変数に依存している可能性があります。または、同じブランチでのパイプライン実行間で調整が必要になる場合があります。Cloud Manager では、これらの設定をパイプライン変数として管理できます。

パイプライン変数について pipeline-variables

Cloud Manager を使用すると、複数の方法でパイプライン変数を設定できます。

変数は、プレーンテキストとして保存することも、保存時に暗号化することもできます。どちらの場合も、変数はビルド環境内で環境変数として使用可能になり、変数は pom.xml ファイル内または他のビルドスクリプト内から参照できます。

Cloud Manager を使用したパイプライン変数の追加 ui

パイプライン変数は、Cloud Manager ユーザーインターフェイスを使用して設定および管理できます。これは、特に様々なステップで異なる設定が必要な場合に、パイプライン管理を効率化するのに役立ちます。

パイプライン変数を追加、編集、削除するには、パイプラインを編集する権限が必要です。

パイプラインが実行中の場合、変数管理はブロックされます。

Cloud Manager を使用してパイプライン変数を追加するには:

  1. パイプラインを管理する際、パイプライン変数を作成するパイプラインの 省略記号 - その他アイコン をクリックします。

  2. ドロップダウンメニューから、「変数を表示/編集」をクリックします。

    パイプライン変数を表示/編集

  3. 変数設定 ​ダイアログボックスで、テーブルの最初の行に詳細を入力します。

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    フィールド 説明
    名前

    設定変数の一意の名前です。パイプラインで使用される特定の変数を識別します。次の命名規則に従う必要があります。

    • 変数には、英数字とアンダースコア(_)のみ使用できます。
    • 名前はすべて大文字にします。
    • 変数の数はパイプラインあたり最大 200 個までです。
    • 名前は 100 文字以下にする必要があります。
    • string 変数の値はそれぞれ、2048 文字未満にする必要があります。
    • secretString 変数型の値はそれぞれ、500 文字以下にする必要があります。
    変数が保持する値です。
    適用されたステップ

    必須。変数が適用されるパイプラインのステップ:

    • ビルド - 変数は、ビルドプロセス中に適用されます。
    • 機能テスト - 変数は、機能テストステップで使用されます。
    • UI テスト - 変数は、UI テスト段階で使用されます。
    タイプ 変数がプレーンテキストか、シークレットとして暗号化されているかを選択します。

    変数の追加

  4. 追加」をクリックします。

    必要に応じて、変数を追加します。

  5. 保存」をクリックします。

パイプライン変数の編集 edit-ui

  1. パイプラインを管理する際、パイプライン変数を編集するパイプラインの 省略記号 - その他アイコン をクリックします。

  2. ドロップダウンメニューで、「変数を表示/編集」をクリックします。

    パイプライン変数の表示/編集

  3. 変数設定 ​ダイアログボックスで、変更する変数の 省略記号 - その他アイコン をクリックします。

  4. ドロップダウンメニューで、「編集」をクリックします。

    変数の編集

  5. 必要に応じて、変数の値を更新します。

    変更できるのは変数の値のみです。

  6. 次のいずれかの操作を行います。

    • 適用 – チェックマークアイコン をクリックして、変更を適用します。
    • 取り消しアイコン をクリックして、変更を元に戻します。
  7. 保存」をクリックします。

パイプライン変数の削除 delete-ui

  1. パイプラインを管理する際、パイプライン変数を削除するパイプラインの 省略記号 - その他アイコン をクリックします。

  2. ドロップダウンメニューで、「変数を表示/編集」をクリックします。

    パイプライン変数の表示/編集

  3. 変数設定 ​ダイアログボックスで、削除する変数の 省略記号 - その他アイコン をクリックし、「削除」をクリックします。

Cloud Manager CLI を使用したパイプライン変数の設定 cli

CLI(コマンドラインインターフェイス)のこのコマンドで、変数を設定します。

$ aio cloudmanager:set-pipeline-variables PIPELINEID --variable MY_CUSTOM_VARIABLE test

このコマンドは、変数を一覧表示します。

$ aio cloudmanager:list-pipeline-variables PIPELINEID

Maven pom.xml ファイル内で使用する場合は、多くの場合、次のような構文を使用して、これらの変数を Maven プロパティにリンクすると便利です。

        <profile>
            <id>cmBuild</id>
            <activation>
                <property>
                    <name>env.CM_BUILD</name>
                </property>
            </activation>
            <properties>
                <my.custom.property>${env.MY_CUSTOM_VARIABLE}</my.custom.property>
            </properties>
        </profile>
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab