검증된 파일 실행
검토자가 실행할 스크립트를 확인해야 한다면 alpacon exec --file PATH를 쓰세요. 서버의 에이전트가 실행 전에 파일 내용을 검토받은 내용과 비교하며, 서로 다르면 실행을 거부합니다.
스크립트 실행
--file에는 서버의 절대 경로를 지정합니다. CLI가 내용을 읽을 위치를 선택하세요.
| 입력 위치 | 예제 | 준비할 파일 |
|---|---|---|
| 로컬의 같은 경로 | alpacon exec --file /opt/check.sh my-server | 내용이 같은 로컬 파일과 서버 파일 |
| 로컬의 다른 경로 | alpacon exec --file /opt/check.sh --file-from ./check.sh my-server | 서버 파일과 내용이 같은 로컬 사본 |
| 로컬 파일을 먼저 업로드 | alpacon exec --file /opt/check.sh --file-from ./check.sh --upload my-server | 로컬 파일. 서버의 기존 파일을 덮어쓸 때만 --overwrite 추가 |
| 서버 파일에서 읽기 | alpacon exec --file /opt/check.sh --from-server my-server | 서버에서 읽을 수 있는 파일 |
기본 인터프리터는 /bin/bash입니다. 다른 인터프리터를 쓰려면 --interpreter에 절대 경로를 지정하세요. 스크립트 인수는 서버 이름과 -- 뒤에 놓으세요.
alpacon exec --file /opt/check.sh --file-from ./check.sh --interpreter /bin/sh my-server -- --summary스크립트나 인수에 자격 증명을 넣지 마세요. 스크립트가 서버에 있는 환경 변수나 파일에서 읽도록 작성하세요. --file에는 --env를 쓸 수 없습니다. 플래그 조합과 업로드 동작은 CLI 참조를 참고하세요.
제한
| 입력 | 제한 |
|---|---|
| 스크립트 내용 | 비어 있지 않은 UTF-8, 최대 65,536바이트(64 KB) |
| 생성된 명령줄 | 인터프리터, 경로, 인수를 합쳐 2048자 |
| 스크립트 경로 | 1024자, 절대 경로 |
| 인터프리터 | 256자, 절대 경로 |
| 각 인수 | 1024자 |
| 인수 개수 | 64개 |
| 제안할 재사용 기간 | 워크스페이스 상한 이내에서 1~366일 |
제출이 거부되면 파일 실행 거부를 참고하세요.
상시 승인
--reuse-days N은 재사용 기간을 제안하는 옵션입니다. 상시 승인은 승인자만 부여할 수 있습니다. 승인은 검토한 내용, 서버, 계정과 그룹, 인터프리터, 인수에 적용됩니다. 이 중 하나라도 달라지면 다시 검토받아야 합니다.
워크스페이스의 상시 승인 설정에는 상시 승인 최대 기간 항목이 있습니다. 이 상한 안에서 기간을 요청하세요. 상한을 낮춰도 이미 부여한 승인의 만료일은 앞당겨지지 않습니다.
슈퍼유저 또는 admin이나 security admin 역할을 가진 멤버는 “승인된 파일 실행”에서 철회를 선택해 상시 승인을 철회할 수 있습니다. 다음 실행에는 다시 승인이 필요하며, 철회한 승인도 감사 기록을 위해 목록에 남습니다.
파일 실행에 필요한 조건
워크스페이스에 AI 검토가 활성화되어 있어야 하며, 서버가 실행 전 파일 확인을 지원해야 합니다. 이 조건 때문에 거부되면 관리자에게 문의하세요. 브라우저로 로그인했다면 작업 세션에 command가 필요합니다. --upload와 --from-server에는 파일 전송 기능(webftp)도 필요합니다. 자세한 내용은 검증된 파일 실행을 참고하세요.