기본값과 제한
작업을 계획할 때 이 값을 참고하세요. 요금제별 제공량과 현재 사용량은 요금제와 결제를 확인하세요.
세션과 만료
승인 대기 시간은 기본 24시간입니다. 그때까지 결정되지 않은 요청은 취소됩니다.
워크스페이스 설정은 서버 접근 정책을 참고하세요.
| 한도 | 값 | 설정 위치 |
|---|---|---|
| 세션 최대 사용 시간 | 기본값은 4시간이며, 5분부터 7일까지 설정할 수 있습니다. | Superuser가 Policies → Server access의 서버 기본 설정 카드에서 설정합니다. 최대 시간을 늘리려면 웹 콘솔을 사용해야 합니다. |
| 만료 경고 | 만료까지 남은 시간이 10분 이내일 때 한 번 알립니다. | 고정되어 있습니다. |
| 연장 종료 시각 | 연장을 요청한 시각부터 최대 사용 시간 이내여야 합니다. | 위의 세션 최대 사용 시간 설정이 적용됩니다. |
세션을 생성할 때 사용 시간은 예약한 시작 시각부터 계산합니다. 바로 시작하는 세션은 요청 시각부터 계산합니다. 폼에는 최대 시간 이내인 선택지만 표시되며, 직접 입력할 수 있는 시간에도 같은 제한이 적용됩니다. 한도를 넘는 요청은 자동으로 단축되지 않고 거부됩니다.
만료까지 남은 시간이 10분 이내이면 요청자와 담당자에게 앱 내 피드와 브라우저 알림으로 경고가 전달됩니다. 토큰에만 지정된 세션에는 이 경고가 전달되지 않습니다. 접근이 계속 필요하면 승인에 걸릴 시간을 고려해 종료 시각 전에 연장을 요청하세요.
종료 시각이 지나면 페이지에 이전 상태가 표시되더라도 추가 작업은 거부됩니다. 열려 있던 연결은 세션이 만료 처리될 때 닫힙니다. 작업 중에 세션이 만료됐다면 다른 세션을 요청하세요.
MFA와 민감한 작업
일반 작업의 MFA 확인은 기본 1시간 동안 유효합니다. 민감한 작업에는 별도의 기본 15분 유효 시간이 적용됩니다. 워크스페이스 관리자는 인증 정책에서 시간을 바꿀 수 있습니다. 유효 시간이 지났다면 안내에 따라 MFA를 다시 확인하세요.
토큰과 서버 등록
토큰 최대 사용 기간은 기본 366일이며 1~366일로 설정할 수 있습니다. 개인 API 토큰과 서버 또는 클러스터 등록 토큰에 적용됩니다. 만료일을 지정하지 않으면 워크스페이스 최대값이 적용되고, 그보다 늦은 날짜를 지정하면 요청이 거부됩니다. 최대값을 낮춰도 기존 토큰의 만료일은 바뀌지 않습니다. 서비스 토큰에는 별도의 만료일이 적용됩니다. 토큰 종류와 등록 토큰을 확인하세요.
워크스페이스 설정과 요금제
Superuser는 서버 접근 정책에서 세션 시간과 토큰 유효 기간의 최대값을 바꿀 수 있습니다. 워크스페이스는 Free, Essentials, Enterprise 요금제 중 하나를 사용합니다. 요금제에 따라 사용량이 제한되거나 확장 기능을 사용할 수 없을 수도 있습니다. 유료 요금제의 현재 제공량은 Alpacon 가격 안내에서 확인하세요. 현재 사용량과 제공량은 요금제와 결제에서 확인하세요.
명령 실행
| 한도 | 값 |
|---|---|
| 명령줄 | 명령줄은 최대 2048자입니다. 명령줄을 줄이거나 스크립트를 검증된 파일로 실행하세요. |
실행 목적(--purpose) | 최대 2000자이며, 이를 넘으면 거부됩니다. 이 명령어를 실행하는 이유를 제한 안에서 작성하세요. |
스크립트 내용(--file) | 내용이 있는 UTF-8 스크립트여야 하며, 최대 65,536바이트(64 KB)입니다. 스크립트를 나누거나 별도 파일에서 데이터를 읽도록 작성하세요. |
| 파일 실행 명령줄 | 인터프리터, 스크립트 경로, 인수를 합쳐 2048자 이내여야 합니다. 경로나 인수를 줄이세요. 큰 입력은 스크립트가 파일에서 읽도록 하세요. |
| 실시간 출력 | 실시간 활동에는 출력의 마지막 16,384자가 표시됩니다. 더 많은 출력을 보려면 저장된 명령어 결과를 여세요. |
| 실행 시간 | 서버에서 명령어를 실행할 수 있는 시간은 최대 30분입니다. 30분 안에 끝나지 않는 작업은 나누어 실행하세요. |
| 포그라운드 대기 | 수신 확인 또는 전달 후 10분 동안 결과가 없으면 포그라운드 exec는 응답 없음으로 판단하고 종료 코드 1로 끝납니다. 서버의 명령어는 최대 30분까지 계속 실행됩니다. 약 10분을 넘길 수 있는 작업에는 --detach와 alpacon exec logs JOB_ID를 쓰세요. |
CLI 상태 대기(ALPACON_EXEC_TIMEOUT) | CLI가 실행 중 상태를 받지 못할 때 기다리는 시간이며 기본값은 30m입니다. 진행 중 상태를 받을 때마다 대기 시간이 다시 시작됩니다. 실행 시간 제한은 아닙니다. CLI가 대기를 끝내도 명령어는 취소되지 않습니다. 다시 제출하기 전에 작업을 확인하세요. |
승인 대기(--wait-approval) | 승인 대기 시간의 기본값은 5분이며 30m 같은 기간을 지정할 수 있습니다. CLI에서 승인을 기다리려면 --wait 또는 --wait-approval을 쓰세요. |
검증된 파일 실행
| 입력 | 제한 |
|---|---|
| 스크립트 내용 | 비어 있지 않은 UTF-8, 최대 65,536바이트(64 KB) |
| 생성된 명령줄 | 인터프리터, 경로, 인수를 합쳐 2048자 |
| 스크립트 경로 | 1024자, 절대 경로 |
| 인터프리터 | 256자, 절대 경로 |
| 각 인수 | 1024자 |
| 인수 개수 | 64개 |
| 제안할 재사용 기간 | 워크스페이스 상한 이내에서 1~366일 |
제출이 거부되면 파일 실행 거부를 참고하세요.
Websh 세션
| 제한 항목 | 적용 내용 |
|---|---|
| 세션 유지 시간 | 기본값은 터미널을 연 시점부터 1일입니다. 개인 설정으로 줄일 수 있으며, 워크스페이스 한도를 넘길 수 없습니다. |
| 공유 링크 만료 시간 | 5~180분이며 기본값은 30분입니다. 링크는 한 번만 사용할 수 있습니다. |
| 이메일 초대 | 한 번에 이메일 주소를 20개까지 입력할 수 있습니다. 중복 입력한 주소도 개수에 포함됩니다. |
| 월간 Websh 사용량과 공유 | 워크스페이스 플랜에 따라 제공 여부와 한도가 달라집니다. |
| 터미널 녹화 재생 | Free에서는 녹화를 재생할 수 없습니다. 아래 안내가 표시되며, 유료 플랜에서는 플랜에 따라 녹화를 볼 수 있습니다. |
Free에서는 터미널 녹화는 Essentials 요금제부터 볼 수 있어요. 안내가 표시됩니다. 플랜별 제공 범위는 플랜과 결제를, 재생 방법은 터미널 녹화를 참고하세요.
키 입력, 터미널 출력, 브라우저 재접속으로는 제한 시간이 초기화되지 않습니다. 작업 세션의 이어하기 탭에서 다시 연결해도 같습니다. 에이전트의 터미널 연결이 다시 맺어질 때만 이 시간이 초기화됩니다. 제한 시간 전이라도 작업 세션이 끝나면 터미널이 종료될 수 있습니다.
Websh 설정에서 세션 유지 시간을 조정하세요. 최소 10분이며 워크스페이스의 Websh 세션 유지 시간을 넘길 수 없습니다. 관리자는 워크스페이스 한도를 10분부터 1일까지 설정할 수 있습니다.
파일 전송
플랜은 파일 하나의 크기가 아니라 한 달 동안 WebFTP로 전송하는 양을 제한합니다. 전송 한도가 있는 플랜에서는 그달의 전송량을 다 쓰면 기간이 초기화될 때까지 새 업로드와 다운로드가 거부되며, 이미 진행 중인 전송은 끝까지 완료됩니다. 남은 전송량은 사용량 페이지에서 확인하세요.