Integrazione di un progetto con un repository Git

Collega un progetto a un repository Git per salvare lì le configurazioni. In questo modo, puoi utilizzare il tuo repository e gli strumenti CI e CD che preferisci per automatizzare le pipeline sulle configurazioni in un progetto.

Questa è una funzionalità sperimentale disponibile a scopo di valutazione e test e potrebbe cambiare senza preavviso.

Le pipeline e le toolchain sono personalizzabili, così puoi automatizzare numerose azioni tra il tuo repository Git e il tuo progetto utilizzando metodi API di progetto o comandi CLI. Ad esempio, puoi creare una pipeline per attivare un aggiornamento nel tuo progetto quando le modifiche alla configurazione vengono unite al ramo principale del tuo repository. Per ulteriori informazioni, consulta Automazione delle azioni dei progetti nel repository Git.

In un progetto, le bozze di configurazione possono essere salvate in qualsiasi ramo del repository. Tuttavia, è possibile convalidare e distribuire le configurazioni di bozza solo dopo averle unite al ramo nel repository che gestisce le pipeline CD. È inoltre necessario sincronizzare gli aggiornamenti dal repository al progetto aggiornando le configurazioni prima di poter convalidare e distribuire tali configurazioni. È possibile automatizzare questo aggiornamento utilizzando il metodo API project.config.update oppure il comando CLI ibmcloud project config-update.

Prima di iniziare

Assicurati di disporre del ruolo di Editor sul servizio Progetti IBM Cloud per gestire le integrazioni del repository Git.
Salva un token di accesso come segreto per connetterti al tuo repository Git. Il token di accesso necessita dell'accesso in scrittura ai rami che vuoi utilizzare e per creare commit nel tuo repository. Il token di accesso deve inoltre essere in grado di elencare i rami e di leggerli.
1. Crea un'istanza del servizio Secrets Manager nel tuo account IBM Cloud. Per creare un segreto, è necessario avere il ruolo Writer o superiore sul servizio Secrets Manager.
2. Dopo aver creato la tua istanza segreta, assicurati di selezionare Altro tipo di segreto per aggiungere un segreto arbitrario. Per informazioni sulla creazione di un segreto arbitrario, vedere Creazione di segreti arbitrari nell'interfaccia utente. Il tuo segreto arbitrario deve contenere il token di accesso per il tuo repository Git.

Collegare un progetto a un repository Git

Collega il tuo repository Git al tuo progetto. In questo modo, le modifiche alla configurazione vengono salvate nel repository e non nel file JSON del progetto. Poiché il progetto deve salvare le configurazioni nel repository, è necessario fornire un token di accesso per autenticarsi con il repository dal progetto.

Nella console IBM Cloud, fai clic sull'icona del menu di navigazione > Progetti e seleziona un progetto.
Dalla scheda Gestisci, seleziona Integrazioni.
Nella sezione Integrazione del repository Git, fare clic su Connetti.
Dal menu Tipo di repository, seleziona il tipo di repository che desideri utilizzare per gestire le tue configurazioni. In genere, questo repository è quello utilizzato per gestire pipeline e toolchain. Puoi selezionare GitHub, GitLab o GitHub Enterprise.
Inserire l' URL del repository.
Facoltativamente, specificare una cartella all'interno del repository. Se vuoi integrare il tuo repository con più progetti, prendi in considerazione la possibilità di specificare una cartella. Ogni progetto può avere la propria cartella.
Passa il mouse o fai clic sul campo del token di accesso, quindi fai clic sull'icona Segreti Icona per selezionare il segreto che contiene il tuo token di accesso.
Se il progetto contiene già delle configurazioni, selezionare Copia i file di configurazione esistenti in questo archivio per salvare le configurazioni esistenti nell'archivio.
Fare clic su Salva.

Passi successivi

Ora che il tuo repository Git è connesso al tuo progetto, sei pronto per personalizzare pipeline e toolchain. Per informazioni su come creare una pipeline che aggiorni automaticamente le configurazioni nel progetto quando le modifiche vengono unite al ramo principale, consulta Automazione delle azioni dei progetti nel repository Git.