Configuration de App Configuration

DevOps Insights Le service prendra fin et sera interrompu le 31 août 2026. Le service Continuous Delivery sera interrompu dans les régions suivantes le 12 février 2027 : au-syd, ca-tor, us-east. Code Risk Analyzer sera également retiré du marché dans toutes les régions à cette date. Si ces fonctionnalités ne sont pas activement utilisées dans une région donnée, elles pourraient y être supprimées plus tôt et ne plus accepter de nouvelles instances. En savoir plus

IBM Cloud® App Configuration est un service de gestion et de configuration de fonctions centralisé qui offre une approche pratique, cohérente et sécurisée pour l'accès, le référencement et la réutilisation des collections d'indicateurs de fonction et de propriétés dans les chaînes d'outils.

Vous pouvez configurer une instance App Configuration à l'aide du tableau de bord de l'instance de service App Configuration pour ajouter et gérer des environnements et des collections spécifiques contenant des ensembles d'options et de propriétés. Vous pouvez affiner l'utilisation des options et des indicateurs de fonction en spécifiant des segments cible qui sont évalués en fonction des attributs et des règles utilisateur.

Vous pouvez également ajouter une intégration d'outil App Configuration à une chaîne d'outils et appliquer des options ou des indicateurs de fonction spécifiques de l'instance de service à l'environnement ou aux propriétés de déclenchement du pipeline associé. Vous pouvez répéter ce processus sur plusieurs chaînes d'outils à l'aide d'instances de service App Configuration, selon les besoins. Par exemple, vous pouvez utiliser une instance de service pour centralement stocker et gérer tous les indicateurs de fonction et les propriétés requis par les chaînes d'outils dans plusieurs environnements.

Lorsque vous appliquez des indicateurs de fonction ou des propriétés à une chaîne d'outils, les références de propriété et d'indicateur de fonction App Configuration sont sauvegardées dans la chaîne d'outils au lieu des valeurs littérales. Cette fonction prend en charge la gestion centralisée des options et des indicateurs de fonction directement à partir d'une instance de service App Configuration. Les indicateurs de fonction et les valeurs de propriété sont alors immédiatement disponibles pour les chaînes d'outils qui contiennent des références aux indicateurs de fonction et aux valeurs de propriété lors des exécutions de pipeline suivantes.

Création d'une intégration App Configuration

Avant de créer une intégration d'outil App Configuration dans votre chaîne d'outils, assurez-vous de fournir une instance du service App Configuration dans une région et un groupe de ressources auquel votre chaîne d'outils peut faire référence.

  1. Si vous configurez cette intégration d'outils lorsque vous créez la chaîne d'outils et qu'une intégration d'outils App Configuration existe dans le modèle que vous configurez, cliquez sur l'onglet App Configuration. Vous pouvez également cliquer sur App Configurationdans la section Plus d'outils. Pour créer une autorisation entre la chaîne d'outils et l'instance de service App Configuration, sélectionnez l'option Créer une autorisation pour cette chaîne d'outils dans la liste déroulante Type d'autorisation. Cela permet à la chaîne d'outils d'accéder aux indicateurs de fonction et aux propriétés stockés dans l'instance de service App Configuration.

  2. Si vous disposez déjà d'une chaîne d'outils et que vous souhaitez y ajouter l'intégration de cet outil, dans la console IBM Cloud, cliquez sur l'icône de menu (icône en forme de hamburger) > Automatisation de la plateforme > Chaînes d'outils. Dans la page Chaînes d'outils, cliquez sur la chaîne d'outils existante pour ouvrir sa page Présentation.

    a. Cliquez sur Ajouter un outil.

    b. Dans la section Intégrations d'outils, cliquez sur App Configuration.

  3. Entrez le nom que vous souhaitez afficher pour cette nouvelle intégration d'outil sur la carte App Configuration de votre chaîne d'outils. Ce nom est utilisé pour identifier l'intégration d'outils dans votre chaîne d'outils.

  4. Sélectionnez la région et le groupe de ressources où votre instance de service App Configuration existe.

  5. Sélectionnez les options des environnement de la configuration de l'application et de la collecte de la configuration de l'application appropriées à partir de l'instance de service App Configuration choisie.

  6. Pour créer une autorisation entre la chaîne d'outils et l'instance de service App Configuration, cliquez sur le bouton Créer une autorisation. Cela permet à la chaîne d'outils d'accéder aux indicateurs de fonction et aux propriétés stockés dans l'instance de service App Configuration.

  7. Cliquez sur Créer une intégration.

