Prepare an Oracle Cloud Native Environment Cluster

Install Oracle Cloud Native Environment

Deploy Oracle Cloud Native Environment with the Kubernetes module, following instructions from Oracle Cloud Native Environment: Getting Started.

• Install a Kubernetes network load balancer implementation, such as OCI-CCM or MetalLB.
• Install a Container Storage Interface Driver, such as OCI-CCM.

Notes

• The oci-ccm module does not elect a default StorageClass or configure policies for the CSIDrivers that it installs. A reasonable choice is the oci-bv StorageClass with its CSIDriver configured with the File group policy.

  kubectl patch sc oci-bv -p '{"metadata": {"annotations":{"storageclass.kubernetes.io/is-default-class":"true"}}}'
  kubectl apply -f - <<EOF
  apiVersion: storage.k8s.io/v1
  kind: CSIDriver
  metadata:
    name: blockvolume.csi.oraclecloud.com
  spec:
    fsGroupPolicy: File
  EOF
  

• Unless explicitly configured, the externalip-validation-webhook-service defaults to blocking all external IP addresses in the cluster, which causes the Verrazzano installation to fail because an IP address cannot be assigned to an ingress controller. When this situation occurs, the Verrazzano platform operator logs will contain a message similar to this:

  admission webhook "validate-externalip.webhook.svc" denied the request: spec.externalIPs:
      Invalid value: "<external IP address>": externalIP specified is not allowed to use
  

  To avoid this error, either disable the externalip-validation-webhook-service or configure the service with your load balancer IP addresses prior to installing Verrazzano. For more information, see Enabling Access to all externalIPs.

Examples

Next steps

To continue, see the Installation Guide.