콘텐츠로 이동

Pods

Pods는 멤버가 워크스페이스에서 실행하는 온디맨드 격리형 클라우드 개발 환경입니다 — 실제 터미널, AI 코딩 에이전트(Claude Code), 그리고 필요한 도구가 사전 설치된 완전한 Linux 머신입니다. 각 Pod는 자체 보안 샌드박스에서 실행되고, 연결이 끊겨도 계속 실행되며, 세션 간에 워크스페이스가 유지됩니다.

조직 관리자로서 멤버가 실행할 수 있는 Pod를 결정하고, 자신의 스택에 맞춘 맞춤형 Pod를 추가할 수 있습니다.

Control Center의 Agentic Pods — 제공 설정, 커스텀 Pod, 지출 한도, 배포.
Control Center의 Agentic Pods — 제공 설정, 커스텀 Pod, 지출 한도, 배포.

두 가지 유형의 Pod

  • 시스템 Pod — SkyDeck이 제공하고 유지 관리하며, 모든 조직에서 사용 가능합니다. 대표적인 것은 Claude Code입니다: GitHub CLI, Claude Code(claude), tailscale, 영구 /workspace 볼륨, tmux 터미널을 갖춘 코딩 Pod입니다. 시스템 Pod를 멤버에게 공개할지, 누구에게 공개할지 선택할 수 있습니다.
  • 맞춤형 Pod — 조직에서 직접 구축합니다(자체 리포지토리, 툴체인, 도구가 포함된 이미지, 또는 SkyDeck 베이스에 클론할 리포지토리를 추가한 것). 맞춤형 Pod는 조직 내에서만 사용 가능하며 특정 그룹으로 범위를 제한할 수 있습니다.

Pod 내부 구성

모든 코딩 Pod는 SkyDeck 베이스에서 시작하므로 항상 작동하는 터미널을 갖추고 있습니다:

  • git, tmux, 인터랙티브 셸이 포함된 Ubuntu Linux
  • GitHub CLI(gh)
  • Claude Code(claude) — claude로 에이전트 시작, claude update로 업데이트
  • 보안 네트워킹을 위한 tailscale
  • 리포지토리와 작업 내용이 위치하는 영구 /workspace 디렉터리(영구 볼륨) — 절전/재개 및 재연결 후에도 유지됩니다

영속성: /workspace는 영구 볼륨입니다. Pod에 구성된 리포지토리는 /workspace에 클론되며(~/git-local이 이곳을 가리킵니다), 보존하려는 모든 것은 그곳에 있어야 합니다. Claude Code Pod에서는 에이전트 자체의 상태 — ~/.claude, 로그인, 설정, 메모리 — 도 영구 볼륨에 보관되므로 에이전트가 절전/재개 후에도 유지됩니다. 그 외의 파일(홈 디렉터리의 나머지, 파일 시스템의 나머지 부분)은 재개 시 이미지에서 재설정되므로 저장 용도로 의존하지 마십시오.

맞춤형 Pod는 이 베이스 위에 프로젝트 리포지토리, 언어 런타임, 데이터베이스 클라이언트, 도구를 추가합니다.

멤버의 Pod 사용 방법

GenStudio 워크스페이스에서 멤버는 Pod 카탈로그(관리자가 사용 가능하게 한 Pod 목록)를 열고, Pod를 실행하여 라이브 터미널을 얻습니다 — Pod가 실행하는 웹 서비스가 있는 경우 브라우저 창도 함께 제공됩니다. Pod는 연결이 끊겨도 계속 실행되고 워크스페이스 볼륨이 유지되므로, 장시간 작업이 재연결 후에도 이어집니다. 멤버는 다른 멤버와 Pod를 공유하여 — 읽기-쓰기 또는 읽기 전용으로 — 하나의 세션을 함께 운영할 수도 있습니다.

멤버용 안내서는 GenStudio의 Pods입니다. 팀이 이를 활용하는 방법은 에이전트를 24시간 실행하기, 에이전트를 함께 운영하기, 팀 전체에 에이전트 배포하기 활용 사례를 참조하세요.

역할별 권한

작업 담당자
멤버가 실행할 수 있는 Pod와 대상 관리 조직 관리자 / 소유자
맞춤형 Pod 생성 조직 관리자 / 소유자
사용 가능한 Pod 실행 멤버

관리자는 컨트롤 센터 → Pods 페이지에서 Pod를 관리합니다. 자체 환경을 구축하려면 맞춤형 Pod 만들기를 참조하세요.

지출 관리

Pod는 실행 중에는 시간당 컴퓨팅 비용(요금은 Pod 크기에 따라 다르며, 관리형 에이전트에 대한 추가 요금이 더해집니다 — 각 Pod의 시간당 요금은 페이지에 표시됩니다)이, 절전 중에는 스토리지 비용만 부과됩니다. Pods 페이지에는 조직의 가드레일이 담겨 있습니다:

  • 월별 예산 — 조직 전체의 Pod 예산과, 이(또는 멤버 한도)에 도달했을 때의 초과 동작입니다: 새 실행 차단, 경고 후 허용, 또는 허용(추적만)입니다. 초과는 새 실행에 영향을 미치며, 이미 실행 중인 Pod는 계속 실행됩니다.
  • 멤버별 한도 — 멤버당 기본 월별 한도이며, 특정 그룹에 다른 한도를 부여하는 그룹별 한도를 설정할 수 있습니다.
  • 멤버당 동시 실행 Pod — 한 멤버가 동시에 실행할 수 있는 Pod 수입니다.
  • 유휴 자동 절전 — 이 시간(분) 동안 활동이 없는 Pod는 자동으로 절전됩니다(기본 20분, 터미널 활동을 기준으로 합니다). 상시 실행 에이전트를 운영하는 팀의 경우 이 값을 늘리거나 사용 안 함으로 설정하고, 대신 예산과 한도로 지출을 제한하십시오.

실행 중인 Pod 관리

동일한 페이지에는 조직의 Pod 활동이 나열됩니다 — 예산 대비 이번 달 지출과 모든 멤버 Pod입니다 — 그리고 관리자가 조직 내 모든 Pod를 절전, 중지, 또는 삭제할 수 있습니다(예: 주말 내내 실행된 채로 남아 있는 Pod). 멤버는 절전 후에도 /workspace 데이터를 유지하므로, 잊혀진 Pod를 절전 상태로 두는 것은 안전합니다.