gitops-workflow

概览

什么是 gitops-workflow？

gitops-workflow 是一个实用技能，利用 ArgoCD 和 Flux 实现 GitOps 工作流，支持自动化、声明式的 Kubernetes 部署和持续调和。它专为希望通过基于 Git 的工作流管理 Kubernetes 基础设施和应用交付的团队和运维人员设计，遵循 OpenGitOps 原则。

谁适合使用此技能？

• 管理 Kubernetes 集群的平台工程师和 DevOps 团队
• 采用 GitOps 实现基础设施即代码的组织
• 希望自动化应用部署、管理多集群环境或执行声明式基础设施管理的任何人

解决的问题

• 实现从 Git 仓库直接自动化 Kubernetes 部署
• 确保集群状态与版本控制的期望状态保持一致
• 支持渐进式交付、多集群管理和密钥处理
• 减少人工干预和配置漂移

使用方法

安装步骤

1. 使用 Skills CLI 安装该技能：

   npx skills add https://github.com/wshobson/agents --skill gitops-workflow
   

2. 查阅 SKILL.md 中的主文档，获取高级指南。

3. 浏览辅助文件：

   • references/argocd-setup.md，详细介绍 ArgoCD 的安装和配置
   • references/sync-policies.md，介绍在 ArgoCD 和 Flux 中配置同步策略

配置 ArgoCD 或 Flux

• ArgoCD：
  • 创建 argocd 命名空间，并按照 references/argocd-setup.md 中说明应用官方清单。
  • 访问 ArgoCD UI，配置 Git 仓库以实现部署自动化。
• Flux：
  • 定义 Kustomization 和 GitRepository 资源，实现同步和部署间隔的自动化。

仓库结构与最佳实践

• 使用清晰的目录结构组织 GitOps 仓库，区分应用、环境和策略。
• 将所有 Kubernetes 清单和配置作为代码存储，利用 Git 进行版本控制和审计。
• 使用同步策略自动化调和，管理部署窗口和重试机制。
• 参考 references/sync-policies.md 文件，获取 YAML 示例和高级配置。

适配您的环境

• 根据集群拓扑、安全需求和部署流程，自定义提供的模板和策略。
• 根据需要与现有 CI/CD 流水线集成。

常见问题

gitops-workflow 实际自动化了什么？

gitops-workflow 通过 ArgoCD 或 Flux 同步集群状态与 Git 仓库，实现 Kubernetes 资源的部署和调和。它支持持续交付、回滚和漂移修正。

我可以同时使用 ArgoCD 和 Flux 吗？

可以。该技能提供了 ArgoCD 和 Flux 的指导和配置示例，您可以根据环境选择最合适的工具。

哪里可以找到安装说明？

ArgoCD 的详细安装步骤见 references/argocd-setup.md。ArgoCD 和 Flux 的同步策略示例见 references/sync-policies.md。

这个技能适合生产环境吗？

适合。gitops-workflow 设计用于生产环境，支持高可用、安全的密钥管理和高级同步策略。请务必根据组织的安全和运维标准审查并调整配置。

如何排查问题？

检查 ArgoCD 或 Flux 控制器的日志，查看各自 UI 中的同步状态，参考提供的文档获取排查建议。技能文件树中包含脚本和参考资料，帮助诊断常见问题。

哪里可以查看所有可用文件和脚本？

在 Agent Skills Finder 界面的 Files 标签中浏览完整文件树，包括嵌套的参考资料和辅助脚本。