IKO - Leçons (Partie 1 - Helm)

La documentation d'IKO est solide. Une seule page web contient environ 50 pages de documentation. Pour les débutants, cela peut être un peu accablant. Comme le dit le proverbe : comment manger un éléphant ? Une bouchée à la fois. Commençons par la première bouchée : helm.

Qu'est-ce que Helm ?

Helm est à Kubernetes ce que l'InterSystems Package Manager (IPM, anciennement ObjectScript Package Manager - ZPM) est à IRIS.

Il facilite l'installation d'applications sur la plateforme - d'une manière adaptée à Kubernetes. C'est-à-dire qu'il est développé de manière à faciliter l'installation selon vos besoins, qu'il s'agisse d'un environnement de développement, de test ou de production.

Nous fournissons sur notre distribution de logiciels CMR tout ce dont vous aurez besoin sous l'onglet IRIS Components - il s'agit d'un .tar.gz. Extrayez-le et vous obtiendrez un .tar. Extrayez-le à nouveau et vous verrez un dossier iris_operator_<votre version>. Vous y trouverez un README avec des instructions, ainsi que 3 dossiers - une image de l'IKO (vous auriez également pu l'obtenir à partir de l'onglet InterSystems Container Registry), et des échantillons. Les échantillons ont pour but de vous aider à constituer vos dossiers, mais ils ne sont pas nécessaires à l'installation d'IKO. Le tableau, en revanche, est nécessaire. Jetons un coup d'œil.

chart
|
|-> iris-operator
               |
               | -> README.md
               | -> .helmignore
               | -> Chart.yaml
               | -> values.yaml
               | -> templates 
                      | -> _helpers.tpl
                      | -> apiregistration.yaml
                      | -> appcatalog-user-roles.yaml
                      | -> cleaner.yaml
                      | -> cluster-role.yaml
                      | -> cluster-role-binding.yaml
                      | -> deployment.yaml
                      | -> mutating-webhook.yaml
                      | -> NOTES.txt
                      | -> service.yaml
                      | -> service-account.yaml
                      | -> user-roles.yaml
                      | -> validating-webhook.yaml
               

Il s'agit de la viande et des pommes de terre (une façon amusante de dire les ingrédients de base) de l'application que nous allons installer. Ne vous inquiétez pas. La seule chose qui nous intéresse sera le fichier values.yaml. Tout le reste se passe dans les coulisses, grâce à Helm. Ouf ! Mais il est important de savoir que même si notre opérateur semble être un pod ordinaire, il est bien plus que cela.

La plupart du contenu du fichier values.yaml ne sera pas abordé dans cet article car vous n'aurez pas à vous en préoccuper. Nous ne nous intéresserons qu'à 4 champs (ok, 5 au maximum).

Il s'agit de operator.registry, operator.repository, operator.tag, imagePullSecrets.name[0] et imagePullPolicy.

Où se trouve votre image IKO ? Votre organisation utilise-t-elle un dépôt privé ? Prévoyez-vous d'extraire des images de l'ICR ? Spécifiez les détails de votre image dans les champs registry, repository et tag. Si vous utilisez l'ICR, vous pouvez le laisser tel quel.

Comment allez-vous accéder au RIC ou au référentiel de votre organisation ? En supposant qu'il soit privé, vous devrez spécifier les détails qui vous permettront d'y accéder pour l'extraction. Dans le prochain article, j'aborde la façon de créer ce secret, que nous pouvons appeler intersystems-pull-secret au lieu du standard dockerhub-secret qui est ce qui est actuellement présent si vous avez téléchargé les fichiers depuis le WRC.

Enfin, pour l'imagePullPolicy, nous pouvons la laisser à Always, ou la changer à IfNotPresent ou Never. Je vous renvoie à la documentation de Kubernetes si vous avez besoin d'éclaircissements lire ici.J'ai tendance à utiliser IfNotPresent.

Il semble que nous soyons prêts (en supposant que vous ayez déjà installé helm, si ce n'est pas le cas installez le avant)! Installons l'IKO. Nous allons devoir indiquer à helm où se trouve le dossier contenant toutes nos données (c'est le dossier iris-operator que vous voyez ci-dessus). Si nous nous trouvons dans le répertoire chart, vous pouvez utiliser la commande

helm install intersystems iris-operator

mais peut-être êtes-vous assis un peu plus haut. Il n'y a pas de problème. C'est très bien aussi en supposant que vous êtes assis dans un dépôt avec iris_operator_amd-3.6.7.100 :

helm install intersystems iris_operator_amd-3.6.7.100/chart/iris-operator

Vous obtiendrez un message indiquant que l'installation a réussi et vous pouvez vérifier que votre déploiement est en cours, comme l'indique le message suivant et notre documentation.

kubectl --namespace=default get deployments -l "release=intersystems, app=iris-operator"

Dans le prochain billet, nous mettrons en œuvre l'opérateur Kubernetes d'InterSystems.