Hoppa till innehållet
Stackship-dokumentation English

App ServiceAnvändareMaskinöversatt

Skapa en app

Skapa en app med guiden i åtta steg — placering, körmiljö, nätverk, beräkningsplan, skalning, distributionskälla och miljövariabler.

Kräver: apps/write

För att skapa en app behöver du apps/write i resursgruppen; rollerna Owner, Contributor och Apps Operator har den. För att bygga från ett förråd behöver du också en distributionskälla i boundaryn — se Distributionskällor.

Öppna guiden

Öppna App Tjänst i sidomenyn i portalen på https://portal.example.com och välj Skapa Appar. Guiden har åtta steg. Nästa kontrollerar fälten i steget du står i; ett namn som redan är upptaget, och KEDA-skalning utan utlösare, avvisas först när du skapar appen.

Grundkonfiguration

  • Apptjänstnamn — 3 till 50 tecken: gemener, siffror och bindestreck, som börjar med en bokstav och inte slutar med bindestreck. Namnet måste vara unikt i resursgruppen och kan inte ändras senare.
  • Boundary, Cluster och Resource group — var appen ska ligga. Boundaryn är den du står i; klustret och resursgruppen fylls i åt dig när det bara finns ett val.

Instansdetaljer

  • Körmiljöstack och Version — vad avbilden byggs med; se Hur en app byggs. Versioner nära eller efter sitt supportslut märks.
  • Port — porten din app lyssnar på, 3000 om du inte ändrar den. Plattformen skickar trafik till en instans först när porten tar emot anslutningar.
  • Sökväg till startprojekt — valfri. För .NET projektfilen som ska publiceras, till exempel src/MyApp/MyApp.csproj; avbilden kör assemblyn med dess namn, och utan sökväg kör den app.dll.

För Node rekommenderar steget ett fält packageManager i package.json (till exempel "packageManager": "pnpm@10.33.2"), så att bygget cachar exakt den versionen av pnpm eller Yarn i avbilden.

För en containerkälla (som väljs i steg 6) används inte körmiljöstacken och versionen, men guiden frågar ändå efter dem.

Nätverk

  • Eget domännamn — valfritt. En egen domän att använda i stället för det genererade värdnamnet, till exempel app.example.com. DNS-posten skapar du själv — se Egna domäner och HTTPS.
  • Endast HTTP — servera appen över okrypterad HTTP, utan certifikat. När det slås på stängs Let's Encrypt SSL av.
  • Let's Encrypt SSL — på som standard: plattformen begär ett certifikat för appens värdnamn och förnyar det. Av besvaras HTTPS med ett självsignerat certifikat som webbläsare varnar för, och beroende på plattformen svarar appen även på okrypterad HTTP utan att skicka besökare vidare till HTTPS — se HTTPS.

En domän som en annan resurs i klustret redan använder vägras när du skapar appen — se Värdnamn som redan används.

Beräkningsplan

Välj en plan. Varje kort visar planens CPU, minne och diskstorlek och en kort beskrivning; standard är förvald. Planer som en policy i boundaryn inte tillåter är inaktiverade — se Vad en app körs på.

Disken används bara om du senare slår på beständig lagring; guiden erbjuder det inte. Se Körmiljö och beräkning.

Skalning

  • Manuell — ett fast Antal replikor, 1 till 20 (standard 1).
  • Horisontell poddautoskalare — Minsta antal replikor och Maximalt antal replikor samt ett CPU-mål (%); standard 1 till 5 vid 70 %.
  • KEDA (händelsestyrd) — minsta (0 tillåter skalning till noll) och högsta antal replikor, standard 1 till 10, och minst en utlösare.

Vad varje alternativ gör står på Skalning.

Distributionskälla

Välj Typ av distributionskälla:

  • GitHub, GitLab eller Azure DevOps — välj installationen (GitHub-installation och så vidare: en distributionskälla ansluten till boundaryn), sedan Repositorie och Branch. Anslut driftsättningskälla lägger till en källa utan att du lämnar guiden; att ansluta GitLab eller Azure DevOps med en OAuth-applikation lämnar sidan, så anslut dem från boundaryn först — se Lägg till en källa.

    När en gren är vald läser guiden package.json i grenens rot och talar om vad det första bygget kommer att göra: köra skriptet start, eller servera byggresultatet som en statisk webbplats. Den varnar när det inte finns någon package.json, eller när det varken finns ett start- eller ett build-skript.

  • Container — den fullständiga avbildsreferensen, registry/name:tag eller registry/name@sha256:…, till exempel ghcr.io/your-org/your-app:v1.2.3. Klustret hämtar den utan autentiseringsuppgifter från dig — se Var koden kommer ifrån.

Pushar till grenen driftsätter appen igen automatiskt — se Automatiska driftsättningar. Du kan byta källa senare — se Distributionskälla.

Appinställningar

Lägg till miljövariabler som nycklar och värden, en i taget eller med Massredigering, eller ladda upp en .env-fil med Ladda upp .env (den ersätter det du har skrivit in). En nyckel är 2 till 100 tecken, börjar med en bokstav eller ett understreck och innehåller bara bokstäver, siffror och understreck; ett värde är högst 500 tecken.

Slå på Byggvariabel för en inställning som bygget också behöver, som VITE_API_URL. När guiden har känt igen ramverket i package.json markeras inställningar med ramverkets publika prefix (till exempel VITE_ eller NEXT_PUBLIC_) åt dig. Högst 32 inställningar kan vara byggvariabler. Se Byggvariabler.

Hemligheter läggs inte till här: lägg till dem när appen har skapats, under Konfiguration → Hemligheter — se Hemligheter.

Granska & Skapa

Kontrollera sammanfattningen och skapa appen. Du kommer tillbaka till applistan medan den första driftsättningen körs; för en app som byggs från ett förråd börjar den med ett bygge, som kan ta flera minuter. Appen visar Creating tills dess första instans är klar och sedan Running — se Statusar.

En app får en managed identity när den skapas. Den börjar utan någon åtkomst; för att låta appen läsa hemligheter från ett valv ger du identiteten Secrets Reader på valvet — se Ge en arbetslast åtkomst.

Med CLI:t

stsh apps create skickar appen som JSON — samma innehåll som API:t tar emot. En app som kör en publik containeravbild:

json
{
  "computePlan": "small",
  "properties": {
    "port": 8080,
    "letsEncrypt": true,
    "scm": { "type": "Container", "image": "ghcr.io/your-org/your-app:v1.2.3" }
  }
}
bash
stsh apps create my-app -g my-resource-group -c my-cluster --file my-app.json

-c anger klustret som appen körs på, vilket plattformen kräver. Kommandot väntar tills appens skapandeoperation är klar; --no-wait återvänder direkt. En app som byggs från GitHub, GitLab eller Azure DevOps behöver också installations- och förråds-ID:n för sin distributionskälla, som guiden i portalen slår upp åt dig.

Nästa steg