4NK_template/docs/project/GITEA_SETUP.md

Configuration Gitea — 4NK_template (projet)

1. Repository

• Activer les Actions (workflows .gitea/workflows/*.yml)
• Vérifier les templates d’issues/PR

2. Protections de branches

• Reviews requises avant merge
• Status checks requis (CI verte)
• Mise à jour obligatoire de la branche avant merge

3. Secrets et variables

• Secrets: OPENAI_API_KEY (optionnel), RELEASE_TOKEN (obligatoire pour publier les releases via API Gitea)
• Variables: paramètres de CI non sensibles, ex: OPENAI_MODEL, OPENAI_API_BASE, OPENAI_TEMPERATURE, BASE_URL

Ajouter RELEASE_TOKEN

• Aller dans Repository Settings → Secrets → New Repository Secret
• Nom: RELEASE_TOKEN ; Valeur: un token personnel avec portée API sur le dépôt
• Le job release-create utilisera ce secret lors d’un push de tag v*

Runner Gitea (labels)

• Configurez votre runner avec labels: self-hosted,linux
• Exemple (act_runner):
  • Enregistrement: ./act_runner register --labels "self-hosted,linux"
  • Service: définissez RUNNER_LABELS="self-hosted,linux"

4. Workflows requis

• code-quality, unit-tests, documentation-tests, security-audit
• deployment-checks, bash-required, markdownlint, release-guard, release-create
• (Optionnels) agents-smoke, openia-agents

5. Processus PR

• Branche dédiée, PR petite et ciblée
• CI verte, review approuvée
• Doc et changelog à jour