# Kubernetes 知识库

欢迎来到 Kubernetes 知识库！本仓库专注于 DevOps、云原生、AI Infra、GitOps 和自动化运维相关知识的整理与分享。

## 📚 目录

- [项目简介](#项目简介)
- [知识体系](#知识体系)
- [快速开始](#快速开始)
- [贡献指南](#贡献指南)
- [资源链接](#资源链接)

## 🎯 项目简介

本仓库旨在构建一个系统化的 Kubernetes 和云原生技术知识库，涵盖从基础概念到高级实践的完整知识体系。我们相信知识的积累和分享是推动技术进步的重要力量。

### 核心价值

- **系统性**：知识结构清晰，从基础到进阶循序渐进
- **实用性**：提供可直接使用的配置和脚本
- **前瞻性**：涵盖最新的云原生和 AI Infra 技术趋势
- **开放性**：欢迎社区贡献和反馈

## 🧠 知识体系

### 1. DevOps

DevOps 是一种重视"软件开发人员（Dev）"和"IT运维技术人员（Ops）"之间沟通合作的文化、运动或惯例。

#### 核心概念

- **CI/CD**：持续集成与持续部署
- **自动化**：基础设施即代码、自动化测试
- **监控与日志**：全链路可观测性
- **协作文化**：开发与运维的协同工作

#### 实践工具

- **Jenkins**：经典的 CI/CD 工具
  - [Jenkins Kubernetes 部署文档](./CICD/Jenkins/README.md)
- **GitLab CI**：集成化的 DevOps 平台
  - [GitLab Kubernetes 部署文档](./CICD/Gitlab/README.md)
- **Drone**：轻量级 CI/CD 平台
  - [Drone 配置与使用](./CICD/Drone/README.md)

### 2. 云原生

云原生技术有利于各组织在公有云、私有云和混合云等新型动态环境中，构建和运行可弹性扩展的应用。

#### 核心技术

- **容器化**：Docker、containerd
- **编排**：Kubernetes、Docker Swarm
- **服务网格**：Istio、Linkerd
- **声明式 API**：CRD、Operator 模式

#### 最佳实践

- **微服务架构**：服务拆分与通信
- **不可变基础设施**：镜像构建与部署
- **自愈能力**：健康检查、自动重启
- **弹性伸缩**：HPA、VPA

### 3. AI Infra

AI 基础设施是为人工智能和机器学习工作负载提供支持的技术栈和架构。

#### 核心组件

- **计算资源**：GPU 集群、TPU、异构计算
- **存储系统**：分布式存储、对象存储
- **网络架构**：RDMA、高速互联
- **调度平台**：Kubeflow、Ray、Volcano

#### 应用场景

- **模型训练**：分布式训练、超参数调优
- **模型服务**：模型推理、在线预测
- **数据处理**：数据预处理、特征工程
- **实验管理**：MLflow、实验追踪

### 4. GitOps

GitOps 是一种用于云原生应用程序和基础设施的操作模型。

#### 核心原则

- **声明式**：整个系统都是声明式定义的
- **版本化**：所有配置都存储在 Git 中
- **自动化**：自动应用 Git 中的配置变更
- **持续协调**：系统持续监控和同步状态

#### 实现工具

- **ArgoCD**：Kubernetes 原生的持续交付工具
- **Flux**：GitOps 工具包的先行者
- **Rancher Fleet**：企业级 GitOps 解决方案
- **Jenkins X**：基于 Jenkins 的云原生 CI/CD

#### 最佳实践

- **单一事实来源**：Git 作为配置的唯一来源
- **分支策略**：Git Flow、GitHub Flow
- **审批流程**：Pull Request、代码审查
- **回滚机制**：快速恢复到之前的状态

### 5. 自动化运维

自动化运维通过脚本和工具实现系统运维的自动化，提高效率和可靠性。

#### 核心领域

- **配置管理**：Ansible、Puppet、Chef
  - [Ansible 配置管理文档](./CICD/Ansible/README.md)
- **容器编排**：Kubernetes、Docker Swarm
- **监控告警**：Prometheus、Grafana、AlertManager
- **日志分析**：ELK Stack、Loki
- **自动扩缩容**：HPA、Cluster Autoscaler

#### 实践方法

- **基础设施即代码 (IaC)**：Terraform、Pulumi
- **混沌工程**：故障注入、韧性测试
- **安全合规**：自动化扫描、合规检查
- **成本优化**：资源利用率分析、自动调优

## 🚀 快速开始

### 环境准备

```bash
# 克隆仓库
git clone https://gitea.offends.cn/Offends/Kubernetes.git
cd Kubernetes
```

### CI/CD 工具部署

#### Jenkins 部署

参考 [Jenkins Kubernetes 部署文档](./CICD/Jenkins/README.md)

```bash
# 创建数据目录
mkdir -p /data/jenkins

# 应用部署配置
kubectl apply -f jenkins-deployment.yaml

# 获取初始密码
kubectl exec -it $(kubectl get pod -l app=jenkins -o jsonpath='{.items[0].metadata.name}') -- cat /var/jenkins_home/secrets/initialAdminPassword
```

#### GitLab 部署

参考 [GitLab Kubernetes 部署文档](./CICD/Gitlab/README.md)

```bash
# 创建数据目录
mkdir -p /data/gitlab

# 修改配置文件中的 IP 地址
# 应用部署配置
kubectl apply -f gitlab-deployment.yaml

# 获取初始密码
kubectl exec -it $(kubectl get pod -l app=gitlab -o jsonpath='{.items[0].metadata.name}') -- grep 'Password:' /etc/gitlab/initial_root_password
```

### GitHub Actions 配置

参考 [GitHub Actions 工作流](./CICD/Github/README.md)

## 📖 学习路径

### 初级阶段

1. **基础概念**
   - 理解 DevOps 核心理念
   - 学习容器化技术 (Docker)
   - 掌握 Kubernetes 基础操作

2. **实践工具**
   - 部署 Jenkins 或 GitLab
   - 实现基本的 CI/CD 流程
   - 编写简单的自动化脚本

### 中级阶段

1. **进阶技术**
   - 深入 Kubernetes 架构
   - 学习服务网格
   - 掌握监控和日志系统

2. **最佳实践**
   - 实施基础设施即代码
   - 建立 GitOps 工作流
   - 优化系统性能和成本

### 高级阶段

1. **专业领域**
   - AI Infra 架构设计
   - 大规模集群管理
   - 多云和混合云部署

2. **创新实践**
   - 混沌工程实施
   - FinOps 成本优化
   - 可观测性体系建设

## 🤝 贡献指南

我们欢迎所有形式的贡献！

### 如何贡献

1. **提交 Issue**：报告问题或提出建议
2. **提交 PR**：改进文档或添加新内容
3. **分享经验**：撰写技术文章或案例研究
4. **代码贡献**：修复 bug 或添加新功能

### 贡献流程

```bash
# 1. Fork 本仓库
# 2. 创建特性分支
git checkout -b feature/your-feature

# 3. 提交更改
git commit -m 'Add some feature'

# 4. 推送到分支
git push origin feature/your-feature

# 5. 提交 Pull Request
```

### 代码规范

- 遵循现有代码风格
- 添加必要的文档和注释
- 确保所有测试通过
- 更新相关文档

## 📚 资源链接

### 官方文档

- [Kubernetes 官方文档](https://kubernetes.io/docs/)
- [Docker 官方文档](https://docs.docker.com/)
- [Jenkins 官方文档](https://www.jenkins.io/doc/)
- [GitLab 官方文档](https://docs.gitlab.com/)

### 社区资源

- [CNCF 云原生全景图](https://landscape.cncf.io/)
- [Kubernetes 博客](https://kubernetes.io/blog/)
- [DevOps 路线图](https://roadmap.sh/devops)

### 推荐书籍

- 《Kubernetes 权威指南》
- 《云原生应用架构实践》
- 《DevOps 实践指南》
- 《GitOps 实战》

### 在线课程

- Kubernetes 官方认证培训
- Cloud Native Computing Foundation (CNCF) 培训
- 云原生实践工作坊

## 📊 项目统计

![Stars](https://img.shields.io/github/stars/Offends/Kubernetes?style=social)
![Forks](https://img.shields.io/github/forks/Offends/Kubernetes?style=social)
![Issues](https://img.shields.io/github/issues/Offends/Kubernetes)
![License](https://img.shields.io/github/license/Offends/Kubernetes)

## 📝 更新日志

### v1.0.0 (2026-01-09)

- ✨ 添加 Jenkins Kubernetes 部署文档
- ✨ 添加 GitLab Kubernetes 部署文档
- ✨ 初始化知识库结构
- ✨ 添加 CI/CD 工具配置
- 📝 编写项目 README 文档

## 📄 许可证

本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件

## 💬 联系方式

- 📧 Email: [your-email@example.com](mailto:your-email@example.com)
- 🐙 GitHub: [@Offends](https://github.com/Offends)
- 💬 微信群: [加入讨论群](#)

## 🙏 致谢

感谢所有为本项目做出贡献的开发者和使用者！

特别感谢以下开源项目：

- Kubernetes 社区
- Docker 社区
- Jenkins 社区
- GitLab 社区
- 所有云原生技术的贡献者

---

**⭐ 如果这个项目对你有帮助，请给一个 Star！**

让我们一起构建更好的云原生技术生态！ 🚀