Documentazione / Collega

GitHub

Collega i repository GitHub a ticket e rilasci con una GitHub App tua.

GitHub collega i repository ai progetti, branch e pull request ai ticket, i rilasci ai deploy. Ogni installazione usa una GitHub App sua, creata una volta dall'amministratore.

Creare la App

Su GitHub: Settings → Developer settings → GitHub Apps → New GitHub App.
Callback URL: https://<tuo-dominio>/member/integrations/github/callback, e spunta Request user authorization (OAuth) during installation: CloseYourIt controlla che chi installa la App sia il proprietario dell'account.
Webhook URL: https://<tuo-dominio>/github/webhook, con un segreto che generi tu.
Permessi sul repository: Contents lettura e scrittura, Pull requests lettura e scrittura, Actions lettura, Environments e Secrets lettura e scrittura (per sincronizzare i token di ingest), Metadata lettura.
Eventi: Push, Create, Release, Pull request.
Creala, poi genera una chiave privata e un client secret.

Collegarla

Aggiungi queste righe a /opt/closeyourit/.env e lancia closeyourit restart:

Variabile	Valore
`GH_APP_ID`	l'ID della App
`GH_APP_SLUG`	il nome nell'indirizzo della App
`GH_APP_PRIVATE_KEY`	la chiave privata, su una riga con `\n`
`GH_APP_CLIENT_ID`	il Client ID mostrato nella pagina della App
`GH_APP_CLIENT_SECRET`	il client secret
`GH_WEBHOOK_SECRET`	il segreto del webhook

Finché mancano, la pagina GitHub dell'app dice che GitHub non è collegato.