Configurazione di App Configuration

DevOps Insights Il servizio giungerà al termine e verrà interrotto il 31 agosto 2026. Il servizio " Continuous Delivery " verrà interrotto nelle seguenti regioni il 12 febbraio 2027: au-syd, ca-tor, us-east. A partire da tale data, anche Code Risk Analyzer verrà ritirato dal mercato in tutte le regioni. Se in una regione non si riscontra un utilizzo attivo di queste funzionalità, queste potrebbero essere dismesse in anticipo e non accettare più nuove istanze. Per saperne di più

IBM Cloud® App Configuration è un servizio centralizzato di gestione e configurazione delle funzionalità che offre un approccio pratico, coerente e sicuro per accedere, consultare e riutilizzare raccolte di flag e proprietà delle funzionalità all'interno delle catene di strumenti.

Puoi configurare un'istanza App Configuration utilizzando il dashboard dell'istanza del servizio App Configuration per aggiungere e gestire specifici ambienti e raccolte che contengono serie di indicatori di funzione e proprietà. È possibile perfezionare ulteriormente l'utilizzo degli indicatori di funzione e delle proprietà specificando i segmenti di destinazione che vengono valutati in base a regole e attributi utente.

Puoi anche aggiungere un'integrazione dello strumento App Configuration a una toolchain e applicare le proprietà o gli indicatori della funzione specifici dall'istanza del servizio all'ambiente o alle proprietà del trigger della pipeline associata. Puoi ripetere questo processo su più toolchain utilizzando le istanze del servizio App Configuration, come richiesto. Ad esempio, puoi utilizzare un'istanza del servizio per archiviare e gestire centralmente tutti gli indicatori di funzione e le proprietà richiesti dalle toolchain in diversi ambienti.

Quando si applicano gli indicatori di funzione o le proprietà a una toolchain, i riferimenti speciali App Configuration dell'indicatore di funzione e della proprietà vengono salvati all'interno della toolchain invece che nei valori letterali. Questa funzione supporta la gestione centralizzata degli indicatori e delle proprietà della funzione direttamente da un'istanza del servizio App Configuration. Gli indicatori della funzione e i valori della proprietà sono immediatamente disponibili per le toolchain che contengono riferimenti a tali indicatori della funzione e valori della proprietà durante le successive esecuzioni della pipeline.

Creazione di un'integrazione App Configuration

Prima di creare un'integrazione App Configuration dello strumento nella tua toolchain, assicurati di fornire un'istanza del App Configuration servizio in una regione e in un gruppo di risorse a cui la tua toolchain può fare riferimento.

  1. Se stai configurando l'integrazione di questo strumento mentre crei la toolchain e nel modello che stai configurando è già presente un'integrazione dello strumento App Configuration, fai clic sulla App Configuration scheda. In alternativa, nella sezione " Altri strumenti ", fare clic su App Configuration. Per creare un'autorizzazione tra la toolchain e l'istanza del servizio App Configuration seleziona l'opzione Crea un'autorizzazione per questa toolchain dal menu a discesa Tipo di autorizzazione. Questo concede l'accesso della toolchain agli indicatori della funzione e alle proprietà archiviate nell'istanza di servizio App Configuration.

  2. Se disponi già di una toolchain e desideri aggiungere questa integrazione, dalla IBM Cloud console clicca sull 'icona Menu > Automazione piattaforma > Toolchain. Nella pagina "Toolchains", fare clic sulla toolchain esistente per aprire la relativa pagina di panoramica.

    a. Fai clic su Add tool.

    b. Nella sezione Integrazioni strumento, fai clic su App Configuration.

  3. Digita il nome che desideri visualizzare per questa nuova integrazione di strumenti nella scheda " App Configuration " della tua catena di strumenti. Questo nome viene utilizzato per identificare l'integrazione degli strumenti nella tua toolchain.

  4. Seleziona la Regione e il gruppo di risorse in cui esiste la tua istanza del servizio App Configuration.

  5. Seleziona le opzioni App Configuration Environment e App Configuration Collection appropriate dalla tua istanza del servizio App Configuration scelta.

  6. Per creare un'autorizzazione tra la toolchain e l'istanza del servizio App Configuration fai clic sul pulsante Crea autorizzazione. Questo concede l'accesso della toolchain agli indicatori della funzione e alle proprietà archiviate nell'istanza di servizio App Configuration.

  7. Fai clic su Crea integrazione.

