Maler og remix

Tilgjengelighet

Manifest- og app-record-workflow for maler er implementert. Den kan liste operatør-kurerte manifester, opprette en ny app-record fra et manifest, seede ikke-hemmelige miljøverdier når environment store er konfigurert, og opprette en ren remix-record fra en kvalifisert app.

Instansiering deployer ikke appen. Deklarerte databaser, buckets og autentiseringstjenester provisioneres ikke automatisk. Noen deklarerte tjenester er selv stub-only, så en oppføring i manifestet beviser ikke at en avhengighet finnes.

Bla gjennom manifester

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

Galleriet er public-read. Et manifest beskriver source Git URL, branch, runtime-defaults, skjema for miljøvariabler og deklarerte tjenester. Gå gjennom repository, gjeldende revisjon, lisens, vedlikeholdsstatus og runtime-kommandoer før instansiering. Et manifest er operatør-metadata, ikke en sikkerhetsanbefaling.

To innebygde seed-manifester gjør at API-et ikke er tomt. Deres eksterne repositories kan endres eller forsvinne, og det finnes ennå ikke automatisert smoke test for hvert seed.

Instansier

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

Kallet oppretter en private app-record og returnerer app_id, source information, runtime type og deklarerte tjenester. Bare nøkler deklarert i manifestet aksepteres. Secret fields seedes ikke av dette kallet.

Etter instansiering:

1. inspiser den nye appens source og runtime-innstillinger;
2. lever secrets via App-hemmeligheter og miljøvariabler;
3. skaff reelle eksterne avhengigheter selv med mindre en tjeneste eksplisitt rapporteres som ready;
4. kall deployment-endpoint; og
5. følg deployment gjennom build, health check og activation.

Remix

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

Eiere kan remixe egen app. En annen bruker kan bare remixe en app som både er public og markert remixable. Den nye appen er private.

Remixen bærer source URL, branch, deployment type, port og lineage. Den kopierer bevisst ikke miljøverdier, secrets, database- eller bucket-referanser, autentiseringsbindinger, checkpoints, IDE-state eller data. Den forked eller pinner heller ikke remote Git-repository. Hvis source-eieren senere endrer eller fjerner det repository, kan en ny deployment avvike eller feile.

For en varig remix: fork source til et repository du kontrollerer, gå gjennom og pin en revisjon, oppdater den nye appens source, og deploy deretter.

Publiseringscheckliste for en mal

Før du presenterer en mal som brukbar:

• bekreft repository og lisens;
• pin eller registrer en testet revisjon;
• valider install, build, run, port og health-atferd;
• test påkrevde miljøfelter uten å avsløre secrets;
• verifiser at hver deklarert tjeneste faktisk er tilgjengelig; og
• instansier, deploy, kjør smoke test og fjern i et rent miljø.