Nubiecloud Docs

Quickstart : de zéro à une app en ligne sur Nubiecloud

Le parcours complet, écran par écran : créer votre compte, votre organisation et votre projet, connecter un repo Git, builder votre image, la déployer avec sa base de données, puis superviser et sauvegarder votre application.

En suivant ce guide, vous partez d'un compte inexistant et vous obtenez une application en ligne, accessible sur Internet, connectée à sa base de données, supervisée et sauvegardée. Comptez 15 à 20 minutes.

Ce tutoriel suit le parcours réel de la console Nubiecloud, dans l'ordre exact des écrans. Le fil rouge : une petite API (par exemple FastAPI ou Express) qui a besoin d'une base PostgreSQL pour démarrer — ce qui permet de montrer comment déployer une dépendance et la brancher à votre application.

Pré-requis

  • Une adresse email valide (vous recevrez un code de validation).
  • Un compte GitHub ou GitLab avec un dépôt contenant votre application (un Dockerfile, ou un projet compatible Buildpacks).
  • Environ 15 à 20 minutes devant vous.

ℹ️ Vocabulaire. Sur Nubiecloud, vos ressources s'organisent en cascade : Organisation → Projet → Environnement → Application (+ ses dépendances managées). Si ces termes ne sont pas clairs, lisez d'abord Concepts clés — mais vous pouvez aussi vous lancer, ce guide les introduit au fil de l'eau.

Étape 1 — Créer votre compte

Rendez-vous sur console.nubiecloud.io et cliquez sur Créer un compte.

  1. Saisissez votre email et un mot de passe.
  2. Validez le formulaire d'inscription.

💡 Astuce. Choisissez un mot de passe d'au moins 8 caractères mêlant majuscules, chiffres et symboles. Vous pourrez le réinitialiser à tout moment via « Mot de passe oublié ».

Étape 2 — Valider votre compte avec le code

Après l'inscription, Nubiecloud vous envoie un code de validation à 6 chiffres par email. Vous arrivez automatiquement sur l'écran de vérification.

  1. Ouvrez l'email reçu et copiez le code à 6 chiffres.
  2. Saisissez-le dans le champ de vérification, puis validez.

⚠️ Attention. C'est bien un code à saisir, pas un lien à cliquer. Si vous ne recevez rien après une minute, vérifiez vos spams puis utilisez le bouton Renvoyer le code. Le code expire après un court délai.

Étape 3 — Créer votre organisation et choisir votre plan

L'organisation est le conteneur de facturation et de ressources partagées par votre équipe. C'est ici que vous choisissez votre plan.

  1. Depuis Organisations, cliquez sur Créer une organisation.
  2. Donnez-lui un nom.
  3. Choisissez un plan : FREE, PROFESSIONAL ou BUSINESS (le plan ENTERPRISE se demande sur devis).
  4. Validez.

💡 Pour ce Quickstart, le plan FREE suffit : il est gratuit et sans limite de durée. Vous pourrez changer de plan plus tard sans recréer quoi que ce soit.

ℹ️ Le plan fixe vos quotas. Le plan de l'organisation détermine le total de CPU / RAM / Stockage que vous pourrez répartir entre vos projets. Voir Comprendre les quotas.

Étape 4 — Créer un projet et définir ses ressources

Un projet regroupe vos applications autour d'un même produit et reçoit une part des ressources de l'organisation.

  1. Allez dans Projets et cliquez sur Créer un projet.
  2. Donnez-lui un nom.
  3. Définissez les ressources allouées : CPU, RAM et Stockage, dans la limite du plan de votre organisation.
  4. Validez.

ℹ️ Preset ou personnalisé. Vous pouvez partir d'un gabarit de ressources prédéfini ou ajuster chaque valeur. Les maximums affichés correspondent à ce que votre plan autorise — voir Configurer les quotas d'un projet.

Étape 5 — Créer un environnement

Une application se déploie toujours dans un environnement (par exemple dev, staging, preproduction ou production).

  1. Ouvrez votre projet, puis l'onglet Environnements.
  2. Cliquez sur Créer un environnement.
  3. Choisissez son type (pour ce guide : production) et nommez-le.
  4. Validez.

⚠️ Étape obligatoire, souvent oubliée. Aucun environnement n'est créé automatiquement avec le projet. Sans environnement, vous ne pourrez pas déployer à l'étape 9. Créez-en au moins un maintenant.

Étape 6 — Connecter votre dépôt Git

Pour builder votre application, Nubiecloud doit accéder à votre code source.

  1. Allez dans Builds, puis Connecter un dépôt.
  2. Choisissez votre fournisseur : GitHub ou GitLab.
  3. Autorisez Nubiecloud via OAuth (vous êtes redirigé vers GitHub/GitLab, puis ramené à la console). Pour GitLab, un jeton personnel (PAT) est également possible.
  4. Sélectionnez le ou les dépôts à utiliser.

💡 Plusieurs dépôts, plusieurs comptes. Vous pouvez connecter plusieurs dépôts, et même plusieurs comptes Git, pour un même projet.

🔒 Sécurité. Nubiecloud ne stocke jamais vos identifiants Git en clair : la connexion repose sur un jeton OAuth chiffré. Vous pouvez révoquer l'accès à tout moment côté GitHub/GitLab.

Étape 7 — Choisir votre mode de build

Vous décidez quand Nubiecloud construit l'image de votre application.

  • Build manuel : vous lancez chaque build à la demande (idéal pour ce premier essai).
  • Build automatique : Nubiecloud build à chaque push, tag ou pull request, selon des règles que vous définissez (la configuration de build).

