Installation du contrôleur d'entrée natif OCI en tant qu'extension de cluster

Dans un éditeur approprié, créez un fichier JSON avec le nom de votre choix (ces instructions supposent que le fichier est appelé native-ingress-controller-addon.json) contenant les éléments suivants :

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

où :

• <compartment-id> est l'OCID du compartiment dans lequel le contrôleur d'entrée natif OCI doit créer l'équilibreur de charge et le certificat OCI.
• <load-balancer-subnet-ocid> est l'OCID du sous-réseau de l'équilibreur de charge.

Par exemple :

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

• Si vous avez configuré un principal d'instance pour permettre au contrôleur d'entrée natif OCI d'accéder aux services et aux ressources OCI, définissez le paramètre authType sur instance.
• Si vous avez configuré un principal d'identité de charge globale pour permettre au contrôleur d'entrée natif OCI d'accéder aux services et ressources OCI, définissez le paramètre authType sur workloadIdentity.
• Si vous avez configuré un principal d'utilisateur pour permettre au contrôleur d'entrée natif OCI d'accéder aux services et ressources OCI, définissez le paramètre authType sur user.

Par exemple :

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

instance est la valeur par défaut du paramètre authType. Par conséquent, si vous n'indiquez pas explicitement de valeur pour authType, le contrôleur d'entrée natif OCI utilise l'identité de l'instance sur laquelle il est exécuté pour accéder aux services et aux ressources OCI. Pour plus d'informations, reportez-vous à Configuration d'un principal d'instance, d'un principal utilisateur ou d'un principal d'identité de charge globale afin d'activer l'accès aux services et ressources OCI.

Par exemple :

{
  "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>

où <cluster-ocid> est l'OCID du cluster sur lequel déployer l'extension de contrôleur d'entrée natif OCI.

Déployez l'extension de contrôleur d'entrée natif OCI sur le cluster en saisissant ce qui suit :

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

où :

• --cluster-id <cluster-ocid> est l'OCID du cluster dans lequel déployer l'extension de contrôleur d'entrée natif OCI.
• --from-json file://<path-to-config-file> indique l'emplacement du fichier de configuration d'extension de contrôleur d'entrée natif OCI que vous avez créé précédemment. Par exemple, --from-json file://./native-ingress-controller-addon.json

Par exemple :

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

Une demande de travail est créée pour déployer l'extension de contrôleur d'entrée native OCI.

Vérifiez que le déploiement de l'extension de contrôleur d'entrée natif OCI a réussi en saisissant ce qui suit :

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

En supposant un déploiement réussi, la sortie affiche l'extension de contrôleur d'entrée native OCI avec l'état de cycle de vie ACTIVE. Par exemple :

{
  "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
    }
  ]
}