OCI ARM 서버 운영 가이드¶

sudo certbot renew --dry-run

sudo certbot certificates

server {
    server_name lab404.kro.kr;
    root /var/www/lab404.kro.kr;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }

    listen 443 ssl;
    ssl_certificate /etc/letsencrypt/live/lab404.kro.kr/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/lab404.kro.kr/privkey.pem;
    include /etc/letsencrypt/options-ssl-nginx.conf;
    ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem;
}

server {
    listen 80;
    server_name lab404.kro.kr;
    return 301 https://$host$request_uri;
}

location / {
    proxy_pass http://localhost:8080;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
}

sudo iptables -L INPUT -n --line-numbers

/home/ubuntu/docker/
├── proxy/                ← Nginx 리버스 프록시 (현재 호스트에서 운영)
├── database/
│   ├── compose.yaml      ← PostgreSQL 18
│   └── .env              ← DB 인증 정보
├── lab404/
│   └── compose.yaml      ← lab404 앱 (템플릿)
├── found404/
│   └── compose.yaml      ← found404 앱 (템플릿)
└── minecraft/            ← 마인크래프트 서버 (필요 시)

# 생성 (최초 1회)
docker network create shared

# 각 compose.yaml에서 참조
networks:
  shared:
    external: true

services:
  postgres:
    image: postgres:18
    container_name: postgres18
    restart: unless-stopped
    ports:
      - "5432:5432"
    env_file: .env
    volumes:
      - /home/ubuntu/postgres/postgres18:/var/lib/postgresql
    networks:
      - shared

networks:
  shared:
    external: true

/home/ubuntu/postgres/
├── postgres18/    ← 현재 사용 중
├── postgres19/    ← 나중에 업그레이드 시
└── postgres20/

# 시작
sudo docker compose -f /home/ubuntu/docker/database/compose.yaml up -d

# 중지
sudo docker compose -f /home/ubuntu/docker/database/compose.yaml down

# 로그 확인
sudo docker logs postgres18

# DB 접속
sudo docker exec -it postgres18 psql -U postgres

# 전체 dump (OCI → 파일)
docker exec postgres18 pg_dumpall -U postgres | gzip > backup.sql.gz

# restore (파일 → OCI)
gunzip -c backup.sql.gz | docker exec -i postgres18 psql -U postgres

매일 새벽 3시 (cron)
    │
    ▼
pg_dumpall + gzip 압축
    │
    ├─► OCI 로컬 보관 (7일)
    │   /home/ubuntu/db-backup/
    │
    └─► NAS 전송 (Tailscale + SCP, 7일)
        /volume1/docker/postgres/backup/

#!/bin/bash
# OCI PostgreSQL → NAS 자동 백업
# cron: 0 3 * * * /home/ubuntu/scripts/db-backup.sh

set -euo pipefail

BACKUP_DIR="/home/ubuntu/db-backup"
NAS_HOST="kindsnoopy@home-nas"
NAS_BACKUP_DIR="/volume1/docker/postgres/backup"
KEEP_DAYS=7
DATE=$(date +%Y%m%d_%H%M)
DUMP_FILE="${BACKUP_DIR}/full_${DATE}.sql.gz"

# 1. dump + 압축
docker exec postgres18 pg_dumpall -U postgres | gzip > "${DUMP_FILE}"

# 2. NAS로 전송 (Tailscale 경유, ubuntu 유저의 SSH 키 사용)
sudo -u ubuntu scp -O -i /home/ubuntu/.ssh/id_ed25519 \
  "${DUMP_FILE}" "${NAS_HOST}:${NAS_BACKUP_DIR}/" 2>/dev/null \
  || echo "[WARN] NAS 전송 실패 — 로컬 백업만 보관"

# 3. 오래된 로컬 백업 삭제
find "${BACKUP_DIR}" -name "full_*.sql.gz" -mtime +${KEEP_DAYS} -delete

# 4. NAS 오래된 백업 삭제
sudo -u ubuntu ssh -i /home/ubuntu/.ssh/id_ed25519 \
  "${NAS_HOST}" "find ${NAS_BACKUP_DIR} -name 'full_*.sql.gz' -mtime +${KEEP_DAYS} -delete" 2>/dev/null \
  || echo "[WARN] NAS 정리 실패"

echo "[OK] backup done: ${DUMP_FILE}"

# root crontab에 등록되어 있음
sudo crontab -l

# 내용
0 3 * * * /home/ubuntu/scripts/db-backup.sh >> /home/ubuntu/db-backup/cron.log 2>&1

# 수동 백업 실행
sudo bash /home/ubuntu/scripts/db-backup.sh

# 백업 목록 확인
ls -lh /home/ubuntu/db-backup/

# 복원 (특정 백업 파일)
gunzip -c /home/ubuntu/db-backup/full_20260411_1337.sql.gz \
  | sudo docker exec -i postgres18 psql -U postgres

# NAS 백업 확인
ssh kindsnoopy@home-nas "ls -lh /volume1/docker/postgres/backup/"

# cron 로그 확인
tail -20 /home/ubuntu/db-backup/cron.log

# 최근 백업 파일 확인
ls -lt /home/ubuntu/db-backup/ | head -5

# OCI → NAS
ssh kindsnoopy@home-nas

# SSH 키: /home/ubuntu/.ssh/id_ed25519 (코멘트: oci-arm-osaka)

services:
  mkdocs:
    build: ./build
    container_name: wiki404
    restart: unless-stopped
    ports:
      - "8000:8000"
    volumes:
      - /home/ubuntu/wiki404/mkdocs.yml:/docs/mkdocs.yml
      - /home/ubuntu/obsidian-vault/99_Publishing:/docs/docs
    command: ["serve", "--dev-addr=0.0.0.0:8000"]

FROM squidfunk/mkdocs-material

RUN pip install --no-cache-dir \
    click==8.2.1 \
    mkdocs-roamlinks-plugin \
    mkdocs-callouts \
    mkdocs-glightbox \
    mkdocs-minify-plugin \
    mkdocs-exclude \
    mkdocs-macros-plugin \
    pymdown-extensions

# 시작
sudo docker compose -f /home/ubuntu/docker/wiki404/compose.yaml up -d

# 재빌드 (Dockerfile 변경 시)
sudo docker compose -f /home/ubuntu/docker/wiki404/compose.yaml up -d --build

# 로그 확인
sudo docker logs --tail 10 wiki404

# 자동 반영 확인 — 이 메시지가 나와야 정상
# INFO - [HH:MM:SS] Watching paths for changes: 'docs', 'mkdocs.yml'