k8s-handle：简化Kubernetes部署的命令行工具

---

项目介绍

k8s-handle是一个基于Python和Jinja2模板引擎的命令行工具，专为简化Kubernetes资源的配置和部署而设计。它提供了一个友好的界面来管理Kubernetes资源配置，支持环境变量注入、模板化文件处理以及灵活的工作模式（如同步或异步部署），无需依赖复杂的包管理系统，如Helm。其核心优势在于，通过单一的配置文件(config.yaml)即可配置所有变量，且可以直接操作Kubernetes REST API进行资源的部署、更新和删除，使得CI/CD流程更加简便。

---

项目快速启动

环境准备

首先，确保你的系统中已经安装了Docker和具有访问Kubernetes集群的能力，比如通过kubeconfig文件。

步骤说明

1. 克隆项目：

   git clone https://github.com/2gis/k8s-handle.git
   

2. 运行示例： 在项目根目录下执行以下命令，该命令将把当前工作目录下的模板文件部署到Kubernetes。

   docker run --rm -v $(pwd):/tmp/ -v "$HOME/.kube:/root/.kube" 2gis/k8s-handle k8s-handle deploy -s staging --use-kubeconfig
   

   这里，-s staging指定部署到staging环境，--use-kubeconfig用来读取你的kubeconfig文件以连接到正确的集群。

部署确认

使用Kubernetes的命令行工具kubectl来验证资源是否成功部署：

kubectl get svc,cm,secrets,deploy -n <your_namespace>

替换<your_namespace>为你实际使用的命名空间。

---

应用案例与最佳实践

k8s-handle适用于多种场景，特别是对于需要根据不同环境（开发、测试、生产）调整配置的应用部署。最佳实践包括：

• 环境隔离：利用k8s-handle的环境特性，为不同环境维护独立的配置。
• 版本控制：将配置文件纳入Git版本控制，确保配置变更可追溯。
• 自动化部署：集成至CI/CD管道中，自动完成从代码提交到资源部署的全流程。

例如，在GitLab CI/CD中，可以通过定义job来自动化这一过程，实现从分支推送触发的环境部署更新。

---

典型生态项目结合

虽然k8s-handle本身是轻量级的部署工具，但它可以与广泛的Kubernetes生态系统中的其他工具协同工作，如：

• GitOps工具（如Flux CD、Argo CD）：k8s-handle可以作为部分配置管理的一部分，辅助GitOps策略实施。
• 服务网格（如Istio）：在部署应用时，可通过k8s-handle配置服务网格相关的资源，如虚拟服务和服务入口。
• 监控和日志：部署时集成Prometheus服务发现配置或Elasticsearch日志收集设置，确保应用监控与日志处理自动化。

结合这些生态工具，k8s-handle可以构成更全面的云原生应用生命周期管理方案。

---

请注意，实际使用时应详细阅读项目最新文档，因为API变化或新功能加入可能会要求不同的用法。