Deckhouse Kubernetes Platform in existing cluster

• Error of the following kind:

  │ │ ┌ Waiting for Deckhouse to become Ready
  │ │ │ Deckhouse pod found: deckhouse-64649df6f9-mf6dt (Pending)
  │ │ │ Deckhouse pod found: deckhouse-64649df6f9-mf6dt (Pending)
  

  Probably, there is no node in the cluster with the node-role.kubernetes.io/control-plane: "" label which is originally used in the nodeSelector of the deckhouse deployment manifest.

  Ways to fix the error:

  • Insert the proper nodeSelector into the deckhouse deployment:

    kubectl -n d8-system edit deployment/deckhouse
    

  • Delete nodeSelector in the deckhouse deployment:

    kubectl patch -n d8-system deployment deckhouse --type json -p '[{"op": "remove", "path": "/spec/template/spec/nodeSelector"}]'
    

The documentation module (deckhouse-web in Deckhouse 1.45 or older), which provides a web interface to the cluster documentation, requires the Ingress controller to be active in the cluster. If there is no Ingress controller in your cluster, you can use the built-in ingress-nginx module:

• Enable the ingress-nginx module, by executing the following command:

  Copy content

  kubectl create -f - <<EOF
  apiVersion: deckhouse.io/v1alpha1
  kind: ModuleConfig
  metadata:
    name: ingress-nginx
  spec:
    enabled: true
  EOF
  

  kubectl create -f - <<EOF apiVersion: deckhouse.io/v1alpha1 kind: ModuleConfig metadata: name: ingress-nginx spec: enabled: true EOF

• Create an ingress-nginx-controller.yml file with the following contents:

  ingress-nginx-controller.ymlCopy filenameCopy content

  # Section containing the parameters of NGINX Ingress controller.
  # https://deckhouse.io/documentation/v1/modules/402-ingress-nginx/cr.html
  apiVersion: deckhouse.io/v1
  kind: IngressNginxController
  metadata:
    name: nginx
  spec:
    ingressClass: nginx
    # The way traffic goes to cluster from the outer network.
    inlet: HostPort
    hostPort:
      httpPort: 80
      httpsPort: 443
    # Describes on which nodes the component will be located.
    # You might consider changing this.
    nodeSelector:
      node-role.kubernetes.io/control-plane: ""
    tolerations:
    - operator: Exists
  

  # Section containing the parameters of NGINX Ingress controller. # https://deckhouse.io/documentation/v1/modules/402-ingress-nginx/cr.html apiVersion: deckhouse.io/v1 kind: IngressNginxController metadata: name: nginx spec: ingressClass: nginx # The way traffic goes to cluster from the outer network. inlet: HostPort hostPort: httpPort: 80 httpsPort: 443 # Describes on which nodes the component will be located. # You might consider changing this. nodeSelector: node-role.kubernetes.io/control-plane: "" tolerations: - operator: Exists

• Once Deckhouse is installed, apply the file using the command below:

  Copy content

  kubectl create -f ingress-nginx-controller.yml
  

  kubectl create -f ingress-nginx-controller.yml