97 lines
2.2 KiB
Markdown
97 lines
2.2 KiB
Markdown
# MinIO Object Storage
|
|
|
|
S3-compatible object storage for b28.dev infrastructure.
|
|
|
|
## Purpose
|
|
|
|
- **Backups**: PostgreSQL dumps, Docker volume snapshots
|
|
- **Media Storage**: Directus file uploads (portfolio + demos)
|
|
- **Demo Artifacts**: Cached API responses, datasets
|
|
|
|
## Deployment
|
|
|
|
**URL**: https://objects.b28.dev
|
|
|
|
**Ports**:
|
|
- 9000: S3 API (programmatic access)
|
|
- 9001: Web Console (admin UI)
|
|
|
|
## Configuration
|
|
|
|
### Environment Variables
|
|
|
|
Copy `.env.example` to `.env` and configure:
|
|
|
|
```bash
|
|
MINIO_ROOT_USER=your-admin-username
|
|
MINIO_ROOT_PASSWORD=your-strong-password
|
|
```
|
|
|
|
### Credentials
|
|
|
|
The same credentials are used for:
|
|
- S3 API access (boto3, MinIO client, etc.)
|
|
- Web console login at https://objects.b28.dev
|
|
|
|
## Deployment on Coolify
|
|
|
|
1. Push this directory to Gitea
|
|
2. In Coolify, create new resource → Git Repository
|
|
3. Point to this repo/directory
|
|
4. Set environment variables
|
|
5. Deploy
|
|
|
|
## Initial Setup
|
|
|
|
After deployment:
|
|
|
|
1. Login to https://objects.b28.dev
|
|
2. Create buckets:
|
|
- `backups` (private)
|
|
- `directus-uploads` (public-read)
|
|
- `demo-artifacts` (private)
|
|
|
|
3. Create service accounts:
|
|
- Directus: read/write to `directus-uploads`
|
|
- Backup scripts: write-only to `backups`
|
|
|
|
## Bucket Structure
|
|
|
|
```
|
|
minio/
|
|
├── backups/
|
|
│ ├── postgres/ # Daily PostgreSQL dumps
|
|
│ ├── volumes/ # Docker volume snapshots
|
|
│ └── configs/ # Infrastructure configs
|
|
├── directus-uploads/ # Directus file storage
|
|
│ ├── portfolio/ # Portfolio media
|
|
│ └── events/ # Events demo media
|
|
└── demo-artifacts/ # Demo-specific data
|
|
└── events-demo/
|
|
├── luma-cache/ # Cached Lu.ma responses
|
|
└── ai-analysis/ # Cached AI analyses
|
|
```
|
|
|
|
## Access via MinIO Client
|
|
|
|
```bash
|
|
# Configure alias
|
|
mc alias set homelab https://objects.b28.dev <access-key> <secret-key>
|
|
|
|
# List buckets
|
|
mc ls homelab
|
|
|
|
# Upload file
|
|
mc cp backup.sql homelab/backups/postgres/
|
|
|
|
# Download file
|
|
mc cp homelab/backups/postgres/backup.sql ./
|
|
```
|
|
|
|
## Backup Strategy
|
|
|
|
See `/scripts/backup-to-minio.sh` for automated backup implementation.
|
|
|
|
**Frequency**: Daily at 2:00 AM UTC
|
|
**Retention**: 7 daily, 4 weekly, 3 monthly
|