Un Conteneur Pro démarre avec un projet de départ qui fonctionne déjà. Il vous reste à le remplacer par votre code. Ce guide vaut pour les modèles Application Node.js, Application Python et Site web statique.
Où se trouve votre application
Votre code vit dans le dossier app de votre conteneur. Dans le conteneur, ce dossier s'appelle /app. Il est conservé à chaque redémarrage, redéploiement ou changement de formule, et il est partagé par tous les nœuds.
| Modèle | Fichier lancé | Port de l'application |
|---|---|---|
| Site web statique | index.html | 80 |
| Application Node.js | server.js | 3000 |
| Application Python | app.py | 8000 |
Déposer votre code
- Ouvrez votre conteneur, onglet Fichiers. Il s'ouvre directement dans le dossier
app. - Cliquez sur Importer pour envoyer vos fichiers (plusieurs à la fois, 100 Mo par fichier), ou sur + Fichier pour en créer un.
- Pour un projet entier, utilisez plutôt le SFTP : les identifiants sont dans l'onglet Accès. Voir Se connecter en SFTP.
- Cliquez sur Redémarrer pour que votre application prenne le nouveau code.
Un site statique n'a pas besoin de redémarrage : un fichier déposé dans app est en ligne tout de suite.
Les dépendances s'installent toutes seules
- Node.js : les paquets de
package.jsonsont installés à chaque démarrage. Ils restent dans/app/node_modules. - Python : les paquets de
requirements.txtsont installés à chaque démarrage. Ils restent dans/app/.pylibs, ils ne sont donc pas retéléchargés quand vos nœuds sont recréés.
Si l'installation échoue, votre application démarre quand même et le message apparaît dans l'onglet Journaux.
Lancer autre chose que server.js ou app.py
Ouvrez Configuration, champ Commande de démarrage, et saisissez votre commande. Par exemple :
node index.js
npm start
uvicorn main:app --host 0.0.0.0 --port 8000Votre commande est lancée depuis /app, après l'installation des dépendances. Laissez le champ vide pour revenir à la commande du modèle.
En Node.js, si server.js n'existe pas et que package.json contient un script start, c'est npm start qui est lancé.
Votre application doit écouter sur toutes les interfaces (0.0.0.0), pas seulement sur localhost, et sur le port indiqué dans Configuration → Ports publiés.
Variables d'environnement et ports
Dans Configuration :
- Variables d'environnement : une ligne par variable (clés d'API, adresse de base de données). Jusqu'à 100.
- Ports publiés : chaque port interne reçoit une adresse publique. Jusqu'à 10 ports, en TCP ou en UDP.
Cliquez sur Enregistrer : vos nœuds sont recréés avec la nouvelle configuration en quelques secondes. Vos dossiers /app et /data et votre adresse publique sont conservés.
L'adresse de votre application
Votre application reçoit une adresse publique de la forme IP:port, affichée en haut du panel avec le bouton Ouvrir. Elle ne change pas quand vous redémarrez ou redéployez.
Vous pouvez pointer un nom de domaine vers cette IP avec un enregistrement A. Le port reste à préciser dans l'adresse (http://exemple.fr:25600). Le HTTPS automatique n'est pas encore proposé.
Lire les journaux
L'onglet Journaux affiche ce que votre application écrit (les console.log, les print, les erreurs). Cochez Suivre en direct pour le voir défiler, ou téléchargez-le.
Si votre conteneur passe en erreur au démarrage, les dernières lignes du journal sont rappelées dans le bandeau rouge.
Où ranger vos données
/app: votre code./data: vos fichiers de données (envois des utilisateurs, base SQLite).
Tout le reste du système du conteneur est remis à neuf à chaque redéploiement. N'y rangez rien que vous voulez garder.
