alpacon edit
로컬 에디터로 원격 파일을 편집합니다.
사용법
alpacon edit [USER@]SERVER:PATH [flags]
핵심 사항
- 원격 경로 형식은
[USER@]SERVER:/path - 에디터를 닫으면 수정한 파일을 원래 경로에 업로드
- 파일 전송 권한은
alpacon cp와 같음
플래그
| 플래그 | 유형 | 설명 | 기본값 |
|---|---|---|---|
--editor | string | 실행할 에디터 명령 (기본값: ALPACON_EDITOR, VISUAL, EDITOR, 다음 vi) | — |
--force | bool | 10 MB 초과 파일을 확인 없이 편집 | false |
-g, --groupname | string | 그룹 이름 지정 | — |
-h, --help | bool | 명령 도움말 표시 | false |
-u, --username | string | 사용자 이름 지정 | — |
--work-session | string | 이 편집을 작업 세션에 연결 (‘work-session use’ 설정보다 우선) | — |
--output | string | 출력 형식: table 또는 json | table |
예제
원격 파일 편집
alpacon edit my-server:/etc/nginx/nginx.conf특정 사용자로 편집
alpacon edit admin@my-server:/etc/hosts
alpacon edit -u admin my-server:/etc/hosts특정 에디터 사용
alpacon edit my-server:/etc/nginx/nginx.conf --editor "code --wait"10 MB 초과 파일을 확인 프롬프트 없이 편집
alpacon edit my-server:/var/log/large.txt --force특정 작업 세션에 연결해 편집
alpacon edit my-server:/etc/nginx/nginx.conf --work-session SESSION_ID상세 설명
로컬 에디터를 사용해 원격 서버의 파일을 편집합니다. 파일을 다운로드해 에디터로 열고, 에디터를 닫으면 원래 경로로 다시 업로드합니다. 파일 전송 및 권한 동작은 alpacon cp와 동일합니다.
원격 경로는 alpacon cp와 같은 [USER@]SERVER:/path 형식을 사용합니다.
에디터 선택
에디터는 다음 순서로 결정됩니다:
--editor플래그ALPACON_EDITOR환경 변수VISUAL환경 변수EDITOR환경 변수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를 참고하세요.