App Configuration wird konfiguriert

DevOps Insights wird am 31. August 2026 das Ende des Betriebs erreichen und eingestellt werden. Continuous Delivery wird am 12. Februar 2027 in den folgenden Regionen eingestellt: au-syd, ca-tor, us-east. Code Risk Analyzer wird zu diesem Zeitpunkt ebenfalls in allen Regionen eingestellt. Wenn diese Funktionen in einer Region nicht aktiv genutzt werden, können sie in dieser Region vorzeitig eingestellt werden, sodass keine neuen Instanzen mehr akzeptiert werden. Weitere Informationen

IBM Cloud® App Configuration ist ein zentraler Featuremanagement- und Konfigurationsservice, der einen komfortablen, konsistenten und sicheren Ansatz für den Zugriff auf, die Referenzierung und die Wiederverwendung von Sammlungen von Feature-Flags und Eigenschaften in Toolchains bietet.

Sie können eine App Configuration-Instanz über das Dashboard der Serviceinstanz App Configuration konfigurieren, um bestimmte Umgebungen und Sammlungen hinzuzufügen und zu verwalten, die Gruppen von Feature-Flags und Eigenschaften enthalten. Sie können die Verwendung von Feature-Flags und -Eigenschaften weiter eingrenzen, indem Sie Zielsegmente angeben, die basierend auf Benutzerattributen und Regeln ausgewertet werden.

Sie können auch eine App Configuration-Toolintegration zu einer Toolchain hinzufügen und bestimmte Feature-Flags oder -Eigenschaften aus der Serviceinstanz auf die Umgebung oder Auslösereigenschaften der zugeordneten Pipeline anwenden. Sie können diesen Prozess bei Bedarf über mehrere Toolchains wiederholen, indem Sie App Configuration-Serviceinstanzen verwenden. Sie können beispielsweise eine Serviceinstanz verwenden, um alle Feature-Flags und -Eigenschaften, die für Toolchains in mehreren Umgebungen erforderlich sind, zentral zu speichern.

Wenn Sie Feature-Flags oder -Eigenschaften auf eine Toolchain anwenden, werden spezielle App Configuration-Feature-Flags und -Eigenschaftsreferenzen in der Toolchain statt in den Literalwerten gespeichert. Dieses Feature unterstützt die zentrale Verwaltung von Feature-Flags und -Eigenschaften direkt aus einer App Configuration-Serviceinstanz. Werte von Feature-Flags und -Eigenschaften sind dann sofort für Toolchains verfügbar, die bei nachfolgenden Pipelineausführungen Referenzen auf diese Feature-Flag- und -Eigenschaftenwerte enthalten.

Eine App Configuration-Integration erstellen

Bevor Sie eine App Configuration-Toolintegration in Ihrer Toolchain erstellen, stellen Sie sicher, dass Sie eine Instanz des App Configuration-Service in einer Region und Ressourcengruppe bereitstellen, auf die Ihre Toolchain verweisen kann.

  1. Wenn Sie diese Toolintegration beim Erstellen der Toolchain konfigurieren und eine App Configuration-Toolintegration in der Vorlage vorhanden ist, die Sie konfigurieren, klicken Sie auf die Registerkarte App Configuration. Alternativ dazu können Sie im Abschnitt Weitere Tools auf App Configurationklicken. Wählen Sie zum Erstellen einer Berechtigung zwischen der Toolchain und der App Configuration-Serviceinstanz die Option Berechtigung für diese Toolchain erstellen aus der Dropdown-Liste Berechtigungstyp aus. Dadurch erhält die Toolchain Zugriff auf die Feature-Flags und Eigenschaften, die in der Serviceinstanz App Configuration gespeichert sind.

  2. Wenn Sie bereits über eine Toolchain verfügen und diese Tool-Integration hinzufügen möchten, klicken Sie in der IBM Cloud-Konsole auf das Menü-Symbol ( Hamburger-Symbol ) > Platform Automation > Toolchains. Klicken Sie auf der Seite Toolchains auf die vorhandene Toolchain, um die zugehörige Übersichtsseite zu öffnen.

    a. Klicken Sie auf Tool hinzufügen.

    b. Klicken Sie im Abschnitt mit den Toolintegrationen auf App Configuration.

  3. Geben Sie den Namen ein, der für diese neue Toolintegration auf der Karte App Configuration in Ihrer Toolchain angezeigt werden soll. Dieser Name wird verwendet, um die Werkzeugintegration in Ihrer Toolchain zu identifizieren.

  4. Wählen Sie die Region und die Ressourcengruppe aus, in denen sich Ihre App Configuration-Serviceinstanz befindet.

  5. Wählen Sie die entsprechenden Optionen App Configuration-Umgebung und App Configuration-Sammlung aus Ihrer ausgewählten App Configuration-Serviceinstanz aus.

  6. Um eine Berechtigung zwischen der Toolchain und der Serviceinstanz von App Configuration zu erstellen, klicken Sie auf die Schaltfläche Berechtigung erstellen. Dadurch erhält die Toolchain Zugriff auf die Feature-Flags und Eigenschaften, die in der Serviceinstanz App Configuration gespeichert sind.

  7. Klicken Sie auf Integration erstellen.

