Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/wenerme/kube-stub-cluster
Stub for Kubernetes Cluster Deployment by using ArgoCD/Helm/Kustomize
https://github.com/wenerme/kube-stub-cluster
Last synced: 4 days ago
JSON representation
Stub for Kubernetes Cluster Deployment by using ArgoCD/Helm/Kustomize
- Host: GitHub
- URL: https://github.com/wenerme/kube-stub-cluster
- Owner: wenerme
- License: mit
- Created: 2021-03-06T07:50:43.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-01-22T06:40:00.000Z (10 months ago)
- Last Synced: 2024-08-02T22:25:07.876Z (3 months ago)
- Language: Smarty
- Size: 421 KB
- Stars: 16
- Watchers: 4
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Kubernetes 集群部署模板
方便学习参考和粘贴复制的集群部署模板。
## Why
* 尽量的复用部署过的项目校验
* 尽量的复用写过的 charts 和 values
* 快速开始使用
## 特点
* 使用国内容器镜像 - 部署快稳定
* 镜像来源于 - [wenerme/container-mirror](https://github.com/wenerme/container-mirror)
* 预先拉好的镜像而不是按需拉
* 使用国内 Charts - 方便使用,稳定,快
* Charts 来源 - [wenerme/charts](https://github.com/wenerme/charts)
* 收集了所需应用的官方 chart 并通过国内 CDN 提供
* ArgoCD 驱动部署
* 应用通过 helm + kustomize 部署
> 部分 docker.io 镜像尚未映射
## 如何修改为自行使用
* 粘贴复制 stub-cluster 为 `<你的名字>-cluster`
* 项目内搜索 example.com 修改为你的域名
* 项目内搜索 stub - 按需修改
## 部署步骤
1. /argocd
* 首先部署 argocd - 其他内容通过 ArgoCD 来部署
* `make apply`
2. /stub-cluster/stub-cluster
* 配置 git 仓库
* 部署 argocd 的 stub-cluster 应用 - 部署 stub-cluster
3. 其他内容将按照 stub-cluster 定义的进行部署
## 部署技巧
* 大部分应用下包含 Makefile
* 包含升级、验证 等 - 可直接在命令行或者 IDE 操作
```bash
# 代理集群网络 - 假设集群是 10.10
sshuttle -r kube-m1 10.10.0.0/16
# 转发 argocd 到本地观察状态
kubectl -n argocd port-forward svc/argocd-server 8443:https
# ArgoCD
# 账号 admin
# 密码
kubectl get pods -n argocd -l app.kubernetes.io/name=argocd-server -o name | cut -d'/' -f 2 | pbcopy
# 部署时观察集群状态
kubectl get events -w --all-namespaces
```
## Explain
> **Note**
>
> 1. Prefer **not** use helm to deploy - hard to maintain & track
> 2. Prefer **hostPath** to deploy PoC - use PVC for cluster or keep use hostPath for simple case
**Bootstrap**
```bash
cd argocd
make nodes # config works
make ns apply
cd -
cd cluster-manifest
# edit repo-ops.secret.yaml update git repo auth info
kubectl apply -f repo-ops.secret.yaml
# edit bootstrap.yaml update git repo
kubectl apply -f bootstrap.yaml
# edit pathes/app-main-repo.yaml update git repo
# edit pathes/cluster-issuer-acme-email.yaml update email
# modify kustomization.yaml as needed
```
```bash
# generate key for argocd
ssh-keygen -t ed25519 -C "$(basename $PWD)" -f argocd -q -N ""
```
**Structure**
- /argocd
- /cluster-manifest
- bootstrap.yaml - ArgoCD Application for cluster-manifest
- cluster/ - cluster wide resources
- res/ - predefined resources
- ns/ - namespace
- services/
- patches/
- /charts - local charts to help deploy
- /dockerfiles - dockerfiles to build adhoc images
- /data-system
- appwrite
- supabase
- postgres
- redis
- /dev-system
- nacos
- clash
- docker
- dind
- docker registry
- woodpecker
- coding-worker
**hostPath**
- `/data/ns///`
- `/data/ns/data-system/postgres/data`
- `/data/ns////`
- `/data/ns/data-system/supabase/imgproxy/storage`
**namespace**
- `*-system` - for others as base
- `monitoring` - for this cluster
- `monitoring-system` - for monitoring as a service - e.g. multi cluster metrics storage
- monitoring - e.g. prometheus, node_exporter
- monitoring-system - observability system - e.g. zincobserve, vector, grafana
- dev-system - CI/CD - e.g. dind, runner
- data-system - Database, FileStorage - e.g. minio, PostgreSQL
## Version Watch
- 
- 
- 
- 
- 
## Requirement
- kubernetes 1.22
- 要求 ingress v1
- 要求 cert-manager 1.5
- 要求 nginx-ingress 1.0
## Note
- 升级 ingres-nginx 需要同步 ingress-nginx/kube-webhook-certgen 版本