ocpctl

README

ocpctl

ocpctl is a CLI tool for OpenControlPlane.

Note: ocpctl currently supports managing local environments running in kind clusters, for development, testing, and CI use cases. Additional features are planned for future releases.

Prerequisites

• Docker

Installation

go install github.com/openmcp-project/ocpctl@latest

Usage

ocpctl env apply <name> [--config <file>]
ocpctl env delete <name>
ocpctl env list

Apply an environment

Creates or updates a local OpenControlPlane environment:

ocpctl env apply my-env

This will:

1. Create a kind cluster named my-env-platform (if it doesn't exist)
2. Apply the openmcp-operator namespace, service account, RBAC, config, and deployment
3. Apply the ClusterProvider and PlatformCluster resources
4. Wait until all resources are ready

List environments

Lists all ocpctl-managed local environments:

ocpctl env list

Only environments whose platform cluster has the Cluster CRD installed (i.e. were created by ocpctl) are shown.

Delete an environment

Deletes all kind clusters belonging to an environment:

ocpctl env delete my-env

This connects to the platform cluster, collects every kind cluster recorded in the Cluster resource provider statuses, and deletes them all.

Configuration

By default, ocpctl uses built-in image versions. To override them, provide a config file:

ocpctl env apply my-env --config env.yaml

Config files use the following format:

apiVersion: ocpctl.open-control-plane.io/v1alpha1
kind: Environment
spec:
  namespace: openmcp-system
  operator:
    image: ghcr.io/openmcp-project/images/openmcp-operator:v0.18.1
  clusterProviders:
    - name: kind
      image: ghcr.io/openmcp-project/images/cluster-provider-kind:v0.3.1
  serviceProviders:
    - name: example
      image: ghcr.io/openmcp-project/images/service-provider-example:v0.4.1
  platformServices:
    - name: example
      image: ghcr.io/openmcp-project/images/platform-service-example:v0.0.10

Only fields present in the config file override the defaults — omitted fields keep their default values.

Multiple environments

Each environment gets its own set of kind clusters prefixed with the environment name (e.g. my-env-platform), so multiple environments can coexist on the same machine.

Support, Feedback, Contributing

This project is open to feature requests/suggestions, bug reports etc. via GitHub issues. Contribution and feedback are encouraged and always welcome. For more information about how to contribute, the project structure, as well as additional contribution information, see our Contribution Guidelines.

Code of Conduct

We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone. By participating in this project, you agree to abide by its Code of Conduct at all times.

Licensing

Copyright OpenControlPlane contributors. Please see our LICENSE for copyright and license information. Detailed information including third-party components and their licensing/copyright information is available via the REUSE tool.

---

OpenControlPlane is part of ApeiroRA, an EU Important Project of Common European Interest (IPCEI-CIS).

Copyright Linux Foundation Europe. For web site terms of use, trademark policy and other project policies please see https://linuxfoundation.eu/en/policies.