Skabeloner og remix

Tilgængelighed

Manifest- og app-record-workflow for skabeloner er implementeret. Det kan liste operatør-kurerede manifester, oprette en ny app-record fra et manifest, seede ikke-hemmelige miljøværdier når environment store er konfigureret, og oprette en ren remix-record fra en berettiget app.

Instansiering deployer ikke appen. Deklarerede databaser, buckets og autentificeringstjenester provisioneres ikke automatisk. Nogle deklarerede tjenester er selv stub-only, så en angivelse i manifestet beviser ikke, at en afhængighed findes.

Gennemse 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, skema for miljøvariabler og deklarerede tjenester. Gennemgå repository, aktuel revision, licens, vedligeholdelsestilstand og runtime-kommandoer før instansiering. Et manifest er operatør-metadata, ikke en sikkerhedsanbefaling.

To indbyggede seed-manifester gør API’et ikke-tomt. Deres eksterne repositories kan ændre sig eller forsvinde, og der findes endnu ikke et automatiseret 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"
  }
}

Kaldet opretter en private app-record og returnerer app_id, source information, runtime type og deklarerede tjenester. Kun nøgler deklareret af manifestet accepteres. Secret fields seedes ikke af dette kald.

Efter instansiering:

gennemgå den nye apps source og runtime-indstillinger;
lever secrets via App-hemmeligheder og miljøvariabler;
skaf rigtige eksterne afhængigheder selv, medmindre en tjeneste eksplicit rapporteres som ready;
kald deployment-endpoint; og
følg deployment gennem build, health check og activation.

Remix


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

Ejere må remixe deres egen app. En anden bruger må kun remixe en app, der både er public og markeret remixable. Den nye app er private.

Remixen bærer source URL, branch, deployment type, port og lineage. Den kopierer bevidst ikke miljøværdier, secrets, database- eller bucket-referencer, autentificeringsbindinger, checkpoints, IDE-state eller data. Den forked eller pinner heller ikke remote Git-repository. Hvis source-ejeren senere ændrer eller fjerner det repository, kan en ny deployment afvige eller fejle.

For en holdbar remix: fork source til et repository du kontrollerer, gennemgå og pin en revision, opdater den nye apps source, og deploy derefter.

Publiceringscheckliste for en skabelon

Før du præsenterer en skabelon som brugbar:

bekræft repository og licens;
pin eller registrer en testet revision;
valider install, build, run, port og health-adfærd;
test påkrævede miljøfelter uden at afsløre secrets;
verificer at hver deklareret tjeneste faktisk er tilgængelig; og
instansier, deploy, kør smoke test og fjern i et rent miljø.