Aller au contenu principal
Version: 1.0.0

Bien démarrer

Bienvenue sur Hikube ! Cette documentation vous guidera à travers les étapes essentielles pour commencer à utiliser la plateforme et gérer vos ressources (tenants, clusters Kubernetes, machines virtuelles et applications).

Accès à la Plateforme​

Pour obtenir un accès à la plateforme Hikube, vous devez faire une demande de création de compte. Toutes les demandes de création de compte doivent être envoyées à sales@hidora.io.
Notre équipe commerciale vous guidera dans le processus d'ouverture de votre compte et vous fournira les informations nécessaires pour commencer à utiliser Hikube.

Voici comment vous connecter à votre tenant Hikube :

. via Kubeconfig​

Pour une gestion avancée, vous pouvez utiliser le fichier Kubeconfig fourni.

Installation des outils nécessaires :​

Une fois ces outils installés, vous pouvez interagir avec votre tenant directement depuis votre terminal.

Organisation des Tenants​

Hikube repose sur un système de tenants permettant d'organiser et d'isoler vos ressources.

Création de Tenants​

Il est recommandé de structurer votre organisation en plusieurs tenants. Pour créer un tenant, utilisez l'interface web :

  1. Rendez-vous dans l'onglet "Catalog".
  2. Sélectionnez l'application "Tenant".
  3. Définissez les paramètres souhaités (host, ingress, isolation...).

Une fois vos tenants créés, vous pouvez y accéder :

  • Depuis l'interface web (menu déroulant en haut à droite).
  • Via leurs Kubeconfigs respectifs, disponibles dans l'onglet "Applications" → cliquez sur le tenant souhaité → récupérez le fichier dans la section "Secrets".

Pour plus d'informations sur la gestion et la création des Tenants, n'hésitez pas à aller consulter notre page dédiée aux Tenants.

Déploiement d'Applications Kubernetes​

Il est déconseillé d'installer des applications directement sur les clusters des tenants.
Bonne pratique :
🔹 Créez un cluster Kubernetes à l’intérieur du tenant (via l’interface web ou en CLI).
🔹 Installez vos applications sur ce nouveau cluster, plutôt que sur celui du tenant directement.

Pour plus d'informations sur le provisionnement de Kubernetes, consultez la page Kubernetes.

Création d’une Machine Virtuelle (VM)​

Étapes de Création​

Une VM sur Hikube repose sur deux ressources essentielles :

  1. VMDisk – Définit l’image disque à utiliser.
  2. VMInstance – Utilise un VMDisk pour démarrer la VM.

Procédure​

  1. Créer un VMDisk

    • Sélectionnez l'application "VMDisk" dans le Catalog.

    • Utilisez une image cloud ISO, par exemple :

      https://cloud-images.ubuntu.com/noble/current/noble-server-cloudimg-amd64.img

    • Configurez la taille du disque et la StorageClass (replicated ou local).

  2. Créer une VMInstance

    • Sélectionnez l'application "VMInstance".
    • Associez-la au VMDisk précédemment créé.
    • Configurez la machine (RAM, CPU, réseau, etc.).
    • Utilisez cloud-init pour automatiser la configuration de la VM :

Pour plus d'informations sur le provisionnement de Kubernetes, consultez les pages VMDisks et VMInstances.

Récupérer les Kubeconfigs des Tenants​

Chaque tenant a un Kubeconfig unique, permettant d'y accéder via kubectl.
Pour récupérer un Kubeconfig :

  1. Accédez à l'interface web.
  2. Ouvrez l'onglet "Applications".
  3. Sélectionnez votre tenant.
  4. Récupérez le Kubeconfig dans la section "Secrets".

Une fois le Kubeconfig récupéré, utilisez la commande suivante pour l’ajouter :

export KUBECONFIG=/chemin/vers/kubeconfig.yaml
kubectl get nodes

Recommandations Générales​

✔ Isoler les environnements : Utilisez plusieurs tenants pour organiser vos ressources proprement.
✔ Créer un Kubernetes par besoin : Ne pas installer les applications sur les clusters des tenants directement.
✔ Utiliser Cloud-Init pour les VMs : Simplifie l’automatisation de l’installation et la configuration.

Bienvenue sur Hikube ! 🎉 Si vous avez des questions ou besoin d’aide, consultez la documentation ou contactez notre support.