Skip to content

Commit c686825

Browse files
committed
prepare README for public release v0.1.0
1 parent e275f11 commit c686825

File tree

1 file changed

+37
-2
lines changed

1 file changed

+37
-2
lines changed

README.md

Lines changed: 37 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ Kubernetes-native declarative infrastructure for [Incus](https://linuxcontainers
66

77
[Cluster API](https://cluster-api.sigs.k8s.io) is a Kubernetes sub-project focused on providing declarative APIs and tooling to simplify provisioning, upgrading, and operating multiple Kubernetes clusters.
88

9-
`cluster-api-provider-lxc` is an Infrastructure Provider for Cluster API, which enables deploying clusters on infrastructure operated by [Incus](https://linuxcontainers.org/incus/introduction/), [Canonical LXD](https://canonical.com/lxd) and [Canonical MicroCloud](https://canonical.com/microcloud).
9+
`cluster-api-provider-lxc` (CAPL) is an Infrastructure Provider for Cluster API, which enables deploying clusters on infrastructure operated by [Incus](https://linuxcontainers.org/incus/introduction/), [Canonical LXD](https://canonical.com/lxd) and [Canonical MicroCloud](https://canonical.com/microcloud).
1010

1111
The provider can be used in single-node development environments for evaluation and testing, but also work with multi-node clusters to deploy and manage production Kubernetes clusters.
1212

@@ -21,7 +21,42 @@ See [Quick Start](./tutorial/quick-start.md) to launch a cluster on a single-nod
2121
## Features
2222

2323
- Supports [Incus](https://linuxcontainers.org/incus/introduction/), [Canonical LXD](https://canonical.com/lxd) and [Canonical MicroCloud](https://canonical.com/microcloud).
24-
- Support for [OVN network load balancers](./reference/templates/ovn.md) and [kube-vip](./reference/templates/kube-vip.md) (production), or simple [haproxy containers](./reference/templates/) (development) for the cluster load balancer.
24+
- Support for [kube-vip](./reference/templates/kube-vip.md) (production), [OVN network load balancers](./reference/templates/ovn.md) or simple [haproxy containers](./reference/templates/development.md) (development) for the cluster load balancer.
2525
- [Default simplestreams server](./reference/default-simplestreams-server.md) with pre-built kubeadm images.
2626
- Supports virtual machines or LXC containers for the cluster machines. Automatically manages the [profile](./reference/profile/kubeadm.md) for Kubernetes to work in LXC containers.
2727
- Can be used for local development similar to CAPD for quickly iterating on custom bootstrap and control-plane providers, e.g. K3s, Canonical Kubernetes, etc.
28+
29+
## Project Roadmap
30+
31+
### v0.2.0
32+
33+
Rough steps for version v0.2.0:
34+
35+
- [x] Private initial alpha testing.
36+
- [x] Cloud provider node patch to link Machines with workload cluster Nodes.
37+
- [x] Test with both [Incus](https://linuxcontainers.org/incus/introduction/) and [Canonical LXD](https://canonical.com/lxd).
38+
- [x] Start cluster-api-provider-lxc book with quick start guide, cluster templates, API reference.
39+
- [x] Publish v0.1.0 release to get initial user feedback.
40+
- [ ] Write documentation with setting up a development environment.
41+
- [ ] Write documentation with common troubleshooting steps.
42+
- [ ] Write documentation with common cluster deployment scenarios.
43+
- [ ] Add e2e tests using the cluster-api testing framework.
44+
- [ ] Add PR blocking CI pipelines.
45+
- [ ] Add cluster-templates for 3rd party providers, e.g. [Canonical Kubernetes](https://github.com/canonical/cluster-api-k8s).
46+
- [ ] Gather initial user feedback.
47+
48+
### $Future
49+
50+
- [ ] Improve API validations and possibly API conformance tests.
51+
- [ ] Add CI to build and push kubeadm and haproxy images to the default simplestreams server.
52+
- [ ] Decide on project OWNERSHIP and testing infrastructure.
53+
- [ ] Split cloud provider node patch to external cloud-provider-incus project.
54+
- [ ] Explore clusters with ClusterTopology=true (clusterclass).
55+
- [ ] Refactor `internal/incus` package and improve consistency and log levels across the code.
56+
- [ ] Add to default list of providers supported by ClusterAPI.
57+
58+
## Getting involved and contributing
59+
60+
The `cluster-api-provider-lxc` project would love your suggestions, contributions and help! The maintainers can be contacted at any time to learn mode about how to get involved.
61+
62+
Remember that there are numerous effective ways to contribute to the project: raise a pull request to fix a bug, improve test coverage, improve existing documentation or even participate in GitHub issues. We want your help!

0 commit comments

Comments
 (0)