Mallar och remix

Tillgänglighet

Manifest- och app-record-workflow för mallar är implementerat. Det kan lista operatörskurerade manifest, skapa ett nytt app-record från ett manifest, fylla i icke-hemliga miljövärden när environment store är konfigurerad, och skapa ett rent remix-record från en behörig app.

Instansiering deployar inte appen. Deklarerade databaser, buckets och autentiseringstjänster provisioneras inte automatiskt. Vissa deklarerade tjänster är i sig stub-only, så en rad i manifestet visar inte att ett beroende finns.

Bläddra bland manifest

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

Galleriet är public-read. Ett manifest beskriver source Git URL, branch, runtime-defaults, schema för miljövariabler och deklarerade tjänster. Granska repository, aktuell revision, licens, underhållsstatus och runtime-kommandon före instansiering. Ett manifest är operatörens metadata, inte ett säkerhetsintyg.

Två inbyggda seed-manifest gör att API:et inte är tomt. Deras externa repositories kan ändras eller försvinna, och det finns ännu inget automatiserat smoke test för varje seed.

Instansiera

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

Anropet skapar ett private app-record och returnerar app_id, source information, runtime type och deklarerade tjänster. Endast nycklar som manifestet deklarerar accepteras. Secret fields fylls inte i av detta anrop.

Efter instansiering:

1. granska nya appens source och runtime-inställningar;
2. tillhandahåll secrets via Apphemligheter och miljövariabler;
3. ordna riktiga externa beroenden själv om inte en tjänst uttryckligen rapporteras som ready;
4. anropa deployment-endpoint; och
5. följ deployment genom build, health check och activation.

Remix

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

Ägare får remixa sin egen app. En annan användare får bara remixa en app som både är public och markerad remixable. Den nya appen är private.

Remixen bär source URL, branch, deployment type, port och lineage. Den kopierar medvetet inte miljövärden, secrets, databas- eller bucket-referenser, autentiseringsbindningar, checkpoints, IDE-state eller data. Den forkar eller pinnar inte heller remote Git-repository. Om source-ägaren senare ändrar eller tar bort det repository kan en ny deployment skilja sig eller misslyckas.

För en hållbar remix: forka source till ett repository du kontrollerar, granska och pinna en revision, uppdatera nya appens source och deploya sedan.

Publiceringschecklista för en mall

Innan du presenterar en mall som användbar:

• bekräfta repository och licens;
• pinna eller registrera en testad revision;
• validera install, build, run, port och health-beteende;
• testa obligatoriska miljöfält utan att exponera secrets;
• verifiera att varje deklarerad tjänst faktiskt är tillgänglig; och
• instansiera, deploya, kör smoke test och ta bort i en ren miljö.