Configurazione di Git Repos and Issue Tracking

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 anticipatamente e non accettare più nuove istanze. Per saperne di più

L' Git Repos and Issue Tracking integrazione dello strumento si basa su GitLab Community Edition, un servizio di hosting basato sul web per i repository (repos) di Git. Puoi avere sia copie locali che remote dei tuoi repository. Per ulteriori informazioni, consultare Git Repos and Issue Tracking.

Se stai configurando Git Repos and Issue Tracking mentre stai creando la toolchain, attieniti alla seguente procedura:

Nella sezione Integrazioni configurabili, fai clic su Git Repos and Issue Tracking.
Rivedi le ubicazioni di destinazione predefinite per i repository Git. Questi repository vengono clonati dai repository di esempio. Se necessario, modifica i nomi dei repository di destinazione.

Se hai una toolchain e vuoi migrare un repository Git presente nella tua toolchain a Git Repos and Issue Tracking, completa la seguente procedura:

Queste istruzioni si applicano alle toolchain che già contengono il repository Git da migrare a Git Repos and Issue Tracking. Per informazioni sull'aggiunta di diversi tipi di Git repos alla tua toolchain, consulta Configurazione GitHub e Configurazione GitLab.

Dalla console IBM Cloud, fare clic Menu > Automazione piattaforma > Toolchain. Nella pagina Toolchains, fai clic sulla toolchain per aprirne la pagina di panoramica.
Fai clic su Aggiungi.
Nella sezione Integrazioni strumento, fai clic su Git Repos and Issue Tracking.
Seleziona il server a cui vuoi distribuire le modifiche al codice. Dopo aver creato l'integrazione, puoi modificarla per gestire l'elenco di server che sei autorizzato a gestire. Fai clic su Manage Authorization per visualizzare un elenco di tutti i server e per eliminare il token che hai fornito per autorizzare il server.
Per creare una copia del repository Git, per il tipo di repository, fai clic su Clone. Immetti un nuovo nome per il repository e l'URL per il repository di origine.
Il tuo nome utente viene automaticamente selezionato per assegnare la proprietà di questa nuova integrazione a te stesso. Dopo aver creato l'integrazione, un altro utente autorizzato può riassegnare la proprietà dell'integrazione a se stesso quando la modifica.
Se vuoi creare un repository privato, seleziona la casella di spunta Make this repository private.
Se desideri utilizzare Issues per la traccia del problema, seleziona la casella di spunta Enable GitLab Issues.
Se desideri tracciare la distribuzione delle modifiche del codice creando tag e commenti nei commit e le etichette e i commenti sui problemi a cui fanno riferimento i commit, seleziona la casella di spunta Track deployment of code changes.
Fai clic su Crea integrazione.

Dopo aver clonato il repository Git, puoi rimuoverlo dalla tua toolchain.

Se hai una toolchain e stai aggiungendo Git Repos and Issue Tracking a essa, attieniti alla seguente procedura:

Dalla console IBM Cloud, fare clic Menu > Automazione piattaforma > Toolchain. Nella pagina Toolchains, fai clic sulla toolchain per aprirne la pagina di panoramica.
Fai clic su Add tool.
Nella sezione Integrazioni strumento, fai clic su Git Repos and Issue Tracking.
Seleziona il server a cui vuoi distribuire le modifiche al codice. Dopo aver creato l'integrazione, puoi modificarla per gestire l'elenco di server che sei autorizzato a gestire. Fai clic su Manage Authorization per visualizzare un elenco di tutti i server e per eliminare il token che hai fornito per autorizzare il server.
Seleziona un tipo di repository:

a. Per creare un repository vuoto, per il tipo di repository, fai clic su New e immetti il nome del repository. b. Per biforcare un repository Git in modo che sia possibile fornire le modifiche attraverso le richieste di unione, per il tipo di repository, fai clic su Fork. Immetti l'URL per il repository di origine. c. Per creare una copia di un repository Git, per il tipo di repository, fai clic su Clone. Immetti un nuovo nome per il repository e l'URL per il repository di origine. d. Se hai un repository Git e desideri utilizzarlo, per il tipo di repository, fai clic su Existing. Immetti l'URL per il repository di origine.
Il tuo nome utente viene automaticamente selezionato per assegnare la proprietà di questa nuova integrazione a te stesso. Dopo aver creato l'integrazione, un altro utente autorizzato può riassegnare la proprietà dell'integrazione a se stesso quando la modifica.
Se vuoi creare un repository privato, seleziona la casella di spunta Make this repository private.
Se desideri utilizzare Issues per la traccia del problema, seleziona la casella di spunta Enable GitLab Issues.
Se desideri tracciare la distribuzione delle modifiche del codice creando tag e commenti nei commit e le etichette e i commenti sui problemi a cui fanno riferimento i commit, seleziona la casella di spunta Track deployment of code changes.
Fai clic su Crea integrazione.
Dalla pagina Panoramica della tua toolchain, sulla carta Repository, fai clic sul repository Git con cui vuoi lavorare. Viene aperta la pagina della panoramica del tuo progetto.

Se non hai i privilegi Master o Proprietario per il repository a cui sei collegato, la tua integrazione è limitata perché non puoi utilizzare un webhook. I webhook sono richiesti per eseguire automaticamente una pipeline quando si esegue il push di un commit al repository. Senza un webhook, devi avviare le tue pipeline manualmente.

