세션 요청하기
서버에서 작업하려면 필요한 내용을 담아 세션을 요청합니다. 제출하면 접근이 허용되기 전에 워크스페이스 관리자가 요청을 검토합니다.
요청 시작하기
두 가지 방법으로 요청을 시작할 수 있습니다.
- 서버에서: 서버 카드나 서버 상세 페이지에서 연결을 클릭합니다. 해당 서버가 요청 폼에 미리 선택됩니다.
- Sessions 페이지에서: 사이드바의 Access에서 Sessions를 열고 새 세션을 클릭합니다.
어느 방법이든 요청 폼으로 이동합니다.
요청 작성하기
폼은 다음 단계로 진행됩니다.
1. 담당자 (슈퍼유저 전용)
기본적으로 세션은 본인을 위해 요청됩니다. 슈퍼유저는 다른 사용자에게 세션을 지정할 수 있습니다.
2. 세션에서 접근할 서버
작업할 서버를 선택합니다. 커미션되고 온라인 상태인 서버만 추가할 수 있습니다. 서버 선택에서 검색해 필요에 따라 추가하거나 제거하세요. 최소 한 대 이상이 필요합니다.
참고: 서버의 연결 버튼으로 시작했다면 해당 서버가 이미 선택되어 있습니다.
3. 세션 사용 목적
접근이 필요한 이유를 작성합니다. 목적은 필수이며 Markdown을 지원하고, 최대 2,048자까지 입력할 수 있습니다.
서버를 선택한 경우 생성을 클릭하면 Alpacon이 목적 초안을 작성하고 서버에 맞는 기능을 추천해 줍니다. 결과를 수정하거나 원래대로를 클릭해 되돌릴 수 있습니다.
4. 세션에서 사용할 기능
웹 터미널, 파일 전송, 명령 실행, 포트 포워딩, 코드 에디터, 권한 상승 등 필요한 기능을 선택합니다. 최소 하나 이상 선택하세요. 웹 터미널, 파일 전송, 명령 실행, 권한 상승은 기본으로 선택되어 있으며, 작업에 맞게 조정하면 됩니다.
각 기능에는 사용 방식 배지가 표시됩니다.
- 사용자용 (웹 인터페이스 · 사용자에 적합): 브라우저에서 실행됩니다.
- 에이전트용 (CLI · 에이전트에 적합): 세션에 진입한 뒤 Alpacon CLI에서 사용합니다.
참고: 코드 에디터와 포트 포워딩 기능은 서버 소유자가 해당 서버에서 먼저 활성화해야 합니다. 에디터·터널 활성화를 참고하세요.
5. 세션 사용 시간
세션을 사용할 수 있는 시간을 설정합니다.
- 프리셋: 1시간, 2시간, 4시간. 세션이 언제 종료되는지 미리보기가 표시됩니다.
- 직접 설정: 직접 설정으로 전환해 시작 시점(지금 또는 예약)과 시간·분 단위 길이를 설정합니다.
워크스페이스는 허용 최대 시간(기본 4시간)을 정하며, 이는 사용 시간 입력란 아래에 표시됩니다. 그보다 긴 세션은 요청할 수 없습니다.
제출하기
세션 요청을 클릭합니다. 세션이 승인 대기 상태로 생성되고 상세 페이지로 이동합니다.
이후 진행
- 요청은 관리자 승인을 기다립니다. 대기 중에는 기능과 서버가 사용 요청된 상태로 표시되며 아직 사용할 수 없습니다.
- 대기 중에는 요청을 취소할 수 있습니다.
- 승인되면 세션은 시작 시각에 활성 상태가 되며, 그전까지는 승인됨 상태로 표시됩니다. 활성 상태가 되면 기능을 실행할 수 있습니다. 세션 사용하기를 참고하세요.
참고: 슈퍼유저는 별도 승인이 필요 없습니다. 본인이 요청한 세션은 자동으로 승인되어 바로 사용할 수 있습니다.
CLI에서 요청하기
Alpacon CLI의 alpacon work-session create로도 세션을 요청할 수 있습니다. 스크립트나 AI 에이전트에 유용합니다.
$ alpacon work-session create --purpose "nginx fix" --scope command,websh --server web-01 --expires-in 2h주요 플래그:
--purpose: 접근이 필요한 이유(필수).--scope: 요청할 기능:command,editor,sudo,tunnel,webftp,websh(쉼표로 구분).--server: 대상 서버 이름(쉼표로 구분).--expires-in/--expires-at: 사용 시간(1h,2h,4h) 또는 절대 시각.--wait: 요청이 승인될 때까지 대기.--use: 생성한 세션을 활성 세션으로 지정해 이후exec,websh,cp,tunnel명령이 자동으로 이 세션에 연결되게 함. 승인이 필요한 경우--wait와 함께 사용.--sudo: 비대화형 호출자가 MFA 프롬프트 없이 실행할 sudo 명령 패턴을 사전 선언(sudo기능이 추가됨).
수명 주기는 동일합니다. 세션은 승인 대기 상태로 시작해 승인되면 사용할 수 있습니다. 나중에 승인된 세션에 진입하려면 alpacon work-session use를 사용하세요. 자세한 내용은 세션 사용하기를 참고하세요. 전체 명령과 플래그 설명은 alpacon work-session CLI 레퍼런스에서 확인할 수 있습니다.