Installieren Sie SystemLink Enterprise mit Helm-Befehlen.

Bei der Installation von SystemLink Enterprise führen Sie die Konfiguration in erster Linie an den folgenden Stellen durch.

  1. systemlink-values.yaml: Konfiguriert den größten Teil der Anwendung.
  2. systemLink-admin-values.yaml: Definiert globale Ressourcen im SystemLink Admin Helm Chart. Helm muss diese Ressourcen installieren, bevor das SystemLink-Helm-Diagramm installiert wird.
  3. systemlink-secrets.yaml: Definiert Secrets in Helm. NI empfiehlt die Verwendung von SOPS zum Verschlüsseln der Datei oder der Secret-Werte in der Datei. Wenn Sie mit dieser Datei keine Secrets bereitstellen möchten, setzen Sie global.deplySecrets auf false.

SystemLink Enterprise speichert seine Konfiguration in YAML-Wertedateien. Bewahren Sie diese Dateien für die gesamte Lebensdauer Ihrer Bereitstellung auf. NI empfiehlt, diese Dateien in einem Source-Versionsverwaltungs-Repository zu speichern. Die Verwendung eines Repositorys hilft, die Versionsverwaltung aufrechtzuerhalten und die Zusammenarbeit im Team zu erleichtern.

Lesen Sie bei der Arbeit mit den Vorlagendateien alle Kommentare sorgfältig durch. In diesen Kommentaren werden die Konfigurationsoptionen für Ihre Anwendung erläutert. In vielen Fällen können Sie die Standardwerte verwenden.
Hinweis Mit <ATTENTION> gekennzeichnete Kommentare erfordern einen bestimmten Wert oder zusätzliche Aufmerksamkeit vor der Bereitstellung.

Diese YAML-Dateien enthalten Secrets und sensible Konfigurationsdaten für Ihre SystemLink Enterprise Bereitstellung. Sie müssen den Zugriff auf diese Dateien beschränken, um zu verhindern, dass unbefugte Benutzer die Sicherheit Ihrer Anwendung beeinträchtigen.

Erstellen von Namensräumen

Sie können Namensräume erstellen, um Ihren Cluster zu organisieren.

  • Erstellen Sie einen Namensraum für das SystemLink Helm-Chart.
    kubectl create namespace <namespace>
  • Erstellen Sie einen Namensraum für das SystemLink Admin Helm-Chart.
    kubectl create namespace <admin-namespace>

Vorbereiten von Zertifikaten

Konfigurieren Sie Zertifikate für die TLS-Kommunikation und Authentifizierung mit externen Ressourcen.

Hinweis SystemLink Enterprise-Endpunkte erfordern TLS. NI empfiehlt die Verwendung von TLS für die gesamte Kommunikation zwischen SystemLink Enterprise und externen Datenspeicher- und Identitätsanbietern. Erhalten Sie nur Zertifikate von vertrauenswürdigen Quellen.

Wenn Sie ein Zertifikat verwenden, um die Kommunikation mit Ihren PostgreSQL-Instanzen zu authentifizieren und zu verschlüsseln, lesen Sie PostgreSQL, um diese Zertifikate in Helm bereitzustellen und zu referenzieren.

Wenn Sie ein von einer privaten Zertifizierungsstelle signiertes Zertifikat für die SystemLink Enterprise Hostnamen, MongoDB oder S3 verwenden, lesen Sie Private Certificate Authorities, um diese Zertifikate in Helm bereitzustellen und zu referenzieren.

Installieren erforderlicher Cluster-Ressourcen

Installieren Sie die erforderlichen Ressourcen global auf dem Cluster.

Ein Benutzer mit den folgenden Berechtigungen muss die folgenden Schritte auf dem SystemLink Admin Helm-Chart ausführen:

  • Ein Cluster-Administrator mit vollen Zugriffsrechten
  • Ein Argo Workflows-Benutzer, der nur CustomResourceDefinition bereitstellt.
  • Ein Flink Operator-Benutzer, der ClusterRoles und ClusterRoleBindings bereitstellt. Der Flink Operator benötigt möglicherweise Berechtigungen zum Bereitstellen über mehrere Namespaces hinweg.

Weitere Informationen zu den für die Installation erforderlichen Kubernetes-Berechtigungen finden Sie unter Erforderliche Kubernetes-Berechtigungen.

SystemLink Admin Values-Datei herunterladen

Laden Sie eine Kopie von systemlink-admin-values.yaml herunter.

Wenn Sie Argo Workflows CRDs bereits als Teil einer anderen Bereitstellung installiert haben, setzen Sie argoworkflowscrds.crds.install auf false.
argoworkflowscrds:
  crds:
    install: false
Wenn Sie bereits Flink Operator in Ihrem Kubernetes-Cluster installiert haben, setzen Sie flinkoperator.enabled auf false.
flinkoperator:
  enabled: false

