https://github.com/DevOpsHiveHQ/crossplane-bootstrapper
Fix the cloud native-control plane paradox! Start the initial setup of Crossplane from a local Kubernetes cluster
https://github.com/DevOpsHiveHQ/crossplane-bootstrapper
cloud-native crossplane k3d k3s kubernetes
Last synced: 3 months ago
JSON representation
Fix the cloud native-control plane paradox! Start the initial setup of Crossplane from a local Kubernetes cluster
- Host: GitHub
- URL: https://github.com/DevOpsHiveHQ/crossplane-bootstrapper
- Owner: DevOpsHiveHQ
- License: apache-2.0
- Created: 2024-04-17T04:38:58.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-05-05T20:31:42.000Z (about 1 year ago)
- Last Synced: 2026-02-28T14:13:20.180Z (4 months ago)
- Topics: cloud-native, crossplane, k3d, k3s, kubernetes
- Homepage:
- Size: 25.4 KB
- Stars: 8
- Watchers: 0
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Crossplane Bootstrapper
Fix the cloud-native control plane paradox!
Start the initial setup of Crossplane from a local Kubernetes cluster
> [!IMPORTANT]
> The following instructions require K3d v5.7.0 or above.
> [!TIP]
> Checkout [KubeZero](https://github.com/DevOpsHiveHQ/kubezero) if you want an easy way to build a production-ready out-of-the-box Kubernetes platform IaC with GitOps designed for multi-environment Cloud Native setup.
## Why?
[Crossplane is awesome](https://github.com/DevOpsHiveHQ/awesome-crossplane)! It is an open-source Kubernetes add-on that extends Kubernetes to manage and provision cloud infrastructure resources using Kubernetes-style configurations. Arguably I'd say it's the best cloud-native way to do IaC and GitOps for infrastructure!
However, it has one tiny challenge given it only works on Kubernetes ... that it needs a working Kubernetes cluster! That means it needs some manual work at the beginning to start the automation.
Here comes Crossplane Bootstrapper which utilizes [K3d](https://github.com/k3d-io/k3d) capabilities to automate that bootstrapping step.
## What?
Using Helm Controller in K3d/K3s you can set up Crossplane automatically in IaC style via a local cluster with minimal manual ad-hoc work which will build your main management cluster on the cloud.
Here is an overview of the flow:
```mermaid
flowchart TB
%% Cluster 1 - Bootstrap.
style k8sBoostrap stroke-dasharray: 2 2
subgraph k8sBoostrap["Kubernetes Cluster - Local"]
%% Initial bootstrap.
K3D["K3d/K3s\nHelm Controller"] --> k8sBoostrap.GitOps
%% Management components.
subgraph k8sBoostrap.GitOps["Bootstrap"]
direction TB
k8sBoostrap.Crossplane[Crossplane]
end
end
%% Cluster 2 - Management.
style k8sManagement stroke-dasharray: 2 2
subgraph k8sManagement["Kubernetes Cluster - Cloud"]
subgraph k8sManagement.InfraManagement[Management]
k8sManagement.InfraManagement.Crossplane[Crossplane]
end
end
%% Bootstrap connections.
k8sBoostrap.Crossplane --"Build Management Cluster"--> k8sManagement
```
## How?
By just running one command, you will have a local cluster with an up-and-running Crossplane which will build your cloud management cluster. You can customize the bootstrapped resources.
1. Prerequisites:
- [K3d](https://k3d.io/) CLI.
- Clone this repo (Crossplane Bootstrapper).
- Edit the config based on your needs [manifest-crossplane-bootstrapper.yaml](manifest-crossplane-bootstrapper.yaml)
2. Run:
```shell
k3d cluster create --config k3d-crossplane-bootstrapper.yaml
```
3. Ensure that everything works as expected:
```shell
kubectl get pod -n crossplane-system
```
4. You can customize the bootstrapping process as you like using [Crossplane Helm values](https://artifacthub.io/packages/helm/crossplane/crossplane/) or any extra Kubernetes objects you need (for example, you will need to deploy the [ProviderConfig](https://docs.crossplane.io/latest/concepts/providers/#provider-configuration)).
## License
This project is open-source by [DevOps Hive](https://devopshive.net/) and licensed under Apache License 2.0. For more details, please review [LICENSE](LICENSE).