Ajout de services à l'aide de modules complémentaires gérés

Les modules complémentaires Managed IBM Cloud Kubernetes Service constituent un moyen simple d'améliorer votre cluster grâce à des fonctionnalités supplémentaires. La version du pilote, du plug-in ou de l'outil open source que vous ajoutez à votre cluster est testée par IBM et approuvée pour être utilisée dans IBM Cloud Kubernetes Service.

Les modules complémentaires gérés que vous pouvez installer dans votre cluster dépendent du type de cluster, de la plateforme de conteneur et du fournisseur d'infrastructure que vous avez choisis.

Support: Les modules complémentaires gérés sont entièrement intégrés dans l'organisation de support IBM Cloud. Pour toute question ou problématique relative à l'utilisation des modules complémentaires gérés, vous pouvez utiliser l'un des canaux de support IBM Cloud Kubernetes Service. Pour plus d'informations, voir Aide et assistance.
Facturation: Si l'outil que vous ajoutez à votre cluster entraîne des coûts, ceux-ci sont automatiquement intégrés et répertoriés dans le cadre de votre facturation IBM Cloud Kubernetes Service. Le cycle de facturation est déterminé par IBM Cloud en fonction du moment où vous activez le module complémentaire dans votre cluster.; En général, aucune configuration supplémentaire, telle que l'ouverture de ports ou d'adresses IP, n'est requise. Toutefois, reportez-vous à la documentation de chaque module complémentaire géré pour trouver les prérequis que votre cluster doit respecter avant d'installer le module complémentaire géré.

Ajout de modules complémentaires gérés

Pour activer un module complémentaire géré dans votre cluster à partir de l'interface de ligne de commande, utilisez la commande ibmcloud ks cluster addon enable. Pour activer un module complémentaire géré dans votre cluster depuis la console, utilisez le volet Modules complémentaires de la page de détails du cluster. Lorsque vous activez le module complémentaire géré, une version prise en charge de l'outil, incluant toutes les ressources d' Kubernetes, est automatiquement installée dans votre cluster.

Pour plus d'informations sur les prérequis pour chaque module complémentaire, voir :

Mise à jour des modules complémentaires gérés

Les versions de chaque module complémentaire géré sont testées par IBM Cloud et approuvées pour être utilisées dans IBM Cloud Kubernetes Service. Pour mettre à jour les composants d'un module complémentaire vers la version la plus récente prise en charge par IBM Cloud Kubernetes Service, utilisez les liens suivants.

Consultez les liens suivants pour connaître les étapes de mise à jour spécifiques de chaque module complémentaire.

Examen des états et des statuts de module complémentaire

Vous pouvez vérifier l'état de santé et l'état d'un module complémentaire en exécutant la commande suivante.

ibmcloud ks cluster addon ls -c CLUSTER_NAME_OR_ID

Exemple de sortie

Name            Version   Health State   Health Status
debug-tool      2.0.0     normal         Addon Ready
istio           1.4       -              Enabling

La colonne Health State décrit le cycle de vie des composants de module complémentaire. Chaque état est décrit dans le tableau suivant :

Etats de santé de module complémentaire
Etat de santé de module complémentaire	Description
`critical`	Le module complémentaire n'est pas prêt à être utilisé pour l'une des raisons suivantes : Certains ou tous les composants du module complémentaire présentent des problèmes. Le déploiement du module complémentaire a échoué. Le module complémentaire est peut-être dans une version non prise en charge. Consultez le champ État de santé pour plus d'informations.
`normal`	Le déploiement du module complémentaire a abouti. Vérifiez le statut pour vous assurer que le module complémentaire est prêt (`Ready`) ou pour déterminer si une mise à jour est disponible.
`pending`	Certains ou tous les composants du module complémentaire sont en cours de déploiement. Attendez que le module complémentaire passe à l'état `normal` avant de l'utiliser.
`updating`	Le module complémentaire est en cours de mise à jour et n'est pas prêt à être utilisé. Vérifiez la zone Statut de santé de la version vers laquelle le module complémentaire est mis à jour.
`warning`	Le module complémentaire peut ne pas fonctionner correctement en raison des limitations du cluster. Pour plus d'informations, voir la zone Statut de santé.

La colonne Health Status fournit des détails sur l'opération en cours d'exécution sur le module complémentaire. Chaque statut est décrit dans le tableau suivant.

Statuts de santé de module complémentaire
Code d'état	Statut de santé de module complémentaire	Description
H1500	`Addon Ready`	Le module complémentaire a été correctement déployé et il est sain.
H1501, H1502, H1503	`Addon Not Ready`	Certains ou tous les composants complémentaires sont malsains. Vérifiez que tous les pods des composants du module complémentaire sont en cours d'exécution. Par exemple, pour le module complémentaire Istio, vérifiez si les pods des espaces de noms `istio-system` et `ibm-operators` sont dans un état `Running` en exécutant la commande `kubectl get pods -n NAMESPACE`.
H1504, H1505, H1506, H1507, H1508	`Failure determining health status.`	Le module de santé complémentaire ne peut pas être déterminée. Ouvrir un dossier d'assistance. Dans la description, ajoutez le code d'erreur provenant de l'état de santé.
H1509	`Addon Unsupported`	Le module complémentaire exécute une version non prise en charge ou la version du module complémentaire n'est pas prise en charge pour votre version de cluster. Mettez à jour votre module complémentaire vers la version la plus récente ou reportez-vous à la procédure de mise à jour spécifique pour Istio.
H1510	`Cluster resources low, not enough workers in Ready state.`	Le module complémentaire n'est pas prêt pour être utilisé pour l'une des raisons suivantes : le cluster ne répond pas aux critères de taille pour le module complémentaire. Par exemple, vérifiez la taille requise pour Istio. Les nœuds workers de votre cluster n'ont pas l'état `Normal`. Examinez l'état et le statut des noeuds worker.
	`Enabling`	Le module complémentaire est en cours de déploiement sur le cluster. Notez que l'installation du module complémentaire peut prendre jusqu'à 15 minutes.
H1512	`Addon daemonset might not be available on all Ready nodes.`	Pour le module complémentaire Route statique : l'opérateur de route statique `DaemonSet` n'est pas disponible sur les noeuds worker, ce qui vous empêche d'appliquer des ressources de route statique. Vos nœuds de travail ne peuvent pas exécuter l'opérateur de route statique `DaemonSet` pour les raisons suivantes : Un ou plusieurs nœuds de travail ont atteint leur Limites de ressources. Un ou plusieurs nœuds de travail exécutent le Nombre maximal de gousses par noeud de travail.

Vous avez encore des problèmes avec le module complémentaire Istio ? Consultez ces rubriques de traitement des incidents pour déboguer votre déploiement Istio.