Șabloane app și remixuri

Disponibilitate

Workflow-ul de manifest șablon și înregistrare app este implementat. Poate lista manifeste curate de operator, crea o înregistrare app nouă dintr-un manifest, seta valori de mediu non-secrete când magazinul de mediu este configurat și crea o înregistrare remix curată dintr-o app eligibilă.

Instanțierea nu deploy-ează app-ul. Bazele de date, bucket-urile și serviciile de autentificare declarate nu sunt provisionate automat. Unele servicii declarate sunt ele însele stub-only, deci o declarație din manifest nu dovedește că există o dependență.

Răsfoire manifeste

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

Galeria are acces public-read. Un manifest descrie source Git URL, branch, valori implicite runtime, schema variabilelor de mediu și serviciile declarate. Înainte de instanțiere, revizuiți depozitul, revizia curentă, licența, starea de mentenanță și comenzile runtime. Manifestul este metadata operator, nu aviz de securitate.

Două manifeste seed integrate fac API-ul nevid. Depozitele lor externe se pot schimba sau dispărea, iar pentru fiecare seed nu există încă smoke test automatizat.

Instanțiere

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

Apelul creează o înregistrare app privată și returnează app_id, informații despre sursă, tip runtime și servicii declarate. Sunt acceptate doar cheile declarate de manifest. Secret fields nu sunt setate prin acest apel.

După instanțiere:

1. inspectați source-ul și setările runtime ale app-ului nou;
2. furnizați secrete prin Secrete și variabile de mediu;
3. asigurați dependențele externe reale singur, dacă serviciul nu este raportat explicit ca ready;
4. apelați endpoint-ul de deploy; și
5. urmăriți deploy-ul prin build, health check și activation.

Remix

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

Proprietarii își pot remixa propria app. Alt utilizator poate remixa doar o app care este atât public, cât și marcată remixable. App-ul nou este private.

Remixul poartă source URL, branch, deployment type, port și lineage. Nu copiază în mod deliberat valori de mediu, secrete, referințe la bază sau bucket, legături de autentificare, checkpoint-uri, starea IDE sau date. De asemenea nu fork-uiește și nu pin-uiește depozitul Git remote. Dacă proprietarul sursei schimbă sau elimină depozitul mai târziu, un deploy nou poate diferi sau eșua.

Pentru un remix durabil, fork-uiți sursa într-un depozit pe care îl controlați, revizuiți și pin-uiți o revizie, actualizați source-ul app-ului nou, apoi deploy-ați.

Listă de verificare pentru publicarea unui șablon

Înainte să prezentați un șablon ca utilizabil:

• confirmați depozitul și licența;
• pin-uiți sau înregistrați o revizie testată;
• validați install, build, run, port și comportamentul health;
• testați câmpurile de mediu obligatorii fără a expune secrete;
• verificați că fiecare serviciu declarat este efectiv disponibil; și
• instanțiați, deploy-ați, rulați smoke test și eliminați într-un mediu curat.