Vai al contenuto principale

What is an Infrastructure?

In Composer, an Infrastructure is a Kubernetes cluster connected to your organization. It provides the compute and storage capacity where Composer deploys the components that serve your Swarms and DS3 Gateways.

Terminology

The shared glossary calls this object a Location; the Composer UI section that lists these clusters is called Infrastructure. The two names refer to the same thing.

How Composer connects an infrastructure​

The connection is a bootstrap sequence driven by a Composer user, typically the Organization owner, from a machine that can reach the cluster:

  1. The Composer user installs the kubectl cubbit plugin and runs kubectl cubbit cluster-connect .... Composer generates the exact command; the procedure is described in Add an infrastructure location.
  2. The command installs the manager-operator in the cluster.
  3. The manager-operator installs and manages the other Cubbit Kubernetes operators and components in that cluster. Composer uses these operators to deploy and reconcile the entities created from the UI:
    • storage agents, through the agent-operator;
    • DS3 Gateways, through the gateway-operator;
    • offloaders, through the offloader-operator.
  4. The Composer user does not install Swarms, DS3 Gateways, or offloaders manually. When a Composer user creates one of these resources, Composer creates the corresponding Kubernetes custom resources and the operators reconcile them.
Composer user
│ kubectl cubbit cluster-connect
▼
Kubernetes cluster
│ installs
▼
manager-operator
├── agent-operator → storage agents (nodes)
├── gateway-operator → DS3 Gateways
└── offloader-operator → offloaders

The manager-operator keeps these components aligned with the desired state that Composer stores for the organization, so upgrades and configuration changes are applied from Composer rather than manually in the cluster.

Physical infrastructure​

A physical infrastructure is a Kubernetes cluster with disks and nodes connected to Composer through the operators described above. The nodes provide the storage capacity used by the Swarms.

Prerequisites​

Connecting a physical infrastructure requires:

  • A Kubernetes cluster that satisfies the prerequisites listed in the Add Infrastructure guide.
  • kubectl installed and configured with administrative access to that cluster.
  • Disks correctly formatted and mounted on the Kubernetes nodes.
  • Network reachability between the cluster and the Cubbit platform.