Skip to content

Commit 0a348e8

Browse files
authored
πŸ“– Updating documentations, deleting some that are no longer useful (#7)
2 parents 1deb1b8 + 16c25cf commit 0a348e8

File tree

3 files changed

+6
-116
lines changed

3 files changed

+6
-116
lines changed

β€ŽREADME.mdβ€Ž

Lines changed: 6 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -1,35 +1,9 @@
11
<a href="https://cluster-api.sigs.k8s.io"><img alt="capi" src="./logos/kubernetes-cluster-logos_final-02.svg" width="160x" /></a>
22
<p>
33
<a href="https://godoc.org/sigs.k8s.io/cluster-api"><img src="https://godoc.org/sigs.k8s.io/cluster-api?status.svg"></a>
4-
<!-- join kubernetes slack channel for cluster-api -->
5-
<a href="http://slack.k8s.io/">
6-
<img src="https://img.shields.io/badge/join%20slack-%23cluster--api-brightgreen"></a>
7-
</p>
84

95
# Cluster API Add-on Provider for Cdk8s
106

11-
## ✨ What is Cluster API Add-on Provider for Cdk8s?
12-
13-
Cluster API Add-on Provider for Cdk8s extends Cluster API by managing the installation, configuration, upgrade, and deletion of cluster add-ons using cdk8s applications. This provider is based on the [Cluster API Add-on Orchestration Proposal](https://github.com/kubernetes-sigs/cluster-api/blob/main/docs/proposals/20220712-cluster-api-addon-orchestration.md), a larger effort to bring orchestration for add-ons to CAPI by using existing package management tools.
14-
15-
This project is a concrete implementation of a ClusterAddonProvider, a pluggable component to be deployed on the Management Cluster. An add-on provider component acts as a broker between Cluster API and a package management tool (in this case, cdk8s).
16-
17-
The aims of the ClusterAddonProvider project are as follows:
18-
19-
#### Goals
20-
21-
- Design a solution for orchestrating Cluster add-ons.
22-
- Leverage the capabilities of cdk8s for defining and synthesizing Kubernetes manifests.
23-
- Make add-on management in Cluster API modular and pluggable.
24-
- Make it clear for developers how to build a Cluster API Add-on Provider based on cdk8s or other tools.
25-
26-
#### Non-goals
27-
28-
- Implement a new, full-fledged package management tool in Cluster API.
29-
- Provide a mechanism for altering, customizing, or dealing with single Kubernetes resources defining a Cluster add-on, i.e. Deployments, Services, ServiceAccounts. Cluster API should treat add-ons as opaque components and delegate all the operations impacting add-on internals to cdk8s.
30-
- Expect users to use a specific package management tool (though this provider focuses on cdk8s).
31-
- Implement a solution for installing add-ons on the management cluster itself.
32-
337
## Cdk8sAppProxy CRD
348

359
The `Cdk8sAppProxy` CustomResourceDefinition (CRD) is used to manage the deployment of cdk8s applications to workload clusters. It allows users to specify the source of the cdk8s application, any input values, and the target clusters for deployment.
@@ -50,18 +24,18 @@ spec:
5024
reference: "main"
5125
referencePollInterval: "5m"
5226
path: "examples/cdk8s-sample-deployment"
53-
clusterSelector: {}
54-
# matchLabels:
55-
# environment: development
27+
clusterSelector: {} # Matches all clusters in the same namespace
28+
# matchLabels:
29+
# environment: development
5630
```
5731

5832
### Cdk8sAppProxySpec Fields
5933

6034
- **gitRepository**: (Optional) Specifies the Git repository for the cdk8s application. `gitRepository` must be specified.
6135
- **url**: (Required) The Git repository URL.
62-
- **reference**: (Optional) The Git reference (branch, tag, or commit) to check out.
63-
- **path**: (Optional) The path within the repository where the cdk8s application is located. Defaults to the root.
64-
- **values**: (Optional) A string containing values to be passed to the cdk8s application, typically in YAML or JSON format. This can be used to customize the deployment. The controller supports Go templating within this field, allowing dynamic values based on cluster properties (e.g., `{{ .Cluster.spec.clusterNetwork.apiServerPort }}`).
36+
- **reference**: (Required) The Git reference (branch, tag, or commit) to check out.
37+
- **referencePollInterval**: (Optional) The interval at which the controller checks for changes in the Git repository. Defaults to `5m`.
38+
- **path**: (Required) The path within the repository where the cdk8s application is located. Defaults to the root.
6539
- **clusterSelector**: (Required) A `metav1.LabelSelector` that specifies which workload clusters the cdk8s application should be deployed to. The controller will watch for clusters matching this selector in the same namespace as the `Cdk8sAppProxy` resource.
6640

6741
## Examples
@@ -71,21 +45,6 @@ Examples of `Cdk8sAppProxy` usage can be found in the `/examples` directory in t
7145
- [`examples/cdk8sappproxy_sample-go.yaml`](./examples/cdk8sappproxy_sample-go.yaml): This example demonstrates how to deploy a sample cdk8s application from a public Git repository to clusters matching a specific label selector. It shows the usage of the `gitRepository` field.
7246
- [`examples/cdk8sappproxy_sample-typescript.yaml`](./examples/cdk8sappproxy_sample-typescript.yaml): This directory contains a sample cdk8s application written in Typescript, which also generates a kustomization file.
7347

74-
## πŸ€— Community, discussion, contribution, and support
75-
76-
Cluster API Add-on Provider for Cdk8s is developed as a part of the [Cluster API project](https://github.com/kubernetes-sigs/cluster-api). As such, it will share the same communication channels and meeting as Cluster API.
77-
78-
This work is made possible due to the efforts of users, contributors, and maintainers. If you have questions or want to get the latest project news, you can connect with us in the following ways:
79-
80-
- Chat with us on the Kubernetes [Slack](http://slack.k8s.io/) in the [#cluster-api](https://kubernetes.slack.com/archives/C8TSNPY4T) channel
81-
- Subscribe to the [SIG Cluster Lifecycle](https://groups.google.com/forum/#!forum/kubernetes-sig-cluster-lifecycle) Google Group for access to documents and calendars
82-
83-
Pull Requests and feedback on issues are very welcome!
84-
See the [issue tracker](https://github.com/eitco/cluster-api-addon-provider-cdk8s/issues) if you're unsure where to start, especially the [Good first issue](https://github.com/eitco/cluster-api-addon-provider-cdk8s/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22) and [Help wanted](https://github.com/eitco/cluster-api-addon-provider-cdk8s/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22) tags, and
85-
also feel free to reach out to discuss.
86-
87-
See also our [contributor guide](CONTRIBUTING.md) and the Kubernetes [community page](https://kubernetes.io/community/) for more details on how to get involved.
88-
8948
### Code of conduct
9049

9150
Participation in the Kubernetes community is governed by the [Kubernetes Code of Conduct](code-of-conduct.md).

β€Ždocs/quick-start.mdβ€Ž

Lines changed: 0 additions & 1 deletion
This file was deleted.

β€Ždocs/releasing.mdβ€Ž

Lines changed: 0 additions & 68 deletions
This file was deleted.

0 commit comments

Comments
Β (0)