Configurazione di GitLab

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:

Se memorizzi il tuo codice sorgente in un repository GitLab, nella sezione Integrazioni configurabili, fai clic su GitLab. Se stai configurando questa integrazione dello strumento su IBM Cloud pubblico, devi autorizzare IBM Cloud ad accedere a GitLab scegliendo OAuth o Personal Access Token.
- Se si sceglie OAuth, fare clic su Autorizza per andare 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.
Se utilizzi un repository sul tuo proprio server GitLab, nella sezione Integrazioni configurabili, fai clic su Add custom server.

a. Immetti un titolo per il tuo server GitHub personalizzato, specifica l'URL root per il server e immetti 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.
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:

Dalla console IBM Cloud, fare clic sull'icona Menu Automazione piattaforma > Toolchains. Nella pagina Toolchains, fai clic sulla toolchain per aprirne la pagina di panoramica. In alternativa, nella pagina della panoramica della tua applicazione, nella scheda di fornitura continua, fai clic su View toolchain. Fai quindi clic su Overview.
Fai clic su Add tool.
Nella sezione Integrazioni strumento, fai clic su GitLab.
Fai clic sul server GitLab server che vuoi utilizzare.
Se hai un repository GitLab e desideri utilizzarlo, per il tipo di repository, fai clic su Existing e immetti l'URL.
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.
Se vuoi creare un repository pubblico sul server, deseleziona la casella di spunta Make this repository private.
Se desideri utilizzare Problemi di GitLab 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. Per ulteriori informazioni, vedere Tracciamento della distribuzione del codice con le toolchain.
Fai clic su Crea integrazione.
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.
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 dello strumento GitLab supporta i seguenti parametri di configurazione che puoi utilizzare con le integrazioni dello strumento Toolchain HTTP API e SDK quando crei, leggie aggiorna.

È 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	L'URL dell'API GitLab.
token API	facoltativo, aggiornabile	Password	token API	Il PAT (Personal Access Token). 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	Impostare questo valore su '`true` per tracciare la distribuzione delle modifiche al codice creando tag, etichette e commenti su commit, richieste di pull e problemi referenziati.
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	toolchain_issues_enabled	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 repo 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	L'URL del repository GitLab per questa integrazione dello 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'URL del repository che vuoi 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	L'URL del token utilizzato per autorizzare con il server GitLab.
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.