Créez un jeton
Dans votre forge : Paramètres, Applications,
Générer un nouveau jeton. Réglez repository sur
Lecture et écriture.

Collez-le une seule fois
Dans un terminal, tapez cette commande avec l'adresse de votre dépôt. Donnez votre identifiant, puis le jeton à la place du mot de passe. Votre poste le garde. Détails Mac et Windows dans le guide assistant de code.
git ls-remote https://societe.gitsi.dev/organisation/appli.git
Branchez votre projet
Ouvrez Claude Code dans le dossier de votre projet, ou dans un dossier vide. Collez la phrase qui correspond à votre cas, avec l'adresse de votre dépôt.
Vous partez de zéro
Clone https://societe.gitsi.dev/organisation/appli.git dans ce dossier, en HTTPS.
On écrira l'application ici, sur la branche main.
Votre projet est sur votre poste, sans Git
Initialise Git dans ce dossier, sur la branche main. Ajoute
https://societe.gitsi.dev/organisation/appli.git comme remote origin, en HTTPS. Récupère
la branche main de la forge et fusionne-la avec
git merge origin/main --allow-unrelated-histories.
Votre projet a déjà Git, sur votre poste ou sur GitHub, GitLab ou ailleurs
S'il existe déjà un remote origin, renomme-le en ancien-origin.
Ajoute https://societe.gitsi.dev/organisation/appli.git comme remote origin,
en HTTPS. Place-toi sur main, récupère la branche main de la forge et
fusionne-la avec git merge origin/main --allow-unrelated-histories.
La forge apporte trois éléments posés par Aleop : aleop-app.toml, .aleop/ et
.gitea/workflows/image.yml. Votre ancien dépôt n'est ni modifié ni supprimé.
Faites préparer l'hébergement
Collez ensuite ce texte. L'assistant montre ce qui va partir avant d'envoyer.
Prépare ce projet pour l'hébergement Aleop, sur la branche main.
Dans aleop-app.toml, ne change ni nom, ni image, ni port.
Le Dockerfile est à la racine du dépôt. L'application y tourne sous un
utilisateur d'uid 10001, pas en root.
Elle écoute sur le port 8000. /sante/ répond 200 en HTTP sur
127.0.0.1, sans redirection vers HTTPS : l'hôte 127.0.0.1 doit être
accepté.
Si elle utilise une base, déclare [base] en PostgreSQL. Le socle fournit
DATABASE_URL, ou DB_HOST, DB_PORT, DB_NAME, DB_USER et DB_PASSWORD, ainsi
que ALLOWED_HOSTS, SITE_URL et ENVIRONNEMENT (preprod ou prod) : déclare
celles que tu lis en source plateforme.
Mets les migrations dans avant_demarrage. Il tourne à chaque déploiement
et doit pouvoir se rejouer. Un chargement à faire une seule fois (données
de départ, compte administrateur) n'y va pas : dis-le moi.
Si elle envoie des mails, déclare [mail] avec son domaine et son adresse.
Le socle fournit SMTP_HOST, SMTP_PORT, SMTP_USER, SMTP_PASSWORD et
SMTP_FROM. Le relais s'utilise sur le port 25, sans identifiant ni TLS :
coupe le TLS, que Django tente par défaut.
Si elle garde des fichiers, par exemple des photos, range-les dans un
dossier déclaré sous [volumes].
Pour une clé secrète propre à l'application, déclare-la en source
generee. Pour la clé d'un autre service, en source saisie, et dis-le moi.
Affiche la variable VERSION_APPLI dans un coin de l'application.
Les formats sont décrits dans .aleop/contrat.py.
Vérifie que .gitignore exclut .env et les fichiers de secrets. Montre-moi
la liste des fichiers qui vont partir avant de pousser, puis fais un
commit et pousse sur main.
Ne force jamais un push et ne réécris jamais l'historique : la forge le
refuse. N'écris aucun jeton ni mot de passe dans le projet.
La préprod se met à jour
Après chaque push, la forge construit l'image, puis la préprod la met en service. En moins de trois minutes, construction comprise, la nouvelle version tourne sur l'adresse de préprod donnée par Aleop. La version affichée change. Essayez votre changement.
La première fois, si votre appli envoie des mails, comptez quelques minutes de plus : Aleop met en place l'envoi.
Le signal vert de l'onglet Actions dit que l'image est construite, pas que l'application fait ce que vous voulez. Ça, vous le vérifiez en préprod.

Si elle ne démarre pas
La version précédente est remise en service. Pendant environ deux minutes, c'est la nouvelle qui est essayée. Demandez la correction à l'assistant, puis « commit et push » : la préprod essaie la version corrigée.

Ensuite, à chaque changement
Demandez le changement à l'assistant, puis « commit et push ». La préprod suit seule. Les étapes 1 à 4, c'est une seule fois.
Je ne vois pas mon changement
Ouvrez l'onglet Actions du dépôt.
- Rond orange : la construction tourne. Attendez.
- Croix rouge : la construction a échoué. Copiez le message à l'assistant et demandez une correction. Un Dockerfile qui n'est pas à la racine du dépôt fait échouer la construction.
- Tout est vert depuis plus de trois minutes et la version n'a pas changé : la nouvelle n'a pas démarré. Demandez à l'assistant de vérifier que
/sante/répond 200 en HTTP sur 127.0.0.1, au port 8000, sans redirection.
Toujours rien : écrivez-nous.
Sans assistant de code
Le même parcours se fait avec Git. De zéro, commencez par git clone de l'adresse du dépôt. Avec un projet existant :
git init -b main # si le projet n'a pas encore Git
git remote rename origin ancien-origin # s'il a déjà un origin
git remote add origin https://societe.gitsi.dev/organisation/appli.git
git fetch origin
git checkout main
git merge origin/main --allow-unrelated-histories
# Dockerfile à la racine : port 8000, /sante/ en HTTP sur 127.0.0.1, uid 10001
git add -A && git commit -m "Hébergement Aleop"
git push -u origin mainBon à savoir
- Vous seul pouvez pousser sur
main. La forge refuse le push forcé et la suppression demain: l'historique reste intact, même si l'assistant se trompe. - Une organisation par application. Une deuxième appli va dans une deuxième organisation : les comptes de publication et de déploiement d'Aleop voient tous les dépôts d'une organisation.
- La clé d'un autre service (paiement, envoi de SMS...) ne va jamais dans le dépôt. Envoyez-la à Aleop, qui la pose sur le serveur.
- La préprod est fermée au public. Votre navigateur demande un identifiant,
preprod, et un mot de passe, qu'Aleop vous envoie par un lien sécurisé. Les moteurs de recherche ne l'indexent pas. - La préprod sert à essayer. Elle n'est pas sauvegardée : n'y gardez rien d'important.
- Revenir à une version d'avant ne défait pas un changement de base de données. Prévenez Aleop avant d'en mettre un en production.
- La mise en production passe par Aleop.
Besoin d'aide ?
Notre équipe support peut vous accompagner pour ce réglage. Écrivez-nous à support@aleop.eu.