変数ライブラリ CI/CD

Microsoft Fabric 変数ライブラリを使用すると、リリースパイプラインのステージ間で構成を管理し、Git で値を保存できます。この記事では、ライフサイクル管理と継続的インテグレーションと継続的デリバリー (CI/CD) のコンテキストで変数ライブラリを使用する方法について説明します。

変数ライブラリと展開パイプライン

変数ライブラリとその値をデプロイパイプラインにデプロイして、ステージ間で変数値を管理できます。

この重要な情報を覚えておいてください。

変数ライブラリ内のすべての 値セット は、デプロイパイプラインのすべてのステージで使用できますが、1 つのステージでアクティブなセットは 1 つだけです。
各ステージに 設定されたアクティブな値 は、個別に選択されます。いつでも変更できます。
変数ライブラリを最初にデプロイまたはコミットする場合、ライブラリのアクティブなセットには既定値が設定されます。この値を変更するには、ターゲットステージまたはリポジトリで新しく作成された変数ライブラリにアクセスし、アクティブなセットを変更します。
デプロイは、各ステージで 設定された選択されたアクティブな値 には影響しませんが、変数ライブラリ内の値自体を更新できます。ワークスペース内のコンシューマー項目 (パイプラインなど) は、アクティブな値セットから正しい値を自動的に受け取ります。

デプロイパイプラインの 1 つのステージで変数または値セットに対する次の操作を実行すると、変数ライブラリが異なるステージの同じ項目と比較して異なるフォームソースとして反映されます。

2 つのステージで異なる変数ライブラリと比較されたデプロイパイプラインのスクリーンショット。

アクティブな値セットを簡単に変更しても、比較時に 異なるフォームソース として登録されません。アクティブな値セットは項目構成の一部ですが、定義には含まれません。そのため、デプロイパイプラインの比較には表示されず、各デプロイでは上書きされません。

他の Fabric 項目と同様に、変数ライブラリを Git と統合してソース管理を行うことができます。変数ライブラリ項目は、Fabric と Git プロバイダーの間で維持および同期できるフォルダーとして格納されます。

項目のアクセス許可は、Git の更新とコミット中に確認されます。

変数ライブラリ項目のスキーマは、次の 4 つの部分を含む JSON オブジェクトです。

変数ライブラリファイルが含まれる Git フォルダーのスクリーンショット。

変数ライブラリフォルダーには、 valueSetsという名前のサブフォルダーが含まれています。このフォルダーには、各値セットの JSON ファイルが含まれています。この JSON ファイルには、その値セット内の 既定値以外 の変数値のみが含まれます。

値セット・ファイルの詳細については、値セットおよび値セットの例を参照してください。

このファイルにない変数の値は、既定値セットから取得されます。

settings.json ファイルには、変数ライブラリの設定が含まれています。

詳細については、変数と settings.json の例を参照してください。

variables.json ファイルには、変数名とその既定値が含まれています。

詳細については、 variables.json の例を参照してください。

次の両方の要件を満たしている限り、 最大 1,000 個の変数と 最大 1,000 個の値セットを使用できます。
- 代替値セット内のセルの合計数が 10,000 未満です。
- 項目のサイズが 1 MB を超えていない。
これらの要件は、変更を保存するときに検証されます。
メモフィールドの文字数は最大 2,048 文字です。
値セットの説明フィールドには、最大 2,048 文字を指定できます。

変数ライブラリの代替値セットは、追加した順序で表示されます。現時点では、UI で並べ替えることはできません。順序を変更するには、JSON ファイルを直接編集します。
各値セットの名前は、変数ライブラリ内で一意である必要があります。
変数名は、変数ライブラリ内で一意である必要があります。異なるアイテム内にある場合は、ワークスペース内に同じ名前の 2 つの変数を含めることができます。
変数ライブラリには、常に 1 つのアクティブな値が一度に 1 つしか設定されていません。アクティブな間は、値セットを削除できません。削除するには、まず別の値セットをアクティブに構成します。デプロイパイプラインのステージごとに異なるアクティブな値を設定できます。

このページはお役に立ちましたか?