Oracle Cloud Infrastructure - Dokumentation

Cluster-Add-on installieren

Erfahren Sie, wie Sie ein Cluster-Add-on mit der Kubernetes Engine (OKE) installieren.

Sie können ein Cluster-Add-on beim Erstellen eines neuen Clusters oder für ein vorhandenes Cluster installieren.

Spezifische Installationsanweisungen:

Weitere Informationen zu Cluster-Add-ons finden Sie unter Cluster-Add-ons konfigurieren.

  • Cluster-Add-on beim Erstellen eines Clusters bereitstellen und konfigurieren

    1. Befolgen Sie die Anweisungen unter Cluster mit explizit definierten Einstellungen im Workflow "Benutzerdefinierte Erstellung" mit der Konsole erstellen, um ein Cluster zu erstellen.
    2. Zeigen Sie auf der Seite Cluster erstellen den Abschnitt Cluster-Add-ons konfigurieren an, um die aktivierten und verfügbaren Cluster-Add-ons anzuzeigen.

      Standardmäßig beim Erstellen eines neuen Clusters:

      • Wichtige Cluster-Add-ons (wie CoreDNS und kube-proxy) werden als aktiviert angezeigt und automatisch aktualisiert.
      • Optionale Cluster-Add-ons (wie das Kubernetes-Dashboard) werden als deaktiviert angezeigt.

      Beachten Sie, dass Sie das CNI-Plug-in für Podnetzwerke auf der Seite Netzwerksetup auswählen. Daher wird das CNI-Plug-in beim Erstellen eines Clusters nicht im Abschnitt Cluster-Add-ons konfigurieren angezeigt.

    3. Klicken Sie auf den Namen des Add-ons, das Sie bereitstellen und konfigurieren möchten.

    4. Wählen Sie die Option <add-on name> aktivieren, um das Cluster-Add-on beim Erstellen des Clusters bereitzustellen und zu aktivieren.

      Beachten Sie, dass Sie wichtige Add-ons beim Erstellen eines Clusters nicht deaktivieren können.

    5. Konfigurieren Sie das Cluster-Add-on, indem Sie die folgenden Details angeben:
      • Automatische Updates: Wählen Sie diese Option aus, wenn Oracle das Add-on automatisch aktualisieren soll, sobald eine neue Version verfügbar ist.
      • Version auswählen: Wählen Sie diese Option aus, wenn Sie die Version des Add-ons steuern möchten, die Oracle im Cluster bereitstellt. Eine Warnung gibt an, dass Sie die Verantwortung für die Aktualisierung des Add-ons übernommen haben. Wenn Sie diese Option auswählen, wählen Sie in der Liste Version die Version des Add-ons aus, das im Cluster bereitgestellt werden soll. Siehe Cluster-Add-ons - Unterstützte Versionen.
      • Option: und Wert: (Optional) Geben Sie mindestens ein Schlüssel/Wert-Paar an, das als Argumente an das Cluster-Add-on übergeben werden soll. Beispiel: Für das Kubernetes-Dashboard können Sie die Option numOfReplicas auswählen und den Wert 3 angeben. Siehe Konfigurationsargumente für Cluster-Add-ons.

    Cluster-Add-on für ein vorhandenes erweitertes Cluster bereitstellen und konfigurieren

    1. Öffnen Sie das Navigationsmenü , und wählen Sie Entwicklerservices aus. Wählen Sie unter Container und Artefakte die Option Kubernetes-Cluster (OKE) aus.
    2. Wählen Sie das Compartment aus, das das Cluster enthält.
    3. Klicken Sie auf der Seite Cluster auf den Namen des zu ändernden Clusters.
    4. Klicken Sie unter Ressourcen auf Add-ons.
    5. Klicken Sie auf Add-ons verwalten und dann auf das Cluster-Add-on, das Sie bereitstellen und konfigurieren möchten.

    6. Wählen Sie die Option <add-on name> aktivieren, um ein Cluster-Add-on bereitzustellen und zu aktivieren, das zuvor in diesem Cluster nicht aktiviert wurde, oder um ein Cluster zu aktivieren, das zuvor bereitgestellt wurde, aber derzeit deaktiviert ist.

    7. Konfigurieren Sie das Cluster-Add-on, indem Sie die folgenden Details angeben:
      • Automatische Updates: Wählen Sie diese Option, wenn Oracle das Add-on automatisch aktualisieren soll, sobald eine neue Version verfügbar ist.
      • Version auswählen: Wählen Sie diese Option aus, wenn Sie die Version des Add-ons steuern möchten, die Oracle im Cluster bereitstellt. Eine Warnung gibt an, dass Sie die Verantwortung für die Aktualisierung des Add-ons übernommen haben. Wenn Sie diese Option auswählen, wählen Sie in der Liste Version die Version des Add-ons aus, das im Cluster bereitgestellt werden soll. Siehe Cluster-Add-ons - Unterstützte Versionen.
      • Option: und Wert: (Optional) Geben Sie mindestens ein Schlüssel/Wert-Paar an, das als Argumente an das Cluster-Add-on übergeben werden soll. Beispiel: Für das Kubernetes-Dashboard können Sie die Option numOfReplicas auswählen und den Wert 3 angeben. Siehe Konfigurationsargumente für Cluster-Add-ons.
    8. Klicken Sie auf Änderungen speichern.

  • Verwenden Sie den Befehl oci ce cluster install-addon und die erforderlichen Parameter, um ein Cluster-Add-on bereitzustellen:

    oci ce cluster install-addon --cluster-id <cluster-ocid> --addon-name <addon-name> [OPTIONS]

    Beispiel:

    oci ce cluster install-addon --cluster-id ocid1.cluster.oc1.iad.aaaaaaaaaf______jrd --addon-name KubernetesDashboard --addon-version v2.7.0-multiarch-1.25-2
    Mit dem Parameter --configurations geben Sie mindestens ein Schlüssel/Wert-Paar an, das als Argumente an das Cluster-Add-on im JSON-Format übergeben werden soll. Sie müssen doppelte Anführungszeichen innerhalb der JSON mit einem einzelnen umgekehrten Schrägstrich maskieren. Beispiel:
    oci ce cluster install-addon --cluster-id ocid1.cluster.oc1.iad.aaaaaaaaaf______jrd --addon-name KubernetesDashboard --addon-version v2.7.0-multiarch-1.25-2 --configurations "[{\"key\": \"numOfReplicas\", \"value\": \"3\"}]"

    Wenn der Wert eines Schlüssels selbst im JSON-Format erforderlich ist, müssen Sie doppelte Anführungszeichen innerhalb der verschachtelten JSON mit drei umgekehrten Schrägstrichen maskieren. Beispiel:

    oci ce cluster install-addon --cluster-id ocid1.cluster.oc1.iad.aaaaaaaaaf______jrd --addon-name KubernetesDashboard --addon-version v2.7.0-multiarch-1.25-2 --configurations "[{\"key\": \"tolerations\", \"value\": \"[{\\\"key\\\":\\\"special\\\", \\\"value\\\":\\\"true\\\", \\\"effect\\\":\\\"noSchedule\\\",\\\"operator\\\":\\\"exists\\\"}]\"}]"

    Um den Parameter --configurations weniger unhandlich zu machen, setzen Sie Schlüssel/Wert-Paare in einfache Anführungszeichen (anstatt doppelte Anführungszeichen). Wenn Sie das Schlüssel/Wert-Paar mit einfachen Anführungszeichen umgeben, müssen Sie keine doppelten Anführungszeichen in der JSON mit einem einzelnen umgekehrten Schrägstrich maskieren. Wenn der Wert eines Schlüssels selbst JSON enthält, müssen Sie nur doppelte Anführungszeichen in der verschachtelten JSON mit einem einzelnen umgekehrten Schrägstrich (anstatt drei umgekehrten Schrägstrichen) maskieren. Beispiel:

    oci ce cluster install-addon --cluster-id ocid1.cluster.oc1.iad.aaaaaaaaaf______jrd --addon-name KubernetesDashboard --addon-version v2.7.0-multiarch-1.25-2 --configurations '[{"key": "numOfReplicas", "value": "3"}]'
    oci ce cluster install-addon --cluster-id ocid1.cluster.oc1.iad.aaaaaaaaaf______jrd --addon-name KubernetesDashboard --addon-version v2.7.0-multiarch-1.25-2 --configurations '[{"key": "tolerations", "value": "[{\"key\":\"special\", \"value\":\"true\", \"effect\":\"noSchedule\",\"operator\":\"exists\"}]"}]'

  • Führen Sie den Vorgang InstallAddon aus, um ein Cluster-Add-on zu installieren.