Merge pull request 'docs: ajout guide déploiement Coolify' (#7) from docs/coolify-deployment into main
Reviewed-on: AVQN/starter-astro#7
This commit is contained in:
56
README.md
56
README.md
@@ -110,4 +110,60 @@ Créez un fichier `.jsx` dans `src/components/` et utilisez-le avec une directiv
|
||||
- [Tailwind CSS](https://tailwindcss.com) - Framework CSS utility-first
|
||||
- [Docker](https://www.docker.com) - Containerisation
|
||||
|
||||
## 🚀 Déploiement sur Coolify (Production)
|
||||
|
||||
Suivez cette procédure étape par étape pour déployer une nouvelle instance de ce site.
|
||||
|
||||
### 1. Préparation dans Gitea
|
||||
|
||||
1. Allez sur le dépôt du template dans Gitea.
|
||||
2. Cliquez sur **"Utiliser ce modèle"** (Use this template).
|
||||
3. Créez votre nouveau dépôt (ex: `mon-nouveau-site`).
|
||||
|
||||
### 2. Création du projet dans Coolify
|
||||
|
||||
1. Dans Coolify, créez un **New Project**.
|
||||
2. Choisissez **Private Repository** (avec déploiement via clé privée).
|
||||
3. Sélectionnez la clé privée : `Gitea`.
|
||||
4. Sélectionnez le serveur : `avqn-worker`.
|
||||
|
||||
### 3. Configuration du Git
|
||||
|
||||
Remplissez les informations suivantes :
|
||||
|
||||
- **Repository URL** : Utilisez le format SSH court (ex: `git@git.avqn.ch:AVQN/mon-nouveau-site.git`).
|
||||
> ⚠️ **Attention** : Ne mettez PAS `ssh://` devant.
|
||||
- **Branch** : `main`
|
||||
|
||||
### 4. Configuration du Build
|
||||
|
||||
Coolify va charger le dépôt. Une fois chargé, configurez comme suit :
|
||||
|
||||
- **Build Pack** : Choisissez `Nixpacks`.
|
||||
- **Options** :
|
||||
- Cochez la case **Is it a static site?** ✅.
|
||||
- **Publish Directory** : Laissez `dist`.
|
||||
|
||||
### 5. Configuration du Domaine
|
||||
|
||||
Changez le domaine par défaut (ex: `https://mon-site.app.avqn.ch`).
|
||||
|
||||
### 6. Fonctionnalités Avancées (Indispensable pour les PRs)
|
||||
|
||||
1. Allez dans l'onglet **Features** (ou Configuration -> Advanced).
|
||||
2. Cochez **Preview Deployments** pour activer les environnements temporaires sur les Pull Requests.
|
||||
|
||||
### 7. Configuration des Webhooks (Sécurité)
|
||||
|
||||
Pour que Coolify puisse nettoyer les environnements de PR automatiquement :
|
||||
|
||||
1. Dans Coolify (menu **Webhooks** du projet), définissez un **Webhook Secret** (générez-en un ou mettez un mot de passe fort).
|
||||
2. Copiez ce secret.
|
||||
3. Allez dans **Gitea -> Configuration du dépôt -> Webhooks**.
|
||||
4. Ajoutez le Webhook Coolify (ou modifiez l'existant) et collez le code dans le champ **Secret**.
|
||||
|
||||
### 8. Lancement
|
||||
|
||||
Cliquez sur **Deploy**. 🚀
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user