feat: add Crossplane + CrossplaneProvider reconciler (#11)

* feat(api): refine `ProviderConfig`

* chore(`ProviderConfig`): update samples

* docs: add docs how to use service-provider-crossplane

* fix: typo

* update docs

* register schemes for clusters

* add mechanism to read CRDs from file system

* feat: first draft of Crossplane reconciler

* refine crossplane reconcile logic

* feat(crossplane): add kubeconfig handling for flux SA on MCP cluster

* feat: add juggler for reconciling Crossplane Instance

* fix: typo

* fix: controller setup

* fix: imports

* fix: liniting issues

* feat(juggler): add `Crossplane` component

* docs: update sample

* fix: remove log

* add todos

* feat: implement deletion

* chore: update MCP scheme

* chore: refactor reconcile loop

* fix: using `POD_NAMESPACE` env variable

* fix: check for `Crossplane` CR is not found beginning of reconcile

* fix(bug): update status

* chore: implement smartrequeue package

* chore: update build submodule

* feat: add `CrossplaneProvider` component

* feat: use component label

* add todo

* chore(dep): update control-plane-operator

* fix: register ObjectReconciler

* fix: remove unused code

* feat: add CrossplaneProvider component to Juggler

* fix: linting errors

* fix: linting error

* fix: disabled crossplane providers

* fix: format package name in `Provider` CR

* docs: update readme

* docs: update readme

* feat: release v0.0.2

* docs: fix typo

* fix: header

* chore: update sample

* fix: remove unnecessary funcs + add tests

* fix: imports

* revert: changes on `health-probe-bind-address`

* chore: remove own docs

* chore: remove unused field

* fix: remove `PolicyRulesComponent` interface from `Crossplane` component

* fix: remove unused code

Author: maximiliantech

.gitignore

@@ -27,3 +27,5 @@ go.work
 *~
 
 *.html
+
+/tmp

README.md

@@ -4,42 +4,70 @@
 
 ## About this project
 
-Service provider Crossplane manages the lifecycle of Crossplane instances.
+Service provider Crossplane manages the lifecycle of Crossplane instances and Crossplane providers in a `ManagedControlPlane`.
 
-## Installation of the Service Provider Crossplane
+## 🏗️ Installation of the Service Provider Crossplane
 
 ### Local Development
+To run the service-provider-crossplane locally, you need to first bootstrap an openMCP environment by using [openmcp-operator](https://github.com/openmcp-project/openmcp-operator) and [cluster-provider-kind](https://github.com/openmcp-project/cluster-provider-kind). A comprehensive guide will follow soon.
 
-To install the service provider Crossplane locally, you can use the following command:
+For current testing reasons, the service-provider-crossplane needs to run in the cluster. To run the latest version of your changes in your local environment, you need to run:
 
 ```bash
-TODO
+task build:img:build
+```
+
+This will build the image of the service-provider-crossplane locally and puts it into your local Docker registry.
+
+```bash
+docker images ghcr.io/openmcp-project/images/service-provider-crossplane
+```
+
+You can then apply the `ServiceProvider` resource to your openMCP Platform cluster:
+
+```yaml
+apiVersion: openmcp.cloud/v1alpha1
+kind: ServiceProvider
+metadata:
+  name: crossplane
+spec:
+  image: ghcr.io/openmcp-project/images/service-provider-crossplane:... # latest local docker image build
 ```
 
 ### OpenMCP Landscape
+When you already have an openMCP environment set up, you can deploy the service-provider-crossplane by applying the following manifest:
 
 ```yaml
-apiVersion: services.openmcp.cloud/v1alpha1
+apiVersion: openmcp.cloud/v1alpha1
 kind: ServiceProvider
 metadata:
   name: crossplane
 spec:
-  image: ghcr.io/openmcp-project/images/service-provicer-crossplane:<version>
+  image: ghcr.io/openmcp-project/images/service-provider-crossplane:<latest-version> # latest upstream version
 ```
 
-## Configure a `ProviderConfig`
+## 📖 Usage
+
+### Configure a `ProviderConfig`
 A `ProviderConfig` is an API where you can configure the installation of a Crossplane instance in your `ManagedControlPlane`.
 
 ```yaml
 apiVersion: crossplane.services.openmcp.cloud/v1alpha1
 kind: ProviderConfig
 metadata:
-  name: providerconfig-sample
+  name: default
 spec:
   chart:
     repository: "https://charts.crossplane.io/stable"
     name: crossplane
-    version: v1.20.0
+    availableVersions:
+      - v1.20.0
+      - v1.19.0
+  availableProviders:
+    - name: provider-kubernetes
+      package: xpkg.upbound.io/upbound/provider-kubernetes
+      versions:
+        - v0.16.0
 ```
 
 ### Install a Crossplane instance
@@ -54,38 +82,54 @@ spec:
   version: v1.20.0
   providers:
     - name: provider-kubernetes
-      version: v0.18.0
+      version: v0.16.0
 ```
 
-## Development
+## 🧑‍💻 Development
 
-### Building the image locally
+### Building the binary locally
 
-To build the image locally, you can use the following command:
+To build the binary locally, you can use the following command:
 
 ```bash
 task build
 ```
 
+### Build the image locally
+
+To build the image locally, you can use the following command:
+
+```bash
+task build:img:build
+```
+
+### Run unit tests locally
+
+To run the unit tests locally, you can use the following command:
+
+```bash
+task test
+```
+
 ### Generating the CRDs, DeepCopy functions etc.
 To generate the CRDs, DeepCopy functions, and other boilerplate code, you can use the following command:
 
 ```bash
 task generate
 ```
 
-## Support, Feedback, Contributing
+## ❤️ Support, Feedback, Contributing
 
 This project is open to feature requests/suggestions, bug reports etc. via [GitHub issues](https://github.com/openmcp-project/service-provider-crossplane/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](CONTRIBUTING.md).
 
-## Security / Disclosure
+## 🔐 Security / Disclosure
 If you find any bug that may be a security problem, please follow our instructions at [in our security policy](https://github.com/openmcp-project/service-provider-crossplane/security/policy) on how to report it. Please do not create GitHub issues for security-related doubts or problems.
 
-## Code of Conduct
+## 🤝 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](https://github.com/openmcp-project/.github/blob/main/CODE_OF_CONDUCT.md) at all times.
 
-## Licensing
+## 📋 Licensing
 
 Copyright 2025 SAP SE or an SAP affiliate company and service-provider-crossplane contributors. Please see our [LICENSE](LICENSE) for copyright and license information. Detailed information including third-party components and their licensing/copyright information is available [via the REUSE tool](https://api.reuse.software/info/github.com/openmcp-project/service-provider-crossplane).
 

Taskfile.yaml

@@ -7,7 +7,7 @@ includes:
     vars:
       API_DIRS: '{{.ROOT_DIR}}/api/v1alpha1/...'
       MANIFEST_OUT: '{{.ROOT_DIR}}/api/crds/manifests'
-      CODE_DIRS: '{{.ROOT_DIR}}/cmd/... {{.ROOT_DIR}}/internal/... {{.ROOT_DIR}}/api/v1alpha1/...'
+      CODE_DIRS: '{{.ROOT_DIR}}/cmd/... {{.ROOT_DIR}}/internal/... {{.ROOT_DIR}}/api/v1alpha1/... {{.ROOT_DIR}}/pkg/...'
       COMPONENTS: 'service-provider-crossplane'
       REPO_URL: 'https://github.com/openmcp-project/service-provider-crossplane'
       CHART_COMPONENTS: "[]"

VERSION

@@ -1 +1 @@
-v0.0.1-dev
+v0.0.2

api/crds/crds.go

@@ -0,0 +1,15 @@
+package crds
+
+import (
+	"embed"
+
+	crdutil "github.com/openmcp-project/controller-utils/pkg/crds"
+	apiextv1 "k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1"
+)
+
+//go:embed manifests
+var CRDFS embed.FS
+
+func CRDs() ([]*apiextv1.CustomResourceDefinition, error) {
+	return crdutil.CRDsFromFileSystem(CRDFS, "manifests")
+}

api/crds/manifests/crossplane.services.openmcp.cloud_providerconfigs.yaml

@@ -70,28 +70,24 @@ spec:
                   - versions
                   type: object
                 type: array
-              availableVersions:
-                description: AvailableVersions holds the list of available versions
-                  for Crossplane.
-                items:
-                  type: string
-                type: array
               chart:
                 description: Optional custom Helm chart configuration.
                 properties:
+                  availableVersions:
+                    description: AvailableVersions of the Helm chart.
+                    items:
+                      type: string
+                    type: array
                   name:
                     description: Name of the Helm chart.
                     type: string
                   repository:
                     description: Repository is the URL to a Helm repository.
                     type: string
-                  version:
-                    description: Version of the Helm chart.
-                    type: string
                 required:
+                - availableVersions
                 - name
                 - repository
-                - version
                 type: object
               imageMapping:
                 additionalProperties:
@@ -101,7 +97,6 @@ spec:
                 type: object
             required:
             - availableProviders
-            - availableVersions
             - chart
             type: object
           status:

api/v1alpha1/providerconfig_types.go

@@ -46,9 +46,9 @@ type ChartSpec struct {
 	// +kubebuilder:validation:Required
 	Name string `json:"name"`
 
-	// Version of the Helm chart.
+	// AvailableVersions of the Helm chart.
 	// +kubebuilder:validation:Required
-	Version string `json:"version"`
+	AvailableVersions []string `json:"availableVersions"`
 }
 
 // ProviderConfigSpec defines the desired state of ProviderConfig.
@@ -61,10 +61,6 @@ type ProviderConfigSpec struct {
 	// +kubebuilder:validation:Optional
 	ImageMapping map[string]string `json:"imageMapping,omitempty"`
 
-	// AvailableVersions holds the list of available versions for Crossplane.
-	// +kubebuilder:validation:Required
-	AvailableVersions []string `json:"availableVersions"`
-
 	// AvailableProviders holds the list of providers that can be configured with the Service Provider Crossplane.
 	// +kubebuilder:validation:Required
 	AvailableProviders []AvailableCrossplaneProvider `json:"availableProviders"`