Predloge aplikacij in remiksi

Razpoložljivost

Potek dela manifesta predloge in zapisa aplikacije je implementiran. Lahko našteje manifeste, ki jih kurira operater, ustvari nov zapis aplikacije iz enega, nastavi ne-skrivne vrednosti okolja, ko je shranjevanje okolja nastavljeno, in ustvari čist zapis remiksa iz ustrezne aplikacije.

Instanciranje ne deploy-a aplikacije. Deklarirane zbirke podatkov, bucketi in storitve avtentikacije se ne provisionirajo samodejno. Nekatere deklarirane storitve so same stub-only, zato deklaracija v manifestu ne dokazuje, da odvisnost obstaja.

Brskanje po manifestih

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

Galerija ima dostop public-read. Manifest opisuje source Git URL, branch, privzete runtime nastavitve, shemo okoljskih spremenljivk in deklarirane storitve. Pred instanciranjem preglejte repozitorij, trenutno revizijo, licenco, stanje vzdrževanja in ukaze runtime. Manifest so metapodatki operaterja, ne varnostna priporočila.

Dva vgrajena seed manifesta zagotovita, da API ni prazen. Njuna zunanja repozitorija se lahko spremenita ali izginita, za vsak seed pa še ni avtomatiziranega smoke testa.

Instanciranje

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

Klic ustvari zasebni zapis aplikacije in vrne app_id, informacije o viru, tip runtime in deklarirane storitve. Sprejeti so le ključi, deklarirani v manifestu. Secret fields ta klic ne nastavi.

Po instanciranju:

1. preglejte source in nastavitve runtime nove aplikacije;
2. dodajte secrete prek Skrivnosti in okoljske spremenljivke;
3. zagotovite resnične zunanje odvisnosti sami, razen če je storitev izrecno poročana kot ready;
4. pokličite endpoint za deploy; in
5. spremljajte deploy skozi build, health check in activation.

Remix

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

Lastniki lahko remiksirajo lastno aplikacijo. Drug uporabnik lahko remiksira le aplikacijo, ki je hkrati public in označena kot remixable. Nova aplikacija je private.

Remix prenese source URL, branch, deployment type, port in lineage. Namerno ne kopira vrednosti okolja, secretov, referenc na zbirko podatkov ali bucket, vezav avtentikacije, checkpointov, stanja IDE ali podatkov. Prav tako ne fork-a ali ne pin-a oddaljenega Git repozitorija. Če lastnik vira pozneje spremeni ali odstrani repozitorij, se lahko nov deploy razlikuje ali spodleti.

Za trajen remix fork-ajte vir v repozitorij, ki ga nadzorujete, preglejte in pin-ajte revizijo, posodobite source nove aplikacije in nato deploy-ajte.

Kontrolni seznam objave predloge

Preden predlogo predstavite kot uporabno:

• potrdite repozitorij in licenco;
• pin-ajte ali zabeležite preizkušeno revizijo;
• preverite install, build, run, port in obnašanje health;
• preizkusite obvezna polja okolja brez razkritja secretov;
• preverite, da je vsaka deklarirana storitev dejansko na voljo; in
• instancirajte, deploy-ajte, izvedite smoke test in odstranite v čistem okolju.