Déployer une application Hello World

Découvrez comment déployer une application Hello World avec l'espace client OVHcloud et l'API OVHcloud

Objectif

Suivez ce guide de démarrage rapide pour déployer une application Hello World conteneurisée sur votre cluster OVHcloud Managed Kubernetes Service, en utilisant l'espace client OVHcloud et l'API OVHcloud.

Dans ce guide, nous allons vous accompagner dans le déploiement d'une application Hello World sur votre OVHcloud Managed Kubernetes Service. Vous pouvez gérer votre cluster via l' ou l'.

Prérequis

Vous devez déjà avoir créé un cluster sur le service OVHcloud Managed Kubernetes.
Vous aurez également besoin de l'outil en ligne de commande kubectl. Vous trouverez les instructions d'installation détaillées de cet outil sur le site officiel de Kubernetes.

Accès à l'espace client OVHcloud

Lien direct :
Pour accéder à vos services : Public Cloud > sélectionnez votre projet

Warning

Pour les utilisateurs de l'API, ce guide suppose que vous êtes familier avec l'. Si vous ne l'avez jamais utilisée, vous trouverez les bases ici : Premiers pas avec l'API OVHcloud.

En pratique

Récupérer les informations de votre cluster

Via l'espace client OVHcloud

Via l'API OVHcloud

Accédez à l'interface d'administration de vos clusters OVHcloud Managed Kubernetes en cliquant sur Managed Kubernetes Service dans le menu de gauche.

Cliquez sur votre cluster pour accéder à ses informations.

Vue du cluster OVHcloud Managed Kubernetes

Dans cette interface d'administration, plusieurs onglets sont disponibles :

Service : une vue globale de votre cluster, avec des informations importantes comme le statut, l'URL de l'API et le fichier de configuration kubectl.
Pools de nœuds : les pools de nœuds de votre cluster, avec les options pour les ajouter, les configurer ou les supprimer.
Accès APIServer : la possibilité de configurer l'accès à l'API-server.
Logs d'Audit : les logs du control plane de votre cluster Kubernetes.

Lister vos clusters OVHcloud Managed Kubernetes

Le endpoint d'API GET /cloud/project/{serviceName}/kube liste tous les clusters Kubernetes disponibles :

GET/cloud/project/{serviceName}/kube

Résultat :

[
  "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
]

En l'appelant, vous pouvez afficher une liste de valeurs. Notez l'ID du cluster que vous souhaitez utiliser. Dans cet exemple, nous y ferons référence sous le nom kubeId.

Récupérer les informations

Le endpoint d'API GET /cloud/project/{serviceName}/kube/{kubeId} fournit des informations importantes sur votre cluster Managed Kubernetes, notamment sa région, son statut et son URL.

GET/cloud/project/{serviceName}/kube/{kubeId}

Résultat :

{
  "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "region": "GRA5",
  "name": "my-tiny-cluster",
  "url": "xxxxxx.c2.gra.k8s.ovh.net",
  "nodesUrl": "xxxxxx.nodes.c2.gra.k8s.ovh.net",
  "version": "1.34.1",
  "nextUpgradeVersions": [],
  "customization": {
    "apiServer": {
      "admissionPlugins": {
        "enabled": [
          "AlwaysPullImages",
          "NodeRestriction"
        ],
        "disabled": []
      }
    }
  },
  "status": "READY",
  "updatePolicy": "ALWAYS_UPDATE",
  "isUpToDate": true,
  "controlPlaneIsUpToDate": true,
  "privateNetworkId": null,
  "createdAt": "2022-09-22T06:57:58Z",
  "updatedAt": "2022-12-15T15:14:44Z"
}

Configurer les paramètres par défaut de la CLI kubectl

Consultez la documentation Configurer kubectl sur un cluster OVHcloud Managed Kubernetes pour cette partie du processus.

Ajouter un pool de nœuds

Via l'espace client OVHcloud

Via l'API OVHcloud

Dans l'onglet Pools de nœuds de l'interface d'administration, cliquez sur le bouton Ajouter un pool de nœuds.

Saisissez un nom pour le pool de nœuds :

Ajouter un pool de nœuds - Définir un nom

Info

Seuls les caractères alphanumériques et le « - » sont autorisés pour le nom du pool de nœuds. Vous ne pouvez pas utiliser de caractères comme « _ », « . » ou « / » comme séparateur dans le nom d'un pool de nœuds.

Choisissez une flavor (type de machine) pour votre pool de nœuds, B2-7 par exemple :

Ajouter un pool de nœuds - Choisir une flavor

Configurez le nombre de nœuds que vous souhaitez ajouter à votre pool de nœuds, 3 par exemple, avec l'autoscaling désactivé.

Ajouter un pool de nœuds - Définir le nombre de nœuds

Définissez le mode de facturation : mensuel ou horaire.

Le premier élément nécessaire pour déployer l'application Hello World est un pool de nœuds dans votre cluster. Pour le créer, vous pouvez utiliser l'endpoint POST /cloud/project/{serviceName}/kube/{kubeId}/nodepool, qui déploiera un pool de nœuds pour votre cluster sur le Public Cloud.