Pour ce Quickstart, restez en manuel : nous lancerons le build à la main à l'étape suivante.

💡 Pour la suite. Une fois à l'aise, activez le build automatique pour transformer chaque git push en nouvelle image. Voir Configurer le build automatique.

Étape 8 — Lancer le build de votre image

  1. Depuis Builds, cliquez sur Lancer un build.
  2. Renseignez les informations :
    • Branche (par défaut, la branche principale du dépôt).
    • Tag de l'image (par défaut latest — pour une mise en prod, préférez un tag versionné comme v1.0.0).
    • Sous-dossier source si votre application est dans un monorepo (ex. services/api).
    • Stratégie : Dockerfile ou Buildpacks.
  3. Lancez le build et suivez les logs jusqu'au message de succès.

⚠️ En cas d'échec. Les logs du build indiquent l'étape qui a échoué (dépendance manquante, Dockerfile introuvable, mauvais sous-dossier…). Consultez la checklist « build qui échoue ».

À la fin, votre image est disponible et prête à être déployée.

Étape 9 — Déployer votre application via son template

Maintenant que l'image existe, déployez-la dans votre environnement.

  1. Ouvrez l'environnement créé à l'étape 5, puis Déployer une application.
  2. Choisissez le template d'application correspondant à votre framework.
  3. Sélectionnez l'image que vous venez de builder.
  4. Renseignez les paramètres de base : ressources (CPU/RAM/Stockage), variables d'environnement, domaine et health check.
  5. Lancez le déploiement.

Templates de code disponibles : Django, FastAPI, Flask, Express, NestJS, React, Next.js, Vue.js, Spring Boot, Gin, Laravel, .NET.

ℹ️ Le détail de chaque champ (variables publiques vs secrets, domaine custom + TLS, health check TCP vs HTTP, réplicas) est documenté dans Déployer une application depuis du code.

Étape 10 — Déployer la base de données et la brancher à l'app

Notre application a besoin d'une base PostgreSQL pour démarrer. L'ordre compte : on déploie d'abord la dépendance, puis on la connecte à l'application.

  1. Toujours dans l'environnement, déployez d'abord le service managé : choisissez le template PostgreSQL et lancez-le.
  2. Une fois la base active, ouvrez sa page de gestion et récupérez ses informations de connexion : l'hôte interne et la chaîne de type DATABASE_URL y sont affichées.
  3. Retournez sur votre application et ajoutez ces informations dans ses variables d'environnement (par exemple DATABASE_URL=...).
  4. Redémarrez l'application : elle démarre désormais avec sa base prête.

Services managés disponibles : PostgreSQL, MySQL, Redis, RabbitMQ, Kafka.

⚠️ Le branchement est une action explicite. Nubiecloud déploie la base, mais c'est vous qui copiez l'hôte/DATABASE_URL du service managé vers les variables d'env de l'application. Si l'application a besoin de la base au démarrage, elle ne bootera correctement qu'après ce câblage.

💡 Plusieurs dépendances ? Répétez l'opération (ex. déployer Redis, récupérer REDIS_URL, l'injecter dans l'app). Déployez chaque dépendance avant l'application qui en a besoin.

Étape 11 — Surveiller les logs et le monitoring

Votre application tourne : vérifiez sa santé.

  1. Ouvrez la page de votre déploiement.
  2. Onglet Logs : suivez les logs en temps réel et l'historique (applications de type code).
  3. Onglet Monitoring : consultez l'état de santé, l'état des pods et les événements de l'application. (La consommation CPU/RAM se suit au niveau des quotas de l'organisation.)

💡 Si l'application ne démarre pas, les logs sont votre premier réflexe — l'erreur de connexion à la base (étape 10 mal câblée) y apparaît clairement.

Étape 12 — Activer les backups de la base

Dernière étape : protégez vos données.

  1. Sur le déploiement de votre base (ou de votre Odoo), ouvrez l'onglet Backups.
  2. Activez les backups automatiques et choisissez la rétention, ou lancez un backup à la demande.

ℹ️ Périmètre. Les backups gérés couvrent PostgreSQL et Odoo. La restauration se fait en mode Blue/Green (validation avant bascule) — voir Restaurer depuis un backup.

Résultat attendu

Vous avez maintenant :

  • ✅ Un compte validé et une organisation sur un plan.
  • ✅ Un projet avec ses ressources et un environnement de production.
  • ✅ Une application déployée depuis votre code, accessible sur son URL.
  • ✅ Une base PostgreSQL managée, branchée à l'application.
  • ✅ Des logs et un monitoring visibles, et des backups activés.

Et après ?

Documentation Nubiecloud

Guides, tutoriels et références pour déployer et opérer vos applications sur Nubiecloud.

Concepts clés

La hiérarchie Organisation → Projet → Environnement → Application, et la distinction entre builder une image et la déployer.

Sur cette page

Pré-requisÉtape 1 — Créer votre compteÉtape 2 — Valider votre compte avec le codeÉtape 3 — Créer votre organisation et choisir votre planÉtape 4 — Créer un projet et définir ses ressourcesÉtape 5 — Créer un environnementÉtape 6 — Connecter votre dépôt GitÉtape 7 — Choisir votre mode de buildÉtape 8 — Lancer le build de votre imageÉtape 9 — Déployer votre application via son templateÉtape 10 — Déployer la base de données et la brancher à l'appÉtape 11 — Surveiller les logs et le monitoringÉtape 12 — Activer les backups de la baseRésultat attenduEt après ?