Sjablonen en remix

Beschikbaarheid

De template-manifest- en app-recordworkflow is geïmplementeerd. Hij kan door operators samengestelde manifesten tonen, vanuit zo’n manifest een nieuw app-record aanmaken, niet-geheime omgevingswaarden invullen wanneer de environment store is geconfigureerd, en vanuit een geschikte app een schoon remix-record aanmaken.

Instantiatie implementeert de app niet. Gedeclareerde databases, buckets en authenticatiediensten worden niet automatisch aangelegd. Sommige gedeclareerde diensten zijn zelf stub-only, dus een vermelding in het manifest bewijst niet dat een dependency bestaat.

Manifesten doorzoeken

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

De galerij is public-read. Een manifest beschrijft een bron-Git-URL, branch, runtime-defaults, schema voor omgevingsvariabelen en gedeclareerde diensten. Controleer repository, huidige revisie, licentie, onderhoudsstatus en runtime-commando’s vóór instantiatie. Een manifest is metadata van de operator, geen beveiligingsgoedkeuring.

Twee ingebouwde seed-manifesten zorgen dat de API niet leeg is. De externe repositories kunnen wijzigen of verdwijnen, en er is nog geen geautomatiseerde smoke test voor elke seed.

Instantiatie

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

De call maakt een private app-record aan en geeft app_id, broninformatie, runtime type en gedeclareerde diensten terug. Alleen keys die het manifest declareert worden geaccepteerd. Secret fields worden door deze call niet ingevuld.

Na instantiatie:

1. controleer de source en runtime-instellingen van de nieuwe app;
2. lever secrets aan via App-geheimen en omgevingsvariabelen;
3. regel echte externe dependencies zelf, tenzij een dienst expliciet als ready wordt gerapporteerd;
4. roep het deployment-endpoint aan; en
5. volg de deployment via build, health check en activation.

Remix

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

Eigenaren mogen hun eigen app remixen. Een andere gebruiker mag alleen een app remixen die zowel public is als als remixable is gemarkeerd. De nieuwe app is private.

De remix neemt source URL, branch, deployment type, port en lineage over. Hij kopieert bewust geen omgevingswaarden, secrets, database- of bucket-referenties, authenticatiebindings, checkpoints, IDE-state of data. Hij forked of pindt ook niet de remote Git-repository. Als de eigenaar van de bron die repository later wijzigt of verwijdert, kan een nieuwe deployment afwijken of mislukken.

Voor een duurzame remix: fork de bron naar een repository die u beheert, controleer en pin een revisie, werk de source van de nieuwe app bij en deploy daarna.

Publicatiechecklist voor een template

Voordat u een template als bruikbaar presenteert:

• bevestig repository en licentie;
• pin of noteer een geteste revisie;
• valideer install-, build-, run-, port- en health-gedrag;
• test verplichte omgevingsvelden zonder secrets bloot te leggen;
• controleer dat elke gedeclareerde dienst echt beschikbaar is; en
• instantieer, deploy, voer een smoke test uit en verwijder het in een schone omgeving.