Integrasi S3 Object Storage di Helipod: File Storage Cloud untuk Aplikasi

Server kamu:
├── public/
│   ├── uploads/
│   │   ├── user-123-avatar.jpg (2MB)
│   │   ├── user-456-photo.png (5MB)
│   │   └── document-789.pdf (10MB)
│   └── total: 50GB
└── Disk: 100GB (50% used)

Cloud Storage (S3/R2):
├── Buckets: helipod-uploads
├── Files: 100,000+ objects
├── Storage: 5TB
├── Bandwidth: Unlimited
└── Cost: $0.023/GB/bulan

S3_ENDPOINT=https://xxx.r2.cloudflarestorage.com
S3_BUCKET=helipod-uploads
S3_ACCESS_KEY=your-access-key
S3_SECRET_KEY=your-secret-key

┌─────────────────────────────────────────┐
│ Bucket: helipod-uploads                 │
├─────────────────────────────────────────┤
│ 📁 uploads/                             │
│   ├── 📁 users/                         │
│   │   ├── 🖼️ user-123-avatar.jpg (2MB) │
│   │   └── 🖼️ user-456-photo.png (5MB)  │
│   └── 📁 documents/                     │
│       └── 📄 contract-789.pdf (10MB)    │
│ 📁 backups/                             │
│   └── 📦 backup-2026-06-17.tar.gz       │
├─────────────────────────────────────────┤
│ Storage: 2.3GB / Unlimited              │
│ Files: 1,234                            │
└─────────────────────────────────────────┘

File: uploads/users/user-123-avatar.jpg

Public URL:
https://helipod-uploads.r2.dev/uploads/users/user-123-avatar.jpg

Signed URL (expiring):
https://helipod-uploads.r2.dev/uploads/users/user-123-avatar.jpg?X-Amz-...

import { S3Client, PutObjectCommand } from '@aws-sdk/client-s3';

const s3 = new S3Client({
  endpoint: process.env.S3_ENDPOINT,
  region: 'auto',
  credentials: {
    accessKeyId: process.env.S3_ACCESS_KEY,
    secretAccessKey: process.env.S3_SECRET_KEY,
  },
});

async function uploadAvatar(userId, file) {
  const key = `users/${userId}/avatar-${Date.now()}.jpg`;
  
  await s3.send(new PutObjectCommand({
    Bucket: process.env.S3_BUCKET,
    Key: key,
    Body: file.buffer,
    ContentType: file.mimetype,
  }));
  
  return `https://${process.env.S3_BUCKET}.r2.dev/${key}`;
}

async function uploadDocument(userId, document) {
  const key = `documents/${userId}/${document.name}`;
  
  await s3.send(new PutObjectCommand({
    Bucket: process.env.S3_BUCKET,
    Key: key,
    Body: document.buffer,
    ContentType: document.mimetype,
    Metadata: {
      'user-id': userId,
      'upload-date': new Date().toISOString(),
    },
  }));
  
  return { key, url: `https://${process.env.S3_BUCKET}.r2.dev/${key}` };
}

import { exec } from 'child_process';
import { promisify } from 'util';

const execAsync = promisify(exec);

async function backupDatabase() {
  // Dump database
  await execAsync('pg_dump mydb > backup.sql');
  
  // Upload ke S3
  const key = `backups/db-${Date.now()}.sql`;
  const backup = fs.readFileSync('backup.sql');
  
  await s3.send(new PutObjectCommand({
    Bucket: process.env.S3_BUCKET,
    Key: key,
    Body: backup,
  }));
  
  console.log(`Backup uploaded: ${key}`);
}

// Serve static assets dari S3
const assets = {
  logo: 'https://helipod-uploads.r2.dev/assets/logo.png',
  favicon: 'https://helipod-uploads.r2.dev/assets/favicon.ico',
  css: 'https://helipod-uploads.r2.dev/assets/styles.css',
};

bucket/
├── users/
│   └── {user-id}/
│       ├── avatar.jpg
│       └── profile/
├── documents/
│   └── {user-id}/
│       └── {document-id}.pdf
├── uploads/
│   └── {date}/
│       └── {filename}
└── backups/
    └── {date}/
        └── backup.tar.gz

// Set content-type untuk setiap file
const contentTypes = {
  '.jpg': 'image/jpeg',
  '.png': 'image/png',
  '.pdf': 'application/pdf',
  '.mp4': 'video/mp4',
};

await s3.send(new PutObjectCommand({
  Bucket: process.env.S3_BUCKET,
  Key: key,
  Body: file.buffer,
  ContentType: contentTypes[ext] || 'application/octet-stream',
}));

// Cloudflare R2 sudah include CDN
// URL langsung cepat dari edge locations
const fileUrl = `https://${bucket}.r2.dev/${key}`;

Di Cloudflare R2:
- Files di /temp/ → Auto-delete setelah 7 hari
- Files di /backups/ → Keep selamanya
- Files di /uploads/ → Keep selamanya

# Migrasi dari S3 ke R2
rclone sync s3:old-bucket s3:new-bucket \
  --s3-endpoint=https://xxx.r2.cloudflarestorage.com