Colleghi il Suo account Bitbucket affinché i Suoi siti vengano distribuiti da un repository

Che cosa comporta la connessione

La connessione di Bitbucket consente a un sito di essere distribuito da uno dei vostri repository Bitbucket Cloud: effettuate il push sul branch e il sito si aggiornerà.

Prima di iniziare

Un account Bitbucket Cloud con accesso ai repository che desiderate distribuire.

1. Create la chiave su Bitbucket

Bitbucket offre due tipi di credenziali ed entrambi funzionano:

• Un token di accesso per un repository, un progetto o un'area di lavoro, creato dalle impostazioni del repository, del progetto o dell'area di lavoro stessa alla voce Token di accesso. È associato a quel repository, progetto o area di lavoro anziché a una persona. Assegnategli l'accesso in lettura ai repository.
• Un token API sul vostro account Atlassian. Selezionate il vostro profilo, quindi Impostazioni account → Sicurezza → Crea e gestisci token API → Crea token API con ambiti. Assegnategli un nome, impostate una scadenza, scegliete Bitbucket come applicazione e selezionate l'accesso in lettura ai repository. Bitbucket mostra il token una sola volta; copiatelo subito.

2. Collegatelo qui

Aprite Integrazioni nella vostra dashboard e scegliete Collega un account. Selezionate Hosting di codice come gruppo e Bitbucket come account, compilate il campo Token API e, se avete creato un token sul vostro account Atlassian anziché un token di accesso, anche Nome utente account, quindi premete Collega account.

Verifichiamo ciò che incollate prima che venga salvato qualsiasi dato. Una chiave non funzionante non viene mai memorizzata e il messaggio indica qual è stato il problema. Una chiave funzionante viene conservata crittografata nel nostro caveau dei segreti — mai nel nostro database — e non viene mai mostrata di nuovo, nemmeno a voi.

Il nome utente determina le modalità di invio del token, quindi inseritelo solo per un token di account. Un token di accesso inserito con un nome utente, o un token di account senza nome utente, viene rifiutato.

Cosa succede dopo

• Un sito può essere distribuito direttamente da un repository su questo account: selezionatelo nella connessione del repository del sito, scegliete il repository e il branch, e un push effettuerà la distribuzione.
• Tutti gli altri branch possono ottenere la propria anteprima, consentendovi 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 origine del codice del sito.

Se la connessione non riesce

Manca un repository. Un token di accesso raggiunge solo il repository, il progetto o l'area di lavoro in cui è stato creato. Createne uno al livello che copre ogni repository necessario.

Ha funzionato e poi si è fermato. Entrambi i tipi di token possono scadere. Createne uno nuovo e collegatelo.

Indica che la chiave è stata rifiutata. Quasi sempre si tratta di una di queste tre cose: uno spazio o un'interruzione di riga copiati insieme alla chiave, una chiave scaduta o una chiave revocata o rigenerata dopo che l'avete copiata. Createne una nuova e incollatela di nuovo.

Si collega, ma qualcosa in seguito fallisce. La chiave si autentica ma manca di un'autorizzazione necessaria per l'azione. Create una nuova chiave con le autorizzazioni elencate sopra, quindi disconnettete la vecchia connessione e collegate la nuova chiave.

Disconnessione

Aprite Integrazioni, individuate l'account e premete Disconnetti. Questa operazione elimina immediatamente la chiave memorizzata. Qualsiasi elemento che la stava utilizzando si interrompe all'azione successiva e le schermate che ne dipendevano lo segnalano anziché fallire silenziosamente.

La disconnessione non annulla ciò che è già stato fatto: i record, le distribuzioni o le impostazioni che abbiamo modificato sul vostro account rimangono invariati. Se ritenete che la chiave stessa possa essere trapelata, revocatela anche presso il fornitore; la disconnessione rimuove la nostra copia, non la loro.