Aller au contenu principal

Concepts et architecture

Comprendre comment s'articule l'écosystème Kuploy, et les termes employés tout au long de cette documentation.

Vue d'ensemble de l'écosystème​

Kuploy se compose de trois éléments qui fonctionnent ensemble :

┌─────────────────────────────────────────────────────────────────┐
│                        kuploy.app                               │
│             (licences et facturation centralisées)              │
│                                                                 │
│  Gère : comptes exploitants, offres de plateforme, clés de      │
│  licence, quotas globaux, codes de rattachement, abonnements    │
└────────────┬────────────────────────────┬───────────────────────┘
             │ synchro. licence           │ synchro. licence
             ▼                            ▼
┌────────────────────────┐  ┌────────────────────────┐
│   kuploy-cloud         │  │   kuploy-cloud         │
│   (instance A)         │  │   (instance B)         │
│                        │  │                        │
│  La plateforme de      │  │  Une autre instance    │
│  déploiement de        │  │  sous la même          │
│  l'exploitant, pour    │  │  licence               │
│  ses clients           │  │                        │
└────────────────────────┘  └────────────────────────┘
        │                           │
        ▼                           ▼
  Les organisations           Les organisations
  y déploient                 y déploient
  (développeurs)              (développeurs)

kuploy (le cœur open source)​

Le moteur de déploiement de base. Il fournit :

  • des déploiements depuis Git, avec plusieurs méthodes de build (Nixpacks, Dockerfile, Buildpacks) ;
  • des bases de données infogérées (PostgreSQL, MySQL, MariaDB, MongoDB, Redis) ;
  • le SSL automatique via Let's Encrypt ;
  • la supervision et les logs en direct ;
  • l'orchestration de conteneurs sur Kubernetes.

kuploy-cloud (l'édition commerciale)​

Elle enrichit le cœur open source de fonctions multi-locataires :

  • la facturation des organisations — des abonnements Stripe pour les organisations clientes ;
  • l'application des licences — les quotas synchronisés depuis kuploy.app ;
  • le tableau de bord d'administration — configuration de Stripe, SMTP, thème et identité visuelle, gestion des administrateurs ;
  • la gestion des équipes — organisations, rôles et contrôle d'accès ;
  • la marque blanche — retirer l'identité Kuploy (offre Enterprise).

kuploy.app (le centre de licences)​

L'autorité centrale de licence à laquelle se connectent les instances kuploy-cloud :

  • les comptes exploitants — les fournisseurs d'accès et opérateurs y souscrivent et gèrent leurs abonnements ;
  • les clés de licence — émises pour un exploitant, rattachées aux instances par code de rattachement ou configuration manuelle ;
  • les quotas globaux — la consommation est suivie sur l'ensemble des instances d'une licence ;
  • les indicateurs de fonctionnalité — ils déterminent les capacités ouvertes à chaque niveau d'offre.

Deux sortes d'offres​

Kuploy comporte deux dimensions de facturation bien distinctes. Les différencier est essentiel.

Les offres de plateforme (kuploy.app → exploitant)​

Ce sont les offres auxquelles vous souscrivez en tant qu'exploitant, sur kuploy.app. Elles fixent des limites globales et des indicateurs de fonctionnalité valables pour toutes vos instances.

Les offres d'instance (exploitant → organisations)​

Ce sont les offres auxquelles souscrivent vos clients, les organisations, au sein de votre instance kuploy-cloud. C'est vous qui les définissez — noms, tarifs, limites et fonctionnalités — dans votre propre instance, à /admin/plans, et elles ne peuvent jamais accorder plus que votre offre de plateforme ne le permet.

Les deux niveaux, ainsi que les niveaux de chaque produit, sont expliqués une fois pour toutes dans Les offres et les deux niveaux. Pour le catalogue de votre instance, voir Gérer vos offres.

Les termes à connaître​

TermeDéfinition
Exploitant (tenant)Un fournisseur d'accès, un opérateur de services ou un hébergeur qui fait tourner une instance kuploy-cloud. Il souscrit une offre de plateforme sur kuploy.app.
OrganisationUn client de l'exploitant. Elle déploie ses applications sur l'instance kuploy-cloud de celui-ci et souscrit une offre d'instance.
DéveloppeurUn membre d'une organisation, qui déploie et gère des applications.
InstanceUn déploiement kuploy-cloud, rattaché à une licence. Selon son offre, un exploitant peut en faire tourner plusieurs.
LicenceUne clé (lic_xxx) émise sur kuploy.app, qui autorise une instance kuploy-cloud à fonctionner. Elle transporte les limites et les indicateurs de fonctionnalité de l'offre.
Code de rattachementUn code de courte durée (par exemple KPXY-4829, valable 15 minutes) qui relie une instance kuploy-cloud à une licence sans configuration manuelle.
ProjetUn regroupement d'applications, de bases de données et de ressources apparentées au sein d'une organisation.
ApplicationUn service déployé : un conteneur qui exécute votre code.
Minutes de buildLe temps passé à construire les images applicatives depuis les sources. Décompté par période de facturation.
Synchronisation de licenceL'échange périodique entre une instance kuploy-cloud et kuploy.app, qui remonte la consommation et redescend les limites à jour.
Offre de plateformeL'abonnement souscrit sur kuploy.app (Hobby, Starter, Growth, Business, Enterprise). Il détermine les capacités au niveau de l'instance.
Offre d'instanceL'abonnement souscrit au sein d'une instance kuploy-cloud (Free, Pro, Business…). Il détermine les limites par organisation. Défini et tarifé par l'exploitant à /admin/plans, ce qui crée automatiquement le produit et le prix Stripe correspondants à l'enregistrement.

Qui doit lire quoi​

Si vous êtes…Commencez ici
Administrateur exploitant, pour mettre en place kuploy-cloudLe guide de l'exploitant
Développeur, pour déployer des applicationsLe guide du développeur
Intégrateur, pour bâtir sur l'APILa référence de l'API