k3s_auto_deploy/QUICK-REFERENCE.md

K3s集群部署快速参考

一键部署

# 完整部署流程
cd /home/fei/opk3s/k3s自动化部署
git clone https://github.com/k3s-io/k3s-ansible.git  # 首次需要
chmod +x scripts/*.sh scripts/*.py
./scripts/deploy-all.sh

常用命令

部署相关

# 一键部署所有组件
./scripts/deploy-all.sh

# 重置状态从头开始
./scripts/deploy-all.sh --reset

# 验证部署状态
./scripts/verify-deployment.sh

# 测试幂等性
./scripts/test-idempotency.sh

分步部署

./scripts/deploy.sh              # 部署K3s集群
./scripts/deploy-gitea.sh        # 部署Gitea
./scripts/setup-gitea.sh         # 初始化Gitea
./scripts/deploy-argocd.sh       # 部署ArgoCD
./scripts/deploy-https.sh        # 配置HTTPS
./scripts/create-argocd-app.sh   # 创建ArgoCD应用
./scripts/push-demo-app.sh       # 推送示例应用

访问地址

获取访问信息

# Gitea
GITEA_PORT=$(kubectl get svc gitea-http -n gitea -o jsonpath='{.spec.ports[0].nodePort}')
echo "Gitea: http://8.216.38.248:$GITEA_PORT"

# ArgoCD
ARGOCD_PORT=$(kubectl get svc argocd-server -n argocd -o jsonpath='{.spec.ports[0].nodePort}')
echo "ArgoCD: https://8.216.38.248:$ARGOCD_PORT"

幂等性特性

所有脚本支持重复执行：

• ✅ 自动跳过已完成步骤
• ✅ 不会破坏现有配置
• ✅ 失败后可断点续传

文档索引

• README.md - 完整使用文档
• IDEMPOTENCY-TEST.md - 幂等性测试指南
• IMPLEMENTATION-SUMMARY.md - 实施总结
• QUICK-REFERENCE.md - 本文档

---

提示: 所有脚本都支持幂等性，可以安全地重复执行！