# K3s集群部署快速参考

## 一键部署

```bash
# 完整部署流程
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
```

## 常用命令

### 部署相关

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

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

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

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

### 分步部署

```bash
./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       # 推送示例应用
```

## 访问地址

### 获取访问信息

```bash
# 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` - 本文档

---

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