Installing Nodes with Kubernetes

This article describes how to install Crosser Nodes on a Kubernetes cluster.

Requirements

Before you start make sure you have the following dependencies ready and working:

• Helm > 3

Installation

helm upgrade --install <releasename> \
    oci://registry.crosser.cloud/charts/node --version 0.4.1 \
    --create-namespace -n <namespace>  
    --values <path-to-your-values.yaml>

#
# If you want to use custom certificate in store you need to set the cert location with set-file option to helm
#

helm upgrade --install <releasename> \
    oci://registry.crosser.cloud/charts/node --version 0.4.1  \
    --create-namespace -n <namespace>  \
    --values <path-to-your-values.yaml> \
    --set node.custom.certificate.enbled=true  \
    --set-file node.custom.certificate.file=<path-to-your-cert.crt> 

Before installing a node you need to update the values.yaml file with credentials to the Crosser Docker registry and for your Crosser Node. This information can be found in Control Center on the Nodes page and the Register Nodes tab (Docker credentials are available in the advancced options section).

Configuration

The values.yaml file is divided into a node specific configuration section, and a Kubernetes deployment specific section.

Examples of a typical config files:

# values.yaml (with nodeID and accessKey)

registry:
  host: docker.crosser.io
  username: username
  password: password
node:
  nodeID:  nodeid
  accessKey: accesskey
expose:
  type: ClusterIP


# values.yaml (with globalKey registration)

registry:
  host: docker.crosser.io
  username: username
  password: password
node:
  globalKey:
    enabled: true
    registrationKey: your-global-key

# values.yaml (with ingress with basic-auth)

registry:
  host: docker.crosser.io
  username: username
  password: password
node:
  nodeID:  nodeid
  accessKey: accesskey
expose:
  ingress:
    enabled: true
    host: crossernode.domain.tld
    auth:
      enabled: true
      username: "edgenode"
      password: "edgenode"
    tls:
      enabled: true


# values.yaml (with ingress and openshift edge termination)

registry:
  host: docker.crosser.io
  username: username
  password: password
node:
  nodeID:  nodeid
  accessKey: accesskey
expose:
  ingress:
    enabled: true
    host: crossernode.domain.tld
    tls:
      enabled: true
      openshiftEdgeTermination: true

Settings

The following table lists the configurable parameters of the node chart and their default values.