alpacon edit

로컬 에디터로 원격 파일을 편집합니다.

사용법

alpacon edit [USER@]SERVER:PATH [flags]

핵심 사항

  • 원격 경로 형식은 [USER@]SERVER:/path
  • 에디터를 닫으면 수정한 파일을 원래 경로에 업로드
  • 파일 전송 권한은 alpacon cp와 같음

플래그

플래그유형설명기본값
--editorstring실행할 에디터 명령 (기본값: ALPACON_EDITOR, VISUAL, EDITOR, 다음 vi)—
--forcebool10 MB 초과 파일을 확인 없이 편집false
-g, --groupnamestring그룹 이름 지정—
-h, --helpbool명령 도움말 표시false
-u, --usernamestring사용자 이름 지정—
--work-sessionstring이 편집을 작업 세션에 연결 (‘work-session use’ 설정보다 우선)—
--outputstring출력 형식: table 또는 jsontable

예제

원격 파일 편집

bash
alpacon edit my-server:/etc/nginx/nginx.conf

특정 사용자로 편집

bash
alpacon edit admin@my-server:/etc/hosts
alpacon edit -u admin my-server:/etc/hosts

특정 에디터 사용

bash
alpacon edit my-server:/etc/nginx/nginx.conf --editor "code --wait"

10 MB 초과 파일을 확인 프롬프트 없이 편집

bash
alpacon edit my-server:/var/log/large.txt --force

특정 작업 세션에 연결해 편집

bash
alpacon edit my-server:/etc/nginx/nginx.conf --work-session SESSION_ID

상세 설명

로컬 에디터를 사용해 원격 서버의 파일을 편집합니다. 파일을 다운로드해 에디터로 열고, 에디터를 닫으면 원래 경로로 다시 업로드합니다. 파일 전송 및 권한 동작은 alpacon cp와 동일합니다.

원격 경로는 alpacon cp와 같은 [USER@]SERVER:/path 형식을 사용합니다.

에디터 선택

에디터는 다음 순서로 결정됩니다:

  1. --editor 플래그
  2. ALPACON_EDITOR 환경 변수
  3. VISUAL 환경 변수
  4. EDITOR 환경 변수
  5. vi (기본값)

--editor 값은 셸을 거치지 않고 명령과 인자로 분리되며, 파일 경로가 마지막 인자로 추가됩니다. 파이프, 리다이렉션, && 같은 셸 문법은 동작하지 않습니다.

경고

GUI 에디터(code, cursor, subl 등)는 창을 연 직후, 파일을 저장하기 전에 즉시 반환됩니다. wait 플래그 없이 사용하면 변경 사항이 업로드되지 않습니다. --editor "code --wait"처럼 에디터의 wait 플래그를 사용하세요. wait 플래그 없는 GUI 에디터가 감지되면 CLI가 경고를 출력합니다.

동작 방식

  • 기존 파일만 편집: 파일을 먼저 다운로드하므로 alpacon edit으로 새 원격 파일을 만들 수 없습니다.
  • 변경 시에만 업로드: 파일을 수정하지 않고 에디터를 닫으면 업로드를 생략하고 No changes를 출력합니다.
  • 대용량 파일: 10 MB 초과 파일은 열기 전에 확인 프롬프트를 표시합니다. --force로 생략할 수 있습니다. 비대화형 셸(스크립트 등)에서는 프롬프트가 표시되지 않으며 --force 없이는 편집이 거부됩니다.
  • 업로드 실패: 변경 사항을 업로드할 수 없으면 편집본을 로컬 임시 경로에 보존하고 해당 경로를 경고로 출력해 작업 내용이 유실되지 않도록 합니다.

작업 세션 요구 사항

브라우저 로그인으로 인증한 경우, alpacon edit을 실행하려면 webftp 기능을 포함한 활성 작업 세션이 필요합니다. 세션을 요청하고 관리하는 방법은 alpacon work-session을 참고하세요. 서비스 토큰 인증에는 이 요구 사항이 적용되지 않습니다. 토큰에는 대상 서버를 허용하는 서버 ACL과 경로를 허용하는 파일 ACL이 필요합니다. 파일을 보낼 때는 upload, 받을 때는 download, edit에는 두 권한 모두(또는 *)가 필요합니다.

새 개인 API 토큰에는 명령어 실행이나 파일 전송 범위를 부여할 수 없습니다. 해당 범위를 이미 가진 토큰은 작업 세션 없이 계속 사용할 수 있습니다. 자동화와 CI에는 서비스 토큰을 쓰세요.

연결할 세션은 --work-session 플래그, ALPACON_WORK_SESSION 환경 변수, alpacon work-session use로 지정한 활성 세션 순으로 결정됩니다. 게이트가 편집을 거부하면 edit은 종료 코드 3으로 종료합니다. --output json으로 실행하면 stderr에서 기계가 읽을 수 있는 진단을 받을 수 있습니다. 에러 코드는 alpacon work-session를 참고하세요.

최종 수정: