Vai al contenuto

Crea un Pod personalizzato

Un Pod personalizzato è l'ambiente proprio della vostra organizzazione — i vostri repository, le toolchain dei linguaggi, i client dei database e gli strumenti — che i vostri membri avviano come qualsiasi altro Pod. I Pods personalizzati sono disponibili esclusivamente all'interno della vostra organizzazione e possono essere limitati a gruppi specifici.

Esistono due modi per crearne uno. La maggior parte dei team inizia con l'Opzione A; usate l'Opzione B quando avete bisogno di incorporare la vostra immagine software.

Info

I Pods personalizzati vengono creati e gestiti dagli amministratori/proprietari dell'organizzazione in Centro di Controllo → Pods. I membri vedono solo i Pods che voi abilitate per loro.

Opzione A — Partire da una base SkyDeck (nessuna immagine da costruire)

Ideale quando volete semplicemente il Pod di codifica standard puntato al vostro repository.

  1. Andate in Centro di Controllo → Pods e fate clic su Nuovo Pod.
  2. Scegliete un'immagine base SkyDeck — ad esempio la base di codifica Claude Code (Ubuntu + gh + Claude Code + tailscale + un terminale funzionante).
  3. Compilate i campi:
  4. Nome e una descrizione/icona opzionale.
  5. Agente — l'agente da preinstallare: Claude Code, OpenClaw, Hermes, JupyterLab o Nessuno per usare il vostro. (Un agente gestito aggiunge un piccolo sovrapprezzo orario — il prezzo mostrato sul Pod lo include.)
  6. Repository (opzionale) — un URL git da clonare in /workspace (il volume durevole) al primo avvio.
  7. Comando di avvio (opzionale) — un comando da eseguire all'avvio del Pod (ad esempio, installare le dipendenze).
  8. Porte esposte (opzionale) — le porte per qualsiasi servizio web eseguito dal vostro Pod; il pannello del browser dell'area di lavoro può raggiungere solo le porte elencate qui.
  9. Dimensione — il livello di vCPU / memoria.
  10. Pannello predefinito — aprire il terminale o il browser.
  11. Fate clic su Salva. Il Pod viene creato per la vostra organizzazione e parte abilitato.

Opzione B — Portare la propria immagine (avanzato)

Ideale quando il vostro ambiente necessita di software preinstallato (versioni specifiche di runtime, pacchetti di sistema, strumenti preinstallati, dati in cache).

  1. Costruite un'immagine sopra la base SkyDeck in modo che il vostro Pod erediti un terminale funzionante e l'agente AI. Nel vostro 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

Conservate la shell e `tmux` della base (costruire `FROM` la base SkyDeck li eredita —
   è questo che fornisce un terminale funzionante). Mettete i runtime dei linguaggi, i
   client dei database e gli strumenti nell'immagine; **tenete i segreti fuori** — vengono
   iniettati all'avvio, non incorporati nell'immagine.

  1. Testatela localmente con Docker, poi pubblicatela nel registro di container da cui SkyDeck estrae le immagini (chiedete al vostro contatto SkyDeck il registro e le credenziali; aggiungete un pull secret se è privato). Etichettate con una versione o digest esplicito — :latest non è accettato; un'etichetta o un digest @sha256:… è obbligatorio.

  2. In Centro di Controllo → Pods → Nuovo Pod, scegliete Avanzato: immagine personalizzata e incollate il riferimento completo dell'immagine (registro/repo:etichetta o registro/repo@sha256:…). Impostate l'agente, le porte esposte, la dimensione e il pannello predefinito come nell'Opzione A, poi fate clic su Salva.

Renderlo disponibile per i vostri membri

Un nuovo Pod personalizzato parte abilitato ma non è visibile a nessuno finché non definite chi può avviarlo. Sulla riga del Pod in Centro di Controllo → Pods:

  • Disponibile per tutti — ogni membro della vostra organizzazione può avviarlo.
  • Per gruppo — assegnate uno o più gruppi/tag in modo che solo i membri di quei gruppi vedano il Pod (lo stesso modello di Gestisci Strumenti). Un membro vede un Pod se appartiene a uno qualsiasi dei gruppi assegnati.

I membri avviano il Pod dallo Spazio di lavoro GenStudio la prossima volta che aprono il catalogo dei Pods.

Info

Controllo dei costi. I Pods accumulano costi di calcolo mentre sono in esecuzione. Impostate un budget dell'organizzazione e limiti di spesa per utente o per gruppo nelle impostazioni di spesa dei Pods, e un auto-sleep per inattività in modo che i Pods dimenticati non continuino a fatturare.

Suggerimenti

  • Fissate la versione base che la vostra immagine estende in modo che un aggiornamento della base non modifichi mai silenziosamente il vostro Pod; aggiornatela deliberatamente.
  • Area di lavoro persistente — solo /workspace. La /workspace di un Pod è un volume durevole ed è l'unico archivio che sopravvive allo sleep/ripresa e alle riconnessioni; il repository configurato viene clonato lì. Tutto il resto nel Pod (la home directory, il resto del file system) viene reimpostato dall'immagine alla ripresa — dite ai membri di conservare tutto ciò che desiderano mantenere sotto /workspace.
  • Aggiornare un Pod personalizzato. Pubblicate una nuova etichetta di immagine e modificate il riferimento all'immagine del Pod; i membri utilizzeranno la nuova immagine al loro prossimo avvio.