본문 바로가기
WIKI 기술 지식 베이스

Turso Cloud와 동기화

원문 보기 위키 갱신

AgentFS를 Turso Cloud와 동기화하면 백업, 협업, 분산 에이전트 배포가 가능해져요.

출처: 문서

본문

동기화 설정하기

1. Turso 데이터베이스 만들기

Turso 계정이 없다면 먼저 가입하세요.

에이전트용 데이터베이스를 만들기:

turso db create my-agent-db

데이터베이스 URL 가져오기:

turso db show my-agent-db --url
# Output: libsql://my-agent-db-username.turso.io

2. 동기화와 함께 초기화하기

동기화를 켠 상태로 새 에이전트 파일시스템 만들기:

agentfs init my-agent --sync-remote-url libsql://my-agent-db-username.turso.io

기존 에이전트에 동기화를 추가하기:

# Edit the database to add sync configuration
# (Feature coming soon)

동기화 명령

원격 변경 가져오기

Turso Cloud에서 변경 사항을 내려받기:

agentfs sync my-agent pull

로컬 변경 내보내기

로컬 변경 사항을 Turso Cloud에 올리기:

agentfs sync my-agent push

동기화 상태 보기

동기화 통계 확인하기:

agentfs sync my-agent stats

체크포인트 만들기

동기화 체크포인트를 강제 실행하기:

agentfs sync my-agent checkpoint

활용 사례

백업과 복구

에이전트 상태를 자동으로 백업하기:

# After important work
agentfs sync my-agent push

# On a new machine
agentfs init my-agent --sync-remote-url libsql://...
agentfs sync my-agent pull

멀티 머신 에이전트

상태를 공유하며 여러 머신에서 에이전트 실행하기:

# Machine A
agentfs run --session shared-agent python3 agent.py
agentfs sync shared-agent push

# Machine B
agentfs sync shared-agent pull
agentfs run --session shared-agent python3 agent.py

부분 동기화

파일시스템이 큰 경우 부분 동기화로 필요한 것만 가져올 수 있어요:

agentfs init my-agent \
  --sync-remote-url libsql://... \
  --sync-partial-prefetch \
  --sync-partial-segment-size 1000

부분 동기화 옵션

옵션 설명
--sync-partial-prefetch 프리페치 활성화
--sync-partial-segment-size 부분 동기화 세그먼트 크기
--sync-partial-bootstrap-query 사용자 지정 부트스트랩 쿼리
--sync-partial-bootstrap-length 부트스트랩 접두어 길이

인증

동기화에는 Turso 인증 토큰이 필요해요. 환경 변수로 설정하세요:

export TURSO_AUTH_TOKEN=$(turso db tokens create my-agent-db)

또는 수명이 긴 토큰을 만들기:

turso db tokens create my-agent-db --expiration none

충돌 해결

AgentFS는 충돌에 last-write-wins를 사용해요. 같은 파일이 여러 머신에서 수정되면:

  1. 머신 A의 push는 성공해요
  2. 머신 B의 push는 실패해요 (충돌)
  3. 머신 B는 먼저 pull한 뒤 push해야 해요

더 알아보기 (Learn more)