Saltar a contenido

Crear un Pod personalizado

Un Pod personalizado es el entorno propio de su organización — sus repositorios, cadenas de herramientas de lenguajes, clientes de bases de datos y herramientas — que sus miembros lanzan como cualquier otro Pod. Los Pods personalizados están disponibles únicamente dentro de su organización y pueden limitarse a grupos específicos.

Hay dos formas de crearlo. La mayoría de los equipos comienzan con la Opción A; utilice la Opción B cuando necesite incorporar su propia imagen de software.

Info

Los Pods personalizados son creados y gestionados por los administradores/propietarios de la organización en Centro de Control → Pods. Los miembros solo ven los Pods que usted habilita para ellos.

Opción A — Partir de una base SkyDeck (sin imagen que construir)

Ideal cuando solo desea el Pod de codificación estándar apuntando a su repositorio.

  1. Vaya a Centro de Control → Pods y haga clic en Nuevo Pod.
  2. Elija una imagen base de SkyDeck — por ejemplo, la base de codificación Claude Code (Ubuntu + gh + Claude Code + tailscale + una terminal funcional).
  3. Complete los campos:
  4. Nombre y una descripción/icono opcionales.
  5. Agente — el agente que preinstalar: Claude Code, OpenClaw, Hermes, JupyterLab o Ninguno para usar el suyo. (Un agente gestionado añade un pequeño recargo por hora — el precio mostrado en el pod ya lo incluye.)
  6. Repositorio (opcional) — una URL de git que se clona en /workspace (el volumen duradero) en el primer lanzamiento.
  7. Comando de inicio (opcional) — un comando que se ejecutará cuando el Pod arranque (por ejemplo, instalar dependencias).
  8. Puertos expuestos (opcional) — puertos para cualquier servicio web que ejecute su Pod; el panel del navegador del espacio de trabajo solo puede alcanzar los puertos listados aquí.
  9. Tamaño — el nivel de vCPU / memoria.
  10. Panel predeterminado — abrir en la terminal o el navegador.
  11. Haga clic en Guardar. El Pod se crea para su organización y comienza habilitado.

Opción B — Traer su propia imagen (avanzado)

Ideal cuando su entorno necesita software incorporado (versiones de runtime específicas, paquetes del sistema, herramientas preinstaladas, datos en caché).

  1. Construya una imagen sobre la base SkyDeck para que su Pod herede una terminal funcional y el agente de IA. En su 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

Conserve el shell y `tmux` de la base (construir `FROM` la base SkyDeck los hereda —
   eso es lo que proporciona una terminal funcional). Incluya runtimes de lenguajes,
   clientes de bases de datos y herramientas en la imagen; **mantenga los secretos fuera**
   — se inyectan en el lanzamiento, no se incorporan a la imagen.

  1. Pruébela localmente con Docker, luego publíquela en el registro de contenedores del que SkyDeck extrae imágenes (consulte a su contacto de SkyDeck el registro y las credenciales; añada un secreto de extracción si es privado). Etiquete con una versión o digest explícito — :latest no se acepta; se requiere una etiqueta o un digest @sha256:….

  2. En Centro de Control → Pods → Nuevo Pod, elija Avanzado: imagen personalizada y pegue la referencia de imagen completa (registro/repo:etiqueta o registro/repo@sha256:…). Establezca el agente, los puertos expuestos, el tamaño y el panel predeterminado como en la Opción A, luego haga clic en Guardar.

Hacerlo disponible para sus miembros

Un nuevo Pod personalizado comienza habilitado pero no es visible para nadie hasta que defina quién puede lanzarlo. En la fila del Pod en Centro de Control → Pods:

  • Disponible para todos — cualquier miembro de su organización puede lanzarlo.
  • Por grupo — asigne uno o más grupos/etiquetas para que solo los miembros de esos grupos vean el Pod (el mismo modelo que en Gestionar Herramientas). Un miembro ve un Pod si pertenece a alguno de los grupos asignados.

Los miembros lanzan el Pod desde el Espacio de trabajo GenStudio la próxima vez que abran el catálogo de Pods.

Info

Control de costes. Los Pods acumulan costes de cómputo mientras están en ejecución. Establezca un presupuesto de organización y límites de gasto por usuario o por grupo en la configuración de gasto de Pods, y configure un auto-reposo por inactividad para que los Pods olvidados no sigan generando cargos.

Consejos

  • Fije la versión base que extiende su imagen para que una actualización de la base nunca cambie silenciosamente su Pod; actualícela de forma deliberada.
  • Espacio de trabajo persistente — solo /workspace. El directorio /workspace de un Pod es un volumen duradero y es el único almacenamiento que sobrevive al reposo/reanudación y a las reconexiones; el repositorio configurado se clona ahí. Todo lo demás en el Pod (el directorio de inicio, el resto del sistema de archivos) se restablece desde la imagen al reanudar — indique a los miembros que conserven todo lo que deseen mantener dentro de /workspace.
  • Actualizar un Pod personalizado. Publique una nueva etiqueta de imagen y edite la referencia de imagen del Pod; los miembros usarán la nueva imagen en su próximo lanzamiento.