App mallid ja remix

Saadavus

Malli manifest ja app kirje töövoog on rakendatud. See saab loetleda operaatori kureeritud manifeste, luua uue app kirje ühest, seemendada mitte salajaseid keskkonnaväärtusi, kui keskkonna hoidla on seadistatud, ja luua puhta remix kirje sobivast app-ist.

Instantieerimine ei deploy app-i. Deklareritud andmebaasid, bucket-id ja autentimisteenused ei provisioneerita automaatselt. Mõned deklareeritud teenused on ise stub-only, seega manifest deklaratsioon ei tõesta sõltuvuse olemasolu.

Sirvi manifeste

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

Galerii on avalikult loetav. Manifest kirjeldab lähte Git URL-i, haru, runtime vaikimisi väärtusi, keskkonnamuutujate skeemi ja deklareeritud teenuseid. Enne instantieerimist vaata üle hoidla, praegune revisjon, litsents, hoolduse seis ja runtime käsud. Manifest on operaatori metaandmed, mitte turbe heakskiit.

Kaks sisseehitatud seed manifesti hoiavad API mitte tühjana. Nende välised hoidlad võivad muutuda või kaduda, ja iga seed jaoks pole veel automatiseeritud smoke testi.

Instantieeri

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

Kutse loob privaatse app kirje ja tagastab selle app_id, lähteinfo, runtime tüübi ja deklareeritud teenused. Aktsepteeritakse ainult manifestis deklareeritud võtmeid. Salajasi väljasid see kutse ei seemenda.

Pärast instantieerimist:

1. vaata üle uue app lähte ja runtime seaded;
2. too saladused App environment variables kaudu;
3. paku ise päris välised sõltuvused, välja arvatud juhul, kui teenus on selgelt teatatud valmis;
4. kutsu deploy endpoint; ja
5. jälgi deploy-d build, health check ja activation kaudu.

Remix

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

Omanikud võivad remix oma app-i. Teine kasutaja võib remix ainult app-i, mis on nii avalik kui ka märgitud remixable. Uus app on privaatne.

Remix kannab lähte URL-i, haru, deployment tüüpi, porti ja lineage. Ta ei kopeeri tahtlikult keskkonnaväärtusi, saladusi, andmebaasi või bucket viiteid, autentimise bindinguid, checkpointe, IDE olekut ega andmeid. Ta ei fork ega pin ka kaug-Git hoidlat. Kui lähte omanik hiljem hoidlat muudab või eemaldab, võib uus deploy erineda või ebaõnnestuda.

Püsiva remix jaoks fork lähte hoidlasse, mida kontrollid, vaata üle ja pin revisjon, uuenda uue app lähte ja deploy.

Avaldamise kontrollnimekiri mallile

Enne malli kasutatavana esitamist:

• kinnita hoidla ja litsents;
• pin või salvesta testitud revisjon;
• valideeri install, build, run, port ja health käitumine;
• testi nõutud keskkonnavälju saladusi avaldamata;
• kontrolli, et iga deklareeritud teenus on tõesti saadaval; ja
• instantieeri, deploy, tee smoke test ja eemalda puhtas keskkonnas.