Add a component to a cluster in local mode

This how-to describes the steps required to add a component (new or existing) to a cluster in local mode.

Add an existing component to a cluster in local mode

To add an existing component to a cluster in local mode for testing purposes, the following steps can be used. This example uses the nfs-subdir-external-provisioner component.

  1. Create a working directory for the cluster

    You can skip this step if you’ve already got a working directory in which you can run commodore catalog compile --local for the cluster you’re targeting.
    mkdir /path/to/working/directory
    commodore catalog compile <cluster-id>
  2. Clone the component, if it’s not present in dependencies/

    test -d dependencies/${COMPONENT_NAME} || \
    git clone${COMPONENT_NAME}.git \
  3. Add the component to the cluster, by adding it in the applications array in the cluster config:

      - nfs-subdir-external-provisioner
  4. Run Commodore in local mode with dependency fetching enabled

    commodore catalog compile <cluster-id> --local
  5. Now you can configure the component and test changes with dependency fetching disabled

    commodore catalog compile <cluster-id> --local --no-fetch-dependencies

Testing a new component in local mode

Commodore’s component new command won’t insert the component into the current cluster configuration.

To test a new component in local mode, you need to explicitly add the component to the cluster by following the steps in the previous section. You can omit the second step of the previous section, if you’ve created the component in the target cluster’s working directory with component new, as that command will initialize the component repo in dependencies/ by default.