Šablóny aplikácií a remixy

Dostupnosť

Workflow manifestu šablóny a záznamu aplikácie je implementovaný. Vie vypísať manifesty kurátorované operátorom, vytvoriť nový záznam aplikácie z jedného z nich, prednastaviť neutajené hodnoty prostredia, keď je nakonfigurované úložisko prostredia, a vytvoriť čistý záznam remixu z kvalifikovanej aplikácie.

Inštanciovanie aplikáciu nenasadí. Deklarované databázy, buckety a autentizačné služby sa neprovisionujú automaticky. Niektoré deklarované služby sú samy stub-only, takže deklarácia v manifeste nedokazuje, že závislosť existuje.

Prehliadanie manifestov

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

Galéria má prístup public-read. Manifest popisuje source Git URL, branch, predvolené runtime, schému premenných prostredia a deklarované služby. Pred inštanciovaním skontrolujte repozitár, aktuálnu revíziu, licenciu, stav údržby a príkazy runtime. Manifest sú metadáta operátora, nie bezpečnostné odporúčanie.

Dva vstavané seed manifesty zabezpečujú, že API nie je prázdne. Ich externé repozitáre sa môžu zmeniť alebo zmiznúť a zatiaľ neexistuje automatizovaný smoke test pre každý seed.

Inštanciovanie

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

Volanie vytvorí súkromný záznam aplikácie a vráti app_id, informácie o zdroji, typ runtime a deklarované služby. Prijímajú sa len kľúče deklarované v manifeste. Secret fields týmto volaním nenastaví.

Po inštanciovaní:

1. skontrolujte source a nastavenia runtime novej aplikácie;
2. dodávajte secrety cez Tajomstvá a premenné prostredia;
3. zabezpečte si skutočné externé závislosti sami, pokiaľ služba nie je výslovne hlásená ako ready;
4. zavolajte endpoint nasadenia; a
5. sledujte nasadenie cez build, health check a activation.

Remix

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

Vlastníci môžu remixovať vlastnú aplikáciu. Iný používateľ môže remixovať len aplikáciu, ktorá je zároveň public a označená ako remixable. Nová aplikácia je private.

Remix prenáša source URL, branch, deployment type, port a lineage. Zámerne ne kopíruje hodnoty prostredia, secrety, referencie na databázu alebo bucket, väzby autentizácie, checkpointy, stav IDE ani dáta. Tiež neforkuje ani nepinuje vzdialené Git repozitáre. Ak vlastník zdroja neskôr repozitár zmení alebo odstráni, nové nasadenie sa môže líšiť alebo zlyhať.

Pre trvalý remix forknite zdroj do repozitára, ktorý ovládate, skontrolujte a pripnite revíziu, aktualizujte source novej aplikácie a potom nasadte.

Kontrolný zoznam publikácie šablóny

Skôr než šablónu predstavíte ako použiteľnú:

• potvrďte repozitár a licenciu;
• pripnite alebo zaznamenajte otestovanú revíziu;
• overte install, build, run, port a správanie health;
• otestujte povinné polia prostredia bez odhalenia secretov;
• overte, že každá deklarovaná služba je skutočne dostupná; a
• zinštancujte, nasaďte, vykonajte smoke test a odstráňte v čistom prostredí.