Template app e remix

Disponibilità

Il workflow manifest template e record app è implementato. Può elencare manifest curati operatore, creare nuovo record app da uno, seedare valori ambiente non segreti quando lo store ambiente è configurato e creare record remix pulito da app eleggibile.

L’istanziazione non deploya l’app. Database, bucket e servizi autenticazione dichiarati non sono provisionati automaticamente. Alcuni servizi dichiarati sono essi stessi solo stub, quindi una dichiarazione manifest non è evidenza che una dipendenza esista.

Sfoglia manifest

GET /api/apps/templates?category=web&q=next
GET /api/apps/templates/{template_id}

La gallery è public-read. Un manifest descrive URL Git sorgente, branch, default runtime, schema variabili ambiente e servizi dichiarati. Rivedi repository, revisione corrente, licenza, stato manutenzione e comandi runtime prima d’istanziazione. Un manifest è metadato operatore, non endorsement sicurezza.

Due manifest seed built-in rendono l’API non vuota. I loro repository esterni possono cambiare o sparire e non c’è ancora smoke test automatico per ogni seed.

Istanziare

POST /api/apps/templates/{template_id}/instantiate
Content-Type: application/json
 
{
  "name": "My app",
  "env": {
    "NEXT_PUBLIC_APP_NAME": "My app"
  }
}

La chiamata crea record app privato e restituisce app_id, informazioni sorgente, tipo runtime e servizi dichiarati. Solo chiavi dichiarate dal manifest sono accettate. Campi secret non sono seedati da questa chiamata.

Dopo istanziazione:

1. ispeziona sorgente e impostazioni runtime della nuova app;
2. fornisci segreti tramite Variabili ambiente app;
3. fornisci dipendenze esterne reali tu stesso salvo servizio esplicitamente riportato ready;
4. chiama endpoint deployment; e
5. segui deploy attraverso build, health check e attivazione.

Remix

POST /api/apps/{source_app_id}/remix
Content-Type: application/json
 
{
  "name": "My private remix"
}

Gli owner possono remixare propria app. Un altro utente può remixare solo app pubblica e marcata remixable. La nuova app è privata.

Il remix porta URL sorgente, branch, tipo deploy, porta e lineage. Non copia valori ambiente, segreti, riferimenti database o bucket, binding autenticazione, checkpoint, stato IDE o dati. Non fork né pin repository Git remoto. Se l’owner sorgente cambia o rimuove quel repository dopo, un nuovo deploy può differire o fallire.

Per remix durabile, fork sorgente in repository che controlli, rivedi e pin revisione, aggiorna sorgente nuova app e poi deploy.

Checklist pubblicazione template

Prima di presentare template come utilizzabile:

• conferma repository e licenza;
• pin o registra revisione testata;
• valida install, build, run, porta e comportamento health;
• testa campi ambiente richiesti senza esporre segreti;
• verifica che ogni servizio dichiarato sia davvero disponibile; e
• istanzia, deploy, smoke-test e rimuovi in ambiente pulito.