Vous devrez fournir plusieurs informations, mais seul le paramètre flavorName (la flavor de l'instance que vous souhaitez créer) est obligatoire. Si vous ne renseignez pas de valeur pour le paramètre desiredNodes, la valeur par défaut sera 1 ; vous créerez donc un nouveau pool de nœuds avec un seul nœud. Pour ce tutoriel, nous choisissons un nœud à usage général, comme la flavor b2-7.

POST/cloud/project/{serviceName}/kube/{kubeId}/nodepool

Résultat :

{
  "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "projectId": "",
  "name": "nodepool-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "flavor": "b2-7",
  "status": "INSTALLING",
  "sizeStatus": "CAPACITY_OK",
  "autoscale": false,
  "monthlyBilled": false,
  "antiAffinity": false,
  "desiredNodes": 0,
  "minNodes": 0,
  "maxNodes": 100,
  "currentNodes": 0,
  "availableNodes": 0,
  "upToDateNodes": 0,
  "createdAt": "2023-01-13T08:52:27Z",
  "updatedAt": "2023-01-13T08:52:27Z",
  "autoscaling": {
    "scaleDownUtilizationThreshold": 0.5,
    "scaleDownUnneededTimeSeconds": 600,
    "scaleDownUnreadyTimeSeconds": 1200
  },
  "template": {
    "metadata": {
      "labels": {},
      "annotations": {},
      "finalizers": []
    },
    "spec": {
      "unschedulable": false,
      "taints": []
    }
  }
}

L'API vous retournera les informations du nouveau pool de nœuds.

Vérifier que votre pool de nœuds est prêt

Via l'espace client OVHcloud

Via l'API OVHcloud

Dans l'onglet Computer Nodes, vous pouvez inspecter l'état de vos pools de nœuds. Le pool de nœuds que vous venez de créer devrait maintenant être à l'état Installing. L'installation du pool de nœuds peut prendre une minute ; n'hésitez pas à faire une courte pause, puis à réessayer jusqu'à ce qu'il soit prêt.

Après sa création, cliquez sur le pool de nœuds afin d'afficher le détail de ses nœuds.

Vous pouvez utiliser le point d'entrée GET /cloud/project/{serviceName}/kube/{kubeId}/nodepool pour lister tous vos pools de nœuds. Recherchez le pool de nœuds que vous venez de créer et vérifiez que le statut est READY.

Info

L'installation du pool de nœuds peut prendre quelques minutes.

GET/cloud/project/{serviceName}/kube/{kubeId}/nodepool

Résultat :

[
  {
    "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "projectId": "a123b4c56d789e0ab12c345d678efa12",
    "name": "nodepool-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "flavor": "b2-7",
    "status": "READY",
    "sizeStatus": "CAPACITY_OK",
    "autoscale": false,
    "monthlyBilled": false,
    "antiAffinity": false,
    "desiredNodes": 1,
    "minNodes": 0,
    "maxNodes": 100,
    "currentNodes": 1,
    "availableNodes": 1,
    "upToDateNodes": 1,
    "createdAt": "2022-09-22T06:58:09Z",
    "updatedAt": "2022-12-15T15:14:33Z",
    "autoscaling": {
      "scaleDownUtilizationThreshold": 0.5,
      "scaleDownUnneededTimeSeconds": 600,
      "scaleDownUnreadyTimeSeconds": 1200
    },
    "template": {
      "metadata": {
        "labels": {},
        "annotations": {},
        "finalizers": []
      },
      "spec": {
        "unschedulable": false,
        "taints": []
      }
    }
  },
  {
    "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "projectId": "a123b4c56d789e0ab12c345d678efa12",
    "name": "nodepool-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "flavor": "b2-7",
    "status": "READY",
    "sizeStatus": "CAPACITY_OK",
    "autoscale": false,
    "monthlyBilled": false,
    "antiAffinity": false,
    "desiredNodes": 0,
    "minNodes": 0,
    "maxNodes": 100,
    "currentNodes": 0,
    "availableNodes": 0,
    "upToDateNodes": 0,
    "createdAt": "2023-01-13T08:52:27Z",
    "updatedAt": "2023-01-13T08:52:39Z",
    "autoscaling": {
      "scaleDownUtilizationThreshold": 0.5,
      "scaleDownUnneededTimeSeconds": 600,
      "scaleDownUnreadyTimeSeconds": 1200
    },
    "template": {
      "metadata": {
        "labels": {},
        "annotations": {},
        "finalizers": []
      },
      "spec": {
        "unschedulable": false,
        "taints": []
      }
    }
  }
]

Déployer votre première application

Vous êtes maintenant prêt à déployer votre première application dans votre cluster OVHcloud Managed Kubernetes.

Pour plus de détails sur ce processus, consultez la documentation déployer une application.

Aller plus loin

Comme vous pouvez le voir dans la section Kubernetes de l', de nombreux endpoints d'API utiles existent pour gérer vos clusters Kubernetes. N'hésitez pas à utiliser les endpoints d'API en fonction de vos cas d'usage.

Si vous avez besoin d'une formation ou d'une assistance technique pour la mise en oeuvre de nos solutions, contactez votre commercial ou cliquez sur ce lien pour obtenir un devis et demander une analyse personnalisée de votre projet à nos experts de l’équipe Professional Services.

Échangez avec notre communauté d'utilisateurs.

Cette page vous a-t-elle aidé ?