작업 세션 문제 해결
아래에서 화면이나 CLI에 표시된 메시지를 찾아보세요. 제출 시 거부된 요청, 승인을 기다리는 요청, 만료된 세션은 각각 조치 방법이 다릅니다.
요청이 거부된 경우
제출 전에 요청 폼의 결과 카드와 서버별 계정 안내를 확인하세요. 세션을 시작할 수 없다면 선택한 서버, 계정, 기능을 다시 살펴보세요.
제출에 실패했다면 오류 코드와 메시지에 따라 조치하세요.
| 코드 | 의미 | 조치 |
|---|---|---|
work_session_admission_denied# | "이 워크스페이스 정책이 선택한 서버로는 작업 세션을 열 수 없게 해뒀어요. 관리자에게 규칙 확인을 요청해 주세요." 접근 규칙에서 세션 요청을 거부했습니다. | Superuser에게 이 서버에 적용되는 접근 규칙을 검토해 달라고 요청하세요. |
approval_no_other_approver# | "요청자 말고는 승인할 사람이 없어서 요청이 바로 반려됐어요. 관리자에게 다른 승인자나 자동 승인 규칙을 추가해 달라고 요청해 주세요." 본인 외에 승인할 사람이 필요하지만 아무도 없습니다. | Superuser에게 다른 승인자나 자동 승인 규칙을 추가해 달라고 요청하세요. |
work_session_agent_not_allowed# | "워크스페이스 승인 정책이 이 에이전트를 허용하지 않아요. 허용된 에이전트를 쓰거나, security admin 역할인 사람에게 허용을 요청해 주세요." 요청한 AI 에이전트가 허용되지 않았습니다. | 허용된 에이전트를 사용하거나 security admin에게 이 에이전트를 허용해 달라고 요청하세요. |
work_session_scope_not_allowed# | "이 기능은 작업 세션의 범위에 없거나, 세션 요청자 유형이 쓸 수 없는 기능이에요. 세션 화면에서 범위를 확인해 주세요." 요청 단계에서는 AI 에이전트가 웹 터미널을 요청한 경우에도 표시됩니다. | 에이전트 요청에서 websh를 제외하세요. 명령어 실행에는 command와 alpacon exec를 사용하세요. |
target_account_other_person# | "선택한 서버 중 하나 이상에서 이 계정이 다른 사람에게 연결돼 있어, 이 계정으로는 작업 세션을 열 수 없어요. 본인 계정이나 공유 계정을 선택해 주세요." | 본인 계정이나 공유 계정을 선택하세요. |
work_session_expires_exceeds_max_ttl# | "세션 시간이 최대 허용 시간을 초과해요." | 사용 시간을 줄이거나 Superuser에게 웹 콘솔에서 최대 시간을 늘려 달라고 요청하세요. |
CLI에서도 에이전트가 websh를 요청하면 "websh" is not allowed for agent sessions가 표시됩니다. command를 요청하고 alpacon exec로 명령어를 실행하세요.
승인자가 반려하면 페이지에 “요청이 거절됐어요”와 반려된 시각이 표시되며, 작업이 아직 필요하면 다시 요청하라는 안내가 나옵니다. 사유는 페이지에 표시되지 않으므로 다시 요청하기 전에 승인자에게 문의하세요. 접근 규칙을 참고하세요.
요청이 승인을 기다리는 경우
“승인을 기다리고 있어요”는 세션이 아직 승인 대기 상태라는 뜻입니다. 페이지에는 승인자에게 알린 시각과 “승인되면 바로 작업할 수 있어요.”라는 안내가 표시됩니다. 승인 권한이 있는 사람의 결정을 기다리세요. 시작을 예약한 세션은 시작 시각까지 기다려야 합니다.
CLI에서 work-session create --wait를 실행하면 Waiting for approval...이 표시됩니다. timed out waiting for approval after 5m0s는 CLI가 대기를 멈췄다는 뜻이며, 요청이 반려됐다는 뜻은 아닙니다. 다시 제출하기 전에 세션 상태를 확인하세요. 요청을 생성할 때 --wait-approval DURATION을 지정하면 더 오래 기다릴 수 있습니다.
다음 메시지와 함께 대기가 끝날 수도 있습니다.
| CLI 메시지 | 조치 |
|---|---|
work session was rejected | 승인자에게 사유를 문의하세요. |
work session expired while waiting for approval | 다른 세션을 요청하세요. |
work session was revoked | 다시 접근을 요청하기 전에 관리자에게 문의하세요. |
work session was cancelled | 접근이 필요하면 다시 요청하세요. |
대기 중인 요청을 취소하려면 “요청 취소”를 선택하거나 alpacon work-session cancel을 실행하세요. 요청자 또는 Superuser만 취소할 수 있습니다. 검토 전에 요청이 만료되거나 요청한 종료 시각이 지나도 자동으로 취소됩니다.
작업 중에 세션이 만료된 경우
웹 터미널에는 작업 세션이 만료되어 세션이 끝났어요.가 표시됩니다. API 오류 work_session_expired의 메시지는 작업 세션이 만료돼서 세션으로 받은 권한이 사라졌어요. 계속하려면 새 작업 세션을 시작해 주세요.입니다.
명령어를 실행하면 CLI에 다음 메시지가 표시될 수 있습니다.
Error: the command operation requires an active WorkSession on this authentication.사유는 selected session has expired이며, 종료 코드는 3입니다.
다른 세션을 요청하고 필요한 승인을 받은 뒤 다시 접속하세요. 만료된 세션은 연장할 수 없습니다. 세션의 터미널, 파일 전송, 포트 포워딩, 에디터 연결은 닫히며, 연장 요청이 대기 중이어도 연결이 유지되지는 않습니다. 작업을 계속하기 전에 세션 이력을 확인하세요.
이후에는 만료까지 남은 시간이 10분 이내라는 경고를 받으면 세션이 끝나기 전에 연장을 요청하세요.
CLI에서 세션에 연결할 수 없는 경우
다음 메시지로 진입에 실패한 원인을 구분할 수 있습니다.
| CLI 출력 | 조치 |
|---|---|
work-session <ID> is in '<status>' state and cannot be used | 상태를 확인하고 승인 또는 활성화를 기다리세요. 끝난 세션이라면 다른 세션을 요청하세요. |
work-session <ID> is an agent session and is not workspace-attachable; agent sessions run non-interactively via their assigned token | work-session use나 --use 대신 에이전트 명령어마다 --work-session ID를 지정하세요. |
this CLI runs under an AI agent, and the work session is a user session—create an agent session with 'alpacon work-session create' and pass its ID with --work-session | 에이전트 세션을 생성하고 명령어마다 ID를 지정하세요. |
no WorkSession selected for this shell | 사람의 활성 세션은 alpacon work-session use ID로 진입하세요. 에이전트 세션은 --work-session ID를 지정하세요. |
work_session_required처럼 접근이 거부되면 종료 코드 3을 반환합니다. Websh를 쓰려면 -t 없이 alpacon login으로 사용자 로그인을 해야 합니다. work-session use를 참고하세요.
서버에 계정이 없는 경우
세션 페이지에 “{account} 계정 없음”이나 “본인 계정 없음”이 표시되면 실행할 수 없습니다. 어떤 기능도 실행할 수 없으면 이 세션의 서버와 연결 계정 조합으로는 실행할 수 있는 작업이 없어요. 관리자에게 계정 생성을 요청하거나 연결 계정을 바꿔주세요.가 표시됩니다.
접속할 때 server_username_groupname_invalid 오류가 발생하면 메시지는 username 또는 그룹명이 등록되지 않았거나 권한이 없어요.입니다. exec에 -u를 지정하지 않았다면 CLI에 no execution user was resolved for '<server>' server와 함께 -u USERNAME을 지정하라는 안내가 표시될 수도 있습니다.
접속 계정에서 선택한 계정을 확인하세요. 관리자에게 그 서버에 계정을 만들어 달라고 요청하거나, 세션 페이지의 “접속 계정 변경”에서 다른 계정을 요청하세요. 계정 변경 요청은 승인을 받아야 적용됩니다. -u USERNAME은 실행할 계정을 선택할 뿐이며, 계정을 만들거나 사용 권한을 부여하지 않습니다.
Linux에서는 첫 접속 때 본인 계정이 자동으로 생성될 수 있습니다. macOS와 Windows에서는 자동으로 생성되지 않습니다. 사용자명을 아직 설정하지 않았다면 먼저 설정하고, 관리자에게 서버 계정을 확인해 달라고 요청하세요. 계정 또는 권한 문제를 참고하세요.
연장이 거부된 경우
연장하려면 사유가 필요하며, 세션이 시작됐고 아직 만료되지 않아야 합니다. 요청한 종료 시각도 워크스페이스 한도 이내여야 합니다. 조건을 충족하지 못하면 다음 오류가 표시됩니다.
| 코드 | 의미 | 조치 |
|---|---|---|
work_session_extension_reason_required# | "연장을 요청하려면 사유가 필요해요." | 사유를 입력하세요. CLI에서는 --reason "..."을 지정하세요. |
work_session_extension_already_pending# | "이 세션의 연장 요청이 이미 승인 대기 중이에요. 결정이 나올 때까지 기다려 주세요." | 대기 중인 요청이 처리되거나 만료될 때까지 기다리세요. |
work_session_not_started# | "아직 시작되지 않은 세션은 연장할 수 없어요. 시작 시각이 지난 뒤에 다시 시도해 주세요." | 세션이 시작된 뒤 연장을 요청하세요. |
work_session_expired# | "작업 세션이 만료돼서 세션으로 받은 권한이 사라졌어요. 계속하려면 새 작업 세션을 시작해 주세요." | 다른 세션을 요청하세요. 만료된 세션은 연장할 수 없습니다. |
work_session_not_active# | "이 기능은 활성 세션에서만 가능해요." 세션이 승인 대기 중이거나 이미 끝났습니다. | 승인 대기 중인 세션은 접근이 허용되고 세션이 시작된 뒤에 연장을 요청하세요. 끝난 세션이라면 다른 세션을 요청하세요. |
work_session_expires_exceeds_max_ttl# | "세션 시간이 최대 허용 시간을 초과해요." 연장 요청 시각부터 제안한 종료 시각까지의 시간이 워크스페이스 최대 사용 시간을 초과했습니다. | 더 짧은 사용 시간이나 더 이른 종료 시각을 선택하세요. |
work_session_extend_not_later# | "새 만료 시간은 현재보다 이후여야 해요." | 기존 종료 시각보다 늦은 시각을 선택하세요. |
work_session_admission_denied# | "이 워크스페이스 정책이 선택한 서버로는 작업 세션을 열 수 없게 해뒀어요. 관리자에게 규칙 확인을 요청해 주세요." 검토에 들어가기 전에 접근 규칙에 따라 연장이 거부됐습니다. | Superuser에게 접근 규칙을 검토해 달라고 요청하세요. |
CLI에서는 다음 세 오류에 구체적인 조치 방법을 안내합니다.
| 오류 | CLI 메시지 |
|---|---|
work_session_extension_reason_required | Pass --reason "..." describing why you need more time, and retry. |
work_session_extension_already_pending | Work session <ID> already has an extension request pending approval; wait for it to be decided before asking again. Find its id with 'alpacon work-session describe <ID> --output json' (field pending_extension_request.id). |
work_session_admission_denied | This workspace refuses this extension outright; ask an admin to adjust the work-session admission policy. |
승인 큐에 들어간 연장 요청도 다음과 같은 이유로 적용되지 않을 수 있습니다.
- 승인자가 반려했습니다. 알림 제목은
{target}에 대한 {request_type} 요청이 거절됐어요이며, 요청 유형은작업 세션 연장입니다. 세션 페이지에 사유가 표시되지 않으므로 승인자에게 문의하세요. - 결정 전에 요청이 만료되거나 세션이 끝났습니다. 기존 종료 시각이 유지됩니다. 세션이 만료되지 않았다면 다시 연장을 요청하고, 만료됐다면 다른 세션을 요청하세요.
- 접속 계정이 다른 사람에게 연결됐습니다. 그 계정으로 추가 셸 접속과 명령어 실행이 거부되며 세션도 연장할 수 없습니다. 관리자에게 계정 연결 상태를 확인해 달라고 요청하세요.