Šablony aplikací a remixy

Dostupnost

Workflow manifestu šablony a záznamu aplikace je implementovaný. Umí vypsat manifesty kurátorované operátorem, vytvořit nový záznam aplikace z jednoho z nich, přednastavit neutajené hodnoty prostředí, když je nakonfigurované úložiště prostředí, a vytvořit čistý záznam remixu z kvalifikované aplikace.

Instanciování aplikaci nenasazuje. Deklarované databáze, buckety a autentizační služby se neprovisionují automaticky. Některé deklarované služby jsou samy stub-only, takže deklarace v manifestu nedokazuje, že závislost existuje.

Procházení manifestů


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

Galerie má přístup public-read. Manifest popisuje source Git URL, branch, výchozí runtime, schéma proměnných prostředí a deklarované služby. Před instanciováním zkontrolujte repozitář, aktuální revizi, licenci, stav údržby a příkazy runtime. Manifest jsou metadata operátora, ne bezpečnostní doporučení.

Dva vestavěné seed manifesty zajišťují, že API není prázdné. Jejich externí repozitáře se mohou změnit nebo zmizet a zatím neexistuje automatizovaný smoke test pro každý seed.

Instanciování


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

Volání vytvoří soukromý záznam aplikace a vrátí app_id, informace o zdroji, typ runtime a deklarované služby. Přijímají se jen klíče deklarované v manifestu. Secret fields tímto voláním nenastaví.

Po instanciování:

zkontrolujte source a nastavení runtime nové aplikace;
dodávejte secrety přes Tajemství a proměnné prostředí;
zajistěte si skutečné externí závislosti sami, pokud služba není výslovně hlášena jako ready;
zavolejte endpoint nasazení; a
sledujte nasazení přes build, health check a activation.

Remix


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

Vlastníci mohou remixovat vlastní aplikaci. Jiný uživatel může remixovat jen aplikaci, která je zároveň public a označená jako remixable. Nová aplikace je private.

Remix přenáší source URL, branch, deployment type, port a lineage. Záměrně ne kopíruje hodnoty prostředí, secrety, reference na databázi nebo bucket, vazby autentizace, checkpointy, stav IDE ani data. Také neforkuje ani nepinuje vzdálené Git repozitáře. Pokud vlastník zdroje později repozitář změní nebo odstraní, nové nasazení se může lišit nebo selhat.

Pro trvalý remix forkněte zdroj do repozitáře, který ovládáte, zkontrolujte a připněte revizi, aktualizujte source nové aplikace a pak nasazte.

Kontrolní seznam publikace šablony

Předtím než šablonu představíte jako použitelnou:

potvrďte repozitář a licenci;
připněte nebo zaznamenejte otestovanou revizi;
ověřte install, build, run, port a chování health;
otestujte povinná pole prostředí bez odhalení secretů;
ověřte, že každá deklarovaná služba je skutečně dostupná; a
zinstancujte, nasaďte, proveďte smoke test a odstraňte v čistém prostředí.