Supported project (namespace) configurations

The projects (namespaces) that you must create on your cluster depend on several factors. Review the following information to determine which projects you must create.

Projects for shared cluster components

The shared cluster components are installed only one time on the cluster. All instances of IBM® Concert on the cluster share these components. Each component is installed in its own project.
Note: Do not install any other software in the project.

The following table provides the default project name and the environment variable that is used to identify the project in commands throughout the documentation. You are not required to use the default project names. The default names are used only if you don't specify a project name when you install the components.

Component Default project name Environment variable
IBM® Certificate Manager ibm-cert-manager ${PROJECT_CERT_MANAGER}
License Service ibm-licensing ${PROJECT_CS_CONTROL}
Scheduling Service None ${PROJECT_SCHEDULING_SERVICE}

Projects required to install an instance of Concert

At a minimum, an instance of Concert has two projects (namespaces): the operators project and the instances project.

Only the specified software should be installed in the operators project and the instances project. The projects do not have default names.

Operators project

The Operators project is where the operators are installed.

In installation and administration commands, the ${PROJECT_OPERATOR} environment variable refers to the operators project.

  • What are Operators?

    An operator is a custom Kubernetes controller. A controller implements a control loop that continually watches the state of specific objects on your cluster and makes adjustments as needed to ensure that the objects are running as expected.

    Each component of Concert includes an operator that is responsible for managing that component. For example, the control plane has a dedicated operator, and each service has a dedicated operator.

Install the operators for the services that you plan to install in the instances project. Each operator monitors the appropriate instances in the instances project.

Instances project

The instances project is where the Concert control plane and services are installed.

In installation and administration commands, the ${PROJECT_INSTANCE} environment variable refers to the instances project.

The operators monitor the instances to ensure that they are running as expected.