Application des options et des indicateurs de fonction

Après avoir configuré votre intégration d'outil App Configuration, vous pouvez l'utiliser pour appliquer des options et des indicateurs de fonction à l'environnement de la chaîne d'outils et aux propriétés de déclenchement.

  1. Dans l'onglet Propriétés de l'environnement de pipeline ou l'onglet Propriétés du déclencheur, cliquez sur Ajouter pour afficher la liste des types de propriété disponibles.

  2. Sélectionnez Valeur de la configuration de l'application et choisissez les options ou les indicateurs de fonction que vous souhaitez appliquer à l'environnement de la chaîne d'outils et aux propriétés de déclenchement.

  3. Indiquez le nom de la nouvelle propriété d'environnement de chaîne d'outils ou de déclencheur.

  4. Sélectionnez l'intégration de l'outil App Configuration et l'environnement et la collecte.

  5. Sélectionnez l'indicateur de fonction ou la propriété et dans la liste de votre instance de service App Configuration, choisissez l'indicateur ou la propriété de la fonction cible.

  6. Cliquez sur OK pour appliquer une référence App Configuration à la zone qui lui est associée.

Autorisation de votre chaîne d'outils pour accéder aux indicateurs d'options et de fonction

Les références aux indicateurs de fonction et aux propriétés stockées dans une instance de service App Configuration sont résolues de manière dynamique lors de l'exécution de la chaîne d'outils. Pour accéder aux options et aux options de fonction requises, vous devez autoriser votre chaîne d'outils à accéder à l'instance App Configuration. Si vous créez une chaîne d'outils à partir d'un modèle, utilisez la liste déroulante Type d'autorisation lors de la configuration de l'intégration App Configuration. Si vous ajoutez une intégration App Configuration à une chaîne d'outils existante, utilisez le bouton Créer une autorisation.

Pour afficher vos autorisations dans IBM Cloud, procédez comme suit :

  1. Dans la console d' IBM Cloud, cliquez sur Gérer > Accès (IAM).
  2. Cliquez sur Autorisations.

Vous pouvez également accéder à vos autorisations sur la page Gérer les autorisations.

Vous pouvez également créer l'autorisation manuellement, si nécessaire. Pour résoudre avec succès les références App Configuration, votre instance de chaîne d'outils doit avoir à la fois un accès Viewer et Reader à l'instance de service App Configuration correcte.

Configuration d' App Configuration à l'aide de l'API

L'intégration App Configuration d'outils prend en charge les paramètres de configuration suivants que vous pouvez utiliser avec l 'API HTTP Toolchain et les SDK lorsque vous créez, lisez et mettez à jour des intégrations d'outils.

Vous devez spécifier la propriété tool_type_id dans le corps de la demande avec la valeur appconfig.

App Configuration Paramètres d'intégration de l'outil
Paramètre Utilisation Type Argument Terraform Description
nom-collection requis, pouvant être mis à jour Chaîne collection_id L'identifiant de la collection App Configuration.
nom-environnement requis, pouvant être mis à jour Chaîne environment_id ID de l'environnement App Configuration.
nom d'instance requis, pouvant être mis à jour Chaîne instance_ID guid de l'instance de service App Configuration.
nom requis, pouvant être mis à jour Chaîne nom Nom de cette intégration d'outils. Les références App Configuration incluent ce nom pour identifier l'instance App Configuration dans laquelle résident les valeurs de configuration. Assurez-vous que chacun des outils App Configuration qui sont intégrés dans une chaîne d'outils possède un nom unique pour que la résolution puisse fonctionner correctement.
région requis, pouvant être mis à jour Chaîne emplacement Emplacement IBM Cloud où se trouve l'instance de service App Configuration.
groupe-ressources requis, pouvant être mis à jour Chaîne resource_group_name Nom du groupe de ressources dans lequel se trouve l'instance de service App Configuration.

Plus d'informations sur App Configuration

Pour en savoir plus sur App Configuration, voir Initiation à App Configuration.