🚀 Démarrage rapide avec Hikube

Bienvenue ! Ce guide vous accompagne pas à pas pour créer votre premier projet sur Hikube. À la fin de ce tutoriel, vous aurez déployé votre première application dans un environnement complètement sécurisé.

---

Prérequis

Accès à la plateforme

Si vous n'avez pas encore de compte Hikube, contactez notre équipe à sales@hidora.io pour obtenir vos accès.

Installation des outils requis

kubectl (obligatoire)

macOS

# Homebrew
brew install kubectl

Linux

# Ubuntu/Debian
sudo apt-get update && sudo apt-get install -y kubectl

# RHEL/CentOS/Fedora
sudo dnf install kubectl
# ou pour les versions plus anciennes
sudo yum install kubectl

# Alpine Linux
sudo apk add kubectl

Windows

# Chocolatey
choco install kubernetes-cli

# winget
winget install Kubernetes.kubectl

📖 Documentation officielle : Install kubectl

kubelogin (requis pour l'authentification OIDC)

kubelogin est un plugin kubectl pour l'authentification OpenID Connect (OIDC).

macOS / Linux (Homebrew)

brew install kubelogin

Krew (macOS, Linux, Windows)

kubectl krew install oidc-login

Windows (Chocolatey)

choco install kubelogin

📖 Documentation officielle : int128/kubelogin

Attention

N'utilisez pas le kubelogin d'Azure (Azure/kubelogin). Hikube utilise l'authentification OIDC standard et nécessite le plugin int128/kubelogin.

Outils optionnels recommandés

Pour une meilleure expérience de gestion Kubernetes :

• Lens - Interface graphique moderne pour Kubernetes
• K9s - Interface terminal interactive pour Kubernetes
• Helm - Gestionnaire de paquets pour Kubernetes
• kubectx + kubens - Outils pour changer rapidement de contexte et namespace

---

Étape 1 : Accéder à votre Tenant

Configuration kubectl

1. Récupérez votre kubeconfig auprès de votre administrateur Hikube
2. Configurez kubectl avec votre fichier de configuration :

   # Option 1: Variable d'environnement
   export KUBECONFIG=/path/to/your/hikube-kubeconfig.yaml
   
   # Option 2: Copie dans le répertoire par défaut
   cp hikube-kubeconfig.yaml ~/.kube/config

3. Vérifiez la connexion :

   kubectl get pods

Configuration multiple

Vous pouvez gérer plusieurs clusters avec kubectl config get-contexts et kubectl config use-context <context-name>

Vérification de votre tenant

Votre tenant est votre espace de travail isolé. Vérifiez que vous êtes dans le bon contexte :

kubectl config current-context

Ne pas utiliser -A / --all-namespaces

Le flag -A (--all-namespaces) effectue une requête au niveau cluster, ce qui est interdit pour un utilisateur tenant. Utilisez toujours les commandes sans -A : votre kubeconfig cible déjà votre namespace.

---

Étape 2 : Créer votre premier Cluster Kubernetes

Déploiement via kubectl

1. Créez un fichier YAML pour votre cluster Kubernetes
2. Personnalisez la configuration selon vos besoins
3. Déployez avec kubectl :

apiVersion: apps.cozystack.io/v1alpha1
kind: Kubernetes
metadata:
  name: kube
spec:
  addons:
    certManager:
      enabled: true
      valuesOverride: {}
    fluxcd:
      enabled: false
      valuesOverride: {}
    ingressNginx:
      enabled: true
      hosts:
      - mon-app.example.com
      valuesOverride: {}
    monitoringAgents:
      enabled: false
      valuesOverride: {}
    verticalPodAutoscaler:
      valuesOverride: {}
  controlPlane:
    replicas: 3
  host: k8s-api.example.com
  kamajiControlPlane:
    addons:
      konnectivity:
        server:
          resources: {}
          resourcesPreset: small
    apiServer:
      resources: {}
      resourcesPreset: small
    controllerManager:
      resources: {}
      resourcesPreset: small
    scheduler:
      resources: {}
      resourcesPreset: small
  nodeGroups:
    md0:
      ephemeralStorage: 30Gi
      instanceType: u1.large
      maxReplicas: 6
      minReplicas: 3
      roles:
      - ingress-nginx
  storageClass: replicated

4. Déployez le cluster :

   # Sauvegardez la configuration dans un fichier
   kubectl apply -f my-kubernetes-cluster.yaml

⏳ Suivi du déploiement

• Le cluster sera prêt en 1-3 minutes
• Suivez l'état avec kubectl :

  kubectl get kubernetes
  kubectl describe kubernetes kube

• Status "Ready" = Cluster opérationnel ✅

---

Configuration DNS

Enregistrements DNS requis

Pour que votre cluster soit accessible, vous devez créer les enregistrements DNS suivants chez votre fournisseur DNS :

# Récupérez l'IP publique de votre cluster via les Ingress
kubectl get ingress

Résultat attendu :

NAME                            CLASS           HOSTS                 ADDRESS        PORTS   AGE
kubernetes-kube                 tenant-myco     k8s-api.example.com   91.x.x.x      80      2m
kubernetes-kube-ingress-nginx   tenant-myco     mon-app.example.com   91.x.x.x      80      2m

Créez les enregistrements DNS chez votre fournisseur :

Type A : k8s-api.example.com → <ADDRESS>
Type A : mon-app.example.com → <ADDRESS>

Configuration DNS

• k8s-api.example.com : Point d'accès à l'API Kubernetes
• mon-app.example.com : Domaine pour vos applications via Ingress
• Remplacez example.com par votre vraie zone DNS

---

Étape 3 : Récupérer le Kubeconfig

Extraction du kubeconfig du cluster

Une fois votre cluster déployé et prêt, récupérez ses credentials avec cette commande :

# Récupérez le kubeconfig du cluster créé (adaptez le nom du cluster)
kubectl get secret kubernetes-<clusterName>-admin-kubeconfig \
  -o go-template='{{ printf "%s\n" (index .data "admin.conf" | base64decode) }}' > admin.conf

# Exemple concret avec le cluster "kube" :
kubectl get secret kubernetes-kube-admin-kubeconfig \
  -o go-template='{{ printf "%s\n" (index .data "admin.conf" | base64decode) }}' > admin.conf

Variable à personnaliser

• <clusterName> : Remplacez par le nom de votre cluster (ex: kube selon le manifeste YAML)

Configuration locale

# Utilisez le kubeconfig du nouveau cluster
export KUBECONFIG=./admin.conf

# Vérifiez la connexion au cluster créé
kubectl get nodes

remarque

Cette commande ne fonctionnera qu'après avoir configuré les enregistrements DNS (section précédente). Les nœuds workers peuvent prendre quelques minutes supplémentaires à apparaître.

Félicitations !

Votre cluster Kubernetes est maintenant opérationnel avec haute disponibilité native !

---

Résumé

Vous avez créé :

• Un cluster Kubernetes haute disponibilité
• Un environnement totalement sécurisé (isolation réseau)
• Un stockage résilient (réplication automatique)

---

Besoin d'aide ?

Documentation

• FAQ → Réponses aux questions courantes
• Troubleshooting → Solutions aux problèmes

Support

• Email : support@hidora.io
• Documentation : Cette plateforme
• Communauté : Forums et chat en temps réel

Bravo ! 🎊

Vous venez de faire vos premiers pas sur Hikube. Votre infrastructure est maintenant prête à accueillir tous vos projets les plus ambitieux !

---

Prochaine étape recommandée : 📖 Concepts clés → Maîtrisez les fondamentaux d'Hikube