You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

89 lines
2.9 KiB
Markdown

# Server Configuration
At the time of writing, I have one single VPS that I use to host my personal
projects. Initially, I started out with docker and having folders of compose
files. I quickly ran into issues re-deploying multiple services at once,
shoehorning traefik configuration into docker and various other tidbits here and
there.
So I decided to bite the bullet and dive into the fabled/dreaded
_**Kubernetes**_.
It's important to note that this is **mostly for learning**, a single node
cluster isn't very effective and honestly makes things a lot harder in a lot of
places compared to docker config. However, I'm fascinated at the fact that you
can interact with a single node cluster the same way you'd do with hundreds of
clusters, it's a pretty powerful abstraction!
Also, _technically_ I'm using [**k3s**](https://k3s.io/) for this single node
cluster.
## High-Level Architecture
![server-architecture](assets/server-architecture.png)
### Example Request
![gitea-example-request](assets/gitea-example.png)
## Useful Commands
1. Get the Bearer Token
```shell
kubectl -n <namespace> create token <user>
```
2. Load in Environment Variables via `.env` (Although, based on
[this stackoverflow post](https://stackoverflow.com/questions/51419102/is-it-possible-to-source-a-env-file-to-create-kubernetes-secrets),
there is some odd behaviour with the command)
```shell
kubectl create secret generic <secret-name> --from-env-file=.env
```
3. Perform PVC Storage Expansion
```shell
kubectl patch pvc <name> -p '{"spec":{"resources":{"requests":{"storage":"<amount>"}}}}'
```
4. Annotation to Allow Secret to be Managed by Sealed Secrets
```yaml
annotations:
sealedsecrets.bitnami.com/managed: "true"
```
## Tools Used
- [k3s](https://k3s.io/)
- [krew](https://krew.sigs.k8s.io/)
- [helm](https://helm.sh/)
- [sealed-secrets](https://sealed-secrets.netlify.app/)
## Liked Resources
- [Phippy goes to the zoo](https://www.youtube.com/watch?v=R9-SOzep73w&t=353s)
- https://blog.zachinachshon.com/k8s-dashboard/
- https://medium.com/codex/sealed-secrets-for-kubernetes-722d643eb658
- https://release.com/blog/kubernetes-secrets-management-a-practical-guide
- https://faun.pub/free-ha-multi-architecture-kubernetes-cluster-from-oracle-c66b8ce7cc37
## TODO
- [ ] Setup [keel.sh](https://keel.sh/) for automatically retrieving the latest
docker hub images and re-deploying my services.
- [ ] Experiment with a two-node cluster using Oracle's [Always Free](https://docs.oracle.com/en-us/iaas/Content/FreeTier/freetier_topic-Always_Free_Resources.htm) tier.
## Acknowledgement
Sincere thanks to one of my best friends
[winston](https://github.com/nekowinston) for helping me set up the cluster,
troubleshoot configurations and taking the time to walk me through concepts. I
really couldn't have done it this fast without him!
## License
[MIT](LICENSE)