문제 해결
자주 발생하는 문제와 해결 방법
devsync doctor 실행하기
섹션 제목: “devsync doctor 실행하기”devsync doctor는 로컬 Devsync 설정을 검사하고 문제가 있는 항목을 알려줘요. 다음 항목들을 확인해요.
- 저장소 유효성 —
~/.config/devsync/sync/가 존재하고 올바른 Git 저장소인지 - 매니페스트 무결성 —
manifest.json이 존재하고 문법적으로 올바른지 - Age 키 —
~/.config/devsync/age/keys.txt가 존재하고 읽을 수 있는지 - 추적 경로 — 매니페스트에 등록된 모든 경로가 실제로 존재하는지
문제가 의심될 때 언제든지 실행해 보세요.
devsync doctordoctor가 실패를 보고하면 출력 메시지를 자세히 읽어보세요. 각 실패 메시지에는 영향받는 항목과 권장 해결 방법이 함께 나와요. 아래 섹션에서 자주 발생하는 실패 유형을 자세히 설명해요.
자주 발생하는 문제
섹션 제목: “자주 발생하는 문제””Age key not found” 또는 복호화 오류
섹션 제목: “”Age key not found” 또는 복호화 오류”원인: ~/.config/devsync/age/keys.txt가 없거나 손상되어 있어요.
해결 방법: age 개인키를 다시 등록해요.
devsync init --key AGE-SECRET-KEY-...”Tracked path does not exist”
섹션 제목: “”Tracked path does not exist””원인: 이전에 추적 등록한 파일이나 디렉터리가 로컬에서 이동하거나 삭제된 경우예요.
해결 방법: 파일을 원래 경로로 복원하거나, 추적에서 제거해요.
devsync untrack ~/.path/to/missing/file”manifest.json is invalid”
섹션 제목: “”manifest.json is invalid””원인: manifest.json을 직접 편집하면서 문법 오류가 생긴 경우예요.
해결 방법: sync 디렉터리로 이동해서 JSON을 직접 수정해요.
devsync cd# manifest.json의 문법 오류를 수정해요exit”Repository not found” / sync 디렉터리 없음
섹션 제목: “”Repository not found” / sync 디렉터리 없음”원인: ~/.config/devsync/sync/가 삭제됐거나 이 기기에서 devsync init을 실행한 적이 없는 경우예요.
해결 방법: Devsync를 다시 초기화해요. 기존 dotfiles 저장소가 있다면 URL을 함께 전달해요.
devsync init https://github.com/yourname/dotfiles.git새로 시작하는 경우엔 URL 없이 실행해요.
devsync initpush 후 변경사항이 원격 저장소에 반영되지 않아요
섹션 제목: “push 후 변경사항이 원격 저장소에 반영되지 않아요”원인: devsync push는 파일을 로컬 sync 디렉터리에 미러링할 뿐, Git 커밋을 생성하지 않아요. 수동으로 커밋하고 push하기 전까지 원격 저장소는 변경되지 않아요.
해결 방법: devsync push 실행 후 sync 디렉터리로 이동해서 커밋해요.
devsync cdgit add .git commit -m "Update dotfiles"git pushexitpull 후 파일이 일부만 복원돼요
섹션 제목: “pull 후 파일이 일부만 복원돼요”원인: 일부 파일이 현재 활성화된 프로파일이 아닌 다른 프로파일에 속해 있어요. devsync pull은 활성 프로파일에 속한 파일만 복원해요.
해결 방법: 현재 활성 프로파일을 확인하고 필요하면 전환해요.
devsync profile listdevsync profile use <name>devsync pull프로파일을 전환하지 않고 특정 프로파일의 파일만 가져올 수도 있어요.
devsync pull --profile <name>암호화된 파일 복원하기
섹션 제목: “암호화된 파일 복원하기”암호화된 파일(.devsync.secret)은 devsync init을 처음 실행할 때 사용한 age 개인키로만 복호화할 수 있어요.
키가 있는 경우:
devsync init --key AGE-SECRET-KEY-...devsync pull키를 잃어버린 경우:
권장 사항: 처음 devsync init을 실행한 직후에 AGE-SECRET-KEY-... 값을 1Password, Bitwarden 같은 비밀번호 관리자에 저장해 두세요.
Devsync 초기화(리셋)하기
섹션 제목: “Devsync 초기화(리셋)하기”완전히 처음부터 다시 시작하고 싶다면 Devsync 설정 디렉터리 전체를 삭제해요.
rm -rf ~/.config/devsync/삭제 후 다시 초기화해요.
devsync init