Oracle Cloud Infrastructure - Dokumentation

Mit dem Kubernetes-Metrikserver als Cluster-Add-on arbeiten

Erfahren Sie, wie Sie den Kubernetes-Metrikserver als Cluster-Add-on auf Clustern mit verwalteten Knotenpools verwenden, die Sie mit der Kubernetes Engine (OKE) erstellt haben.

Die Verwendung des Kubernetes-Metrikservers als Cluster-Add-on und nicht als eigenständiges Programm vereinfacht die Konfiguration und laufende Wartung. Einfacher geht's:

  • Aktivieren oder deaktivieren Sie den Kubernetes Metrics Server.
  • Aktivieren und deaktivieren Sie automatische Updates von Oracle.
  • Wählen Sie Add-on-Versionen für Kubernetes Metrics Server aus.
  • Add-on-spezifische Anpassungen mit genehmigten Konfigurationsargumenten für Schlüssel/Wert-Paare verwalten

Um den Kubernetes-Metrikserver als Cluster-Add-on zu verwenden, müssen Sie auch cert-manager bereitstellen. Sie können cert-manager auf zwei Arten bereitstellen:

  • Sie können cert-manager als eigenständiges Open-Source-Produkt bereitstellen. Wenn Sie cert-manager als Standalone-Produkt bereitstellen, setzen Sie das Konfigurationsargument skipAddonDependenciesCheck auf true. Weitere Informationen zum cert-manager finden Sie in der cert-manager.io-Dokumentation.
  • Sie können cert-manager als Cluster-Add-on bereitstellen. Weitere Informationen zum Bereitstellen von cert-manager als Cluster-Add-on finden Sie unter Cluster-Add-on installieren.

In diesen Abschnitten wird beschrieben, wie Sie mit dem Kubernetes Metrics Server-Add-on arbeiten:

Kubernetes-Metrikserver als Cluster-Add-on bereitstellen

Erfahren Sie, wie Sie mit kubectl den Kubernetes-Metrikserver als Cluster-Add-on auf Clustern mit verwalteten Knotenpools bereitstellen, die Sie mit der Kubernetes Engine (OKE) erstellt haben.

In diesen Anweisungen wird beschrieben, wie Sie den Kubernetes-Metrikserver als Cluster-Add-on bereitstellen:

Schritt 1: Add-on-Konfigurationsdatei für Kubernetes Metrics Server erstellen

Hinweis

In diesen Anweisungen wird beschrieben, wie Sie eine Add-on-Konfigurationsdatei für den Kubernetes-Metrikserver erstellen, damit Sie das Add-on für den Kubernetes-Metrikserver mit der CLI bereitstellen können. Die Konfigurationsdatei enthält genehmigte Konfigurationsargumente für Schlüssel/Wert-Paare. Sie müssen eine Konfigurationsdatei erstellen, wenn Sie das Add-on über die CLI (oder über die API) bereitstellen. Sie können das Add-on für den Kubernetes-Metrikserver auch mit der Konsole bereitstellen. In diesem Fall geben Sie Konfigurationsargumente in der UI an. Weitere Informationen zum Deployment des Kubernetes-Metrikserver-Add-ons mit der Konsole finden Sie unter Cluster-Add-on installieren.

  1. Erstellen Sie in einem geeigneten Editor eine JSON-Datei mit einem Namen Ihrer Wahl (bei diesen Anweisungen wird davon ausgegangen, dass die Datei enablemetrics-server.json heißt), die Folgendes enthält:

    {
  "addonName": "KubernetesMetricsServer",
  "configurations": [
  ]
}

    Dieser Inhalt ist ausreichend, um das Kubernetes Metrics Server-Add-on zu aktivieren.

  2. (Optional) Geben Sie in der von Ihnen erstellten Datei enablemetrics-server.json andere Konfigurationsargumente an, um das Kubernetes-Metrikserver-Add-on anzupassen. Informationen zu den Konfigurationsargumenten, die Sie festlegen können, finden Sie unter Add-on-Konfigurationsargumente für Kubernetes Metrics Server.

  3. Speichern und schließen Sie die Datei enablemetrics-server.json.

