Remove README

This commit is contained in:
2025-11-19 12:52:53 +00:00
parent a0579fcdc8
commit 03b64e2f7e

View File

@@ -1,177 +0,0 @@
# Scaleway Deployment - Quick Start
This branch contains everything needed to deploy your Hugo Notebook to Scaleway at `notebook.arnodo.fr`.
## 📁 Files Added
- `.gitea/workflows/deploy.yml` - Gitea Actions workflow for Object Storage deployment
- `docs/SCALEWAY_DEPLOYMENT.md` - Complete Object Storage setup guide
- `docs/SCALEWAY_DEPLOYMENT_DOCKER.md` - Docker instance deployment guide
- `docs/DEPLOYMENT_COMPARISON.md` - Comparison of all deployment options
- `scripts/setup-scaleway.sh` - Automated Scaleway setup script
## 🚀 Quick Start (Recommended: Object Storage)
### 1. Install Scaleway CLI
```bash
# macOS
brew install scw
# Linux
curl -o /usr/local/bin/scw -L "https://github.com/scaleway/scaleway-cli/releases/latest/download/scaleway-cli_$(uname -s)_$(uname -m)"
chmod +x /usr/local/bin/scw
# Configure
scw init
```
### 2. Run Setup Script
```bash
chmod +x scripts/setup-scaleway.sh
./scripts/setup-scaleway.sh
```
This will:
- Create Object Storage bucket `notebook-arnodo-fr`
- Configure static website hosting
- Apply public read policy
### 3. Get API Keys
```bash
# In Scaleway console: IAM → API Keys → Generate
# Or via CLI:
scw iam api-key create description="Gitea Deployment"
```
Save:
- Access Key ID
- Secret Access Key
### 4. Add Gitea Secrets
Go to: `https://gitea.arnodo.fr/Damien/Notebook/settings/secrets`
Add:
- `SCW_ACCESS_KEY`: Your access key
- `SCW_SECRET_KEY`: Your secret key
- `SCW_BUCKET_NAME`: `notebook-arnodo-fr`
### 5. Configure DNS
Add CNAME record:
```
notebook.arnodo.fr CNAME notebook-arnodo-fr.s3-website.fr-par.scw.cloud.
```
### 6. Deploy!
Merge this branch to `main`, or push any change to `main`:
```bash
git checkout main
git merge scaleway-deployment
git push
```
Gitea Actions will automatically:
1. Build Hugo site
2. Upload to Scaleway Object Storage
3. Your site will be live at `https://notebook.arnodo.fr`
## 💰 Cost
**Object Storage**: ~€1-2/month
- Storage: €0.01/GB/month
- Traffic: First 75 GB free
- Very low cost for blogs
**Docker Instance**: ~€10/month (if you need more control)
## 📊 Deployment Methods Comparison
| Feature | Object Storage | Docker Instance |
|---------|---------------|-----------------|
| Cost | €1-2/month | €10/month |
| Maintenance | None | Regular updates |
| SSL | Via CDN | Let's Encrypt |
| Control | Limited | Full |
| Setup Time | 30 min | 1-2 hours |
See `docs/DEPLOYMENT_COMPARISON.md` for full analysis.
## 🔍 Testing Before DNS Switch
Test your deployment:
```bash
# After deployment, check:
curl -I http://notebook-arnodo-fr.s3-website.fr-par.scw.cloud
# Test specific page:
curl http://notebook-arnodo-fr.s3-website.fr-par.scw.cloud/posts/your-post/
```
## 🔄 Migration Strategy
1. **Parallel run**: Keep GitHub Pages active
2. **Test thoroughly**: Verify Scaleway deployment works
3. **Switch DNS**: Point to Scaleway
4. **Monitor**: Watch for 30 days
5. **Decommission**: Remove GitHub Pages when confident
## 📚 Documentation
- **Object Storage Setup**: `docs/SCALEWAY_DEPLOYMENT.md`
- **Docker Instance Setup**: `docs/SCALEWAY_DEPLOYMENT_DOCKER.md`
- **Comparison Guide**: `docs/DEPLOYMENT_COMPARISON.md`
## 🆘 Troubleshooting
### Build fails
- Check Hugo version in workflow
- Verify theme submodules
- Check Gitea Actions logs
### Files not accessible
- Verify bucket policy allows public read
- Check bucket website configuration
- Ensure files were uploaded (check workflow logs)
### DNS not working
- Wait for DNS propagation (up to 48 hours, usually < 1 hour)
- Verify CNAME with: `dig notebook.arnodo.fr`
- Check TTL settings
## 🔗 Useful Links
- Scaleway Console: https://console.scaleway.com
- Scaleway Docs: https://www.scaleway.com/en/docs/storage/object/
- Gitea Actions Logs: https://gitea.arnodo.fr/Damien/Notebook/actions
## ✅ Checklist
Before merging:
- [ ] Scaleway account created
- [ ] Object Storage bucket created
- [ ] API keys generated
- [ ] Gitea secrets configured
- [ ] DNS CNAME record added
- [ ] Tested workflow locally (optional)
After merging:
- [ ] Verify Gitea Actions run successfully
- [ ] Test site at bucket URL
- [ ] Verify custom domain works
- [ ] Check all pages load correctly
- [ ] Monitor costs in Scaleway console
## 🎯 Recommended Next Steps
1. ✅ Merge this PR
2. ⬜ Monitor first deployment
3. ⬜ Test all site functionality
4. ⬜ Set up Scaleway monitoring/alerts
5. ⬜ Consider adding CDN (if high traffic)
6. ⬜ Document any custom workflows
---
**Questions?** Check the detailed guides in the `docs/` directory or reach out for help!