Feature-Flags und -Eigenschaften anwenden

Nachdem Sie Ihre App Configuration-Toolintegration konfiguriert haben, können Sie sie verwenden, um Feature-Flags und -Eigenschaften auf die Toolchain-Umgebung und auf Auslösereigenschaften anzuwenden.

  1. Klicken Sie auf der Registerkarte mit den Umgebungseigenschaften der Pipeline oder auf der Registerkarte mit den Auslösereigenschaften auf Hinzufügen, um die Liste der verfügbaren Eigenschaftstypen anzuzeigen.

  2. Wählen Sie AppConfig-Wert aus und wählen Sie die Feature-Flags oder -Eigenschaften aus, die Sie auf die Toolchain-Umgebung und die Auslösereigenschaften anwenden möchten.

  3. Geben Sie den Namen für die neue Toolchain-Umgebung oder Auslösereigenschaft an.

  4. Wählen Sie die App Configuration-Toolintegration und eine Umgebung und eine Sammlung darin aus.

  5. Wählen Sie Feature-Flag oder Eigenschaft aus und wählen Sie in der Liste in Ihrer App Configuration-Serviceinstanz das Flag oder die Eigenschaft des Zielfeatures aus.

  6. Klicken Sie auf OK, um eine App Configuration-Referenz auf das zugehörige Feld anzuwenden.

Ihre Toolchain für den Zugriff auf Feature-Flags und -Eigenschaften berechtigen

Referenzen auf Feature-Flags und -Eigenschaften, die in einer App Configuration-Serviceinstanz gespeichert sind, werden dynamisch aufgelöst, wenn die Toolchain ausgeführt wird. Für den Zugriff auf die erforderlichen Feature-Flags und -Eigenschaften müssen Sie Ihre Toolchain für den Zugriff auf die App Configuration-Instanz berechtigen. Wenn Sie eine Toolchain aus einer Vorlage erstellen, verwenden Sie die Dropdown-Liste Berechtigungstyp bei der Konfiguration der Integration von App Configuration. Wenn Sie eine App Configuration-Integration zu einer vorhandenen Toolchain hinzufügen, verwenden Sie die Schaltfläche Berechtigung erstellen.

Führen Sie die folgenden Schritte aus, um Ihre Autorisierungen in IBM Cloud anzuzeigen:

  1. Klicken Sie in der IBM Cloud-Konsole auf Verwalten > Zugriff (IAM).
  2. Klicken Sie auf Autorisierungen.

Sie können Ihre Berechtigungen auch auf der Seite Berechtigungen verwalten einsehen.

Sie können die Berechtigung bei Bedarf auch manuell erstellen. Damit App Configuration-Referenzen erfolgreich aufgelöst werden können, muss Ihre Toolchain-Instanz sowohl über Viewer- als auch über Reader-Zugriff auf die richtige App Configuration-Serviceinstanz verfügen.

App Configuration-Konfiguration mithilfe der API

Die App Configuration Tool-Integration unterstützt die folgenden Konfigurationsparameter, die Sie mit der HTTP Toolchain-API und den SDKs verwenden können, wenn Sie Tool-Integrationen erstellen, lesen und aktualisieren.

Sie müssen die Eigenschaft tool_type_id im Anforderungshauptteil mit dem Wert appconfig angeben.

parameter für die WerkzeugintegrationApp Configuration
Parameter Verwendung Typ Terraform-Argument Beschreibung
datensammlungsname erforderlich, aktualisierbar Zeichenfolge Sammlungs-ID Die ID der App Configuration-Sammlung.
Umgebungsname erforderlich, aktualisierbar Zeichenfolge Umgebungs-id Die ID der App Configuration-Umgebung
instance-name erforderlich, aktualisierbar Zeichenfolge instance_id Die guid der App Configuration-Serviceinstanz.
Name erforderlich, aktualisierbar Zeichenfolge Name Der Name dieser Toolintegration. App Configuration-Referenzen enthalten diesen Namen, um die App Configuration-Instanz zu identifizieren, in der sich die Konfigurationswerte befinden. Stellen Sie sicher, dass jedes der App Configuration-Tools, die in eine Toolchain integriert sind, einen eindeutigen Namen hat, damit die Auflösung ordnungsgemäß funktioniert.
Bereich erforderlich, aktualisierbar Zeichenfolge Standort Die Position IBM Cloud, an der sich die Serviceinstanz von App Configuration befindet.
Ressourcengruppe erforderlich, aktualisierbar Zeichenfolge resource_group_name Der Name der Ressourcengruppe, in der sich die App Configuration-Serviceinstanz befindet.

Weitere Informationen zu App Configuration

Weitere Informationen zu App Configuration finden Sie in Einführung in App Configuration.