Installez SystemLink Enterprise à l'aide des commandes Helm.

Lors de l'installation de SystemLink Enterprise, vous effectuez principalement la configuration aux endroits suivants.

  1. systemlink-values.yaml: Configure la majeure partie de l'application.
  2. systemlink-admin-values.yaml: Définit les ressources globales dans le graphe déroulant Helm SystemLink Admin. Helm doit installer ces ressources avant d'installer le graphe déroulant Helm SystemLink.
  3. systemlink-secrets.yaml: Définit les secrets dans Helm. NI recommande d'utiliser des techniques telles que SOPS pour crypter le fichier ou les valeurs secrètes du fichier. Si vous ne souhaitez pas déployer de secrets avec ce fichier, définissez global.deplySecrets sur faux.

SystemLink Enterprise stocke sa configuration dans des fichiers de valeurs YAML. Vous devez conserver ces fichiers pendant toute la durée du déploiement. NI recommande de stocker ces fichiers au sein d'un dépôt de contrôle de source. L’utilisation d’un dépôt permet de maintenir le contrôle de version et de faciliter la collaboration au sein d’une équipe.

Lorsque vous travaillez avec les fichiers modèles, lisez attentivement tous les commentaires. Ces commentaires de modèle expliquent les options de configuration pour votre application. Dans la plupart des cas, les valeurs par défaut sont adéquates.
Remarque Les commentaires marqués d'<ATTENTION> requièrent une valeur spécifique ou une attention supplémentaire avant le déploiement.

Ces fichiers YAML contiennent des secrets et des données de configuration sensibles pour votre déploiement SystemLink Enterprise. Vous devez restreindre l'accès à ces fichiers pour empêcher les utilisateurs non autorisés de compromettre la sécurité de votre application.

Création d'espaces de noms

Il est possible de créer des espaces de noms afin d'organiser votre cluster.

  • Créez un espace de noms pour le graphe déroulant Helm SystemLink.
    kubectl create namespace <namespace>
  • Créez un espace de noms pour le graphe déroulant Helm SystemLink Admin.
    kubectl create namespace <admin-namespace>

Préparation de certificats

Configurez des certificats pour la communication TLS (Transport Layer Security) et l'authentification avec des ressources externes.

Remarque Les extrémités SystemLink Enterprise requièrent TLS pour fonctionner. NI recommande d'utiliser TLS pour toutes les communications entre SystemLink Enterprise et les fournisseurs de stockage de données et d'identité externes. N'obtenez des certificats que de sources fiables.

Si vous utilisez un certificat pour authentifier et crypter la communication avec vos instances PostgreSQL, reportez-vous à PostgreSQL pour déployer et référencer ces certificats dans Helm.

Si vous utilisez un certificat signé par une autorité privée pour les noms d'hôte SystemLink Enterprise, MongoDB ou S3, reportez-vous à Autorités de certification privées pour déployer et référencer ces certificats dans Helm.

Installation de prérequis sur le cluster

Il est possible d'installer les ressources requises sur le cluster de façon globale.

Un utilisateur disposant des privilèges suivants doit effectuer les étapes suivantes sur le graphe déroulant Helm SystemLink Admin.

  • Un administrateur de cluster disposant de droits d'accès complets.
  • Un utilisateur Argo Workflows ne déployant que CustomResourceDefinition.
  • Utilisateur Flink Operator déployant ClusterRoles et ClusterRoleBindings. L'opérateur Flink peut nécessiter des autorisations pour déployer entre espaces de noms.

Pour en savoir plus sur les autorisations Kubernetes requises pour l'installation, reportez-vous à Autorisations Kubernetes requises.

Télécharger le fichier SystemLink Admin Values

Téléchargez une copie de systemlink-admin-values.yaml.

Si les flux de travail CRD Argo sont déjà installés dans le cadre d'un autre déploiement, définissez argoworkflowscrds.crds.install à faux.
argoworkflowscrds:
  crds:
    install: false
Si l'opérateur Flink est déjà déployé sur votre cluster Kubernetes, définissez flinkoperator.enabled à faux.
flinkoperator:
  enabled: false

Installer les prérequis

