Creating IngressClassParameters, IngressClass, and Ingress Resources

Create IngressClassParameters resource 🔗

Use the custom IngressClassParameters resource to specify details of the OCI load balancer to create for the OCI native ingress controller.

Define the resource in a .yaml file. Here's a minimal example:

apiVersion: "ingress.oraclecloud.com/v1beta1"
kind: IngressClassParameters
metadata:
  name: <icp-name>
  namespace: <ns-name>
spec:
  compartmentId: "<compartment-ocid>"
  subnetId: "<subnet-ocid>"
  loadBalancerName: "<lb-name>"
  isPrivate: false
  maxBandwidthMbps: <max-bw>
  minBandwidthMbps: <min-bw>
  reservedPublicAddressId: <reserved-ip-ocid>

where:

• name: <icp-name> is the name of the new IngressClassParameters resource
• name: <ns-name> is the name of the namespace in which to create the new IngressClassParameters resource.
• compartmentId: "<compartment-ocid>" is the OCID of the compartment that you want the new load balancer to belong to.
• subnetId: "<subnet-ocid>" is the OCID of the load balancer's subnet.
• loadBalancerName: "<lb-name>" is the name to give the new load balancer.
• maxBandwidthMbps: <max-bw> is the upper amount of bandwidth that you want the new load balancer to support during time of peak workload.
• minBandwidthMbps: <min-bw> is the amount of bandwidth that you want the new load balancer to always have available to provide instant readiness for workloads.
• reservedPublicAddressId: <reserved-ip-ocid> is optionally the OCID of an existing reserved public IP address resource to use for the load balancer. If you don't specify a reserved public IP address, the load balancer is assigned a random IP address. For more information about creating a reserved public IP address, see Creating a Reserved Public IP.

For example:

apiVersion: "ingress.oraclecloud.com/v1beta1"
kind: IngressClassParameters
metadata:
  name: native-ic-params
  namespace: acme-namespace
spec:
  compartmentId: "ocid1.compartment.oc1..aaaaaaaa______ddq"
  subnetId: "ocid1.subnet.oc1.iad.aaaaaaaa______dba"
  loadBalancerName: "native-ic-lb"
  isPrivate: false
  maxBandwidthMbps: 400
  minBandwidthMbps: 100

Create the resource by entering kubectl create -f <filename>.yaml

Create IngressClass resource 🔗

Use the IngressClass resource to associate an Ingress resource with the OCI native ingress controller and the IngressClassParameters resource. You can also use the IngressClass resource to specify whether the OCI native ingress controller is the default controller for Ingress resources.

Define the resource in a .yaml file. Here's a minimal example:

apiVersion: networking.k8s.io/v1
kind: IngressClass
metadata:
  name: <ic-name>
  annotations:
    ingressclass.kubernetes.io/is-default-class: "<true|false>"
spec:
  controller: oci.oraclecloud.com/native-ingress-controller
  parameters:
    scope: Namespace
    namespace: <ns-name>
    apiGroup: ingress.oraclecloud.com
    kind: ingressclassparameters
    name: <icp-name>

where:

• name: <ic-name> is the name of the new IngressClass resource
• ingressclass.kubernetes.io/is-default-class: "<true|false>" indicates whether this IngressClass is the default IngressClass to use if an Ingress resource does not explicitly specify an ingressClassName. It is recommended to specify a default IngressClass.
• controller: oci.oraclecloud.com/native-ingress-controller specifies the OCI native ingress controller as the ingress controller to use
• namespace: <ns-name> is the name of the namespace containing the parameters to use when .spec.parameters.scope is set to Namespace.
• name: <icp-name> is the name of the IngressClassParameters resource that specifies details of the OCI load balancer to create for the OCI native ingress controller.

For example:

apiVersion: networking.k8s.io/v1
kind: IngressClass
metadata:
  name: native-ic-ingress-class
  annotations:
    ingressclass.kubernetes.io/is-default-class: "true"
spec:
  controller: oci.oraclecloud.com/native-ingress-controller
  parameters:
    scope: Namespace
    namespace: acme-namespace
    apiGroup: ingress.oraclecloud.com
    kind: ingressclassparameters
    name: native-ic-params

Create the resource by entering kubectl create -f <filename>.yaml

Create Ingress resource 🔗

Use the Ingress resource to specify rules to route external traffic to backend services.

Define the resource in a .yaml file. Here's a minimal example:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: <i-name>
spec:
  ingressClassName: <ic-name>
  rules:
    <ingress-rule>

For example:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: native-ic-ingress
spec:
  ingressClassName: native-ic-ingress-class
  rules:
    - host: "foo.bar.com"
      http:
        paths:
          - pathType: Exact
            path: "/testecho1"
            backend:
              service:
                name: testecho1
                port:
                  number: 80

Create the resource by entering kubectl create -f <filename>.yaml