Alkalmazássablonok és remixek
Elérhetőség
A sablon manifest és app-record workflow implementálva van. Képes operátor által kurált manifesteket listázni, új app recordot létrehozni egy manifestből, nem titkos környezeti értékeket seedelni, ha a környezettár be van állítva, és tiszta remix recordot készíteni egy jogosult appból.
Az instantiation nem telepíti az appot. A deklarált databases, buckets és authentication services nem provisionálódnak automatikusan. Egyes deklarált services maguk is stub-only, ezért a manifest deklaráció nem bizonyítja, hogy a függőség létezik.
Manifestek böngészése
GET /api/apps/templates?category=web&q=next
GET /api/apps/templates/{template_id}A galéria public-read. A manifest source Git URL-t, branch-et, runtime alapértelmezéseket, környezeti változók sémáját és deklarált services-t ír le. Instantiation előtt nézze át a tárolót, az aktuális revíziót, a licencet, a karbantartás állapotát és a runtime parancsokat. A manifest operátor metadata, nem biztonsági ajánlás.
Két beépített seed manifest biztosítja, hogy az API ne legyen üres. Külső tárolóik változhatnak vagy eltűnhetnek, és még nincs automatizált smoke test minden seedre.
Instantiation
POST /api/apps/templates/{template_id}/instantiate
Content-Type: application/json
{
"name": "My app",
"env": {
"NEXT_PUBLIC_APP_NAME": "My app"
}
}A hívás privát app recordot hoz létre, és visszaadja az app_id-t, a forrás adatait, a runtime típust és a deklarált services-t. Csak a manifest által deklarált kulcsok fogadhatók el. A secret fields ezzel a hívással nem seedelődnek.
Instantiation után:
- ellenőrizze az új app source-ját és runtime beállításait;
- adjon meg secreteket az Alkalmazás titkok és környezeti változók oldalon;
- biztosítsa a valódi külső függőségeket maga, hacsak a service nincs kifejezetten ready-ként jelentve;
- hívja a deployment endpointot; és
- kövesse a deploymentet build, health check és activation felé.
Remix
POST /api/apps/{source_app_id}/remix
Content-Type: application/json
{
"name": "My private remix"
}A tulajdonosok remixelhetik a saját appjukat. Más felhasználó csak olyan appot remixelhet, amely egyszerre public és remixable jelölésű. Az új app private.
A remix source URL-t, branch-et, deployment type-ot, portot és lineage-t viszi át. Szándékosan nem másol környezeti értékeket, secreteket, database vagy bucket hivatkozásokat, authentication bindingeket, checkpointokat, IDE állapotot vagy adatot. A távoli Git tárolót sem fork-olja, sem pin-eli. Ha a forrás tulajdonosa később módosítja vagy eltávolítja a tárolót, az új deployment eltérhet vagy elbukhat.
Tartós remixhez fork-olja a forrást egy Ön által irányított tárolóba, ellenőrizze és pin-elje a revíziót, frissítse az új app source-ját, majd telepítsen.
Közzétételi ellenőrzőlista sablonhoz
Mielőtt sablont használhatóként mutat be:
- erősítse meg a tárolót és a licencet;
- pin-elje vagy rögzítse a tesztelt revíziót;
- validálja az install, build, run, port és health viselkedést;
- tesztelje a kötelező környezeti mezőket secretek felfedése nélkül;
- ellenőrizze, hogy minden deklarált service tényleg elérhető; és
- instantiáljon, telepítsen, futtasson smoke testet, és távolítsa el tiszta környezetben.