OCI Native Ingress Controller als Cluster-Add-on installieren

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

{
  "addonName": "NativeIngressController",
  "configurations": [
    {
      "key": "compartmentId",
      "value": "<compartment-ocid>"
    },
    {
      "key": "loadBalancerSubnetId",
      "value": "<load-balancer-subnet-ocid>"
    }    
  ]
}

Hierbei gilt:

• <compartment-id> ist die OCID des Compartments, in dem der native OCI-Ingress-Controller den OCI-Load Balancer und das Zertifikat erstellen soll.
• <load-balancer-subnet-ocid> ist die OCID des Subnetzes des Load Balancers.

Beispiel:

{
  "addonName": "NativeIngressController",
  "configurations": [
    {
      "key": "compartmentId",
      "value": "ocid1.compartment.oc1..aaaaaaaa______ddq"
    },
    {
      "key": "loadBalancerSubnetId",
      "value": "ocid1.subnet.oc1.iad.aaaaaaaa______dba"
    }    
  ]
}

• Wenn Sie einen Instanz-Principal eingerichtet haben, damit der native OCI-Ingress-Controller auf OCI-Services und -Ressourcen zugreifen kann, setzen Sie den Parameter authType auf instance.
• Wenn Sie einen Workload-Identitäts-Principal eingerichtet haben, damit der native OCI-Ingress-Controller auf OCI-Services und -Ressourcen zugreifen kann, setzen Sie den Parameter authType auf workloadIdentity.
• Wenn Sie einen Benutzer-Principal eingerichtet haben, damit der native OCI-Ingress-Controller auf OCI-Services und -Ressourcen zugreifen kann, setzen Sie den Parameter authType auf user.

Beispiel:

      "key": "authType",
      "value": "workloadIdentity"

Beachten Sie, dass instance der Standardwert des Parameters authType ist. Wenn Sie also nicht explizit einen Wert für authType angeben, verwendet der native OCI-Ingress-Controller die Identität der Instanz, auf der er ausgeführt wird, um auf OCI-Services und -Ressourcen zuzugreifen. Weitere Informationen finden Sie unter Instanz-Principal, Benutzer-Principal oder Workload-Identitäts-Principal einrichten, um Zugriff auf OCI-Services und -Ressourcen zu ermöglichen.

Beispiel:

{
  "addonName": "NativeIngressController",
  "configurations": [
    {
      "key": "compartmentId",
      "value": "ocid1.compartment.oc1..aaaaaaaa______ddq"
    },
    {
      "key": "loadBalancerSubnetId",
      "value": "ocid1.subnet.oc1.iad.aaaaaaaa______dba"
    },
    {
      "key": "authType",
      "value": "workloadIdentity"
    },
    {
      "key": "logVerbosity",
      "value": "2"
    }        
  ]
}

oci ce cluster list-addons --cluster-id <cluster-ocid>

Dabei ist <cluster-ocid> die OCID des Clusters, auf dem Sie das native Ingress-Controller-Add-on für OCI bereitstellen möchten.

Stellen Sie das native Ingress-Controller-Add-on für OCI im Cluster bereit, indem Sie Folgendes eingeben:

oci ce cluster install-addon --addon-name NativeIngressController --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 native Ingress-Controller-Add-on für OCI bereitstellen möchten.
• --from-json file://<path-to-config-file> gibt den Speicherort der zuvor erstellten Konfigurationsdatei für das OCI-native Ingress-Controller-Add-on an. Beispiel: --from-json file://./native-ingress-controller-addon.json

Beispiel:

oci ce cluster install-addon --addon-name NativeIngressController --from-json file://./native-ingress-controller-addon.json --cluster-id ocid1.cluster.oc1.iad.aaaaaaaam______dfr

Eine Arbeitsanforderung wird erstellt, um das OCI-Add-on für den nativen Ingress-Controller bereitzustellen.

Bestätigen Sie das erfolgreiche Deployment des OCI-Add-ons für den nativen Ingress-Controller, indem Sie Folgendes eingeben:

oci ce cluster list-addons --cluster-id <cluster-ocid>

Bei einer erfolgreichen Bereitstellung zeigt die Ausgabe das native OCI-Ingress-Controller-Add-on mit dem Lebenszyklusstatus ACTIVE an. Beispiel:

{
  "data": [
    {
      "addon-error": null,
      "current-installed-version": "v1.19.0",
      "lifecycle-state": "ACTIVE",
      "name": "NativeIngressController",
      "time-created": "2023-11-06T11:21:11+00:00",
      "version": null
    }
  ]
}