Créer un cluster

Vous pouvez créer des clusters Kubernetes managés pour déployer vos applications conteneurisées. OKS vous permet de démarrer des clusters Kubernetes avec une configuration prédéfinie et des services essentiels pré-installés, afin de vous éviter de gérer des déploiements inutiles.

Créer un cluster avec OKS CLI

Avant de commencer :

Pour créer un cluster, utilisez la commande cluster create en suivant cette syntaxe :

Exemple de requête : Créer un cluster mono Sous-région
$ oks-cli cluster create \
    --cluster-name NAME_OF_CLUSTER \
    --project-name NAME_OF_PROJECT \
    --admin "1.2.3.4/32,5.6.7.8/32" \
    --version VERSION_NUMBER \
    --control-plane "cp.3.masters.small" \
    --zone 2b
Exemple de requête : Créer un cluster multi-Sous-régions
$ oks-cli cluster create \
    --cluster-name NAME_OF_CLUSTER \
    --project-name NAME_OF_PROJECT \
    --admin "1.2.3.4/32,5.6.7.8/32" \
    --version VERSION_NUMBER \
    --control-plane "cp.3.masters.small" \
    --cp-multi-az

Cette commande contient les options suivantes que vous devez spécifier :

  • cluster-name : Le nom du cluster, d’une longueur maximale de 40 caractères alphanumériques et tirets (-). Ce nom doit commencer par une lettre minuscule et ne doit pas finir par un tiret. Il doit être unique dans le projet.

  • (optionnel) description : La description du cluster que vous voulez créer.

  • (optionnel) project-name : Le nom du projet dans lequel vous voulez créer le cluster.

  • admin : Les IP à mettre sur liste blanche, en notation CIDR et séparées par des virgules. Cette plage d’une ou plusieurs IP est vide par défaut, et doit être spécifiée pour pouvoir gérer le cluster après sa création.

  • (optionnel) cidr-pods : Le CIDR /16 à utiliser en interne pour les pods. Le CIDR du projet, les CIDR des pods, et les CIDR des services ne doivent pas se chevaucher.

  • (optionnel) cidr-service : Le CIDR /16 à utiliser en interne pour les services. Le CIDR du projet, les CIDR des pods, et les CIDR des services ne doivent pas se chevaucher.

  • (optionnel) control-plane : La taille souhaitée du control plane. Pour en savoir plus, voir Control planes.

  • (optional) cp-multi-az : Active l’option de control plane multi-Sous-régions, pour créer un cluster multi-Sous-régions.

    • Lorsque vous utilisez cette option, le control plane est déployé sur trois Sous-régions différentes afin d’assurer sa haute disponibilité.

    • Seuls les control planes haute disponibilité peuvent être déployés dans un cluster multi-Sous-régions.

  • (optionnel) enable-admission-plugins : La liste des plugins d’admission supplémentaires que vous souhaitez activer sur le cluster. Pour en savoir plus sur les plugins d’admission, voir la documentation Kubernetes (anglais uniquement).

  • (optionnel) disable-admission-plugins : La liste des plugins d’admission de la liste par défaut que vous souhaitez désactiver.

  • (optionnel) disable-api-termination : La possibilité de supprimer le cluster via l’API. Si true, la suppression du cluster est désactivée. Si false, elle est activée.

  • (optionnel) dryrun : Fournit une vue d’ensemble des opérations effectuées par la commande sans pour autant l’exécuter. Vous pouvez l’utiliser comme mesure de sécurité pour examiner l’impact d’une commande avant de l’exécuter.

  • (optionnel) filename : Le nom du fichier de définition à partir duquel vous voulez créer le cluster.

  • (optionnel) output : Le format de sortie de la réponse (json | yaml). Par défaut, le format de la réponse est JSON. Le fichier généré avec la définition du cluster peut être modifié et appliqué en utilisant la commande -f --filename …​.

  • (optionnel) quirk : Les clés et les paramètres à transmettre au cluster. Cette option est requise pour les demandes de fonctionnalités.

  • (optionnel) tags : Les tags que vous voulez ajouter aux nœuds du cluster.

  • (optionnel) version : Une des versions prises en charge de Kubernetes. Pour en savoir plus sur les versions prises en charge, voir Versions Kubernetes prises en charge.

  • (optionnel) zone : La Sous-région dans laquelle vous voulez déployer le control plane du cluster.

Vous pouvez afficher toutes les options disponibles en utilisant la commande cluster create avec la syntaxe suivante :

$ oks-cli cluster create --help

Vous pouvez utiliser la commande cluster list pour vérifier le statut du cluster. Votre cluster est créé lorsque son statut passe de deploying à ready.

Pages connexes

Méthode API correspondante