Configurazione di GitLab

Continuous Delivery Il servizio 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ù

GitLab è un servizio di hosting basato sul web per i repository Git. Puoi avere sia copie locali che remote dei tuoi repository, ciò rende più semplice la collaborazione.

Puoi configurare GitLab come una integrazione dello strumento nella tua toolchain in modo da poter gestire il codice sorgente in un repository nuovo o esistente su GitLab.com o nell'istanza di GitLab della tua azienda. Partecipa al social coding attraverso wiki, traccia dei problemi e richieste di unione.

Se stai configurando questa integrazione dello strumento mentre stai creando la toolchain, segui questi passi:

  1. Se memorizzi il tuo codice sorgente in un repository GitLab, nella sezione Integrazioni configurabili, fai clic su GitLab. Se si configura l'integrazione di questo strumento su IBM Cloud Public, è necessario autorizzare IBM Cloud ad accedere a GitLab scegliendo tra OAuth o Token di accesso personale.

    • Se si sceglie OAuth, fare clic su Autorizza per accedere al sito web GitLab. Se non disponi di una sessione GitLab attiva, ti viene richiesto di accedere. Fai clic su Authorize Application per consentire a IBM Cloud di accedere al tuo account GitLab. Se hai una sessione di GitLab attiva ma non avevi immesso la tua password recentemente, ti potrebbe essere richiesto di immettere la tua password GitLab per la conferma.

    • Se scegli il token di accesso personale, devi immettere il token di accesso personale da utilizzare per autorizzare con GitLab a clonare i repository ed eseguire altre azioni per tuo conto. Se non hai un token di accesso personale, puoi seguire la documentazione sul sito web GitLab per crearne uno. Assicurarsi che il proprio token di accesso personale disponga dei diritti api.

  2. Se utilizzi un repository sul tuo proprio server GitLab, nella sezione Integrazioni configurabili, fai clic su Add custom server.

    a. Digita un titolo per il tuo GitHub server personalizzato, specifica la root URL per il server e inserisci il tuo token di accesso personale.

    b. Se non hai un token di accesso personale, puoi seguire la documentazione sul sito web GitLab per crearne uno.

    c. Se il vostro server GitHub è air-gapped o non è accessibile su Internet pubblico, potete collegare e integrare un Delivery Pipeline Private Worker da eseguire sulla vostra infrastruttura Kubernetes per accedere a risorse interne o in sede. Per ulteriori informazioni sui Delivery Pipeline Lavoratori privati, vedere Lavorare con Delivery Pipeline Lavoratori privati.

  3. Rivedi le ubicazioni del repository di destinazione predefinite per i repository GitLab. Questi repository vengono clonati dai repository di esempio. Se necessario, modifica i nomi dei repository di destinazione.

Se disponi di una toolchain a cui stai aggiungendo questa integrazione dello strumento, completa la seguente procedura:

  1. Dalla console IBM Cloud, fare clic sull'icona Menu > Automazione piattaforma > Toolchain. Nella pagina Toolchains, fai clic sulla toolchain per aprirne la pagina di panoramica.

  2. Fai clic su Add tool.

  3. Nella sezione Integrazioni strumento, fai clic su GitLab.

  4. Fai clic sul server GitLab server che vuoi utilizzare.

  5. Se hai un repository GitLab e desideri utilizzarlo, per il tipo di repository, fai clic su Existing e immetti l'URL.

  6. Se desideri utilizzare un nuovo repository GitLab, immetti un nome per il repository, digita l'URL per il repository che stai clonando o dividendo e seleziona il tipo di repository:

    a. Per creare un repository vuoto, fai clic su New.

    b. Per creare una copia di un repository GitLab, fai clic su Clone.

    c. Per biforcare un repository GitLab in modo che sia possibile fornire le modifiche attraverso le richieste di unione, fai clic su Fork.

  7. Se vuoi creare un repository pubblico sul server, deseleziona la casella di spunta Make this repository private.

  8. Se desideri utilizzare Problemi di GitLab per la traccia del problema, seleziona la casella di spunta Enable GitLab Issues.

  9. 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.

  10. Fai clic su Crea integrazione.

  11. Dalla pagina della panoramica della tua toolchain, sulla scheda Repository, fai clic sul repository GitLab con cui vuoi lavorare. A seconda del repository che hai selezionato, si aprirà il sito web di GitLab o il repository GitLab della tua azienda, dove puoi visualizzare i contenuti del repository.

  12. Se hai abilitato Problemi GitLab, fai clic su GitLab Issues per aprirlo. Puoi utilizzare questa istanza dei problemi GitLab per la toolchain completa, anche se la toolchain contiene più repository GitLab.

    Se non hai i privilegi Proprietario o Master 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 GitLab utilizzando l'API

L'integrazione GitLab 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 gitlab.

Parametri di integrazione dello strumentoGitLab
Parametro Utilizzo Immettere Argomento Terraform Descrizione
url root API facoltativo, aggiornabile Stringa url root API URL L'API GitLab.
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.
connessione_cieca facoltativo, aggiornabile, Default: false Booleano connessione_cieca Impostare questo valore su true per indicare che il server non è indirizzabile su Internet pubblico perché IBM Cloud non può convalidare i dettagli di connessione forniti. Alcune funzioni che richiedono l'accesso API al server Git saranno disabilitate. Delivery Pipeline funziona solo utilizzando un worker privato che ha accesso in rete al server 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 creando tag, etichette e commenti su commit, pull request e issue di riferimento.
id_git facoltativo, immutabile Stringa id_git Impostare questo valore su gitlab per gitlab.como sul GUID di un server GitLab personalizzato.
has_issues facoltativo, aggiornabile, Default: true Booleano problemi_toolchain_abilitati Imposta questo valore su true per abilitare Issues nel repository GitLab e aggiungere 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 se i problemi sono abilitati sul repository GitLab.
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 GitLab 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 privato il repository quando crei un repository o cloni o biforca 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 " GitLab ".
repo_name facoltativo, immutabile Stringa repo_name Il nome del repository " GitLab " 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 URL del repo GitLab 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 Il URL del repository che desideri duplicare o clonare. 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 utilizzato per l'autorizzazione con il GitLab server.
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 esistente in un nuovo repository Git, fork per biforcare un repository Git esistente o link per collegarlo a un repository Git esistente.