Add, Register, and Deploy a Cluster

After creating a cluster, it has to be registered by installing the NavOps CLI and agent. You can add node configurations containing custom resources and scripts and deploy the cluster.

Add a Cluster

  1. In NavOps, click Clusters to open the Clusters page.
  2. Click Add Cluster.
  3. Enter a name for the cluster.
  4. For Type, select the workload manager.
  5. Add a description for the cluster.
  6. Click Save.
    The new cluster is added and displayed in the list of clusters.

Register and Deploy a Cluster

  1. Click the name of the cluster to open the overview page.
  2. To install the CLI, select the target architecture.
  3. On the head node of the cluster run the displayed commands to:
    1. Download the CLI binary
      1. For amd64:
        sudo curl --insecure https://10.0.1.79:443/resources/cli/navops_linux_amd64 -o /usr/local/bin/navops
      2. For arm64:
        sudo curl --insecure https://10.0.1.79:443/resources/cli/navops_linux_arm64 -o /usr/local/bin/navops
    2. Make it executable.
      sudo chmod 0755 /usr/local/bin/navops
    3. Add to the path.
      export PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/local/bin
  4. To register the head node, select it and run the displayed commands to:
    1. Export the NavOps environment variables.
      export NAVOPS_URL=https://10.0.1.79:443
      export NAVOPS_DISABLE_TLS_VERIFICATION=1
      export NAVOPS_NATS_URLS=<nats token to use>
      export NAVOPS_NATS_TLS_INSECURE_SKIP_VERIFY=1
    2. Log in.
      navops auth login
    3. Install agent using a node configuration. A default node configuration is added when a cluster is created. You can also add custom node configurations with resources and scripts.
      navops agent install --node-config-uid 48008a06-39ff-4ec0-8dfc-0ceab26f8751
    4. Run the agent setup script.
      sudo /opt/navops/bin/agent-setup.sh
    5. Start the navops-agent service.
      sudo systemctl start navops-agent
  5. Click Deploy the cluster.
    The cluster object can be configured to specify a custom download path for downloading agents:
    _meta:
      type: Cluster
      ...
    config:
      agent_download_path: </path/to/directory/> or <http[s]://url-to-download/>
    The path can either be a URL, or a filesystem path to a directory. The agent tarballs with their default directory structure must exist at the location. When the navops agent install command is used, the CLI will search for the agent tarballs in this location.