Aller au contenu principal

Rattacher votre instance à une licence

Toute instance kuploy-cloud a besoin d'une licence valide pour fonctionner. La licence détermine les limites de l'offre et autorise l'instance à se synchroniser avec le centre de licences, chez kuploy.app.

Sans licence :

  • la création de ressources est bloquée — projets, applications, bases de données… ;
  • les déploiements ne peuvent pas démarrer ;
  • l'assistant de configuration s'affiche pour vous guider dans le rattachement.

Cette page décrit la mise en place côté Kuploy Cloud. Ce que les licences ont en commun d'un produit à l'autre — codes de rattachement, états de synchronisation, qui exploite un déploiement, et pourquoi une clé est un identifiant — figure dans Licences.

Offres de plateforme et offres d'instance

Ce que vous payez à kuploy.app et ce que vos organisations vous paient relèvent de deux niveaux distincts — voir Les offres et les deux niveaux.

Les offres de plateforme​

Votre niveau Kuploy Cloud fixe des limites globales et des indicateurs de fonctionnalité pour toutes les instances rattachées à votre licence. Les niveaux, leurs limites et leurs fonctionnalités figurent dans Les offres et les deux niveaux → Les niveaux Kuploy Cloud ; les tarifs sont sur kuploy.app/pricing.

Les autres produits​

Leeram Business et GrowthOps utilisent les mêmes licences, mais l'autorité d'exploitation et la mise en place diffèrent. Voir Licences → Qui exploite un déploiement, Leeram Business et GrowthOps.

Rattacher votre instance​

Il y a trois façons de relier votre instance kuploy-cloud à une licence.

La façon la plus simple, et sans aucune configuration :

  1. Démarrez votre instance kuploy-cloud sans configuration de licence
  2. Un assistant de configuration apparaît et affiche un code de rattachement (par exemple KPXY-4829)
  3. Rendez-vous sur kuploy.app/claim et connectez-vous
  4. Saisissez le code et choisissez la licence à rattacher
  5. Votre instance reçoit automatiquement la licence et commence à se synchroniser

Les avantages :

  • aucune modification de .env à la main ;
  • aucune clé de licence à copier-coller ;
  • fonctionne derrière un pare-feu, car l'instance interroge vers l'extérieur ;
  • sûr : les codes expirent au bout de 15 minutes.
astuce

Le code de rattachement s'affiche sur l'écran de votre instance kuploy-cloud. Il suffit d'ouvrir kuploy.app/claim dans un autre onglet pour terminer l'opération.

Option B : la configuration manuelle, par variables d'environnement​

Pour un déploiement automatisé, ou lorsque le code de rattachement ne convient pas, la licence se configure par variables d'environnement.

Ajoutez ceci au fichier .env de votre kuploy-cloud :

LICENSE_KEY=lic_xxxxxxxxxxxxxxxx
LICENSE_HUB_URL=https://kuploy.app

Puis redémarrez votre instance.

Option C : la configuration depuis l'interface d'administration​

Vous pouvez aussi configurer — ou modifier — la connexion au centre de licences directement depuis le tableau de bord d'administration, sans redémarrage :

  1. Allez dans Admin → Domains → License Hub Integration
  2. Saisissez l'URL du centre de licences et la clé de licence
  3. Cliquez sur Save License Hub Configuration

La configuration enregistrée depuis l'interface prime sur les variables d'environnement. Vous pouvez donc amorcer par variables d'environnement, puis les remplacer depuis l'interface sans toucher à votre .env ni redémarrer.

L'ordre de priorité

La configuration de licence effective suit cet ordre :

  1. la configuration de l'interface d'administration, stockée en base — prioritaire dès qu'elle est enregistrée ;
  2. les variables d'environnement (LICENSE_KEY, LICENSE_HUB_URL) — pour l'amorçage et en recours ;
  3. le flux de rattachement, c'est-à-dire la licence stockée en base depuis un code de rattachement — utilisé lorsqu'aucune variable d'environnement n'est définie.

Pour revenir aux variables d'environnement, utilisez Admin → Domains → Reset License Hub.

Retrouver votre clé de licence​

  1. Connectez-vous à kuploy.app
  2. Allez dans Licenses
  3. Cliquez sur votre licence pour en voir le détail
  4. Copiez la clé

Les variables d'environnement​

Les variables de licence — LICENSE_KEY, LICENSE_HUB_URL et LICENSE_SYNC_INTERVAL_SECONDS — sont listées dans la référence des variables d'environnement. Une configuration de centre de licences enregistrée depuis l'interface d'administration (Admin → Domains) prime sur elles, sans redémarrage.

Pour la suite​