88 lines
1.8 KiB
Markdown
88 lines
1.8 KiB
Markdown
|
||
# Démarrage avec Docker
|
||
|
||
## Builder ou re-builder l'image Docker
|
||
|
||
Pour construire ou reconstruire l'image Docker (forcer le rebuild même si une image existe déjà) :
|
||
|
||
```bash
|
||
docker build --no-cache -t chill-site:latest .
|
||
```
|
||
|
||
## Lancer le site en local avec un nom de conteneur
|
||
|
||
```bash
|
||
docker run --name chill-site-container -p 1313:1313 -p 3001:3001 -d chill-site:latest
|
||
```
|
||
|
||
Pour relancer après un arrêt :
|
||
|
||
```bash
|
||
docker start chill-site-container
|
||
```
|
||
|
||
Pour supprimer le conteneur (si besoin de re-builder et relancer) :
|
||
|
||
```bash
|
||
docker rm -f chill-site-container
|
||
```
|
||
|
||
Le site sera accessible sur http://localhost:1313
|
||
|
||
## Utiliser le backend de contact
|
||
|
||
Le formulaire de contact du site envoie les données vers un backend Node.js défini dans `contact-backend.js`.
|
||
|
||
### 1. Configurer les variables d'environnement
|
||
|
||
Créer un fichier `.env` à la racine du projet (ou copier `.env.template`) et renseigner :
|
||
|
||
```bash
|
||
SMTP_HOST=smtp.example.com
|
||
SMTP_PORT=587
|
||
SMTP_SECURE=false
|
||
SMTP_USER=utilisateur@example.com
|
||
SMTP_FROM=utilisateur@example.com
|
||
SMTP_PASS=mot_de_passe
|
||
PORT=3001
|
||
```
|
||
|
||
Notes :
|
||
- `SMTP_SECURE=true` en général pour le port 465.
|
||
- `SMTP_SECURE=false` en général pour les ports 587 et 25.
|
||
|
||
### 2. Installer les dépendances Node.js
|
||
|
||
Si ce n'est pas déjà fait :
|
||
|
||
```bash
|
||
npm install
|
||
```
|
||
|
||
### 3. Démarrer le backend contact
|
||
|
||
```bash
|
||
node contact-backend.js
|
||
```
|
||
|
||
Le serveur écoute par défaut sur `http://localhost:3001` et expose l'endpoint `POST /contact`.
|
||
|
||
### 4. Vérifier l'URL du formulaire
|
||
|
||
Dans `content/contact.md`, la valeur `contactForm.action` doit pointer vers le backend :
|
||
|
||
```yaml
|
||
contactForm:
|
||
action: "http://localhost:3001/contact"
|
||
```
|
||
|
||
### 5. Lancer le site Hugo
|
||
|
||
Dans un autre terminal :
|
||
|
||
```bash
|
||
npm run start
|
||
```
|
||
|
||
Le formulaire sera alors fonctionnel en local, à condition que le backend tourne en même temps.
|