環境変数

環境変数（Env Var）は、EnvVarが処理された後に使用可能になります。

BitriseCLIによって公開されたEnvVarがあります。これらは最初から利用できます：たとえば、 BITRISE_SOURCE_DIR と BITRISE_TRIGGERED_WORKFLOW_ID。

他のすべてのEnvVarは処理され、ビルドが進むにつれて利用できるようになります。

処理順序は次のとおりです。

新しい環境変数（環境変数）を設定するには：

それでおしまい。新しいEnvVarが保存され、使用できるようになります。

新しいビルドをスケジュールする場合、または新しいビルドを手動で開始する場合は、カスタム環境変数（Env Var）を設定するオプションがあります。これらの変数は、開始またはスケジュールしたビルドでのみ使用できます。

多くの ステップ入力 環境変数（環境変数）を受け入れ、 秘密 入力値として。

Env VarまたはSecretをステップ入力値として使用するには：

それでおしまい。次にそのワークフローのビルドを実行するとき、ステップ入力は挿入されたEnv変数の値をステップ入力値として使用します。

環境変数（Env Var）には通常、単純な文字列値が含まれています。ただし、他のEnvVarを値として含むEnvVarを設定することは可能です。

いつでも、Env Varの値に別の環境変数を使用できます。いわば、EnvVarを埋め込みます。たとえば、の値を設定するとします。 $BITRISE_AUTH Env Var to $PERSONAL_ACCESS_TOKEN これは別のEnv変数です。

これを行うには、次のキーを確認する必要があります $BITRISE_AUTH ワークフローとステップに渡される埋め込みEnv変数になるように、その値に置き換えられます。

1つのステップからEnvVarを公開し、ビルド中にステップの後に実行される他のすべてのステップで使用できるようにすることができます。あなたが使用することができます envman EnvVarsを管理します。

これは、キーを使用して新しいEnvVarを追加する簡単な例です。 MY_RELEASE_NOTE：

envman add --key MY_RELEASE_NOTE --value "This is the release note"

あなたは呼び出すことができます envman スクリプトステップを含む任意のステップで、またはあなたがそれをから呼び出す場合はあなた自身のスクリプト（あなたのリポジトリに保存されている）でさえ bitrise 建てる。

値を次のように指定できます --value パラメータ、またはパイプを使用して：

echo 'hi' | envman add --key MY_RELEASE_NOTE

ファイルから値を読み取ることもできます。

envman add --key MY_RELEASE_NOTE --valuefile ./some/file/path

Env Varが公開されると、他のEnvVarと同じように使用できます。これらの公開されたEnv変数は、他のステップの入力でも使用できます。

これは、リリースノートのEnv Varを公開し、それを別の場所で使用する例です。 Script と Send a Slack message ステップ。

workflows:
  example:
    steps:
    - script:
        inputs:
        - content: |
            #!/bin/bash
            envman add --key MY_RELEASE_NOTE --value "This is the release note"
    - script:
        inputs:
        - content: |
            #!/bin/bash
            echo "My Release Note: $MY_RELEASE_NOTE"
    - slack:
        inputs:
        - channel: ...
        - webhook_url: ...
        - message: "Release Note: $MY_RELEASE_NOTE"

別のEnvVarのキーを介してアクセスできるようにEnvVarの値を公開する場合は、そうすることができます。

たとえば、の値を公開するには BITRISE_BUILD_NUMBER キーの下 MY_BUILD_NUMBER：

 envman add --key MY_BUILD_NUMBER --value "${BITRISE_BUILD_NUMBER}"

この後、後続のステップはの値を取得できます BITRISE_BUILD_NUMBER から MY_BUILD_NUMBER 環境変数の値を変更した場合 BITRISE_BUILD_NUMBER この後、の値 MY_BUILD_NUMBER 変更されることはなく、元の値を保持します。

カスタムEnvVarが定義されているかどうかを知る必要がある場合は、簡単に確認でき、値を上書きすることもできます。

#!/bin/bash
set -ex
if [ ! -z "$API_PROJECT_SCHEME" ] ; then
  envman add --key PROJECT_SCHEME --value "$API_PROJECT_SCHEME"
fi

このスクリプトは、 API_PROJECT_SCHEME Env Varが定義されており、定義されている場合、その値はに割り当てられます。 PROJECT_SCHEME 環境変数、の元の値を上書きします PROJECT_SCHEME。

または、ワークフローの環境変数を設定することもできます。ワークフローに設定した環境変数は、アプリの環境変数またはアプリとして定義されている場合、環境変数を上書きします ひみつ。

Env Varを定義し、それらのEnvVarを使用できる別のワークフローを実行するワークフローの例を次に示します。

workflows:

  deploy-alpha:
    envs:
    - ENV_TYPE: alpha
    after_run:
    - _deploy

  _deploy:
    steps:
    - script:
        inputs:
        - content: |
            #!/bin/bash
            echo "ENV_TYPE: $ENV_TYPE"

あなたが実行する場合 deploy-alpha ワークフロー、それは設定します ENV_TYPE Env Var to alpha、それからそれは実行されます deploy そのEnv変数を使用できるワークフロー。この例では、単にその値を出力します（印刷されるテキストは次のようになります： ENV_TYPE: alpha）。