Configurazione di Git Repos and Issue Tracking utilizzando l'API

L'integrazione dello strumento Git Repos and Issue Tracking supporta i seguenti parametri di configurazione che possono essere utilizzati con l'API e gli SDK di Toolchain HTTP quando si creano, leggono e aggiornano le integrazioni degli strumenti.

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

parametri di integrazione dello strumentoGit Repos and Issue Tracking
Parametro	Utilizzo	Immettere	Argomento Terraform	Descrizione
url root API	facoltativo, aggiornabile	Stringa	url root API	URL dell'API Git Repos and Issue Tracking.
token API	facoltativo, aggiornabile	Password	token API	Il token di accesso personale (PAT). Questo parametro è obbligatorio solo se `auth_type` è impostato su `pat`, altrimenti viene ignorato.
auth_type	facoltativo, aggiornabile, `Default: oauth`	Stringa	auth_type	Imposta il metodo di autenticazione da utilizzare per accedere al provider Git.
diramazione predefinita	facoltativo, aggiornabile	Stringa	diramazione predefinita	Il nome del ramo predefinito del repository Git.
enable_traceability	facoltativo, aggiornabile, `Default: false`	Booleano	enable_traceability	Imposta questo valore su " `true` " per monitorare l'implementazione delle modifiche al codice tramite la creazione di tag, etichette e commenti su commit, pull request e issue di riferimento.
id_git	facoltativo, immutabile	Stringa	id_git	Imposta questo valore su `hostedgit` per la destinazione Git Repos and Issue Tracking.
has_issues	facoltativo, aggiornabile, `Default: true`	Booleano	problemi_della_catena_strumenti_abilitati	Imposta questo valore su `true` per abilitare i problemi sul repository Git Repos and Issue Tracking e aggiungi una scheda di integrazione dello strumento Issues alla toolchain. Imposta questo valore su `false` per rimuovere la scheda di integrazione dello strumento dalla toolchain. Questa azione non influisce sul fatto che i problemi siano abilitati sul repository Git Repos and Issue Tracking.
proprietario_integrazione	facoltativo, aggiornabile	Stringa	proprietario_integrazione	Selezionare l'utente con cui vengono eseguite le operazioni Git.
id_proprietario	facoltativo, immutabile	Stringa	id_proprietario	L'utente o il gruppo Git Repos and Issue Tracking che possiede il repository. Questo parametro è obbligatorio quando crei un repository o cloni o biforca un repository. Questo valore viene calcolato quando ti colleghi a un repository esistente.
repo privato	facoltativo, immutabile, `Default: true`	Booleano	repo privato	Imposta questo valore su `true` per rendere il repository privato quando crei un repository o quando cloni o biforchi un repository. Questo parametro non viene utilizzato quando ti colleghi a un repository esistente.
id_repo	facoltativo, immutabile	Stringa	id_repo	L'ID del progetto " Git Repos and Issue Tracking ".
repo_name	facoltativo, immutabile	Stringa	repo_name	Il nome del repository " Git Repos and Issue Tracking " da creare. Questo parametro è obbligatorio quando crei un repository o cloni o biforca un repository. Questo valore viene calcolato quando ti colleghi a un repository esistente.
repo_url	facoltativo, immutabile	Stringa	repo_url	Il sito URL del repo Git Repos and Issue Tracking per l'integrazione di questo strumento. Questo parametro è obbligatorio quando ti colleghi a un repository esistente. Questo valore viene calcolato quando crei un repository o cloni o biforca un repository.
url_repo_origine	facoltativo, immutabile	Stringa	url_repo_origine	L'indirizzo URL del repo di cui si vuole fare il fork o il clone. Questo parametro è obbligatorio quando esegui il fork o la clonazione di un repository, ma non viene utilizzato quando crei un repository o un link a un repository esistente.
url_token	facoltativo, aggiornabile	Stringa	url_token	Il token URL che viene usato per autorizzare il server Git Repos and Issue Tracking.
Immettere	richiesto, immutabile	Stringa	Immettere	L'operazione da eseguire per inizializzare la nuova integrazione dello strumento. Utilizza `new` per creare un repository Git, `clone` per clonare un repository Git esistente in un nuovo repository Git, `fork` per biforcare un repository Git esistente o `link` per collegarlo a un repository Git esistente.

Se hai effettuato l'accesso IBM Cloud utilizzando un profilo attendibile, quando configuri un'integrazione Git Repos and Issue Tracking dello strumento devi utilizzare il metodo di autenticazione Token di accesso personale. Il metodo di autenticazione OAuth è incompatibile con l'autenticazione Trusted Profiles.The Personal Access Token (PAT) consente di configurare l'integrazione dello strumento Git Repos and Issue Tracking tramite GUI, API o Terraform. Questo perché il PAT è legato all'utente effettivo che possiede il profilo di fiducia. Gli utenti possono usare i loro token di accesso personali per creare o riconfigurare le integrazioni dello strumento Git Repos and Issue Tracking nella toolchain. Tuttavia, per accedere all'interfaccia utente del repo Git, devono effettuare il login come utente normale.