81 lines
1.5 KiB
Markdown
81 lines
1.5 KiB
Markdown
|
# Quick Start — One-Time CI/CD Setup (3 minutes)
|
||
|
|
|
||
|
|
## 🚀 Setup
|
||
|
|
|
||
|
|
### 1. Get Registry Token
|
||
|
|
```bash
|
||
|
|
# Ask for the 'rock' org token (already has write:package)
|
||
|
|
# OR create one: https://git.riotpiao.com/user/settings/tokens
|
||
|
|
# - Scope: write:package
|
||
|
|
# - Copy the token value
|
||
|
|
```
|
||
|
|
|
||
|
|
### 2. Add Secret to Repository
|
||
|
|
```bash
|
||
|
|
# Go to: https://git.riotpiao.com/rock/poimen-memory/settings/secrets
|
||
|
|
# Add: Name=REGISTRY_PAT, Value=<token>
|
||
|
|
# Save
|
||
|
|
```
|
||
|
|
|
||
|
|
### 3. Push to Trigger Build
|
||
|
|
```bash
|
||
|
|
cd ~/workplace/Poimen/memory
|
||
|
|
git commit --allow-empty -m "Trigger CI"
|
||
|
|
git push
|
||
|
|
```
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## ✨ That's It!
|
||
|
|
|
||
|
|
After these 3 steps, every push automatically:
|
||
|
|
- ✅ Runs all tests
|
||
|
|
- ✅ Builds Docker image
|
||
|
|
- ✅ Pushes to `forgejo.riotpiao.com/rock/poimen-memory:latest`
|
||
|
|
- ✅ ArgoCD deploys to K8s
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 📊 Monitor
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# Watch build
|
||
|
|
https://git.riotpiao.com/rock/poimen-memory/actions
|
||
|
|
|
||
|
|
# Watch deployment
|
||
|
|
kubectl get pods -n poimen -l app.kubernetes.io/name=poimen-memory -w
|
||
|
|
```
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 🧪 Test When Ready
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# Port forward
|
||
|
|
kubectl port-forward -n poimen svc/poimen-memory 8080:80 &
|
||
|
|
|
||
|
|
# Health check
|
||
|
|
curl http://localhost:8080/health
|
||
|
|
```
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 🔄 Apply to Other Repos
|
||
|
|
|
||
|
|
Same pattern for `poimen`, `poimen-workflows`, etc:
|
||
|
|
|
||
|
|
1. Add `REGISTRY_PAT` secret
|
||
|
|
2. Copy `.forgejo/workflows/build.yaml` from this repo
|
||
|
|
3. Push
|
||
|
|
|
||
|
|
See `CI-SETUP.md` for details.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Pattern Details
|
||
|
|
|
||
|
|
- **Based on**: homelab-frontend (proven pattern)
|
||
|
|
- **Runner**: docker:27-cli (supports buildx)
|
||
|
|
- **Tags**: commit SHA + "latest"
|
||
|
|
- **No manual steps**: Fully automated
|