Notice pour votre IA
# Notice MyPC : mettre mon site en ligne (Hébergement Docker pour IA)
Version générique. La notice déjà remplie avec mes accès est jointe à l'e-mail de MyPC et se télécharge dans mon espace MyPC.
Tu es l'assistant de programmation de mon projet. Aide-moi à mettre ce site en ligne chez MyPC, étape par étape.
Explique-moi simplement ce que tu fais, et préviens-moi quand j'ai quelque chose à faire moi-même.
Mes accès (dans l'e-mail de MyPC) :
- Dépôt Git : MON-DEPOT (du type git@git.ntcloud.ovh:clients/clientNNN-site.git)
- Compte Gitea : MON-IDENTIFIANT-GITEA, sur https://git.ntcloud.ovh (je m'y connecte moi-même, tu n'as pas mon mot de passe)
- Adresse de démo : https://MON-ADRESSE-DEMO (du type diamant.ntcloud.ovh)
- Fichiers du dossier data/ (sFTP) : accès fermé par défaut. Je l'active moi-même dans mon espace MyPC (https://inscription.ntcloud.ovh/hebergement/espace), bouton « Activer l'accès sFTP » ; la commande de connexion s'y affiche ensuite (du type sftp -P 22NN sftp-clientNNN@sftp.ntcloud.ovh).
## 1. Préparer le projet
- Un fichier Dockerfile à la racine du projet, un seul conteneur.
- L'application écoute sur le port 3000.
- Aucun mot de passe ni clé d'API dans le code (voir l'étape 5).
## 2. Clé SSH (une seule fois)
- Si la clé ~/.ssh/id_ed25519 n'existe pas, crée-la : ssh-keygen -t ed25519
- Montre-moi sa partie publique (id_ed25519.pub). Je la colle moi-même sur https://git.ntcloud.ovh :
mon profil, Settings, SSH / GPG Keys, Add Key.
- Vérifie ensuite la connexion : ssh -T git@git.ntcloud.ovh
## 3. Envoyer le code
- Clone le dépôt MyPC dans un nouveau dossier : git clone MON-DEPOT
(il arrive dans le dossier clientNNN-site).
- Il contient un site d'exemple : remplace-le par mon projet (avec son Dockerfile).
Ne touche pas au dossier .gitea/ : il contient les actions de MyPC.
- Puis : git add . / git commit -m "Mise en ligne" / git push (branche main).
## 4. Vérifier la mise en ligne
- Chaque git push sur main lance l'action « Mise en ligne » : construction, test de démarrage, mise en ligne en HTTPS.
- Suis-la dans l'onglet Actions du dépôt, sur https://git.ntcloud.ovh.
- Si elle échoue, l'ancienne version reste en ligne : lis l'erreur, corrige, renvoie.
- Une fois réussie, le site est sur https://MON-ADRESSE-DEMO.
## 5. Mots de passe et clés d'API
- Jamais dans le code ni dans le dépôt : l'application les lit dans son environnement (process.env, os.environ…).
- Dis-moi lesquels il faut, avec leur NOM exact (majuscules, chiffres et _) : je les saisis moi-même dans
mon espace MyPC, rubrique « Variables secrètes », une ligne NOM=valeur par variable. Le site redémarre avec elles.
- Ne me demande jamais leurs valeurs, et ne les écris nulle part.
## 6. Fichiers à garder (images, fichiers des visiteurs)
- L'application les range dans le dossier data/ (monté dans /app/data, variable DATA_DIR) :
il est conservé à chaque mise en ligne et à chaque retour en arrière.
- J'y accède en sFTP avec ma clé SSH de Gitea, une fois l'accès activé dans mon espace MyPC.
- Pas de code en sFTP : le code passe par git push.
- L'application doit tourner avec l'utilisateur 1000 (USER node dans une image Node, comme le site d'exemple) :
c'est celui de mon accès sFTP. Ce qu'elle écrirait en root, je pourrais le lire mais pas le modifier.
## 7. Envoyer des e-mails, ouvrir un port
- Le port 25 est fermé en sortie : l'application ne peut pas envoyer ses e-mails directement.
- Pour en envoyer (création de compte, mot de passe oublié, formulaire de contact…), passe par un service d'envoi
d'e-mails transactionnels : de préférence par son API en HTTPS, sinon en SMTP authentifié sur le port 587.
Ses identifiants vont dans les Variables secrètes (étape 5). Je crée moi-même le compte chez ce service et je
règle mon nom de domaine comme il l'indique (SPF, DKIM).
- Seul le web est publié : l'application, sur le port 3000, en HTTPS sur mon adresse. Aucun autre port n'est ouvert.
- S'il faut un autre port ou un autre protocole (WebSocket, serveur de jeu…), j'écris à MyPC, qui étudie au cas par cas.
## 8. Gérer le site (onglet Actions du dépôt, action Gestion, Run workflow, puis choisir)
- restart : redémarrer le site.
- status : voir son état et la version en ligne.
- logs : lire les derniers journaux, pour comprendre un problème.
- rollback : revenir à la version précédente.
## 9. Mon nom de domaine
- Rien à faire ici : quand le site me plaît, j'écris à MyPC, qui le branche sur mon domaine.
Si tu bloques, dis-le-moi. Avec l'offre Assistance, j'écris à MyPC (en répondant à l'e-mail de mes accès), du lundi au vendredi de 9 h à 19 h.
Avec l'offre Essentiel, il n'y a pas d'assistance, mais MyPC restaure une sauvegarde sur demande.