helm upgrade <admin-release>oci://downloads.artifacts.ni.com/ni-docker/ni/helm-charts/systemlinkadmin 
--install 
--version <version> 
--namespace <admin-namespace> 
--values systemlink-admin-values.yaml 
--values systemlink-values.yaml 
--values systemlink-secrets.yaml 
--wait --timeout 20m0s
Tableau 62. Prérequis d'installation du cluster
Paramètre Description
admin-release Le nom de release utilisé pour installer le graphe déroulant Helm SystemLink Admin.
downloads.artifacts.ni.com/ni-docker L'URL du registre. Si vous utilisez un miroir local, remplacez cette URL par l'URL du registre du miroir.
version La version spécifique du logiciel à installer.
admin-namespace L'espace de noms créé pour le graphe déroulant Helm SystemLink Admin.

Cette commande est exécutée à l'expiration du délai d'installation et dès que l'état Prêt sera associé à toutes les ressources. Le délai d'attente par défaut est de 20 minutes. Le délai d'attente configuré est raisonnable, mais le temps d'installation est susceptible de varier selon une multitude de facteurs. Ajustez le délai si nécessaire.

Configuration de SystemLink Enterprise

Avant d'installer SystemLink Enterprise, vous devez configurer vos fichiers de valeurs SystemLink. Téléchargez les fichiers de configuration modèles à partir du dépôt SystemLink Enterprise GitHub pour commencer.

Ce manuel documente les paramètres de configuration des fichiers suivants.
  • systemlink-values.yaml
  • systemlink-admin-values.yaml
  • systemlink-secrets.yaml

Chaque rubrique de manuel fait référence aux valeurs Helm spécifiques qui s'appliquent à cette zone de configuration.

Installation de l'application

Installez SystemLink Enterprise sur le cluster.

L'utilisateur qui effectue l'installation n'a pas besoin d'un accès complet au cluster. Cependant, l'utilisateur doit avoir un accès complet à l'espace de noms créé pour l'application.

Pour plus de détails sur les autorisations Kubernetes requises pour l'installation, reportez-vous à Autorisations Kubernetes requises.
Remarque Cette rubrique suppose que vous avez nommé le certificat de base de données postgres.pem, mais vous pouvez utiliser n'importe quel nom. SystemLink Enterprise déploie le certificat en tant que ressource ConfigMap.

Installer SystemLink Enterprise

helm upgrade <release> 
oci://downloads.artifacts.ni.com/ni-docker/ni/helm-charts/systemlink 
--install 
--version <version> 
--namespace <namespace> 
--values systemlink-values.yaml 
--values systemlink-secrets.yaml 
--set-file database.postgresCertificate=postgres.pem 
--wait --timeout 20m0s
Tableau 63. SystemLink Enterprise Installer les paramètres
Paramètre Description
finale Le nom que Helm attribue à l'ensemble des logiciels installés.
downloads.artifacts.ni.com/ni-docker L'URL du registre. Si vous utilisez un miroir local, remplacez cette URL par l'URL du registre du miroir.
version La version spécifique du logiciel à installer.
espace de noms L'espace de noms pour l'application.

Cette commande est exécutée à l'expiration du délai d'installation et dès que l'état Prêt sera associé à toutes les ressources. Le délai d'attente par défaut est de 20 minutes. Le délai d'attente configuré est raisonnable, mais le temps d'installation est susceptible de varier selon une multitude de facteurs. Ajustez le délai si nécessaire.

Remarque Vous pouvez installer plusieurs instances de SystemLink Enterprise sur le même cluster. Pour installer plusieurs instances, répétez les commandes précédentes avec un espace de noms et des valeurs différents pour chaque instance. Les prérequis de cluster sont installés une seule fois pour toutes les instances.

Validation de l'installation

Testez que SystemLink Enterprise est installé correctement.

Vous pouvez valider une installation SystemLink Enterprise réussie. Inspectez les sondes de préparation pour les pods déployés par le graphe déroulant HelmSystemLink Enterprise en utilisant l'une des méthodes suivantes.

  • Utilisation d'une application, telle que Lens.
  • Exécution de la commande suivante.
    kubectl describe pod <pod-name> -n <namespace>
Si un pod ne passe pas à l'état prêt et qu'il redémarre continuellement après plusieurs minutes, NI recommande de mettre au point le pod. Vous pouvez mettre au point le pod en inspectant le journal du pod avec la commande suivante.
kubectl logs <pod-name> -n <namespace>