시작하기
기본 개념
기존 파일 환경의 데이터를 클라우드 스토리지로 이전하기
기업의 파일은 NAS, SMB 공유 폴더, NFS 스토리지, 파일 서버 등 다양한 환경에 분산되어 있습니다.
클라우드 이전은 기존 파일을 지정된 클라우드 스토리지로 전송하고, 이전 기간 동안 발생하는 변경 사항을 지속적으로 반영해 최종 전환 시점까지 파일 상태를 관리하는 방식입니다.
기존 파일 환경
│
▼
초기 파일 이전
│
▼
변경 파일 동기화
│
▼
전환 상태 확인
│
▼
클라우드 전환

초기 파일 이전과 변경 파일 동기화를 연결하면 기존 파일 환경의 데이터를 클라우드로 이전하고 전환 시점까지 파일 상태를 관리할 수 있습니다.
이전 흐름
초기 파일 이전부터 변경 파일 동기화와 최종 전환까지 이어가기
파일 이전은 초기 데이터를 클라우드로 전송한 뒤, 이전 기간 동안 생성되거나 수정되는 파일을 계속 반영하는 흐름으로 구성합니다.
① 원본 환경 연결
│
▼
② 초기 파일 이전
│
▼
③ 변경 사항 감지
│
▼
④ 변경 파일 동기화
│
▼
⑤ 전환 상태 확인
│
▼
⑥ 클라우드 전환
이 흐름을 통해 초기 파일과 이후 변경되는 파일을 함께 관리하며 클라우드 전환을 진행할 수 있습니다.
전환 효과
기존 파일 흐름을 클라우드 환경으로 이어가기
초기 이전과 변경 동기화를 함께 구성하면 전환 기간 동안 원본 환경과 클라우드의 파일 상태를 연결해 관리할 수 있습니다.
| 구분 | 기존 파일 환경 | 클라우드 전환 흐름 |
|---|---|---|
| 초기 데이터 | 기존 환경에서 관리 | 대량 파일을 클라우드로 이전 |
| 변경 파일 | 파일별 상태 확인 | 변경 사항을 지속적으로 동기화 |
| 전환 준비 | 환경별 파일 상태 확인 | 이전과 동기화 결과를 기준으로 확인 |
| 이후 업무 | 기존 저장 위치 활용 | 클라우드 저장 위치를 기준으로 연결 |
IT 엔지니어
원본 환경
NAS와 파일 서버의 이전 경로 연결하기
먼저 이전할 파일이 저장된 NAS, SMB, NFS, 파일 서버를 연결하고, 클라우드로 이전할 파일 경로를 지정합니다.
각 원본 환경에서 파일을 읽고 변경 사항을 확인할 수 있도록 접근 범위를 설정합니다.
NAS ─────────┐
SMB ─────────┤
NFS ─────────┼──→ Migration Flow
File Server ─┘

여러 원본 환경을 연결하면 파일 저장 위치별 이전 작업을 하나의 흐름에서 구성할 수 있습니다.
클라우드 연결
클라우드 스토리지와 대상 경로 구성하기
원본 환경을 연결한 후 파일을 저장할 클라우드 스토리지와 대상 위치를 설정합니다.
대상 버킷이나 컨테이너, 저장 경로를 지정하고 원본 파일 경로와 연결합니다.
Original Storage
│
▼
Migration Flow
│
▼
Cloud Storage
└─ Target Path

이전할 원본 경로와 클라우드 저장 위치를 구성하면 초기 이전과 변경 동기화에 사용할 파일 흐름이 준비됩니다.
초기 이전
기존 대량 파일을 클라우드로 전송하기
이전 환경 구성이 완료되면 기존 파일과 대량 데이터를 클라우드 스토리지로 전송합니다.
실행 중에는 처리된 파일 수와 전체 용량, 진행률과 작업 상태를 확인할 수 있습니다.
Original Files
│
▼
Initial Transfer
│
▼
Cloud Storage

초기 이전 결과는 이후 변경 파일 동기화와 최종 전환을 위한 기준으로 활용합니다.
변경 동기화
이전 기간 동안 변경되는 파일을 계속 반영하기
초기 이전 이후에도 기존 파일 환경에서는 새로운 파일이 생성되거나 기존 파일이 수정될 수 있습니다.
New Items와 Modified Items를 기준으로 변경 사항을 확인하고, 해당 파일을 클라우드 스토리지에 동기화하도록 구성합니다.
Original Environment
│
New / Modified
│
▼
Change Detection
│
▼
Sync
│
▼
Cloud Storage

