91 lines
2.6 KiB
Markdown
91 lines
2.6 KiB
Markdown
# Setup triage automatico su un repository
|
|
|
|
## Prerequisiti
|
|
|
|
- Gitea Actions abilitate sul repository
|
|
- Issues abilitate sul repository
|
|
- Runner disponibile con label `linux_amd64` (o label equivalente)
|
|
- Accesso admin al repository per creare secrets e labels
|
|
|
|
## Passaggi
|
|
|
|
### 1. Secrets
|
|
|
|
Crea i seguenti secrets nel repository (`Settings → Actions → Secrets`):
|
|
|
|
| Secret | Valore | Descrizione |
|
|
|---|---|---|
|
|
| `TOKEN` | Token API Gitea | Permette all'action di applicare label e commentare |
|
|
| `OPENCODE_API_KEY` | API key OpenCode | Autenticazione per il provider AI |
|
|
|
|
### 2. Labels
|
|
|
|
Crea le label `bug` e `richiesta` (o verifica che esistano):
|
|
|
|
```
|
|
bug #ee0701 Malfunzionamento, errore, crash o anomalia
|
|
richiesta #007bff Nuova funzionalità, miglioramento o ottimizzazione
|
|
```
|
|
|
|
Se il repo ha già label simili con nomi diversi, unificarle sulla versione minuscola per evitare ambiguità col triage.
|
|
|
|
### 3. Workflow
|
|
|
|
Crea il file `.gitea/workflows/triage-issue.yml`:
|
|
|
|
```yaml
|
|
name: Triage Issue
|
|
|
|
on:
|
|
issues:
|
|
types: [opened]
|
|
|
|
jobs:
|
|
triage:
|
|
runs-on: linux_amd64
|
|
steps:
|
|
- uses: actions/checkout@v4
|
|
|
|
- uses: https://git.incloud.ovh/anuti/Actions/install-opencode@main
|
|
|
|
- uses: https://git.incloud.ovh/anuti/Actions/triage-issue@main
|
|
with:
|
|
issue-title: ${{ github.event.issue.title }}
|
|
issue-body: ${{ github.event.issue.body }}
|
|
issue-number: ${{ github.event.issue.number }}
|
|
repository: ${{ github.repository }}
|
|
api-token: ${{ secrets.TOKEN }}
|
|
api-key: ${{ secrets.OPENCODE_API_KEY }}
|
|
```
|
|
|
|
Se il runner ha una label diversa da `linux_amd64`, modificare `runs-on` di conseguenza.
|
|
|
|
### 4. Commit e push
|
|
|
|
```bash
|
|
git add .gitea/workflows/triage-issue.yml
|
|
git commit -m "Aggiunge workflow triage automatico"
|
|
git push
|
|
```
|
|
|
|
### 5. Test
|
|
|
|
Aprire una nuova issue sul repository. Entro pochi secondi il runner dovrebbe:
|
|
|
|
1. Classificare l'issue come `bug` o `richiesta`
|
|
2. Applicare la label corrispondente
|
|
3. Pubblicare un commento con riassunto, gap analisi e domande aperte
|
|
4. Caricare un file `.md` con l'analisi tecnica completa come asset dell'issue
|
|
|
|
### Troubleshooting
|
|
|
|
**Il workflow non parte**
|
|
- Verificare che `has_actions: true` sul repository (API: `PATCH /repos/{owner}/{repo}` con body `{"has_actions":true}`)
|
|
- Verificare che il runner sia online e abbia la label corretta
|
|
|
|
**Errore "secret not found"**
|
|
- Verificare che i secrets `TOKEN` e `OPENCODE_API_KEY` siano configurati
|
|
|
|
**Label non trovata**
|
|
- Il triage cerca label con nome esattamente `bug` e `richiesta`. Crearle se mancanti.
|