백업 및 복원
Anyy 백업은 일관된 프로필 스냅샷을 캡처합니다. 복원은 항상 새로 생성할, 아직 존재하지 않는 프로필 디렉터리에 게시하며 실행 데이터에 덮어쓰지 않습니다.
백업 만들기
anyy backup create
기본 아카이브는 프로필 백업 영역에 타임스탬프 이름으로 기록됩니다. 필요하면 다른 대상을 선택하세요.
anyy backup create --output /secure/path/anyy-backup.tar.gz
Gateway에 접근 가능하면 명령이 상주 런타임에 일관된 스냅샷 생성을 요청합니다. 오프라인이면 Anyy가 변경 가능한 상태를 읽기 전에 프로필 독점 소유권을 획득해야 합니다.
포함 항목
아카이브에는 프로필 구성, 역할·스킬 파일, 워크스페이스·메모리 데이터, 일정, 채널 구성, 데이터베이스 스냅샷, 참조된 영속 객체나 아티팩트가 포함될 수 있습니다.
백업은 선택한 프로필 하나를 캡처합니다. 형제 프로필이나 설치된 Anyy 실행 파일은 묶지 않습니다. 프로필별로 따로 백업하세요.
임시 런타임 파일은 제외됩니다. 프로필 외부 콘텐츠를 따라가지 않고 심볼릭 링크를 거부합니다.
관리 자격 증명 디렉터리는 명시적 선택 필요
기본 백업은 관리되는 secrets/와 mcp/oauth/ 디렉터리를 제외합니다. 프로필 비밀정보와 지원 MCP/OAuth 자료는 명시적으로 추가하세요.
anyy backup create --include-secrets
이 플래그는 해당 관리 디렉터리를 제어할 뿐 포함된 모든 파일의 비밀정보를 검사하지는 않습니다. 구성과 사용자 파일은 내용을 그대로 포함합니다. config.yaml의 인라인 MCP 환경/헤더 값이나 워크스페이스 및 다른 캡처 파일의 비밀정보는 --include-secrets 없이도 아카이브에 들어갈 수 있습니다. 백업은 아카이브 전체를 대상으로 비밀정보를 가리지 않습니다.
아카이브를 암호화하고 접근을 제한하며 일반 파일 공유나 이슈 추적기에 업로드하지 마세요. 관리 자격 증명 디렉터리를 제외해도 비밀정보 없는 아카이브를 보장하지는 않습니다.
백업 목록
anyy backup list
anyy backup list --json
목록 명령은 프로필 백업 위치에서 인식한 아카이브를 보고합니다. 사용자 지정 경로의 아카이브도 직접 지정하면 복원할 수 있습니다.
안전한 복원
아직 존재하지 않는 대상 디렉터리를 선택하세요.
anyy backup restore \
--archive /secure/path/anyy-backup.tar.gz \
--target-home /path/to/new-profile
복원은 대상에 게시하기 전에 매니페스트, 파일 해시, 가용 공간, 경로, 아카이브 구조를 검증합니다. 대상 옆에서 결과를 준비하고 필요한 인덱스와 감사 상태를 재구성한 뒤 원자적으로 게시합니다.
복원 후:
anyy status --home /path/to/new-profile
anyy doctor --home /path/to/new-profile
명령과 TUI에서 복원된 홈을 명시적으로 사용하세요.
anyy --home /path/to/new-profile
anyy dashboard --home /path/to/new-profile
프로필 가져오기/등록 명령은 없습니다. 이름 있는 프로필로 복원하려면 아직 존재하지 않는 표준 대상 BASE_HOME/profiles/NAME을 선택하고 검증한 뒤 anyy --profile-root BASE_HOME profile use NAME을 실행하세요. 먼저 profile create NAME을 실행하지 마세요. 디렉터리가 생성되므로 복원이 거부됩니다.
복구 규칙
- 현재 프로필 홈을
--target-home으로 선택하지 마세요. - 이미 존재하는 디렉터리 위에 복원하지 마세요.
- 복원 프로필이
status와doctor를 통과할 때까지 소스 아카이브를 보관하세요. - 발신 채널이나 유료 공급자를 활성화하기 전에 제외된 자격 증명을 다시 연결하세요.
- 주기적으로 복원을 테스트하세요. 테스트하지 않은 아카이브는 백업 시도일 뿐입니다.
문제 해결
| 증상 | 설명 |
|---|---|
| 백업이 오프라인 모드를 거부함 | 실행 프로세스가 여전히 프로필을 소유함. 상주 경로를 쓰거나 중지하세요 |
| 복원이 대상 존재를 알림 | 존재하지 않는 새 경로 선택. 덮어쓰기 복원은 의도적으로 미지원 |
| 해시 또는 매니페스트 검증 실패 | 우회하지 말고 정상임이 확인된 다른 아카이브 사용 |
| 복원된 공급자가 인증 불가 | 관리 자격 증명이 제외되었거나 사용할 수 없는 참조에 의존할 수 있음. 자격 증명 재연결 |