Collegate il vostro account GitLab affinché i vostri siti vengano distribuiti da un repository

Vantaggi del collegamento

Il collegamento di GitLab consente a un sito di effettuare il deployment da uno dei Suoi repository GitLab e ci permette di pubblicare su GitLab Pages nel Suo account laddove lo scelga come host per un sito.

Prima di iniziare

Un account GitLab con accesso ai progetti di cui desidera effettuare il deployment.

1. Crei la chiave su GitLab

In GitLab, selezioni il Suo avatar in alto a destra, quindi Edit profile → Access → Personal access tokens, e generi un nuovo token (GitLab potrebbe etichettarlo come Legacy token nel menu Generate token). Gli assegni un nome, imposti una data di scadenza e selezioni questi ambiti (scope):

• api
• write_repository

Prema Generate token e lo copi: GitLab lo mostra una sola volta.

2. Lo colleghi qui

Apra Integrazioni nella Sua dashboard e scelga Collega un account. Selezioni Hosting del codice come gruppo e GitLab come account, compili Token API e prema Collega account.

Verifichiamo quanto incollato prima che qualsiasi elemento venga salvato. Una chiave non funzionante non viene mai memorizzata e la risposta indica quale sia stato l'errore. Una chiave funzionante viene conservata crittografata nella nostra cassaforte dei segreti — mai nel nostro database — e non viene mai più mostrata, nemmeno a Lei.

Cosa succede dopo

• Un sito può effettuare il deployment direttamente da un repository presente su questo account: lo scelga nella connessione del repository del sito, indichi il repository e il branch, e un'operazione di push avvierà il deployment.
• Ogni altro branch può ottenere la propria anteprima, consentendoLe di verificare una modifica prima che raggiunga il sito di produzione.
• Gli host statici basati su Git come Render e Azure Static Web Apps utilizzano questa connessione come sorgente del codice del sito.

In caso di mancata connessione

Funzionava e poi ha smesso. I token di GitLab scadono sempre — di norma al massimo un anno dopo la loro creazione — e GitLab Le invia un'e-mail prima che ciò avvenga. Ne crei uno nuovo e lo colleghi.

Manca un ambito (scope). Gli ambiti di un token non possono essere modificati dopo la sua creazione; crei un nuovo token selezionando entrambi gli ambiti.

Indica che la chiave è stata rifiutata. Quasi sempre dipende da una di queste tre cause: uno spazio o un'interruzione di riga copiati insieme a essa, una chiave scaduta oppure una chiave revocata o rigenerata dopo che l'ha copiata. Ne crei una nuova e la incolli nuovamente.

Si connette, ma in seguito qualcosa non funziona. La chiave esegue l'autenticazione ma è priva di un'autorizzazione necessaria per l'azione. Crei una nuova chiave con le autorizzazioni sopra elencate, quindi scolleghi la vecchia connessione e colleghi la nuova chiave.

Scollegamento

Apra Integrazioni, individui l'account e prema Scollega. Ciò elimina immediatamente la chiave memorizzata. Qualsiasi elemento che la stava utilizzando si interromperà alla sua azione successiva, e le schermate che ne dipendevano lo segnaleranno espressamente anziché fallire silenziosamente.

Lo scollegamento non annulla quanto già eseguito: i record, i deployment o le impostazioni che abbiamo modificato sul Suo account rimangono invariati. Se ritiene che la chiave stessa possa essere stata compromessa, provveda a revocarla anche presso il fornitore; lo scollegamento rimuove la nostra copia, non la loro.