chore(reorganize): README section a bit
Signed-off-by: Devin Buhl <devin@buhl.casa>
This commit is contained in:
1 file changed
+21
-19
@@ -338,6 +338,14 @@ To access services from the outside world port forwarded `80` and `443` in your
|
|||||||
|
|
||||||
Now if nothing is working, that is expected. This is DNS after all!
|
Now if nothing is working, that is expected. This is DNS after all!
|
||||||
|
|
||||||
|
### 🤖 Renovatebot
|
||||||
|
|
||||||
|
[Renovatebot](https://www.whitesourcesoftware.com/free-developer-tools/renovate/) will scan your repository and offer PRs when it finds dependencies out of date. Common dependencies it will discover and update are Flux, Ansible Galaxy Roles, Terraform Providers, Kubernetes Helm Charts, Kubernetes Container Images, Pre-commit hooks updates, and more!
|
||||||
|
|
||||||
|
The base Renovate configuration provided in your repository can be view at [.github/renovate.json5](https://github.com/k8s-at-home/template-cluster-k3s/blob/main/.github/renovate.json5). If you notice this only runs on weekends and you can [change the schedule to anything you want](https://docs.renovatebot.com/presets-schedule/) or simply remove it.
|
||||||
|
|
||||||
|
To enable Renovate on your repository, click the 'Configure' button over at their [Github app page](https://github.com/apps/renovate) and choose your repository. Over time Renovate will create PRs for out-of-date dependencies it finds. Any merged PRs that are in the cluster directory Flux will deploy.
|
||||||
|
|
||||||
### 🪝 Github Webhook
|
### 🪝 Github Webhook
|
||||||
|
|
||||||
Flux is pull-based by design meaning it will periodically check your git repository for changes, using a webhook you can enable Flux to update your cluster on `git push`. In order to configure Github to send `push` events from your repository to the Flux webhook receiver you will need two things:
|
Flux is pull-based by design meaning it will periodically check your git repository for changes, using a webhook you can enable Flux to update your cluster on `git push`. In order to configure Github to send `push` events from your repository to the Flux webhook receiver you will need two things:
|
||||||
@@ -368,7 +376,19 @@ Flux is pull-based by design meaning it will periodically check your git reposit
|
|||||||
|
|
||||||
Now that you have the webhook url and secret, it's time to set everything up on the Github repository side. Navigate to the settings of your repository on Github, under "Settings/Webhooks" press the "Add webhook" button. Fill in the webhook url and your secret.
|
Now that you have the webhook url and secret, it's time to set everything up on the Github repository side. Navigate to the settings of your repository on Github, under "Settings/Webhooks" press the "Add webhook" button. Fill in the webhook url and your secret.
|
||||||
|
|
||||||
### 👉 Troubleshooting
|
### 💾 Storage
|
||||||
|
|
||||||
|
Rancher's `local-path-provisioner` is a great start for storage but soon you might find you need more features like replicated block storage, or to connect to a NFS/SMB/iSCSI server. Check out the projects below to read up more on some storage solutions that might work for you.
|
||||||
|
|
||||||
|
- [rook-ceph](https://github.com/rook/rook)
|
||||||
|
- [longhorn](https://github.com/longhorn/longhorn)
|
||||||
|
- [openebs](https://github.com/openebs/openebs)
|
||||||
|
- [nfs-subdir-external-provisioner](https://github.com/kubernetes-sigs/nfs-subdir-external-provisioner)
|
||||||
|
- [democratic-csi](https://github.com/democratic-csi/democratic-csi)
|
||||||
|
- [csi-driver-nfs](https://github.com/kubernetes-csi/csi-driver-nfs)
|
||||||
|
- [synology-csi](https://github.com/SynologyOpenSource/synology-csi)
|
||||||
|
|
||||||
|
## 👉 Troubleshooting
|
||||||
|
|
||||||
Our [wiki](https://github.com/k8s-at-home/template-cluster-k3s/wiki) (WIP, contributions welcome) is a good place to start troubleshooting issues. If that doesn't cover your issue, come join and say Hi in our [Discord](https://discord.gg/k8s-at-home) server by starting a new thread in the #kubernetes support channel.
|
Our [wiki](https://github.com/k8s-at-home/template-cluster-k3s/wiki) (WIP, contributions welcome) is a good place to start troubleshooting issues. If that doesn't cover your issue, come join and say Hi in our [Discord](https://discord.gg/k8s-at-home) server by starting a new thread in the #kubernetes support channel.
|
||||||
|
|
||||||
@@ -378,26 +398,8 @@ You may also open a issue on this GitHub repo or open a [discussion on GitHub](h
|
|||||||
|
|
||||||
The world is your cluster, see below for important things you could work on adding.
|
The world is your cluster, see below for important things you could work on adding.
|
||||||
|
|
||||||
### 🤖 Renovatebot
|
|
||||||
|
|
||||||
[Renovatebot](https://www.whitesourcesoftware.com/free-developer-tools/renovate/) will scan your repository and offer PRs when it finds dependencies out of date. Common dependencies it will discover and update are Flux, Ansible Galaxy Roles, Terraform Providers, Kubernetes Helm Charts, Kubernetes Container Images, Pre-commit hooks updates, and more!
|
|
||||||
|
|
||||||
The base Renovate configuration provided in your repository can be view at [.github/renovate.json5](https://github.com/k8s-at-home/template-cluster-k3s/blob/main/.github/renovate.json5). If you notice this only runs on weekends and you can [change the schedule to anything you want](https://docs.renovatebot.com/presets-schedule/) or simply remove it.
|
|
||||||
|
|
||||||
To enable Renovate on your repository, click the 'Configure' button over at their [Github app page](https://github.com/apps/renovate) and choose your repository. Over time Renovate will create PRs for out-of-date dependencies it finds. Any merged PRs that are in the cluster directory Flux will deploy.
|
|
||||||
|
|
||||||
Our Check out our [wiki](https://github.com/k8s-at-home/template-cluster-k3s/wiki) (WIP, contributions welcome) for more integrations!
|
Our Check out our [wiki](https://github.com/k8s-at-home/template-cluster-k3s/wiki) (WIP, contributions welcome) for more integrations!
|
||||||
|
|
||||||
### 💾 Storage
|
|
||||||
|
|
||||||
In no particular order, here are some popular storage related items you could install and use in your cluster:
|
|
||||||
|
|
||||||
- [rook-ceph](https://github.com/rook/rook)
|
|
||||||
- [nfs-subdir-external-provisioner](https://github.com/kubernetes-sigs/nfs-subdir-external-provisioner)
|
|
||||||
- [democratic-csi](https://github.com/democratic-csi/democratic-csi)
|
|
||||||
- [csi-driver-nfs](https://github.com/kubernetes-csi/csi-driver-nfs)
|
|
||||||
- [longhorn](https://github.com/longhorn/longhorn)
|
|
||||||
|
|
||||||
## 🤝 Thanks
|
## 🤝 Thanks
|
||||||
|
|
||||||
Big shout out to all the authors and contributors to the projects that we are using in this repository.
|
Big shout out to all the authors and contributors to the projects that we are using in this repository.
|
||||||
|
|||||||
Reference in new issue
Block a user