변경 파일을 지속적으로 반영하면 초기 이전 이후의 파일 상태도 클라우드 환경에 이어서 관리할 수 있습니다.
전환 검증
초기 이전과 변경 동기화 결과 확인하기
최종 전환 전에 초기 파일 이전 결과와 이후 변경 파일의 동기화 상태를 함께 확인합니다.
파일 수와 용량, 최근 실행 결과, 동기화 상태를 기준으로 원본 환경과 클라우드 환경의 전환 준비 상태를 확인할 수 있습니다.
Initial Transfer ──┐
├──→ Migration Status
Change Sync ───────┘
│
┌────┴────┐
▼ ▼
Ready Check Items

초기 이전과 변경 동기화 결과를 함께 확인하면 클라우드 환경을 기준으로 업무를 전환할 시점을 정할 수 있습니다.
최종 전환
클라우드 환경을 기준으로 파일 업무 전환하기
전환 검증이 완료되면 클라우드 스토리지를 이후 파일 업무의 기준 환경으로 설정합니다.
업무 시스템과 애플리케이션, 후속 파일 작업의 저장 위치를 클라우드와 연결해 파일 흐름을 이어갈 수 있습니다.
Before
NAS / File Server
│
▼
Migration Flow
│
▼
Cloud Storage
│
▼
After
App / Service / Workflow

이전 이후에는 클라우드에 저장된 파일을 기준으로 다음 업무와 자동화 작업을 연결할 수 있습니다.
운영 대응
이전과 동기화 작업을 확인하고 다시 실행하기
이전 과정에서 확인이 필요한 작업은 Runs와 상세 실행 기록을 통해 원본 연결 상태, 대상 경로, 파일 처리 결과와 동기화 상태를 확인합니다.
Migration Run
│
▼
Status Check
│
┌────┴─────┐
▼ ▼
Complete Check Items
│
▼
View Details
│
▼
Update Settings
│
▼
Retry
│
▼
Result Confirm