Applicazione di indicatori di funzione e proprietà

Dopo aver configurato la tua integrazione dello strumento App Configuration, puoi utilizzarlo per applicare le proprietà e gli indicatori della funzione all'ambiente della toolchain e alle proprietà di trigger.

  1. Nella scheda Proprietà dell'ambiente Pipeline o nella scheda Proprietà trigger, fare clic su Aggiungi per visualizzare l'elenco dei tipi di proprietà disponibili.

  2. Seleziona AppConfig value e scegli gli indicatori di funzione o proprietà che vuoi applicare all'ambiente della toolchain e alle proprietà del trigger.

  3. Specificare il nome per il nuovo ambiente toolchain o la proprietà trigger.

  4. Seleziona l'integrazione dello strumento App Configuration e un ambiente e una raccolta da esso.

  5. Seleziona Indicatore funzione o Proprietà e dall'elenco all'interno della tua istanza del servizio App Configuration, scegli l'indicatore o la proprietà della funzione di destinazione.

  6. Fare clic su OK per applicare un riferimento App Configuration al campo associato.

Autorizzazione della tua toolchain per accedere agli indicatori e alle proprietà della funzione

I riferimenti agli indicatori e alle proprietà della funzione archiviate in un'istanza del servizio App Configuration vengono risolti dinamicamente quando viene eseguita la toolchain. Per accedere alle proprietà e agli indicatori della funzione richiesti, devi autorizzare la tua toolchain ad accedere all'istanza App Configuration. Se stai creando una toolchain da un template, utilizza l'elenco a discesa Tipo di autorizzazione durante la configurazione dell'integrazione App Configuration. Se stai aggiungendo un'integrazione App Configuration a una toolchain esistente, utilizza il pulsante Crea autorizzazione.

Per visualizzare le tue autorizzazioni in IBM Cloud, completa la seguente procedura:

  1. Dalla console di IBM Cloud, fare clic su Gestisci > Accesso (IAM).
  2. Fare clic su Autorizzazioni.

Puoi anche accedere alle tue autorizzazioni nella pagina Gestisci autorizzazioni.

È anche possibile creare l'autorizzazione manualmente, se necessario. Per risolvere correttamente i riferimenti App Configuration, la tua istanza della toolchain deve disporre dell'accesso sia Viewer che Reader all'istanza del servizio App Configuration corretta.

Configurazione di App Configuration utilizzando la API

L'integrazione App Configuration degli strumenti supporta i seguenti parametri di configurazione che è possibile utilizzare con l 'API HTTP Toolchain e gli SDK durante la creazione, la lettura e l'aggiornamento delle integrazioni degli strumenti.

È necessario specificare la proprietà tool_type_id nel corpo della richiesta con il valore appconfig.

parametri di integrazione dello strumentoApp Configuration
Parametro Utilizzo Immettere Argomento Terraform Descrizione
nome - raccolta richiesto, aggiornabile Stringa id_raccolta L'ID della raccolta App Configuration.
nome - ambiente richiesto, aggiornabile Stringa id_ambiente L'ID dell'ambiente App Configuration.
nome-istanza richiesto, aggiornabile Stringa instance_id Il guid dell'istanza del servizio App Configuration.
nome richiesto, aggiornabile Stringa nome Il nome di questa integrazione dello strumento. I riferimenti App Configuration includono questo nome per identificare l'istanza App Configuration in cui risiedono i valori di configurazione. Assicurati che ciascuno degli strumenti App Configuration integrati in una toolchain abbia un nome univoco per il corretto funzionamento della risoluzione.
regione richiesto, aggiornabile Stringa ubicazione L'ubicazione IBM Cloud dove si trova l'istanza del servizio App Configuration.
gruppo di risorse richiesto, aggiornabile Stringa nome_gruppo_risorse Il nome del gruppo di risorse in cui si trova l'istanza del servizio App Configuration.

Ulteriori informazioni su App Configuration

Per ulteriori informazioni su App Configuration, vedi Introduzione a App Configuration.