Collegare GitHub Issues: guida passo passo
Apre una segnalazione su GitHub per ogni test non superato, aggiunge un commento se il test fallisce di nuovo e la chiude quando il test viene superato senza problemi. GitHub non accetta il caricamento di file, quindi la segnalazione indica la cartella delle evidenze anziché allegare lo screenshot. Questa guida ti accompagna da zero fino alla verifica della connessione ed elenca gli errori che potresti incontrare, con le relative cause e soluzioni.
Ultimo aggiornamento:
Mantieni riservate le tue credenziali. Non incollare mai token, chiavi, password o URL di webhook in una chat. Inseriscili solo in Studio → Impostazioni → Integrazioni, dove vengono salvati nel file .env del tuo spazio di lavoro e visualizzati come puntini. Lo stesso vale per un assistente IA: può accompagnarti lungo questa guida, ma non ha mai bisogno del tuo token.
Cosa serve
- Un account GitHub che possa aprire segnalazioni nel repository (un collaboratore o il proprietario).
- Un repository con la funzionalità Issues attivata (Impostazioni del repository → Funzionalità → Issues).
- Un token di accesso personale con autorizzazioni granulari e permesso Issues → Lettura e scrittura su quel repository, oppure un token classico con ambito repo.
Ottieni le credenziali
- Apri https://github.com/settings/personal-access-tokens/new (un token con autorizzazioni granulari).
- Assegnagli un nome, imposta una scadenza e in Accesso ai repository scegli Solo repository selezionati, quindi seleziona il repository che riceverà le segnalazioni.
- In Autorizzazioni → Autorizzazioni del repository imposta Issues su Lettura e scrittura. Non serve altro.
- Genera il token e copialo subito. GitHub lo mostra una sola volta. Non incollarlo da nessuna parte tranne che nello Studio (passaggio successivo).
Collegalo nello Studio
- Nello Studio, apri Impostazioni → Integrazioni → Collega GitHub Issues.
- Quando richiesto, inserisci il token e premi Salva & verifica. Lo Studio mostra a chi appartiene il token e a quanti repository può accedere.
- Seleziona il repository in "Destinazione delle segnalazioni". L'elenco mostra solo i repository a cui il token può accedere e in cui la funzionalità Issues è attiva.
- Attiva
GITHUB_ISSUES_ENABLED.
Verifica che funzioni
- Verifica connessione mostra "accesso effettuato come <you>" e "<owner/repo> accetta segnalazioni". La verifica esegue solo operazioni di lettura; non apre mai segnalazioni.
- Apri Impostazioni → Integrazioni → Ticket e premi Crea ticket di prova sulla destinazione GitHub. Verrà aperta una segnalazione con l'etichetta nexus-test.
- Aprila su GitHub, verifica l'etichetta e chiudila o eliminala quando hai finito.
Errori comuni
| Cosa vedi | Causa | Soluzione |
|---|---|---|
| "GitHub ha rifiutato il token (401)" | Il token è errato, scaduto, revocato o copiato solo in parte. | Crea un nuovo token con Issues → Lettura e scrittura e salvalo di nuovo. |
| HTTP 403 | Il token non dispone dell'autorizzazione Issues, il repository non è stato selezionato per il token oppure il limite di richieste è stato raggiunto. | Modifica il token: imposta Issues su Lettura e scrittura e seleziona il repository. Se è stato raggiunto il limite di richieste, attendi qualche minuto. |
| HTTP 404 | Il repository non esiste, è stato rinominato oppure il token non può visualizzarlo (i repository privati devono essere selezionati nel token con autorizzazioni granulari). | Seleziona il repository dall'elenco oppure aggiungilo ai repository accessibili tramite il token. |
| HTTP 422 | GitHub ha rifiutato un campo della segnalazione, in genere un assegnatario che non è un collaboratore, oppure un titolo o un'etichetta non accettati da GitHub. | Rimuovi l'assegnatario in Impostazioni → Integrazioni → Ticket oppure aggiungi quella persona come collaboratore. |
| "La funzionalità Issues è disattivata in <repo>" | La funzionalità Issues è disabilitata nel repository. | Attiva Impostazioni → Funzionalità → Issues nel repository oppure scegline un altro. |
| "impossibile raggiungere GitHub (…)" oppure "nessuna risposta entro il tempo previsto" | Questo PC non riesce a raggiungere api.github.com: una VPN o un proxy impediscono l'accesso, oppure manca la connessione di rete. | Apri github.com in un browser sullo stesso PC, quindi riprova la verifica. |
| Tutte le verifiche hanno esito positivo, ma non compare alcuna segnalazione | GITHUB_ISSUES_ENABLED è false; oppure l'esito era FLAKY o legato all'ambiente; oppure si trattava di un'esecuzione in un ambiente isolato; oppure il test ha già una segnalazione aperta (in caso di errore ripetuto viene invece aggiunto un commento). | Attiva GITHUB_ISSUES_ENABLED e usa Crea ticket di prova per verificare che la connessione funzioni. |
Chiavi di configurazione
| Chiave | Cosa fa | Valore valido | Come verificarlo |
|---|---|---|---|
GITHUB_ISSUES_ENABLED | Crea segnalazioni su GitHub per i test non superati | true o false | Attiva dopo che Verifica connessione ha avuto esito positivo, poi esegui Crea ticket di prova. |
GITHUB_ISSUES_TOKEN | Token di accesso GitHub (segreto, salvato solo su questo computer) | Una sola riga, senza virgolette né spazi | Verifica connessione: "token rifiutato" significa che è errato, scaduto o revocato. |
GITHUB_ISSUES_REPO | Repository GitHub per le segnalazioni | owner/repo, ad esempio acme/web | Selezionalo dall’elenco; Studio salva solo un repository accessibile con il token e con la funzione Issues attiva. |
Approfondimenti: tutte le integrazioni, la guida alle impostazioni, risoluzione dei problemi. Altre guide: Jira Cloud, Azure Boards, Slack, Microsoft Teams, Telegram.
Non riesci ancora a risolvere? Scrivi a [email protected] riportando l'esatta riga di errore mostrata da Studio. Non includere token.