Déployer son site web automatiquement sur les serveurs du Garage

1. Mise en ligne de son site

1.1 Se rendre à l'adresse correspondant au type de projet :

• Pour déployer un site web
• pour déployer un site hugo

1.2 Cliquer sur Utiliser ce modèle.

1.3 Choisir un nom de dépôt et, dans les éléments du modèle, cocher Contenu Git (branche par défaut).

Bien choisir le nom de votre dépôt, car celui-ci figurera dans le nom de domaine pour accéder au site déployé.

les majuscules et les caractères spéciaux rendront le projet non déployable (exemple: mon_projet).

1.4 Cliquer sur Créer un dépôt.

1.5 Une fois le dépôt créé, le cloner sur votre machine locale :

git clone git@git.legaragenumerique.fr:gitea_username/nom_du_projet.git

Le git clone via SSH nécessite d'ajouter sa clé SSH sur le serveur GIT, sinon on peux le cloner en utilisant le lien HTTPS

1.6 Ajouter votre contenu en respectant les structure décrite ci-dessous:

Pour déployer

un site webun site hugo

├── Dockerfile
├── html
│   ├── content
│   │   ├── page1.html
│   │   ├── page2.html
│   │   └── page3.html
│   ├── css
│   │   └── styles.css
│   └── index.html
└── README.md

├── Dockerfile
├── hugo
│   ├── content
│   │   ├── page1.html
│   │   ├── page2.html
│   │   └── page3.html
│   └── config.toml
└── README.md

1.7 créer la branch deploy et la pousser:

git checkout -b deploy
git push -u origin deploy

Le site est mis en ligne à l'adresse gitea_username-nom_du_projet.legaragenumerique.xyz

2. Mettre à jour son site

• Une fois les modifications éffectuée sur vos fichiers, simplement pousser sur le serveur:

  git add * 
  git commit -m "maj fichier example.html"
  git push

S'assurer d'être bien sur la branche deploy

3. Retirer son site

3.1 changer de branche (ne plus être sur la branche deploy):

git checkout main

3.2 supprimer la branch deploy locale:

git branch -d deploy

3.3 supprimer la branch deploy distante:

git push --delete origin deploy

Le site n'est plus en ligne