Démarrage rapide

Démarrage rapide

Ce guide vous accompagne pour créer votre premier cluster Kubernetes sur Deployme.cloud.

Astuce

Avec le plan Community, vous bénéficiez de 20 heures/mois de cluster hébergé gratuitement, sans carte bancaire.

Via l’interface web (Manager)

1. Créez votre compte

   Rendez-vous sur app.deployme.cloud et inscrivez-vous. L’authentification est gérée via OIDC (Zitadel).

2. Créez un nouveau cluster

   Depuis le dashboard, cliquez sur “Nouveau cluster” et configurez :

   • Nom du cluster
   • Nombre de control planes (1 ou 3 pour la haute disponibilité)
   • Nombre de workers (1 minimum)
   • Taille des nodes (CPU / RAM)

3. Attendez le provisioning

   Le cluster est provisionné automatiquement. L’opération prend généralement 2 à 5 minutes.

4. Récupérez votre kubeconfig

   Une fois le cluster prêt, téléchargez le fichier kubeconfig depuis le dashboard.

5. Connectez-vous à votre cluster

   export KUBECONFIG=~/Downloads/deployme-kubeconfig.yaml
   kubectl get nodes

Via le SDK

Go

package main

import (
    "context"
    "fmt"
    deployme "github.com/deployme-cloud/deployme-sdk-go"
)

func main() {
    client := deployme.NewClient("YOUR_API_TOKEN")

    cluster, err := client.Clusters.Create(context.Background(), &deployme.CreateClusterInput{
        Name:          "mon-cluster",
        ControlPlanes: 1,
        Workers:       2,
        NodeSize:      "medium",
    })
    if err != nil {
        panic(err)
    }

    fmt.Printf("Cluster %s créé ! Status: %s\n", cluster.Name, cluster.Status)
}

Python

from deployme import DeploymeClient

client = DeploymeClient(api_token="YOUR_API_TOKEN")

cluster = client.clusters.create(
    name="mon-cluster",
    control_planes=1,
    workers=2,
    node_size="medium",
)

print(f"Cluster {cluster.name} créé ! Status: {cluster.status}")

TypeScript

import { DeploymeClient } from "@deployme-cloud/sdk";

const client = new DeploymeClient({ apiToken: "YOUR_API_TOKEN" });

const cluster = await client.clusters.create({
  name: "mon-cluster",
  controlPlanes: 1,
  workers: 2,
  nodeSize: "medium",
});

console.log(`Cluster ${cluster.name} créé ! Status: ${cluster.status}`);

Via Terraform

terraform {
  required_providers {
    deployme = {
      source  = "deployme-cloud/deployme"
      version = "~> 0.1"
    }
  }
}

provider "deployme" {
  api_token = var.deployme_api_token
}

resource "deployme_cluster" "example" {
  name           = "mon-cluster"
  control_planes = 1
  workers        = 2
  node_size      = "medium"
}

output "kubeconfig" {
  value     = deployme_cluster.example.kubeconfig
  sensitive = true
}

Via la CLI

# Installation
curl -fsSL https://get.deployme.cloud/cli | sh

# Authentification
deployme auth login

# Créer un cluster
deployme cluster create \
  --name mon-cluster \
  --control-planes 1 \
  --workers 2 \
  --node-size medium

# Récupérer le kubeconfig
deployme cluster kubeconfig mon-cluster > kubeconfig.yaml

Et ensuite ?

Votre cluster est prêt. Vous pouvez maintenant :

• Consulter le guide de monitoring pour surveiller votre cluster
• Apprendre le scaling pour ajuster la taille de votre cluster
• Explorer la référence API pour automatiser vos workflows