Voraussetzungen installieren

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
Tabelle 62. Voraussetzungen für die Cluster-Installation
Parameter Beschreibung
admin-release Der Release-Name, der für die Installation des SystemLink Admin Helm-Charts verwendet wird.
downloads.artifacts.ni.com/ni-docker Die URL des Registrierungsdienstes. Wenn Sie mit einer lokalen Kopie arbeiten, ersetzen Sie diese URL durch die URL der Spiegel-Registry.
Version Die spezifische Version der Software, die installiert werden soll.
admin-namespace Der Namensraum, der für das SystemLink Admin Helm-Chart erstellt wurde.

Dieser Befehl wartet bis zum konfigurierten Timeout, bis die Installation abgeschlossen ist und alle Ressourcen in den Bereitschaftszustand übergehen. Die Standardeinstellung für den Timeout lautet 20 Minuten. Der Timeout ist konservativ berechnet; die tatsächliche Installationszeit kann jedoch aufgrund einer Vielzahl von Faktoren variieren. Passen Sie den Timeout bei Bedarf an.

Konfigurieren von SystemLink Enterprise

Vor der Installation von SystemLink Enterprise müssen Sie Ihre SystemLink-Wertedateien konfigurieren. Laden Sie die Vorlage für Konfigurationsdateien aus dem SystemLink Enterprise GitHub-Repository herunter, um zu beginnen.

Dieses Handbuch dokumentiert die Konfigurationsparameter für die folgenden Dateien.
  • systemlink-values.yaml
  • systemlink-admin-values.yaml
  • systemlink-secrets.yaml

Jedes Thema in dieser Anleitung verweist auf die spezifischen Helm-Werte, die für diesen Konfigurationsbereich gelten.

Installieren der Anwendung

Installieren SystemLink Enterprise auf dem Cluster.

Der Benutzer, der die Installation vornimmt, benötigt keinen vollen Cluster-Zugriff. Der Benutzer muss aber vollen Zugriff auf den für die Anwendung erstellten Namensraum haben.

Weitere Informationen zu den für die Installation erforderlichen Kubernetes-Berechtigungen finden Sie unter Erforderliche Kubernetes-Berechtigungen.
Hinweis Dieses Thema geht davon aus, dass Sie das Datenbankzertifikat postgres.pem genannt haben, aber Sie können jeden beliebigen Namen verwenden. SystemLink Enterprise stellt das Zertifikat als ConfigMap-Ressource bereit.

SystemLink Enterprise installieren

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
Tabelle 63. Installationsparameter SystemLink Enterprise
Parameter Beschreibung
Release Der Name, den Helm der installierten Softwaresammlung zuweist.
downloads.artifacts.ni.com/ni-docker Die URL des Registrierungsdienstes. Wenn Sie mit einer lokalen Kopie arbeiten, ersetzen Sie diese URL durch die URL der Spiegel-Registry.
Version Die spezifische Version der Software, die installiert werden soll.
Namensraum Der Namespace für die Anwendung.

Dieser Befehl wartet bis zum konfigurierten Timeout, bis die Installation abgeschlossen ist und alle Ressourcen in den Bereitschaftszustand übergehen. Die Standardeinstellung für den Timeout lautet 20 Minuten. Der Timeout ist konservativ berechnet; die tatsächliche Installationszeit kann jedoch aufgrund einer Vielzahl von Faktoren variieren. Passen Sie den Timeout bei Bedarf an.

Hinweis Sie können auf ein und demselben Cluster auch mehrere Instanzen von SystemLink Enterprise installieren. Um mehrere Instanzen zu installieren, wiederholen Sie für jede Instanz die oben genannten Befehle mit einem anderen Namensraum und anderen Werten. Die erforderlichen Cluster-Ressourcen werden nur ein Mal für alle Instanzen installiert.

Validieren der Installation

Testen Sie, ob SystemLink Enterprise korrekt installiert wurde.

Sie können eine erfolgreiche SystemLink Enterprise Installation überprüfen. Überprüfen Sie die Bereitschaftssonden für die von dem SystemLink Enterprise-Helm-Chart bereitgestellten Pods mit einer der folgenden Methoden.

  • Verwenden einer Anwendung wie Lens.
  • Führen Sie den folgenden Befehl aus.
    kubectl describe pod <pod-name> -n <namespace>
Wenn ein Pod nicht in den Bereitschaftszustand eintritt und nach einigen Minuten kontinuierlich neu gestartet wird, empfiehlt NI die Fehlersuche am Pod. Sie können den Pod auf Fehler untersuchen, indem Sie das Protokoll für den Pod mit dem folgenden Befehl untersuchen.
kubectl logs <pod-name> -n <namespace>