Installi l'app GitHub di Zinn® per consentirci di effettuare il deployment senza un token a lunga durata

Vantaggi del collegamento

L'installazione dell'app GitHub di Zinn® consente a un sito di effettuare il deploy dai Suoi repository — e a una bacheca di progetto di rimanere sincronizzata con GitHub — senza doverci fornire un token personale. Conserviamo solo il numero di installazione dell'app, che da solo è inutile, e generiamo un token valido per un'ora ogni volta che ne abbiamo bisogno. È la scelta migliore per un'organizzazione, perché non appartiene a una singola persona e non smette di funzionare quando qualcuno se ne va.

Prima di iniziare

Un account GitHub, oppure i diritti di proprietario sull'organizzazione in cui desidera installare l'app. Le organizzazioni che vietano le app di terze parti richiedono l'autorizzazione di un proprietario; se ciò non è possibile, utilizzi invece un token con autorizzazioni specifiche (Collega il Suo account GitHub).

1. Creare la chiave su GitHub

Non c'è alcuna chiave da creare. Installi l'app GitHub di Zinn® sul Suo account personale o sulla Sua organizzazione, e scelga se includere tutti i repository o solo quelli di cui desidera che effettuiamo il deploy.

Quindi individui il numero di installazione:

• Account personale — Settings → Applications → Installed GitHub Apps, e Configure accanto all'app Zinn®.
• Organizzazione — Your organizations → Settings → GitHub Apps, e Configure accanto all'app Zinn®.

Il numero alla fine della barra degli indirizzi in quella pagina — ad esempio github.com/settings/installations/12345678 — è il numero di installazione.

2. Effettuare il collegamento qui

L'app viene selezionata nel punto in cui viene utilizzata anziché nella schermata Integrazioni:

• Nel collegamento del repository di un sito, scelga GitHub (app install).
• Nel collegamento a GitHub di una bacheca di progetto, scelga The Zinn® GitHub app.

Incolli il Numero di installazione e prosegua. Verifichiamo l'installazione prima di salvare qualsiasi dato; un numero che non riusciamo a raggiungere non viene mai memorizzato.

Cosa succede dopo

• I repository concessi all'app compaiono affinché il sito possa effettuarne il deploy, e un push ne avvia il deploy.
• Ogni azione che eseguiamo compare nel log di controllo dell'installazione su GitHub sotto il nome dell'app, non il Suo.
• Per concederci altri repository, modifichi l'accesso ai repository dell'app nella stessa pagina Configure — non è necessario ricollegare nulla.

Se non si collega

Manca un repository. L'installazione copre solo i repository che ha scelto. Apra Configure e lo aggiunga.

Il numero viene rifiutato. Verifichi che si tratti del numero di installazione presente nella barra degli indirizzi, non dell'ID dell'app stessa, e che l'app sia ancora installata — un'app disinstallata non ha alcuna installazione.

Indica che la chiave è stata rifiutata. Quasi sempre una di queste tre cose: 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 di nuovo.

Si collega, ma in seguito qualcosa non funziona. La chiave esegue l'autenticazione ma non dispone di un'autorizzazione necessaria per l'azione. Crei una nuova chiave con le autorizzazioni indicate sopra, quindi disconnetta il vecchio collegamento e colleghi la nuova chiave.

Disconnessione

Apra Integrazioni, individui l'account e prema Disconnetti. In questo modo la chiave memorizzata viene eliminata immediatamente. Qualsiasi elemento che la stava utilizzando si interrompe all'azione successiva, e le schermate che dipendevano da essa lo segnalano chiaramente invece di fallire in modo silenzioso.

La disconnessione non annulla quanto già fatto — i record, i deploy o le impostazioni che abbiamo modificato sul Suo account rimangono come sono. Se ritiene che la chiave stessa possa essere stata compromessa, la revochi anche presso il fornitore; la disconnessione rimuove la nostra copia, non la loro.