Project

Usa questa pagina per consultare workspace, sandbox e comandi di integrazione continua del progetto.

Il manifest Project: l'involucro (apiVersion, kind, metadata; vedi Manifest) più spec.

Campi

ProjectSpec (spec)

Campo	Tipo	Predefinito	Significato
workspace	Workspace	required	Dove lavorano gli agenti.
sandbox	Sandbox or null	null	Il container in cui girano i loro comandi, quando ne eseguono.
ci	CI or null	null	Come si costruisce e si testa il progetto.

Workspace (spec.workspace)

Campo	Tipo	Predefinito	Significato
type	folder or git	required	folder per un percorso su questa macchina, git per un repository.
path	str or null	null	folder: il percorso in cui lavorano gli agenti.
url	str or null	null	git: l'URL del repository da clonare.
defaultBranch	str	main	git: il branch da cui parte un nuovo worktree.
forge	none or github	none	Quale forge ospita le pull request del progetto.
forgeUrl	str or null	null	L'URL della forge, per un'istanza self-hosted.
tokenEnv	str or null	null	La variabile d'ambiente che contiene il token della forge.

Sandbox (spec.sandbox)

Campo	Tipo	Predefinito	Significato
image	str	required	L'immagine del container da avviare.
cpus	float	2.0	Quante CPU può usare la sandbox.
memory	str	2g	Il limite di memoria della sandbox, come lo scrive Docker.
timeout	int	300	Secondi che un comando può girare prima di essere ucciso.
egress	list[str]	[]	Host che la sandbox può raggiungere; vuoto significa nessuna rete.
env	list[str]	[]	Nomi di variabili d'ambiente che la sandbox riceve; Docker li legge dal worker, Kubernetes da envSecret.

CI (spec.ci)

Campo	Tipo	Predefinito	Significato
script	str	required	Il comando che costruisce e testa il progetto.
test	str or null	null	Il comando dietro il tool ws.test; se assente vale script.

Vedi anche

• Tool built-in per l'accesso ai tool workspace.
• Runtime per i default della sandbox.