Colleghi il Suo account GitHub con un token in modo che i Suoi siti vengano distribuiti da un repository

Vantaggi del collegamento

Il collegamento di GitHub tramite token consente a un sito di eseguire il deployment da uno dei Suoi repository: effettui il push sul branch e il sito si aggiorna. Ci permette inoltre di pubblicare su GitHub Pages sul Suo account, qualora lo scelga come host per un sito.

Se i Suoi repository appartengono a un'organizzazione, è preferibile utilizzare invece l'app GitHub di Zinn® — consulti Installare l'app GitHub di Zinn®. Un token appartiene a una sola persona e smette di funzionare quando quest'ultima lascia l'organizzazione.

Prima di iniziare

Un account GitHub con accesso ai repository di cui desidera eseguire il deployment. Se appartengono a un'organizzazione, un proprietario potrebbe dover approvare i token a grana fine (fine-grained) per la stessa.

1. Creare la chiave su GitHub

Su GitHub, faccia clic sull'immagine del Suo profilo, quindi su Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token. Assegni un nome e scelga una data di scadenza. Sotto Repository access selezioni Only select repositories e indichi quelli di cui esegue il deployment — l'accesso più limitato possibile tra quelli funzionanti.

Sotto Repository permissions assegni l'autorizzazione Read and write per:

• Contents
• Pages
• Administration

Prema Generate token e lo copi — GitHub lo mostra una sola volta.

2. Effettuare il collegamento qui

Apra Integrations nella Sua dashboard e scelga Connect an account. Selezioni Code hosting come gruppo e GitHub come account, compili il campo API token e prema Connect account.

Verifichiamo i dati incollati prima di procedere con qualsiasi salvataggio. Una chiave che non funziona non viene mai memorizzata e la risposta indica quale sia stato l'errore. Una chiave funzionante viene conservata crittografata nella nostra cassaforte per i segreti — mai nel nostro database — e non viene mai più mostrata, nemmeno a Lei.

Cosa accade dopo

• Un sito può eseguire il deployment direttamente da un repository presente su questo account: lo selezioni nel collegamento al repository del sito, indichi il repository e il branch, e un push avvierà il deployment.
• Ogni altro branch può disporre di una propria anteprima, consentendoLe di verificare una modifica prima che raggiunga il sito di produzione.
• Gli host statici creati con Git come Render e Azure Static Web Apps utilizzano questa connessione come sorgente per il codice del sito.

Se non si connette

Un repository non compare. L'accesso ai repository associato al token non lo include. Modifichi il token su GitHub e aggiunga il repository.

Funzionava e poi ha smesso di funzionare. I token a grana fine scadono alla data indicata. Ne generi uno nuovo e lo colleghi; GitHub Le invierà un'e-mail prima della scadenza di un token.

Viene indicato che la chiave è stata rifiutata. Si tratta quasi sempre di una tra tre eventualità: uno spazio o un'interruzione di riga copiati insieme ad essa, una chiave scaduta, oppure una chiave revocata o rigenerata dopo essere stata copiata. Ne crei una nuova e la incolli nuovamente.

Si connette, ma in seguito qualcosa genera un errore. La chiave supera l'autenticazione ma non possiede 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.

Disconnessione

Apra Integrations, individui l'account e prema Disconnect. In questo modo la chiave memorizzata verrà eliminata immediatamente. Qualsiasi elemento che la stava utilizzando si arresterà all'azione successiva, e le schermate interessate lo segnaleranno espressamente anziché fallire silenziosamente.

La disconnessione non annulla ciò che è già stato eseguito — i record, i deployment o le impostazioni modificate sul Suo account rimangono invariati. Se ritiene che la chiave stessa sia stata compromessa, provveda a revocarla anche presso il fornitore; la disconnessione rimuove la nostra copia, non la loro.