From e01100156ffddfb4975e1aa7518744c2f0e3801a Mon Sep 17 00:00:00 2001 From: ertopogo Date: Sun, 18 Jan 2026 22:25:26 +0100 Subject: Refactor environment variables and enhance installation documentation. Updated DATABASE_URL, NEXT_PUBLIC_MEDUSA_BACKEND_URL, ADMIN_CORS, and STORE_CORS to align with the revised internal DNS structure. Included additional guidelines for DNS nomenclature and clarified Git deployment instructions in INSTALLATION.md. --- INSTALLATION.md | 103 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 103 insertions(+) (limited to 'INSTALLATION.md') diff --git a/INSTALLATION.md b/INSTALLATION.md index 69bcd4c..359abe0 100644 --- a/INSTALLATION.md +++ b/INSTALLATION.md @@ -9,6 +9,24 @@ Assurez-vous d'avoir : - Une base de données **PostgreSQL** accessible (version 12+ recommandée). - **Apache** installé sur la machine hôte. +## 1.1 Nomenclature DNS (ruka.lan) + +Objectif : utiliser des noms internes stables sur `ruka.lan`, puis ouvrir les mêmes +noms en DNS public plus tard avec un minimum d'adaptations. + +Format recommande : +``` +...ruka.lan +``` + +Exemples pour Lucien Sens Bon (projet `lsb`) sur `huitral` : +- `www.lsb.huitral.ruka.lan` : storefront (site public) +- `api.lsb.huitral.ruka.lan` : API Medusa +- `admin.lsb.huitral.ruka.lan` : admin (optionnel, sinon /app sur l'API) + +Conseil : gardez cette nomenclature pour tous vos projets afin de pouvoir passer +en DNS public sans changer les URLs dans l'application. + ## 2. Configuration Initiale 1. **Variables d'environnement** : @@ -22,6 +40,43 @@ Assurez-vous d'avoir : *Note : Si votre Postgres est sur la machine hôte (hors Docker), utilisez `host.docker.internal` comme hôte dans l'URL de connexion, ou l'IP locale du serveur.* + Exemple de valeurs utilisées dans ce projet (PostgreSQL sur `npagnun`) : + ```ini + DATABASE_URL=postgres://luciensbdb:VOTRE_MOT_DE_PASSE_DB@192.168.99.35:5432/sens_bon_db + NEXT_PUBLIC_MEDUSA_BACKEND_URL=http://api.lucien-sens-bon.com + ADMIN_CORS=http://api.lucien-sens-bon.com + STORE_CORS=http://lucien-sens-bon.com + ``` + + Édition avec `vim` : + ```bash + vim .env + ``` + +## 2.1 Dépôt Git (Chillka) et récupération sur Huitral + +Cette section est à faire **avant** le reste si vous déployez depuis Git. + +### 2.1.1 Corriger le HEAD du dépôt bare (Chillka) + +Sur `chillka` : +```bash +git --git-dir=/var/data/git/repositories/lucien-sens-bon.git symbolic-ref HEAD refs/heads/main +``` + +### 2.1.2 Cloner le projet sur `huitral` + +Sur `huitral` : +```bash +cd /var/www +git clone toshiro@chillka:/var/data/git/repositories/lucien-sens-bon.git +cd lucien-sens-bon +git fetch origin +git checkout -b main origin/main +``` + +> Si votre branche distante est `master`, remplacez `main` par `master` dans les commandes ci‑dessus. + ## 3. Installation et Démarrage Lancez les conteneurs (cela va construire les images Backend et Storefront) : @@ -30,6 +85,8 @@ Lancez les conteneurs (cela va construire les images Backend et Storefront) : docker-compose up -d --build ``` +> Sur Debian 13, utilisez de préférence `docker compose` (sans tiret) si le plugin est installé. + Cela va démarrer 3 conteneurs : - `medusa-backend` (API) sur le port 9000 - `medusa-storefront` (Site Web) sur le port 8000 @@ -75,6 +132,52 @@ Pour rendre le site accessible depuis le web (port 80/443), configurez Apache su - **Storefront** : Accédez à `http://lucien-sens-bon.com` (ou votre domaine). Vous devriez voir la page d'accueil. - **Admin** : Accédez à `http://api.lucien-sens-bon.com/app` (le dashboard admin est servi par le backend). Connectez-vous avec l'utilisateur créé à l'étape 4. +## 7. Dépôt Git (Chillka) et déploiement sur Huitral + +Cette section documente la mise en place du dépôt Git **bare** sur le serveur `chillka` et le déploiement du projet sur `huitral`. + +### 7.1 Créer le dépôt bare sur `chillka` + +Sur `chillka` (root ou sudo) : +```bash +sudo mkdir -p /var/data/git/repositories/lucien-sens-bon.git +sudo git init --bare /var/data/git/repositories/lucien-sens-bon.git +sudo chown -R toshiro:git-group-users /var/data/git/repositories/lucien-sens-bon.git +``` + +### 7.2 Corriger les permissions (si `Permission denied`) + +Le dossier parent doit être accessible au groupe `git-group-users` : +```bash +sudo chgrp -R git-group-users /var/data/git/repositories +sudo chmod -R 2775 /var/data/git/repositories +``` + +### 7.3 Pousser le projet vers `chillka` (depuis votre machine locale) + +Dans le dossier du projet : +```bash +git init +git add . +git commit -m "Initial commit: Medusa Backend + Storefront + Config" +git remote add origin toshiro@chillka:/var/data/git/repositories/lucien-sens-bon.git +git push -u origin main +``` + +> Si votre branche locale s'appelle `master`, utilisez : +> ```bash +> git push -u origin master +> ``` + +### 7.4 Récupérer le projet sur `huitral` + +Sur `huitral` : +```bash +cd /var/www +git clone toshiro@chillka:/var/data/git/repositories/lucien-sens-bon.git lucien-sens-bon +cd lucien-sens-bon +``` + ## 7. Paiements Crypto Pour activer les paiements Crypto, nous vous conseillons d'installer un plugin comme `medusa-payment-coinbase` ou d'utiliser une intégration Stripe Crypto si disponible. -- cgit v1.2.3