Mallit ja remix
Saatavuus
Mallin manifest- ja app-record -workflow on toteutettu. Se voi listata operaattorin kuratoimat manifestit, luoda uuden app-recordin manifestista, täyttää ei-salaiset ympäristöarvot kun environment store on konfiguroitu, ja luoda puhtaan remix-recordin kelvollisesta appista.
Instansointi ei deployaa appia. Ilmoitetut tietokannat, bucketit ja autentikointipalvelut eivät provisionoidu automaattisesti. Jotkin ilmoitetut palvelut ovat itsessään stub-only, joten manifestin merkintä ei todista riippuvuuden olemassaoloa.
Selaa manifesteja
GET /api/apps/templates?category=web&q=next
GET /api/apps/templates/{template_id}Galleria on public-read. Manifest kuvaa source Git URL:n, branchin, runtime-oletukset, ympäristömuuttujien skeeman ja ilmoitetut palvelut. Tarkista repository, nykyinen revisio, lisenssi, ylläpitotila ja runtime-komennot ennen instansointia. Manifest on operaattorin metadataa, ei turvallisuussuositus.
Kaksi sisäänrakennettua seed-manifestia pitää API:n ei-tyhjänä. Niiden ulkoiset repositoryt voivat muuttua tai kadota, eikä jokaiselle seedille ole vielä automatisoitua smoke testiä.
Instansoi
POST /api/apps/templates/{template_id}/instantiate
Content-Type: application/json
{
"name": "My app",
"env": {
"NEXT_PUBLIC_APP_NAME": "My app"
}
}Kutsu luo private app-recordin ja palauttaa app_id:n, source informationin, runtime typen ja ilmoitetut palvelut. Vain manifestissa deklaroidut avaimet hyväksytään. Secret fields eivät täyty tämän kutsun kautta.
Instansoinnin jälkeen:
- tarkista uuden appin source ja runtime-asetukset;
- toimita secretit kohdassa Sovelluksen salaisuudet ja ympäristömuuttujat;
- hanki oikeat ulkoiset riippuvuudet itse, ellei palvelua raportoida eksplisiittisesti ready-tilaan;
- kutsu deployment-endpoint; ja
- seuraa deploymentia buildin, health checkin ja activationin kautta.
Remix
POST /api/apps/{source_app_id}/remix
Content-Type: application/json
{
"name": "My private remix"
}Omistajat voivat remixata oman appinsa. Toinen käyttäjä voi remixata vain appin, joka on sekä public että merkitty remixable. Uusi app on private.
Remix sisältää source URL:n, branchin, deployment typen, portin ja lineagen. Se ei kopioi tarkoituksella ympäristöarvoja, secretejä, tietokanta- tai bucket-viittauksia, autentikointikytkentöjä, checkpointeja, IDE-statea tai dataa. Se ei myöskään forkkaa tai pinnaa remote Git-repositorya. Jos source-omistaja myöhemmin muuttaa tai poistaa repositoryn, uusi deployment voi erota aiemmasta tai epäonnistua.
Kestävää remixiä varten: forkkaa source repositoryyn, jota hallitset, tarkista ja pinnaa revisio, päivitä uuden appin source ja deploy sen jälkeen.
Julkaisun tarkistuslista mallille
Ennen kuin esität mallin käyttökelpoisena:
- vahvista repository ja lisenssi;
- pinnaa tai kirjaa testattu revisio;
- validoi install, build, run, port ja health-käyttäytyminen;
- testaa pakolliset ympäristökentät paljastamatta secretejä;
- varmista, että jokainen ilmoitettu palvelu on oikeasti saatavilla; ja
- instansoi, deploy, aja smoke test ja poista puhtaassa ympäristössä.