Schritt 2: Stellen Sie das Kubernetes Metrics Server-Add-on im Cluster bereit, und bestätigen Sie das erfolgreiche Deployment

Hinweis

In diesen Anweisungen wird beschrieben, wie Sie das Kubernetes-Metrikserver-Add-on auf Clustern mit verwalteten Knotenpools mit der CLI und einer Konfigurationsdatei bereitstellen. Sie können das Add-on auch über die Konsole und die API bereitstellen. Weitere Informationen finden Sie unter Cluster-Add-on installieren.

  1. Falls noch nicht geschehen, führen Sie die Schritte zum Einrichten der kubeconfig-Konfigurationsdatei des Clusters aus, und legen Sie (gegebenenfalls) die Umgebungsvariable KUBECONFIG so fest, dass sie auf die Datei verweist. Beachten Sie, dass Sie Ihre eigene kubeconfig-Datei einrichten müssen. Sie können nicht mit einer kubeconfig-Datei, die von einem anderen Benutzer eingerichtet wurde, auf ein Cluster zugreifen. Siehe Clusterzugriff einrichten.
  2. Vergewissern Sie sich, dass das Kubernetes Metrics Server-Add-on noch nicht auf dem Cluster installiert wurde, indem Sie Folgendes eingeben:
    oci ce cluster list-addons --cluster-id <cluster-ocid>

    Dabei ist <cluster-ocid> die OCID des Clusters, auf dem Sie das Kubernetes-Metrikserver-Add-on bereitstellen möchten.

  3. Wenn Ihr Oracle Cloud Infrastructure-Benutzer ein Mandantenadministrator oder Clusteradministrator ist, überspringen Sie den nächsten Schritt, und fahren Sie mit dem darauf folgenden Schritt fort.
  4. Wenn Ihr Oracle Cloud Infrastructure-Benutzer kein Mandantenadministrator oder Clusteradministrator ist, bitten Sie einen Mandantenadministrator oder Clusteradministrator, Ihrem Benutzer die Kubernetes-RBAC-clusterrole "cluster-admin" für das Cluster zu erteilen, indem Sie Folgendes eingeben:
    
kubectl create clusterrolebinding <my-cluster-admin-binding> --clusterrole=cluster-admin --user=<user-OCID>

    Weitere Informationen finden Sie unter Info zu Zugriffskontrolle und Kubernetes-Engine (OKE).

  5. Stellen Sie das Kubernetes Metrics Server-Add-on auf dem Cluster bereit, indem Sie Folgendes eingeben:

    oci ce cluster install-addon --addon-name KubernetesMetricsServer --cluster-id <cluster-ocid> --from-json file://./<path-to-config-file>

    Hierbei gilt:

    • --cluster-id <cluster-ocid> ist die OCID des Clusters, in dem Sie das Kubernetes-Metrikserver-Add-on bereitstellen möchten.
    • --from-json file://<path-to-config-file> gibt den Speicherort der zuvor erstellten Konfigurationsdatei für das Kubernetes Metrics Server-Add-on an. Beispiel: --from-json file://./enablemetrics-server.json

    Beispiel:

    oci ce cluster install-addon --addon-name KubernetesMetricsServer --from-json file://./enablemetrics-server.json --cluster-id ocid1.cluster.oc1.iad.aaaaaaaam______dfr

    Eine Arbeitsanforderung wird erstellt, um das Kubernetes-Metrikserver-Add-on bereitzustellen.

  6. Stellen Sie sicher, dass der Kubernetes-Metrikserver erfolgreich bereitgestellt wurde und verfügbar ist, indem Sie Folgendes eingeben:

    kubectl get deployment metrics-server -n kube-system

Kubernetes Metrics Server-Add-on aktualisieren

Hinweis

