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 > Managed Kubernetes Service

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

Vos clusters sont répertoriés sur la page Managed Kubernetes Service.

Cliquez sur le nom de votre cluster pour accéder à sa page de détails.

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 dans le champ 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.

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

Définissez le mode de facturation : mensuel ou horaire, puis confirmez la création.

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 Pools de nœuds, 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 ou Deploying. 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 nom du 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.

Pour une formation ou une assistance technique sur la mise en œuvre de nos solutions, contactez votre commercial ou consultez la page Professional Services pour obtenir un devis et faire analyser votre projet par nos experts.

Échangez avec notre communauté d'utilisateurs.

Cette page vous a-t-elle aidé ?