IBM Cloud Docs
App Configuration の構成

App Configuration の構成

IBM Cloud® App Configuration は、一元化されたフィーチャー管理および構成サービスであり、ツールチェーン内の機能フラグおよびプロパティーの集合にアクセスし、それらを参照し、再利用するための、便利で一貫性のあるセキュアなアプローチを提供します。

App Configuration サービス・インスタンス・ダッシュボードを使用して、機能フラグとプロパティーのセットを含む特定の環境および集合を追加および管理することにより、 App Configuration インスタンスを構成できます。 ユーザー属性とルールに基づいて評価するターゲット・セグメントを指定することにより、機能フラグとプロパティーの使用をさらに絞り込むことができます。

また、 App Configuration ツール統合をツールチェーンに追加し、サービス・インスタンスの特定の機能フラグまたはプロパティーを、関連するパイプラインの環境プロパティーまたはトリガー・プロパティーに適用することもできます。 必要に応じて、 App Configuration サービス・インスタンスを使用して、複数のツールチェーンにわたってこのプロセスを繰り返すことができます。 例えば、サービス・インスタンスを使用して、複数の環境にわたるツールチェーンに必要なすべての機能フラグとプロパティーを一元的に保管して管理することができます。

機能フラグまたはプロパティーをツールチェーンに適用すると、特殊な App Configuration 機能フラグおよびプロパティー参照が、リテラル値ではなくツールチェーン内に保存されます。 この機能は、 App Configuration サービス・インスタンスから直接、機能フラグおよびプロパティーの一元的な管理をサポートします。 機能フラグとプロパティー値は、後続のパイプライン実行時に、それらの機能フラグとプロパティー値への参照を含むツールチェーンですぐに使用可能になります。

App Configuration 統合の作成

ツールチェーン内に App Configuration ツール統合を作成する前に、ツールチェーンが参照できるリージョンおよびリソース・グループに App Configuration サービスのインスタンスをプロビジョンする必要があります。

  1. ツールチェーン作成時にこのツール統合を構成していて、構成するテンプレート内に App Configuration ツール統合が存在する場合は、 App Configuration タブをクリックします。 あるいは、**「その他のツール (More tools)」セクションで「App Configuration」**をクリックします。 ツールチェーンと App Configuration サービス・インスタンスの間に許可を作成するには、 「許可タイプ」 ドロップダウンから 「このツールチェーンの許可を作成します」 オプションを選択します。 これにより、 App Configuration サービス・インスタンスに保管されている機能フラグおよびプロパティーへのアクセス権限がツールチェーンに付与されます。

  2. 既存のツールチェーンがあり、そこにこのツール統合を追加する場合、IBM Cloudコンソールから、メニューアイコンの ハンバーガーアイコン>Platform Automation>Toolchains をクリックします。 「ツールチェーン」ページで、既存のツールチェーンをクリックして、その「概要」ページを開きます。 あるいは、アプリの「概要」ページの「継続的デリバリー」カードで、**「ツールチェーンの表示」をクリックします。 次に、「概要」**をクリックします。

    a. **「ツールの追加」**をクリックします。

    b. 「ツール統合」セクションで**「App Configuration」**をクリックします。

  3. ツールチェーンの App Configuration カードに、この新しいツール統合のために表示する名前を入力します。 この名前は、ツールチェーン内でこのツール統合を識別するために使用されます。

  4. App Configuration サービス・インスタンスが存在する リージョン および リソース・グループ を選択します。

  5. 選択した App Configuration サービス・インスタンスから、適切な App Configuration 環境 オプションと App Configuration コレクション オプションを選択します。

  6. ツールチェーンと App Configuration サービス・インスタンスの間に許可を作成するには、 「許可の作成」 ボタンをクリックします。 これにより、 App Configuration サービス・インスタンスに保管されている機能フラグおよびプロパティーへのアクセス権限がツールチェーンに付与されます。

  7. 「統合の作成」 をクリックします。

機能フラグおよびプロパティーの適用

App Configuration ツール統合を構成した後、それを使用して、機能フラグとプロパティーをツールチェーン環境およびトリガー・プロパティーに適用できます。

  1. 「パイプライン環境プロパティー」タブまたは「トリガー・プロパティー」タブで、 追加 をクリックして、使用可能なプロパティー・タイプのリストを表示します。

  2. AppConfig 値 を選択し、ツールチェーン環境およびトリガー・プロパティーに適用する機能フラグまたはプロパティーを選択します。

  3. 新しいツールチェーン環境またはトリガー・プロパティーの名前を指定します。

  4. App Configuration ツール統合と、その中から 環境 および コレクション を選択します。

  5. 機能フラグ または プロパティー を選択し、 App Configuration サービス・インスタンス内のリストから、ターゲット機能フラグまたはプロパティーを選択します。

  6. OK をクリックして、関連付けられているフィールドに App Configuration リファレンスを適用します。

機能フラグおよびプロパティーにアクセスするためのツールチェーンの許可

App Configuration サービス・インスタンスに保管されている機能フラグおよびプロパティーへの参照は、ツールチェーンの実行時に動的に解決されます。 必要な機能フラグおよびプロパティーにアクセスするには、ツールチェーンに App Configuration インスタンスへのアクセスを許可する必要があります。 テンプレートからツールチェーンを作成する場合は、 App Configuration 統合を構成するときに 「許可タイプ」 ドロップダウンを使用します。 App Configuration 統合を既存のツールチェーンに追加する場合は、 「許可の作成」 ボタンを使用します。

IBM Cloud で許可を表示するには、以下の手順を実行します。

  1. IBM Cloud コンソールから、「管理」 > **「アクセス (IAM)」**とクリックします。
  2. 「許可」 をクリックします。

また、Manage authorizationsページで自分の権限にアクセスすることもできます。

必要に応じて、手動で許可を作成することもできます。 App Configuration リファレンスを正常に解決するには、ツールチェーン・インスタンスによる、正しい App Configuration サービス・インスタンスに対する Viewer と Reader の両方のアクセス権限の保持が必要です。

APIを使用したApp Configurationの設定

App Configuration ツール統合は、 、 読み取り、および 更新 ツール統合を作成するときに ツールチェーン HTTP API および SDK で使用できる以下の構成パラメーターをサポートします。

appconfig 値を使用して、要求本体に tool_type_id プロパティーを指定する必要があります。

App Configurationツール統合パラメータ
パラメーター 使用法 タイプ Terraform 引数 説明
コレクション名 必須、更新可能 ストリング collection_id App ConfigurationコレクションのID。
環境名 必須、更新可能 ストリング environment_id App Configuration 環境の ID です。
インスタンス名 必須、更新可能 ストリング instance_id App Configuration サービス・インスタンスの guid。
名前 必須、更新可能 ストリング 名前 このツール統合の名前。 App Configuration 参照には、構成値が存在する App Configuration インスタンスを識別するためのこの名前が含まれています。 ツールチェーンに統合されている各 App Configuration ツールが、正しく機能するように解決するための固有の名前を持っていることを確認します。
リージョン 必須、更新可能 ストリング ロケーション App Configuration サービス・インスタンスが配置されている IBM Cloud のロケーション。
リソース・グループ 必須、更新可能 ストリング resource_group_name App Configuration サービス・インスタンスが配置されているリソース・グループの名前。

App Configuration に関する詳細

App Configuration について詳しくは、App Configuration の概説を参照してください。