맞춤형 Pod 만들기¶

맞춤형 Pod는 조직 고유의 환경입니다 — 자체 리포지토리, 언어 툴체인, 데이터베이스 클라이언트, 도구를 포함하며, 멤버들이 다른 Pod와 동일하게 실행할 수 있습니다. 맞춤형 Pods는 조직 내에서만 사용 가능하며 특정 그룹으로 제한할 수 있습니다.

만드는 방법은 두 가지입니다. 대부분의 팀은 옵션 A로 시작합니다. 자체 소프트웨어 이미지를 포함해야 하는 경우에는 옵션 B를 사용하십시오.

Info

맞춤형 Pods는 컨트롤 센터 → Pods에서 조직의 관리자/소유자가 생성하고 관리합니다. 멤버는 관리자가 활성화한 Pods만 볼 수 있습니다.

옵션 A — SkyDeck 기반에서 시작 (이미지 빌드 불필요)¶

표준 코딩 Pod를 자체 리포지토리에 연결하기만 하면 될 때 가장 적합합니다.

컨트롤 센터 → Pods로 이동하여 새 Pod를 클릭합니다.
SkyDeck 기본 이미지를 선택합니다 — 예: Claude Code 코딩 기반 (Ubuntu + gh + Claude Code + tailscale + 작동하는 터미널).
다음 항목을 입력합니다:
이름 및 선택적 설명/아이콘.
에이전트 — 사전 설치할 에이전트: Claude Code, OpenClaw, Hermes, JupyterLab, 또는 자체 에이전트를 사용하려면 없음. (관리형 에이전트는 소액의 시간당 추가 요금이 발생하며, Pod에 표시된 요금에 포함되어 있습니다.)
리포지토리 (선택 사항) — 첫 번째 실행 시 /workspace(영구 볼륨)에 클론할 git URL.
시작 명령어 (선택 사항) — Pod 시작 시 실행할 명령어 (예: 의존성 설치).
노출 포트 (선택 사항) — Pod에서 실행하는 웹 서비스용 포트. 워크스페이스 브라우저 창은 여기에 나열된 포트에만 접근할 수 있습니다.
크기 — vCPU / 메모리 티어.
기본 창 — 터미널 또는 브라우저로 열기.
저장을 클릭합니다. Pod가 조직을 위해 생성되고 활성화된 상태로 시작됩니다.

옵션 B — 자체 이미지 사용 (고급)¶

특정 런타임 버전, 시스템 패키지, 사전 설치된 도구, 캐시된 데이터 등 소프트웨어가 포함된 환경이 필요한 경우에 가장 적합합니다.

SkyDeck 기반 위에 이미지를 빌드하여 Pod가 작동하는 터미널과 AI 에이전트를 상속하도록 합니다. Dockerfile에서:

FROM <skydeck-coding-base-image>     # ask your SkyDeck contact for the reference
# add your repos, language toolchains, DB clients, project tools…
RUN apt-get update && apt-get install -y --no-install-recommends <your-packages>

!!! warning

기반의 셸과 `tmux`를 유지하십시오 (SkyDeck 기반으로부터 `FROM`으로 빌드하면 이를
   상속합니다 — 작동하는 터미널을 제공하는 것이 바로 이것입니다). 언어 런타임, 데이터베이스
   클라이언트, 도구는 이미지에 포함하십시오. **시크릿은 포함하지 마십시오** — 시크릿은
   이미지에 포함되지 않고 실행 시 주입됩니다.

Docker로 로컬 테스트를 진행한 후, SkyDeck이 가져오는 컨테이너 레지스트리에 푸시합니다 (레지스트리와 자격 증명은 SkyDeck 담당자에게 문의하십시오. 비공개 레지스트리인 경우 pull 시크릿을 추가하십시오). 명시적인 버전 또는 다이제스트로 태그를 지정하십시오 — :latest는 허용되지 않습니다. 태그 또는 @sha256:… 다이제스트가 필수입니다.
컨트롤 센터 → Pods → 새 Pod에서 고급: 맞춤형 이미지를 선택하고 전체 이미지 참조(레지스트리/리포지토리:태그 또는 레지스트리/리포지토리@sha256:…)를 붙여넣습니다. 옵션 A와 동일하게 에이전트, 노출 포트, 크기, 기본 창을 설정한 후 저장을 클릭합니다.

멤버가 사용할 수 있도록 설정하기¶

새로운 맞춤형 Pod는 활성화된 상태로 시작되지만, 실행 권한을 부여받은 사람을 설정할 때까지 누구에게도 표시되지 않습니다. 컨트롤 센터 → Pods에서 Pod 행에서:

모두에게 공개 — 조직의 모든 멤버가 실행할 수 있습니다.
그룹별 — 하나 이상의 그룹 / 태그를 지정하여 해당 그룹의 멤버만 Pod를 볼 수 있도록 합니다 (도구 관리와 동일한 방식입니다). 멤버는 지정된 그룹 중 하나에 속해 있으면 Pod를 볼 수 있습니다.

멤버는 다음에 Pod 카탈로그를 열 때 GenStudio 워크스페이스에서 Pod를 실행합니다.

Info

비용 관리. Pods는 실행 중에 컴퓨팅 비용이 발생합니다. Pods 지출 설정에서 조직 예산과 사용자 또는 그룹별 지출 한도를 설정하고, 방치된 Pods가 계속 청구되지 않도록 유휴 자동 절전 기능을 설정하십시오.

팁¶

기반 버전을 고정하십시오. 이미지가 확장하는 기반 버전을 고정하면 기반 업데이트로 인해 Pod가 의도치 않게 변경되는 것을 방지할 수 있습니다. 의도적으로 업그레이드하십시오.
영구 워크스페이스 — /workspace만 해당. Pod의 /workspace는 영구 볼륨이며 절전/재개 및 재연결 후에도 유지되는 유일한 저장소입니다. 구성된 리포지토리는 그곳에 클론됩니다. Pod 내의 그 외 모든 것(홈 디렉터리, 파일 시스템의 나머지 부분)은 재개 시 이미지에서 재설정됩니다 — 보관하려는 모든 것은 /workspace 아래에 두도록 멤버에게 안내하십시오.
맞춤형 Pod 업데이트. 새 이미지 태그를 푸시하고 Pod의 이미지 참조를 편집하십시오. 멤버들은 다음 실행 시 새 이미지를 사용하게 됩니다.