Vantaggi del collegamento
Il collegamento di Bitbucket consente a un sito di eseguire il deployment da uno dei Suoi repository Bitbucket Cloud: invii le modifiche tramite push al ramo e il sito si aggiornerà.
Prima di iniziare
Un account Bitbucket Cloud con accesso ai repository di cui desidera eseguire il deployment.
1. Creare la chiave su Bitbucket
Bitbucket offre due tipi di credenziali ed entrambi sono validi:
- Un token di accesso per un repository, un progetto o un'area di lavoro, creato dalle impostazioni specifiche di tale repository, progetto o area di lavoro alla voce Token di accesso. È associato a quel repository, progetto o area di lavoro piuttosto che a una persona. Assegni l'accesso in sola lettura ai repository.
- Un token API sul Suo account Atlassian. Selezioni il Suo profilo, quindi Impostazioni account → Sicurezza → Crea e gestisci i token API → Crea token API con ambiti. Assegni un nome, imposti una scadenza, scelga Bitbucket come app e selezioni l'accesso in sola lettura ai repository. Bitbucket mostra il token una sola volta; lo copi in quel momento.
2. Effettuare il collegamento qui
Apra Integrazioni nella Sua dashboard e scelga Collega un account. Selezioni Hosting del codice come gruppo e Bitbucket come account, compili Token API — e, qualora abbia creato un token sul Suo account Atlassian invece di un token di accesso, compili anche Nome utente dell'account, quindi prema Collega account.
Testiamo ciò che incolla 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 nel nostro archivio protetto dei segreti — mai nel nostro database — e non viene mai mostrata di nuovo, nemmeno a Lei.
Il nome utente determina la modalità di invio del token, pertanto lo inserisca unicamente per un token dell'account. Un token di accesso inserito con un nome utente, oppure un token dell'account privo di esso, verrà rifiutato.
Operazioni successive
- Un sito può eseguire il deployment direttamente da un repository su questo account: lo selezioni nella connessione del repository del sito, scelga il repository e il ramo, e un'operazione di push avvierà il deployment.
- Ogni altro ramo può ottenere la propria anteprima, permettendoLe di verificare una modifica prima che raggiunga il sito attivo.
- Gli host statici basati su Git come Render e Azure Static Web Apps utilizzano questa connessione come sorgente per il codice del sito.
In caso di mancata connessione
Manca un repository. Un token di accesso raggiunge esclusivamente il repository, il progetto o l'area di lavoro in cui è stato creato. Ne crei uno al livello che copra tutti i repository di cui necessita.
Funzionava e poi si è interrotto. Entrambi i tipi di token possono scadere. Ne crei uno nuovo e lo colleghi.
Indica che la chiave è stata rifiutata. Si tratta quasi sempre di una fra tre cause: uno spazio o un'interruzione di riga copiati insieme ad essa, una chiave scaduta, oppure una chiave revocata o rigenerata dopo che l'ha copiata. Ne crei una nuova e la incolli di nuovo.
Si connette, ma in seguito un'operazione fallisce. La chiave supera 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.
Disconnessione
Apra Integrazioni, individui l'account e prema Disconnetti. Ciò comporta l'eliminazione immediata della chiave memorizzata. Qualsiasi elemento che la stava utilizzando si arresterà alla sua azione successiva, e le schermate dipendenti da essa lo segnaleranno invece di fallire silenziosamente.
La disconnessione 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; la disconnessione rimuove la nostra copia, non la loro.