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
• Option A (runner dédié): gitea/act_runner via docker-compose dans runner/
• Option B (conteneur unifié): RUNNER_MODE=runner dans docker-compose.ci.yml + BASE_URL et REGISTRATION_TOKEN
  • Enregistrement (automatisé par entrypoint si variables présentes)
  • Démarrage: docker compose -f docker-compose.ci.yml up -d

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
• (Conteneur unifié) job custom pour builder et lancer docker-compose.ci.yml si nécessaire

5. Processus PR

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