App veidnes un remix

Pieejamība

Veidnes manifest un app ieraksta darba plūsma ir ieviesta. Tā var uzskaitīt operatora atlasītus manifestus, izveidot jaunu app ierakstu no viena, iestatīt sākotnējās ne slepenās vides vērtības, kad vides glabātuve ir konfigurēta, un izveidot tīru remix ierakstu no piemērotas app.

Instantiācija neizvieto app. Deklarētās datubāzes, bucket un autentifikācijas pakalpojumi netiek automātiski provisionēti. Daži deklarētie pakalpojumi paši ir tikai stub, tāpēc manifest deklarācija nav pierādījums, ka atkarība pastāv.

Pārlūkot manifestus

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

Galerija ir publiski lasāma. Manifest apraksta avota Git URL, zaru, runtime noklusējumus, vides mainīgo shēmu un deklarētos pakalpojumus. Pirms instantiācijas pārskatiet repozitoriju, pašreizējo revīziju, licenci, uzturēšanas stāvokli un runtime komandas. Manifest ir operatora metadati, ne drošības apstiprinājums.

Divi iebūvēti seed manifesti nodrošina, ka API nav tukšs. To ārējās repozitorijas var mainīties vai pazust, un vēl nav automatizēta smoke test katrai seed.

Instancēt

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

Izsaukums izveido privātu app ierakstu un atgriež tā app_id, avota informāciju, runtime tipu un deklarētos pakalpojumus. Tiek pieņemtas tikai manifest deklarētās atslēgas. Slepenie lauki ar šo izsaukumu netiek iestatīti.

Pēc instantiācijas:

1. pārskatiet jaunās app avotu un runtime iestatījumus;
2. piegādājiet noslēpumus caur App environment variables;
3. nodrošiniet īstās ārējās atkarības paši, ja vien pakalpojums nav skaidri ziņots kā gatavs;
4. izsauciet izvietošanas endpoint; un
5. sekojiet izvietošanai caur build, health check un activation.

Remix

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

Īpašnieki var remix savu app. Cits lietotājs var remix tikai app, kas ir gan publiska, gan atzīmēta kā remixable. Jaunā app ir privāta.

Remix nes avota URL, zaru, deployment tipu, portu un lineage. Apzināti netiek kopētas vides vērtības, noslēpumi, datubāzes vai bucket atsauces, autentifikācijas binding, checkpoint, IDE stāvoklis vai dati. Tas arī nefork repozitoriju un nepin attālo Git repozitoriju. Ja avota īpašnieks vēlāk maina vai noņem repozitoriju, jauna izvietošana var atšķirties vai neizdoties.

Ilgmūžīgam remix nokopējiet (fork) avotu repozitorijā, ko kontrolējat, pārskatiet un pin revīziju, atjauniniet jaunās app avotu un izvietojiet.

Publicēšanas kontrolsaraksts veidnei

Pirms veidni piedāvāt kā lietojamu:

• apstipriniet repozitoriju un licenci;
• pin vai fiksējiet pārbaudītu revīziju;
• validējiet install, build, run, port un health uzvedību;
• pārbaudiet obligātos vides laukus neizpaužot noslēpumus;
• pārliecinieties, ka katrs deklarētais pakalpojums patiešām ir pieejams; un
• instancējiet, izvietojiet, veiciet smoke test un noņemiet tīrā vidē.