App šablonai ir remix

Prieinamumas

Šablono manifest ir app įrašo darbo eiga įgyvendinta. Ji gali rodyti operatoriaus atrinktus manifestus, sukurti naują app įrašą iš vieno, įrašyti pradines ne slaptas aplinkos reikšmes, kai aplinkos saugykla sukonfigūruota, ir sukurti švarų remix įrašą iš tinkamos app.

Instantiacija neįdiegia app. Deklaruotos duomenų bazės, bucket ir autentifikacijos paslaugos automatiškai nekuriamos. Kai kurios deklaruotos paslaugos pačios yra tik stub, todėl manifest deklaracija neįrodo, kad priklausomybė egzistuoja.

Naršyti manifestus

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

Galerija skirta viešam skaitymui. Manifest aprašo šaltinio Git URL, šaką, runtime numatytuosius, aplinkos kintamųjų schemą ir deklaruotas paslaugas. Prieš instantiaciją peržiūrėkite saugyklą, dabartinę reviziją, licenciją, priežiūros būseną ir runtime komandas. Manifest yra operatoriaus metaduomenys, ne saugumo patvirtinimas.

Du įmontuoti seed manifestai užtikrina, kad API nebūtų tuščias. Jų išorinės saugyklos gali pasikeisti ar išnykti, ir dar nėra automatizuoto smoke test kiekvienam seed.

Instancijuoti

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

Skambutis sukuria privatų app įrašą ir grąžina jo app_id, šaltinio informaciją, runtime tipą ir deklaruotas paslaugas. Priimami tik manifest deklaruoti raktai. Slaptų laukų šis skambutis neužpildo.

Po instantiacijos:

1. peržiūrėkite naujos app šaltinį ir runtime nustatymus;
2. pateikite slaptus duomenis per App environment variables;
3. patys pateikite tikras išorines priklausomybes, nebent paslauga aiškiai pranešta kaip paruošta;
4. kvieskite diegimo endpoint; ir
5. stebėkite diegimą per build, health check ir activation.

Remix

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

Savininkai gali remix savo app. Kitas vartotojas gali remix tik app, kuri yra ir vieša, ir pažymėta remixable. Nauja app privati.

Remix perduoda šaltinio URL, šaką, deployment tipą, portą ir lineage. Sąmoningai ne kopijuojamos aplinkos reikšmės, slapti duomenys, duomenų bazės ar bucket nuorodos, autentifikacijos binding, checkpoint, IDE būsena ar duomenys. Taip pat neforkinama ir neprisegama nuotolinė Git saugykla. Jei šaltinio savininkas vėliau pakeičia ar pašalina tą saugyklą, naujas diegimas gali skirtis ar nepavykti.

Ilgalaikei remix nukopijuokite (fork) šaltinį į savo valdomą saugyklą, peržiūrėkite ir prisekite reviziją, atnaujinkite naujos app šaltinį ir dieginkite.

Publikavimo kontrolinis sąrašas šablonui

Prieš pateikiant šabloną kaip naudotiną:

• patvirtinkite saugyklą ir licenciją;
• prisekite ar užfiksuokite išbandytą reviziją;
• patikrinkite install, build, run, port ir health elgseną;
• išbandykite privalomus aplinkos laukus neatskleisdami slaptų duomenų;
• patikrinkite, kad kiekviena deklaruota paslauga tikrai prieinama; ir
• instancijuokite, dieginkite, atlikite smoke test ir pašalinkite švarioje aplinkoje.