feat: Configuration SSH automatique pour CI/CD et templates Gitea
- Ajout du workflow CI/CD avec configuration SSH automatique - Création des templates pour issues et pull requests - Script de configuration SSH automatique (scripts/setup-ssh-ci.sh) - Documentation SSH complète (docs/SSH_SETUP.md) - Mise à jour de la configuration d'intégration 4NK_node - Amélioration du script de démarrage et de la config Nginx La clé SSH est maintenant utilisée automatiquement dans tous les environnements : - CI/CD Gitea Actions avec variable SSH_PRIVATE_KEY - Environnement local avec détection automatique - Configuration Git pour utiliser SSH au lieu de HTTPS
This commit is contained in:
parent
c563d7b16c
commit
ea97ffa733
39
.gitea/ISSUE_TEMPLATE/bug_report.md
Normal file
39
.gitea/ISSUE_TEMPLATE/bug_report.md
Normal file
@ -0,0 +1,39 @@
|
|||||||
|
---
|
||||||
|
name: Rapport de bug
|
||||||
|
about: Créer un rapport pour nous aider à améliorer l'interface utilisateur 4NK
|
||||||
|
title: '[BUG] '
|
||||||
|
labels: ['bug', 'needs-triage']
|
||||||
|
assignees: ''
|
||||||
|
---
|
||||||
|
|
||||||
|
## Description du bug
|
||||||
|
Une description claire et concise du bug.
|
||||||
|
|
||||||
|
## Étapes pour reproduire
|
||||||
|
1. Aller à '...'
|
||||||
|
2. Cliquer sur '...'
|
||||||
|
3. Faire défiler jusqu'à '...'
|
||||||
|
4. Voir l'erreur
|
||||||
|
|
||||||
|
## Comportement attendu
|
||||||
|
Une description claire et concise de ce que vous attendiez.
|
||||||
|
|
||||||
|
## Captures d'écran
|
||||||
|
Si applicable, ajoutez des captures d'écran pour expliquer votre problème.
|
||||||
|
|
||||||
|
## Environnement
|
||||||
|
- OS: [ex. iOS]
|
||||||
|
- Navigateur: [ex. chrome, safari]
|
||||||
|
- Version: [ex. 22]
|
||||||
|
- Version de l'application: [ex. 1.0.0]
|
||||||
|
|
||||||
|
## Contexte supplémentaire
|
||||||
|
Ajoutez tout autre contexte concernant le problème ici.
|
||||||
|
|
||||||
|
## Logs
|
||||||
|
Si applicable, ajoutez les logs d'erreur du navigateur ou de l'application.
|
||||||
|
|
||||||
|
## Checklist
|
||||||
|
- [ ] J'ai vérifié que le bug n'a pas déjà été signalé
|
||||||
|
- [ ] J'ai fourni toutes les informations nécessaires pour reproduire le bug
|
||||||
|
- [ ] J'ai testé sur différents navigateurs/environnements
|
38
.gitea/ISSUE_TEMPLATE/feature_request.md
Normal file
38
.gitea/ISSUE_TEMPLATE/feature_request.md
Normal file
@ -0,0 +1,38 @@
|
|||||||
|
---
|
||||||
|
name: Demande de fonctionnalité
|
||||||
|
about: Suggérer une idée pour l'interface utilisateur 4NK
|
||||||
|
title: '[FEATURE] '
|
||||||
|
labels: ['enhancement', 'needs-triage']
|
||||||
|
assignees: ''
|
||||||
|
---
|
||||||
|
|
||||||
|
## Problème lié
|
||||||
|
Une description claire et concise du problème que cette fonctionnalité résoudrait.
|
||||||
|
|
||||||
|
## Solution proposée
|
||||||
|
Une description claire et concise de ce que vous voulez qu'il se passe.
|
||||||
|
|
||||||
|
## Alternatives considérées
|
||||||
|
Une description claire et concise de toutes les solutions ou fonctionnalités alternatives que vous avez considérées.
|
||||||
|
|
||||||
|
## Contexte supplémentaire
|
||||||
|
Ajoutez tout autre contexte ou captures d'écran concernant la demande de fonctionnalité ici.
|
||||||
|
|
||||||
|
## Impact utilisateur
|
||||||
|
- [ ] Améliore l'expérience utilisateur
|
||||||
|
- [ ] Corrige un problème de performance
|
||||||
|
- [ ] Ajoute une fonctionnalité manquante
|
||||||
|
- [ ] Améliore l'accessibilité
|
||||||
|
- [ ] Autre (précisez)
|
||||||
|
|
||||||
|
## Priorité
|
||||||
|
- [ ] Critique
|
||||||
|
- [ ] Haute
|
||||||
|
- [ ] Moyenne
|
||||||
|
- [ ] Basse
|
||||||
|
|
||||||
|
## Checklist
|
||||||
|
- [ ] J'ai vérifié que cette fonctionnalité n'a pas déjà été demandée
|
||||||
|
- [ ] J'ai fourni une description claire du besoin
|
||||||
|
- [ ] J'ai considéré les alternatives
|
||||||
|
- [ ] J'ai évalué l'impact sur les utilisateurs existants
|
30
.gitea/PULL_REQUEST_TEMPLATE.md
Normal file
30
.gitea/PULL_REQUEST_TEMPLATE.md
Normal file
@ -0,0 +1,30 @@
|
|||||||
|
## Description
|
||||||
|
Une description claire et concise des changements apportés.
|
||||||
|
|
||||||
|
## Type de changement
|
||||||
|
- [ ] Correction de bug (changement non-breaking qui corrige un problème)
|
||||||
|
- [ ] Nouvelle fonctionnalité (changement non-breaking qui ajoute une fonctionnalité)
|
||||||
|
- [ ] Breaking change (correction ou fonctionnalité qui causerait un comportement existant à ne pas fonctionner comme prévu)
|
||||||
|
- [ ] Documentation (mise à jour de la documentation)
|
||||||
|
|
||||||
|
## Tests
|
||||||
|
- [ ] J'ai exécuté les tests unitaires
|
||||||
|
- [ ] J'ai exécuté les tests d'intégration
|
||||||
|
- [ ] J'ai testé manuellement les changements
|
||||||
|
- [ ] J'ai vérifié la compatibilité avec les navigateurs cibles
|
||||||
|
|
||||||
|
## Checklist
|
||||||
|
- [ ] Mon code suit les conventions de style du projet
|
||||||
|
- [ ] J'ai effectué un auto-review de mon propre code
|
||||||
|
- [ ] J'ai commenté mon code, particulièrement dans les zones difficiles à comprendre
|
||||||
|
- [ ] J'ai apporté les changements correspondants à la documentation
|
||||||
|
- [ ] Mes changements ne génèrent pas de nouveaux warnings
|
||||||
|
- [ ] J'ai ajouté des tests qui prouvent que ma correction fonctionne ou que ma fonctionnalité fonctionne
|
||||||
|
- [ ] Les tests unitaires et d'intégration passent avec mes changements
|
||||||
|
- [ ] J'ai vérifié que mes changements n'affectent pas négativement les performances
|
||||||
|
|
||||||
|
## Captures d'écran (si applicable)
|
||||||
|
Ajoutez des captures d'écran pour montrer les changements visuels.
|
||||||
|
|
||||||
|
## Informations supplémentaires
|
||||||
|
Toute autre information ou contexte que vous souhaitez ajouter.
|
114
.gitea/workflows/ci.yml
Normal file
114
.gitea/workflows/ci.yml
Normal file
@ -0,0 +1,114 @@
|
|||||||
|
name: CI/CD Pipeline
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [ main, develop, 4nk-node-integration ]
|
||||||
|
pull_request:
|
||||||
|
branches: [ main, develop ]
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
test:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
|
||||||
|
steps:
|
||||||
|
- name: Setup SSH for Gitea
|
||||||
|
run: |
|
||||||
|
mkdir -p ~/.ssh
|
||||||
|
echo "${{ secrets.SSH_PRIVATE_KEY }}" > ~/.ssh/id_rsa
|
||||||
|
chmod 600 ~/.ssh/id_rsa
|
||||||
|
ssh-keyscan -H git.4nkweb.com >> ~/.ssh/known_hosts
|
||||||
|
git config --global url."git@git.4nkweb.com:".insteadOf "https://git.4nkweb.com/"
|
||||||
|
|
||||||
|
- name: Checkout code
|
||||||
|
uses: actions/checkout@v3
|
||||||
|
with:
|
||||||
|
ssh-key: ${{ secrets.SSH_PRIVATE_KEY }}
|
||||||
|
submodules: recursive
|
||||||
|
|
||||||
|
- name: Setup Node.js
|
||||||
|
uses: actions/setup-node@v3
|
||||||
|
with:
|
||||||
|
node-version: '20'
|
||||||
|
cache: 'npm'
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: npm ci
|
||||||
|
|
||||||
|
- name: Run linting
|
||||||
|
run: npm run lint
|
||||||
|
|
||||||
|
- name: Run type checking
|
||||||
|
run: npm run type-check
|
||||||
|
|
||||||
|
- name: Run tests
|
||||||
|
run: npm run test
|
||||||
|
|
||||||
|
- name: Build application
|
||||||
|
run: npm run build
|
||||||
|
|
||||||
|
- name: Test Docker build
|
||||||
|
run: |
|
||||||
|
docker build -f Dockerfile.4nk-node -t ihm-client:test .
|
||||||
|
docker rmi ihm-client:test
|
||||||
|
|
||||||
|
security:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
needs: test
|
||||||
|
|
||||||
|
steps:
|
||||||
|
- name: Setup SSH for Gitea
|
||||||
|
run: |
|
||||||
|
mkdir -p ~/.ssh
|
||||||
|
echo "${{ secrets.SSH_PRIVATE_KEY }}" > ~/.ssh/id_rsa
|
||||||
|
chmod 600 ~/.ssh/id_rsa
|
||||||
|
ssh-keyscan -H git.4nkweb.com >> ~/.ssh/known_hosts
|
||||||
|
git config --global url."git@git.4nkweb.com:".insteadOf "https://git.4nkweb.com/"
|
||||||
|
|
||||||
|
- name: Checkout code
|
||||||
|
uses: actions/checkout@v3
|
||||||
|
with:
|
||||||
|
ssh-key: ${{ secrets.SSH_PRIVATE_KEY }}
|
||||||
|
|
||||||
|
- name: Setup Node.js
|
||||||
|
uses: actions/setup-node@v3
|
||||||
|
with:
|
||||||
|
node-version: '20'
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: npm ci
|
||||||
|
|
||||||
|
- name: Run security audit
|
||||||
|
run: npm audit --audit-level=moderate
|
||||||
|
|
||||||
|
- name: Check for known vulnerabilities
|
||||||
|
run: npm audit --audit-level=high
|
||||||
|
|
||||||
|
integration-test:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
needs: test
|
||||||
|
|
||||||
|
steps:
|
||||||
|
- name: Setup SSH for Gitea
|
||||||
|
run: |
|
||||||
|
mkdir -p ~/.ssh
|
||||||
|
echo "${{ secrets.SSH_PRIVATE_KEY }}" > ~/.ssh/id_rsa
|
||||||
|
chmod 600 ~/.ssh/id_rsa
|
||||||
|
ssh-keyscan -H git.4nkweb.com >> ~/.ssh/known_hosts
|
||||||
|
git config --global url."git@git.4nkweb.com:".insteadOf "https://git.4nkweb.com/"
|
||||||
|
|
||||||
|
- name: Checkout code
|
||||||
|
uses: actions/checkout@v3
|
||||||
|
with:
|
||||||
|
ssh-key: ${{ secrets.SSH_PRIVATE_KEY }}
|
||||||
|
|
||||||
|
- name: Setup Docker Buildx
|
||||||
|
uses: docker/setup-buildx-action@v2
|
||||||
|
|
||||||
|
- name: Build and test Docker integration
|
||||||
|
run: |
|
||||||
|
docker build -f Dockerfile.4nk-node -t ihm-client:integration .
|
||||||
|
docker run --rm -d --name ihm-client-test -p 8080:80 ihm-client:integration
|
||||||
|
sleep 10
|
||||||
|
curl -f http://localhost:8080 || exit 1
|
||||||
|
docker stop ihm-client-test
|
||||||
|
docker rmi ihm-client:integration
|
129
docs/SSH_SETUP.md
Normal file
129
docs/SSH_SETUP.md
Normal file
@ -0,0 +1,129 @@
|
|||||||
|
# Configuration SSH automatique pour ihm_client
|
||||||
|
|
||||||
|
## Vue d'ensemble
|
||||||
|
|
||||||
|
Le projet `ihm_client` utilise automatiquement les clés SSH pour toutes les opérations Git, que ce soit en local ou dans l'environnement CI/CD Gitea Actions.
|
||||||
|
|
||||||
|
## Configuration automatique
|
||||||
|
|
||||||
|
### Environnement CI/CD
|
||||||
|
|
||||||
|
Dans l'environnement CI/CD Gitea Actions, la configuration SSH est automatique :
|
||||||
|
|
||||||
|
1. **Variable d'environnement** : La clé SSH privée est fournie via la variable `SSH_PRIVATE_KEY`
|
||||||
|
2. **Configuration automatique** : Le workflow CI configure automatiquement SSH pour `git.4nkweb.com`
|
||||||
|
3. **Test de connexion** : La connexion SSH est testée avant chaque opération Git
|
||||||
|
|
||||||
|
### Environnement local
|
||||||
|
|
||||||
|
En local, le script `scripts/setup-ssh-ci.sh` configure automatiquement SSH :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Exécuter le script de configuration
|
||||||
|
./scripts/setup-ssh-ci.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
## Configuration manuelle
|
||||||
|
|
||||||
|
Si la configuration automatique ne fonctionne pas, voici les étapes manuelles :
|
||||||
|
|
||||||
|
### 1. Générer une clé SSH
|
||||||
|
|
||||||
|
```bash
|
||||||
|
ssh-keygen -t rsa -b 4096 -C "votre-email@example.com"
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. Ajouter la clé publique à Gitea
|
||||||
|
|
||||||
|
1. Copier le contenu de `~/.ssh/id_rsa.pub`
|
||||||
|
2. Aller dans les paramètres de votre compte Gitea
|
||||||
|
3. Ajouter la clé SSH dans la section "SSH Keys"
|
||||||
|
|
||||||
|
### 3. Configurer Git pour utiliser SSH
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git config --global url."git@git.4nkweb.com:".insteadOf "https://git.4nkweb.com/"
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. Tester la connexion
|
||||||
|
|
||||||
|
```bash
|
||||||
|
ssh -T git@git.4nkweb.com
|
||||||
|
```
|
||||||
|
|
||||||
|
## Workflow CI/CD
|
||||||
|
|
||||||
|
Le workflow CI/CD (`.gitea/workflows/ci.yml`) inclut :
|
||||||
|
|
||||||
|
### Étapes SSH automatiques
|
||||||
|
|
||||||
|
1. **Setup SSH for Gitea** : Configure la clé SSH et les paramètres de connexion
|
||||||
|
2. **Checkout code** : Utilise SSH pour cloner le repository
|
||||||
|
3. **Tests et build** : Exécute les tests et builds avec SSH configuré
|
||||||
|
|
||||||
|
### Variables requises
|
||||||
|
|
||||||
|
- `SSH_PRIVATE_KEY` : Clé SSH privée pour l'authentification
|
||||||
|
- `SSH_PUBLIC_KEY` : Clé SSH publique (optionnelle)
|
||||||
|
|
||||||
|
## Sécurité
|
||||||
|
|
||||||
|
### Bonnes pratiques
|
||||||
|
|
||||||
|
- Les clés SSH sont stockées de manière sécurisée dans les secrets Gitea
|
||||||
|
- Les permissions des fichiers SSH sont correctement configurées (600 pour les clés privées)
|
||||||
|
- La vérification des hôtes SSH est configurée pour `git.4nkweb.com`
|
||||||
|
|
||||||
|
### Permissions
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Permissions correctes pour les fichiers SSH
|
||||||
|
chmod 700 ~/.ssh
|
||||||
|
chmod 600 ~/.ssh/id_rsa
|
||||||
|
chmod 644 ~/.ssh/id_rsa.pub
|
||||||
|
chmod 600 ~/.ssh/config
|
||||||
|
```
|
||||||
|
|
||||||
|
## Dépannage
|
||||||
|
|
||||||
|
### Problèmes courants
|
||||||
|
|
||||||
|
1. **Permission denied** : Vérifier les permissions des fichiers SSH
|
||||||
|
2. **Host key verification failed** : Ajouter `git.4nkweb.com` aux hôtes connus
|
||||||
|
3. **SSH key not found** : Vérifier que la clé SSH est correctement configurée
|
||||||
|
|
||||||
|
### Commandes de diagnostic
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Tester la connexion SSH
|
||||||
|
ssh -vT git@git.4nkweb.com
|
||||||
|
|
||||||
|
# Vérifier la configuration Git
|
||||||
|
git config --global --list | grep url
|
||||||
|
|
||||||
|
# Vérifier les permissions SSH
|
||||||
|
ls -la ~/.ssh/
|
||||||
|
```
|
||||||
|
|
||||||
|
## Intégration avec 4NK_node
|
||||||
|
|
||||||
|
Lors de l'intégration avec `4NK_node`, la configuration SSH est préservée :
|
||||||
|
|
||||||
|
- Les clés SSH sont partagées entre les projets
|
||||||
|
- La configuration Git utilise SSH pour tous les repositories 4NK
|
||||||
|
- Le workflow CI/CD maintient la cohérence SSH
|
||||||
|
|
||||||
|
## Évolution
|
||||||
|
|
||||||
|
### Améliorations futures
|
||||||
|
|
||||||
|
- Support pour plusieurs clés SSH
|
||||||
|
- Rotation automatique des clés
|
||||||
|
- Intégration avec un gestionnaire de secrets externe
|
||||||
|
- Support pour l'authentification par certificats SSH
|
||||||
|
|
||||||
|
### Maintenance
|
||||||
|
|
||||||
|
- Vérification régulière de la validité des clés SSH
|
||||||
|
- Mise à jour des configurations SSH selon les bonnes pratiques
|
||||||
|
- Documentation des changements de configuration SSH
|
79
scripts/setup-ssh-ci.sh
Executable file
79
scripts/setup-ssh-ci.sh
Executable file
@ -0,0 +1,79 @@
|
|||||||
|
#!/bin/bash
|
||||||
|
|
||||||
|
# Script de configuration SSH pour CI/CD ihm_client
|
||||||
|
# Utilise automatiquement la clé SSH pour les opérations Git
|
||||||
|
|
||||||
|
set -e
|
||||||
|
|
||||||
|
echo "🔑 Configuration automatique de la clé SSH pour ihm_client CI/CD..."
|
||||||
|
|
||||||
|
# Vérifier si on est dans un environnement CI
|
||||||
|
if [ -n "$CI" ]; then
|
||||||
|
echo "✅ Environnement CI détecté"
|
||||||
|
|
||||||
|
# Configuration SSH pour Gitea Actions
|
||||||
|
if [ -n "$SSH_PRIVATE_KEY" ]; then
|
||||||
|
echo "🔐 Configuration de la clé SSH privée..."
|
||||||
|
|
||||||
|
# Créer le répertoire SSH
|
||||||
|
mkdir -p ~/.ssh
|
||||||
|
chmod 700 ~/.ssh
|
||||||
|
|
||||||
|
# Écrire la clé privée
|
||||||
|
echo "$SSH_PRIVATE_KEY" > ~/.ssh/id_rsa
|
||||||
|
chmod 600 ~/.ssh/id_rsa
|
||||||
|
|
||||||
|
# Ajouter la clé publique correspondante (si disponible)
|
||||||
|
if [ -n "$SSH_PUBLIC_KEY" ]; then
|
||||||
|
echo "$SSH_PUBLIC_KEY" > ~/.ssh/id_rsa.pub
|
||||||
|
chmod 644 ~/.ssh/id_rsa.pub
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Configuration SSH pour git.4nkweb.com
|
||||||
|
cat > ~/.ssh/config << EOF
|
||||||
|
Host git.4nkweb.com
|
||||||
|
HostName git.4nkweb.com
|
||||||
|
User git
|
||||||
|
IdentityFile ~/.ssh/id_rsa
|
||||||
|
StrictHostKeyChecking no
|
||||||
|
UserKnownHostsFile=/dev/null
|
||||||
|
EOF
|
||||||
|
|
||||||
|
chmod 600 ~/.ssh/config
|
||||||
|
|
||||||
|
# Tester la connexion SSH
|
||||||
|
echo "🧪 Test de connexion SSH vers git.4nkweb.com..."
|
||||||
|
if ssh -T git@git.4nkweb.com 2>&1 | grep -q "Welcome"; then
|
||||||
|
echo "✅ Connexion SSH réussie"
|
||||||
|
else
|
||||||
|
echo "⚠️ Connexion SSH établie (message de bienvenue non détecté)"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Configurer Git pour utiliser SSH
|
||||||
|
git config --global url."git@git.4nkweb.com:".insteadOf "https://git.4nkweb.com/"
|
||||||
|
|
||||||
|
echo "✅ Configuration SSH terminée"
|
||||||
|
else
|
||||||
|
echo "⚠️ Variable SSH_PRIVATE_KEY non définie, utilisation de HTTPS"
|
||||||
|
fi
|
||||||
|
else
|
||||||
|
echo "ℹ️ Environnement local détecté"
|
||||||
|
|
||||||
|
# Vérifier si une clé SSH existe
|
||||||
|
if [ -f ~/.ssh/id_rsa ]; then
|
||||||
|
echo "🔑 Clé SSH locale trouvée"
|
||||||
|
|
||||||
|
# Configurer Git pour utiliser SSH localement
|
||||||
|
git config --global url."git@git.4nkweb.com:".insteadOf "https://git.4nkweb.com/"
|
||||||
|
|
||||||
|
echo "✅ Configuration SSH locale terminée"
|
||||||
|
else
|
||||||
|
echo "⚠️ Aucune clé SSH trouvée, configuration manuelle requise"
|
||||||
|
echo "💡 Pour configurer SSH manuellement :"
|
||||||
|
echo " 1. Générer une clé SSH : ssh-keygen -t rsa -b 4096"
|
||||||
|
echo " 2. Ajouter la clé publique à votre compte Gitea"
|
||||||
|
echo " 3. Tester : ssh -T git@git.4nkweb.com"
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo "🎯 Configuration SSH terminée pour ihm_client"
|
Loading…
x
Reference in New Issue
Block a user