Veeam Backup 플러그인 개발

[jeongda-young]

Veeam Custom Backup Plug-in

Veeam Backup & Replication과 Mold 환경을 연동하기 위한 Custom Backup Plug-in 구조를 설계 및 구현한다.
본 Plug-in은 Veeam의 Script Hook 기능과 REST API를 활용하여 Mold 백업 정책과 Veeam Backup Job을 연결하는 역할을 한다.
초기 구현은 Script 기반 Plug-in 방식을 사용하고, 이후 필요 시 REST API 기반 백업 제어 기능으로 확장할 수 있도록 설계한다.

개발목적

• Mold 가상머신 백업 정책과 Veeam Backup Job 연동
• Veeam Script Hook 기반 Custom Backup Plug-in 구현
• Mold Backup Catalog와 Veeam Backup 정보 동기화
• 향후 REST API 기반 Backup / Restore 제어 구조 확장

개발 범위

Backup Integration

• Mold Backup Offering ↔ Veeam Job 매핑
• Script 기반 Backup Hook 실행
• Backup Job 실행 시 Mold API 연동

Backup Metadata Sync

• Veeam Backup Session 조회
• Mold Backup Catalog 동기화

Script 기반 Backup Plug-in

• Pre-freeze Script
• Post-thaw Script
• Job Script

아키텍처

Mold
 └─ Backup Trigger
     └─ Veeam Backup Job
         ├─ Pre-freeze Script
         │   └─ Mold API 호출
         ├─ Backup 수행
         └─ Post-thaw Script
             └─ Cleanup / 로그 기록

Script 기반 Plug-in 흐름

1. Veeam Backup Job 실행

2. Pre-freeze Script 실행
   - Mold API 호출
   - 백업 대상 VM 조회
   - snapshot 준비

3. Veeam Backup 수행

4. Post-thaw Script 실행
   - 백업 staging 파일 삭제
   - cleanup 수행

Pre-freeze Script

• 백업 시작 전에 실행되는 Script

역할

• Mold API 호출
• 백업 대상 VM 조회
• snapshot 또는 staging 준비

#!/bin/sh

LOG="/var/log/veeam-pre-freeze.log"

echo "$(date '+%F %T') START pre-freeze" >> "$LOG"

/usr/local/bin/mold-pre-backup.sh >> "$LOG" 2>&1
RC=$?

echo "$(date '+%F %T') END pre-freeze rc=$RC" >> "$LOG"

exit $RC

Post-thaw Script

• 백업 완료 후 실행되는 Script

역할

• staging 파일 삭제
• cleanup 수행
• 로그 기록

#!/bin/sh

LOG="/var/log/veeam-post-thaw.log"

echo "$(date '+%F %T') START post-thaw" >> "$LOG"

/usr/local/bin/mold-post-backup.sh >> "$LOG" 2>&1
RC=$?

echo "$(date '+%F %T') END post-thaw rc=$RC" >> "$LOG"

exit $RC

Backup Catalog 동기화

• Mold에서는 Veeam 백업 정보를 동기화하기 위한 Sync Scheduler가 필요하다.

Sync Scheduler 실행

→ Veeam Backup Session 조회
→ Backup 목록 확인
→ Mold Backup Catalog 업데이트
→ 삭제된 Backup 정리

[jeongda-young]

Veeam 기반 Custom Plug-in 설계 정리 (Mold 연계)

---

1. Script 기반 Custom Plug-in 방식

Veeam은 VM 또는 Agent 백업 시 스냅샷 생성 전후에 pre-freeze / post-thaw script를 실행할 수 있다.

이 스크립트는 다음 목적에 사용된다.

• 애플리케이션 정합성 확보
• 외부 시스템 연동
• 백업 전후 준비 및 정리 작업

실행 로직

Backup job 시작
└─ Pre-freeze script
   백업 직전 준비 작업
   예: DB freeze, Mold API 호출, snapshot 준비

└─ VM snapshot 생성 및 백업 수행

└─ Post-thaw script
   백업 이후 정리 작업
   예: DB unfreeze, staging 파일 삭제

활용 예

• Mold API 호출
• VM snapshot 준비
• 파일 export 및 mount
• 백업 staging 디렉토리 생성
• 백업 완료 후 cleanup

Pre-freeze Script 예시

#!/bin/sh

LOG="/var/log/veeam-mold-pre.log"

echo "$(date '+%F %T') PRE FREEZE START" >> "$LOG" 2>&1

/usr/local/bin/mold-pre-backup.sh >> "$LOG" 2>&1
RC=$?

echo "$(date '+%F %T') PRE FREEZE END rc=$RC" >> "$LOG" 2>&1
exit $RC

Post-thaw Script 예시

#!/bin/sh

LOG="/var/log/veeam-mold-post.log"

echo "$(date '+%F %T') POST THAW START" >> "$LOG" 2>&1

/usr/local/bin/mold-post-backup.sh >> "$LOG" 2>&1
RC=$?

echo "$(date '+%F %T') POST THAW END rc=$RC" >> "$LOG" 2>&1
exit $RC

---

2. Pre-job / Post-job Script 방식

이 방식은 백업 Job 자체의 시작 전후에 스크립트를 실행하는 방식이다.

실행 로직

Backup job 시작

└─ Pre-job script
   백업 시작 전 준비 작업

└─ 실제 백업 수행

└─ Post-job script
   백업 결과 후처리

활용 예

Pre-job

• 백업 대상 VM 검증
• Mold API 호출
• 외부 시스템 로그 기록

Post-job

• 백업 결과 통보
• 로그 적재
• 백업 staging 파일 정리

Pre-job Script 예시

#!/bin/sh

LOG="/var/log/veeam-job.log"

echo "$(date '+%F %T') JOB START" >> "$LOG"

/usr/local/bin/mold-job-pre.sh >> "$LOG" 2>&1
exit $?

Post-job Script 예시

#!/bin/sh

LOG="/var/log/veeam-job.log"

echo "$(date '+%F %T') JOB END" >> "$LOG"

/usr/local/bin/mold-job-post.sh >> "$LOG" 2>&1
exit $?

---

3. REST API 방식

Veeam Backup & Replication은 Enterprise Manager REST API를 제공하여 외부 시스템과 연동할 수 있다.

REST API를 사용하면 다음 작업이 가능하다.

• Backup Job 조회
• Backup Job 실행
• Backup Session 조회
• Restore 작업 실행

REST API 기반 백업 흐름

Mold
 └─ Veeam REST API 호출
      ├─ Backup Job 실행
      ├─ Job 상태 조회
      └─ Backup 결과 확인

API 호출 흐름 예

1. 로그인 및 세션 생성
2. Backup Job 목록 조회
3. 특정 Job 실행
4. Job Session 조회
5. 백업 완료 확인