Instalando o Controlador de Entrada Nativo do OCI como um Complemento de Cluster

Em um editor adequado, crie um arquivo JSON com um nome de sua escolha (essas instruções pressupõem que o arquivo seja chamado native-ingress-controller-addon.json) contendo o seguinte:

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

em que:

• <compartment-id> é o OCID do compartimento no qual o controlador de entrada nativo do OCI deve criar o balanceador de carga e o certificado do OCI.
• <load-balancer-subnet-ocid> é o OCID da sub-rede do balanceador de carga.

Por exemplo:

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

• Se você tiver configurado um controlador de instâncias para permitir que o controlador de entrada nativo do OCI acesse serviços e recursos do OCI, defina o parâmetro authType como instance.
• Se você tiver configurado um controlador de identidades de carga de trabalho para permitir que o controlador de entrada nativo do OCI acesse serviços e recursos do OCI, defina o parâmetro authType como workload.
• Se você tiver configurado um controlador de usuários para permitir que o controlador de entrada nativo do OCI acesse serviços e recursos do OCI, defina o parâmetro authType como user.

Por exemplo:

      "key": "authType",
      "value": "workload"

Observe que instance é o valor padrão do parâmetro authType; portanto, se você não especificar explicitamente um valor para authType, o controlador de entrada nativo do OCI usará a identidade da instância na qual ele está sendo executado para acessar serviços e recursos do OCI. Para obter mais informações, consulte Configurando um Controlador de Instâncias, um Controlador de Usuários ou um Controlador de Identidades de Carga de Trabalho para Ativar o Acesso aos Serviços e Recursos do OCI.

Por exemplo:

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

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

em que <cluster-ocid> é o OCID do cluster no qual você deseja implantar o add-on do controlador de entrada nativo do OCI.

Implante o complemento do controlador de entrada nativo do OCI no cluster digitando:

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

em que:

• --cluster-id <cluster-ocid> é o OCID do cluster no qual você deseja implantar o add-on do controlador de entrada nativo do OCI.
• --from-json file://<path-to-config-file> especifica o local do arquivo de configuração complementar do controlador de entrada nativo do OCI criado anteriormente. Por exemplo, --from-json file://./native-ingress-controller-addon.json

Por exemplo:

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

Uma solicitação de serviço é criada para implantar o complemento do controlador de entrada nativo do OCI.

Confirme a implantação bem-sucedida do complemento do controlador de entrada nativo do OCI digitando:

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

Supondo uma implantação bem-sucedida, a saída mostra o complemento do controlador de entrada nativo do OCI com um estado de ciclo de vida ACTIVE. Por exemplo:

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