| 확인 항목 | 확인 내용 | 후속 작업 |
|---|---|---|
| 원본 환경 | NAS·SMB·NFS·파일 서버 연결과 경로 | 연결과 경로 확인 |
| 클라우드 | 저장 위치와 접근 상태 | 대상 설정 확인 |
| 초기 이전 | 대량 파일 처리 결과 | 필요한 작업 다시 실행 |
| 변경 동기화 | 추가·수정 파일의 반영 상태 | 동기화 작업 다시 실행 |
| 실행 기록 | 작업 상태와 상세 처리 결과 | 설정 확인 후 재실행 |
개발자
기존 공유 폴더를 클라우드로 옮기고 이전 기간 동안 변경분을 계속 반영하기
연동 준비
공통 호출 코드와 경로 표기 준비하기
import os
import requests
BASE_URL = os.getenv("INNORIX_BASE_URL", "https://app.innorix.com").rstrip("/")
TOKEN = os.environ["INNORIX_ACCESS_TOKEN"]
WORKSPACE_ID = os.getenv("INNORIX_WORKSPACE_ID") # optional; falls back to the current workspace
STATUS_COMPLETE = 2
TERMINAL = {2, 4, 5, 9, 99} # complete / error / cancelled / partial / failed
NOT_SUCCEEDED = {4, 5, 9, 99}
def api(method, path, body=None, params=None):
headers = {
"Content-Type": "application/json",
"Authorization": f"Bearer {TOKEN}",
}
if WORKSPACE_ID:
headers["x-workspace-id"] = WORKSPACE_ID
response = requests.request(
method, BASE_URL + path,
headers=headers, json=body, params=params, timeout=30,
)
payload = response.json() if response.content else {}
if not response.ok:
raise RuntimeError(payload.get("message") or f"HTTP {response.status_code}")
return payload.get("data")
def is_terminal(detail):
return detail.get("isTerminal", detail.get("status") in TERMINAL)import base64
import time
def encode_path(device_id, raw_path):
normalized = str(raw_path or "").replace("\\", "/")
token = base64.b64encode(normalized.encode("utf-8")).decode("ascii")
return f"{device_id}_ino_{token}"
def now_iso():
return time.strftime("%Y-%m-%dT%H:%M:%S.000Z", time.gmtime())전송 상태는 아래 값으로 판단합니다. 종료 상태는 다섯 개이고 성공에 해당하는 값은 완료(2)입니다.
| 상태 값 | 의미 | 종료 |
|---|---|---|
| 2 | 완료 | 예 |
| 4 | 오류 | 예 |
| 5 | 취소 | 예 |
| 9 | 부분 완료 | 예 |
| 99 | 실패 | 예 |
| 1 · 6 · 12 · 13 | 시작·전송 중·동기화 중·수신 중 | 아니오 |
이전 범위 파악
옮길 파일의 개수와 용량 미리 확인하기
이전을 시작하기 전에 규모를 알아야 일정을 잡을 수 있습니다.
def scan(device_id, path, max_pages=200):
page = api("POST", f"/api/devices/{device_id}/files/search",
{"path": path, "pageSize": 1000})
total = size = 0
search_id = page.get("searchId")
try:
for _ in range(max_pages):
for item in page.get("items") or []:
if item["type"] == "file":
total += 1
size += item.get("size") or 0
if not page.get("hasMore"):
break
page = api("GET", f"/api/devices/{device_id}/files/search",
params={"cursor": page["nextCursor"]})
finally:
# stop the device scan once the count is done
if search_id:
api("POST", f"/api/devices/{device_id}/files/search/cancel",
{"uuid": search_id})
return total, size
count, size = scan("device-nas-01", "/share/team")
print(f"{count} files / {size / (1024 ** 3):.1f}GB")검색은 장비가 디스크를 실제로 탐색하는 작업입니다. 중단하지 않으면 확인이 끝난 뒤에도 탐색이 계속됩니다.
초기 이전
기존 대량 파일을 클라우드로 보내기
전체를 한 번에 보내면 실패했을 때 다시 시작할 범위가 커집니다. 상위 폴더 단위로 나눠 보냅니다.
def target_for(folder, base):
return folder.replace("/share", base, 1)
def migrate(source, target, folder, base):
transfer = api("POST", "/api/transfers/manual", {
"sourceDevice": source,
"targetDevice": target,
"targetPath": target_for(folder, base),
"sourcePaths": [folder],
"sendAllFolder": True,
"transferOptions": {"target-action": "overwrite"},
})
return transfer["monitorId"]
FOLDERS = ["/share/team/design", "/share/team/docs", "/share/team/archive"]
transfers = {
folder: migrate("device-nas-01", "device-cloud-01", folder, "/migrated")
for folder in FOLDERS
}도착 정책은 overwrite를 씁니다. 이전 도중 다시 실행하는 경우가 많은데 numbering이면 사본이 쌓입니다.
파일 수가 매우 많은 폴더는 전송이 오래 걸립니다. 중단되면 이어받기로 재개할 수 있으므로 처음부터 재전송할 필요가 없습니다.
def wait(monitor_id, timeout=3600, interval=3):
deadline = time.time() + timeout
while time.time() < deadline:
detail = api("GET", f"/api/transfers/{monitor_id}")
if is_terminal(detail):
return detail
time.sleep(interval)
raise TimeoutError(monitor_id)
def failed_files(monitor_id):
result = api("GET", f"/api/transfers/{monitor_id}/files", params={
"state": "any", "size": 500,
}) or {}
return [r for r in (result.get("children") or [])
if r.get("status") in NOT_SUCCEEDED]
def retry_failed(monitor_id):
rows = failed_files(monitor_id)
if not rows:
return 0
api("POST", f"/api/transfers/{monitor_id}/retry", {
"filesRetry": [
{"filePath": r["sourceFilePath"], "isDir": bool(r.get("isFolder"))}
for r in rows
]
})
return len(rows)for folder, monitor_id in transfers.items():
detail = wait(monitor_id, timeout=86400)
print(f"{folder:28} {detail.get('statusName')}"
f" {detail.get('fileCount')} files")
if detail["status"] != STATUS_COMPLETE:
print(f" retried {retry_failed(monitor_id)} files")변경분 동기화
이전 기간 동안 바뀐 파일 계속 반영하기
초기 이전이 며칠 걸리는 동안에도 원본에서는 파일이 계속 바뀝니다. 주기적으로 변경분만 보냅니다.
transfer = api("POST", "/api/transfers/manual", {
"sourceDevice": "device-nas-01",
"targetDevice": "device-cloud-01",
"targetPath": "/migrated/team/design",
"sourcePaths": ["/share/team/design"],
"sendAllFolder": True,
"incremental": True,
"transferOptions": {"target-action": "overwrite"},
})기본값은 꺼짐입니다. 변경분 계산은 장비의 에이전트가 수행하며, 마지막 전송 이후 추가되거나 수정된 파일만 보냅니다.
증분에는 반드시 overwrite를 씁니다. numbering이면 수정된 파일이 새 이름으로 쌓여 클라우드 쪽 상태가 원본과 달라집니다.
스크립트를 계속 돌릴 수 없다면 시간 단위 자동화로 등록합니다.
def build_sync(name, source, source_path, target, target_path, schedule):
return {
"name": name,
"flowName": name,
"transferType": "normal",
"timezone": "Asia/Seoul",
"step": 1,
"isUpcoming": False,
"details": [
{
"senderId": source,
"receiverId": target,
"sourceItem": [
{
"hash": encode_path(source, source_path),
"filePath": source_path,
"isDir": True,
}
],
"targetPath": encode_path(target, target_path),
"step": 1,
"transferOptions": {
"noSchedule": False,
"target-action": "overwrite",
"send-fileoption": {},
},
}
],
"schedules": [schedule],
}
HOURLY = {
"type": "hour",
"startDateType": "now",
"startDate": now_iso(),
"timezone": "Asia/Seoul",
}
syncs = {
folder: api("POST", "/api/automations", build_sync(
f"sync {folder}", "device-nas-01", folder,
"device-cloud-01", target_for(folder, "/migrated"),
HOURLY))["automationId"]
for folder in FOLDERS
}자동화 요청에서 반드시 지켜야 하는 항목이 네 개 있습니다.
| 항목 | 지정 방식 |
|---|---|
isUpcoming | 반드시 false. 서버 기본값 true는 요청에 담긴 일정을 무시하고 5분짜리 일회성 일정으로 대체합니다. triggerAutomation이 붙은 단계는 서버가 false로 강제하므로, 트리거가 없는 첫 단계에만 직접 지정하면 됩니다 |
step | 최상위와 details 양쪽에 넣습니다. 흐름 안에서의 홉 위치입니다 |
sourceItem | hash(경로 토큰)와 filePath(평문 경로)를 함께 넣습니다 |
syncType | transferOptions 안에 넣습니다. 1은 단방향, 2는 양방향입니다 |
네 항목 모두 누락해도 등록은 성공하고 실행 시점에 동작이 달라집니다. 반복 일정을 등록했는데 한 번만 실행되고 끝났다면 isUpcoming부터 확인합니다.
진행 상황 집계
전송별 진행률과 동기화 회차를 조회하기
def progress(transfers):
for folder, monitor_id in transfers.items():
detail = api("GET", f"/api/transfers/{monitor_id}")
print(f"{folder:28} {detail.get('statusName'):12}"
f" {detail.get('percent', 0):>5}%"
f" {detail.get('fileCount', 0)} files")동기화 자동화의 회차별 결과는 실행 이력으로 확인합니다.
for folder, automation_id in syncs.items():
runs = api("GET", f"/api/automations/{automation_id}/executions") or []
latest = runs[0] if runs else {}
print(f"{folder:28} runs {len(runs):>3}"
f" last {latest.get('startTime')} {latest.get('status')}")실행 이력은 최신 회차가 배열 앞에 옵니다. 이력이 비어 있으면 자동화가 등록만 되고 실행되지 않은 것이므로 isUpcoming과 시작 조건을 확인합니다.
전환 검증
원본과 클라우드의 파일이 일치하는지 확인하기
전환 시점을 정하려면 두 환경의 파일이 일치하는지 확인해야 합니다. 폴더별로 원본과 대상의 파일 목록을 비교해 누락을 찾습니다.
def list_names(device_id, path):
names, page = set(), 1
while True:
result = api("GET", f"/api/devices/{device_id}/files", params={
"path": path, "page": page, "size": 200, "type": "file",
}) or {}
names.update(item["name"] for item in result.get("items") or [])
if page >= (result.get("lastPage") or 1):
return names
page += 1
missing = list_names("device-nas-01", "/share/team/design") \
- list_names("device-cloud-01", "/migrated/team/design")
print(f"{len(missing)} missing")누락된 파일이 있으면 해당 폴더를 다시 전송해 목록을 맞춥니다. 이름만이 아니라 크기까지 대조하려면 목록에 size를 함께 담아 비교합니다.
전환과 정리
동기화를 멈추고 클라우드를 기준 환경으로 두기
전환이 끝나면 동기화 자동화를 정지합니다. 원본이 계속 반영되면 클라우드 쪽 변경이 덮어써질 수 있습니다.
for automation_id in syncs.values():
api("POST", f"/api/automations/{automation_id}/pause", {"pause": True})일정 기간 문제가 없으면 삭제합니다. 정지 상태로 두면 나중에 실수로 재개될 수 있습니다.
for automation_id in syncs.values():
api("DELETE", f"/api/automations/{automation_id}")| 확인 항목 | 확인 내용 |
|---|---|
| 이전 범위 | 파일 수와 전체 용량 |
| 초기 이전 | 폴더별 전송 상태 |
| 변경 동기화 | 회차별 실행 결과 |
| 검증 | 원본과 대상의 파일 목록 일치 여부 |
| 전환 | 동기화 정지와 정리 |