In diesen Anweisungen wird beschrieben, wie Sie das Add-on "Kubernetes-Metrikserver" mit der CLI und einer Konfigurationsdatei aktualisieren. Sie können das Add-on auch über die Konsole und die API aktualisieren. Weitere Informationen finden Sie unter Cluster-Add-on aktualisieren.

  1. Konfigurationsdatei für das Kubernetes Metrics Server-Add-on in einem geeigneten Editor öffnen

  2. Fügen Sie Konfigurationsparameter in der Konfigurationsdatei nach Bedarf hinzu, entfernen oder ändern Sie sie. Informationen zu den Parametern, die Sie festlegen können, finden Sie unter Add-on-Konfigurationsargumente für Kubernetes Metrics Server.

  3. Aktualisieren Sie das Kubernetes-Metrikserver-Add-on mit dem Befehl oci ce cluster update-addon, indem Sie Folgendes eingeben:
    oci ce cluster update-addon --addon-name KubernetesMetricsServer --from-json file://<path-to-config-file> --cluster-id <cluster-ocid>

    Hierbei gilt:

    • --cluster-id <cluster-ocid> ist die OCID des Clusters, in dem Sie das Kubernetes-Metrikserver-Add-on aktualisieren möchten.
    • --from-json file://<path-to-config-file> gibt den Speicherort der Add-on-Konfigurationsdatei für den Kubernetes-Metrikserver an, die beim Aktualisieren des Add-ons verwendet werden soll. Beispiel: --from-json file://./enablemetrics-server.json

    Beispiel:

    oci ce cluster update-addon --addon-name KubernetesMetricsServer --from-json file://./enablemetrics-server.json.json --cluster-id ocid1.cluster.oc1.iad.aaaaaaaam______dfr

    Eine Arbeitsanforderung wird erstellt, um die Kubernetes-Ressourcen zu aktualisieren, die für den Kubernetes-Metrikserver erforderlich sind.

  4. Optional: Zeigen Sie den Status der Kubernetes-Metrikserverpods an, um den Fortschritt zu beobachten, indem Sie Folgendes eingeben:
    kubectl get pods -n kube-system | grep metrics-server

Kubernetes-Metrikserver-Add-on deaktivieren (und entfernen)

Hinweis

In diesen Anweisungen wird beschrieben, wie Sie das Kubernetes-Metrikserver-Add-on mit der CLI und einer Konfigurationsdatei deaktivieren und entfernen. Sie können das Add-on auch über die Konsole und die API aktualisieren. Weitere Informationen finden Sie unter Cluster-Add-on deaktivieren (und entfernen).

  1. Deaktivieren (und optional) Sie das Kubernetes-Metrikserver-Add-on mit dem Befehl oci ce cluster disable-addon, indem Sie Folgendes eingeben:

    oci ce cluster disable-addon --addon-name KubernetesMetricsServer --cluster-id <cluster-ocid> --is-remove-existing-add-on <true|false>

    Hierbei gilt:

    • --cluster-id <cluster-ocid> ist die OCID des Clusters, in dem Sie das Kubernetes-Metrikserver-Add-on deaktivieren (und optional entfernen) möchten.
    • --is-remove-existing-add-on <true|false> gibt an, dass das Kubernetes Metrics Server-Add-on entweder vollständig entfernt werden soll (wenn es auf true gesetzt ist), oder dass das Add-on nicht entfernt werden soll, sondern einfach deaktiviert und nicht verwendet werden soll (wenn es auf false gesetzt ist). Wenn Sie das Add-on deaktivieren, aktualisiert Oracle es nicht mehr automatisch, wenn neue Versionen verfügbar sind.

    Beispiel:

    oci ce cluster disable-addon --addon-name KubernetesMetricsServer --cluster-id ocid1.cluster.oc1.iad.aaaaaaaam______dfr --is-remove-existing-add-on true

    Eine Arbeitsanforderung wird erstellt, um den Kubernetes-Metrikserver zu deaktivieren (und optional zu entfernen).

  2. Optional: Zeigen Sie den Status der Kubernetes-Metrikserverpods an, um den Fortschritt zu beobachten, indem Sie Folgendes eingeben:
    kubectl get pods -n kube-system | grep metrics-server