Hurtig introduktion: Opret en app med Copilot Managed Runtime SDK (prøveversion)

[Denne artikel er foreløbig dokumentation og kan ændres uden varsel.]

Denne hurtige introduktion viser, hvordan du stilladser, kører og leverer en Hello World-app fra din terminal ved hjælp af Copilot Managed Runtime CLI (@microsoft/managed-apps-cli) og Copilot Managed Runtime SDK (@microsoft/managed-apps). Til sidst kører din Hello World-app lokalt, forhåndsvist på en hostet URL-adresse og installeres live til brugere – alt sammen fra terminalen, med kildekontrol håndteret af et platformadministreret lager.

De vigtigste trin dækker standardstien fra slutpunkt til slutpunkt. Afsnittet Variationer dækker binding til et eksisterende GitHub-lager, konvertering af et eksisterende webprojekt og trækning af en app til en ny maskine.

Forudsætninger

Før du begynder, skal du kontrollere, at følgende værktøjer er installeret og konfigureret på din computer:

• Node.js (LTS-version).
• Git, med en legitimationsstyring konfigureret.
• En terminal efter eget valg (Visual Studio Code integreret terminal, Windows Terminal, iTerm osv.).

Proces

I følgende tabel beskrives den proces, du skal følge.

Installér Copilot Managed Runtime CLI

Installer CLI globalt, så kommandoen ms er tilgængelig i alle projekter:

npm install -g @microsoft/managed-apps-cli

Bekræft installationen:

ms --version

Log på

Godkend CLI med din lejer. Denne engangskonfiguration pr. maskine bruger din Microsoft Entra-identitet til alt det, der følger.

ms auth login

Der åbnes et browservindue til logon. Når du har logget på, bekræfter terminalen den godkendte identitet.

Opret appen

Opret en ny app, og stillads projektet i én kommando. Denne kommando opretter appen på platformen, konfigurerer et platformsadministreret Git-lager for dig og stilladserer dine projektfiler.

ms app create hello-world --display-name "Hello World"
cd hello-world

Da platformen administrerer repo'en, behøver du ikke at konfigurere dit eget kildekontrolelement for at komme i gang. Platformen klargør, sikrer og forbinder automatisk lageret til build- og installationspipelinen.

Byg og kør appen lokalt

Byg og kør appen lokalt for dit indre udviklingsloop. Denne fremgangsmåde gør, at du kan se ændringer med det samme, når du redigerer kode. Bevar din lokale tilstand for alle gentagelser: skrivefunktioner, tilpasning af brugergrænsefladen, fejlfinding af logik, forsøg med forbindelseskal. Flyt til et platformsbuild , når appen fungerer, som du ønsker det lokalt, og du er klar til at validere den i et hostet miljø.

Installér afhængigheder én gang, og start derefter den lokale udviklerløkke:

npm install
ms app dev

ms app dev er den ene local-dev-kommando – den starter dit projekts udviklingsproces. Brug det, når du vil køre lokalt i stedet for npm run dev et andet framework-script. Du skal kun køre npm install igen, når afhængighederne ændres. Fordi ms app dev læser dens konfiguration fra ms.config.json i stedet package.jsonfor , fungerer den samme kommando for enhver framework og pakkehåndtering. Åbn URL'en til Lokal afspilning , der er trykt på terminalen. Du bør kunne se skabelonen Hello World køre på localhost.

Tilføj en forbindelse (valgfrit)

Hvis din app har brug for data, kan du tilføje en forbindelse. Start med at finde ud af, hvad der er tilgængeligt i dit miljø:

ms connector list [--search <query>]

CLI udskriver matchende forbindelser med deres id, godkendelsestype, tabelflag og styringsstatus (DLP og ACP). Forebyggelse af datatab (DLP) og avancerede forbindelsespolitikker (ACP) er administratordefinerede regler, der styrer, hvilke connectorer din app har tilladelse til at bruge. Når du ser denne status på designtidspunktet, ved du på forhånd, om en forbindelse er tilladt i dit miljø. Du undgår at bygge mod en datakilde, som politikken blokerer på installations- eller kørselstidspunktet.

Vælg en af de angivne forbindelser, og føj den til din app:

ms app add data-source --connector <connector>

I interaktiv tilstand fører CLI dig gennem hele konfigurationen: Vælg en eksisterende forbindelse, eller opret en ny, vælg et datasæt (f.eks. et SharePoint-websted), og vælg derefter en tabel. CLI genererer automatisk stærkt indtastede modeller og tjenester i generated/ - uden behov for ekstra kommandoer.

Bekræft, byg og skub for at få vist eksempel

Nu, hvor appen kører lokalt, skal du bekræfte dit arbejde og skubbe det. Dette push uploader din seneste bekræftelse til det platformsadministrerede lager. Det udløser ikke et build af sig selv. Platformen bygger din app efter behov, når du åbner forhåndsvisningens URL-adresse.

git add .
git commit -m "first pass"
git push

Afspil appen i eksempeltilstand

Når din app fungerer, som du ønsker det lokalt, og du er klar til at teste den i et hostet miljø, skal du åbne den i visningstilstand:

ms app play --mode preview

Hvis du ikke angiver et app-id, anvendes kommandoen som standard til dit aktuelle katalogs appprojekt.

Når du spiller appen i forhåndsvisningstilstand, starter platformen et build til din seneste push-bekræftelse. Du får vist en af disse tilstande i eksempelvisningen, hvis det er første gang, du rammer eksempelvisningen efter et tryk:

1. Banner med igangværende build – platformen opbygger dit seneste engagement.
2. Build Complete. Den nye version af din app er klar. – Vælg Opdater for at indlæse det nyeste build.
3. Banner med mislykket build – noget gik galt under buildet. Kør ms app build-status[--commit <id>] for at få de fulde fejloplysninger, så du kan rette koden og skubbe igen. Hvis du udelader bekræftelses-id'et, anvendes kommandoen som standard til din senest oprettede bekræftelse.

Installér til live

Når eksemplet ser rigtigt ud, kan du opgradere til en live-app med en enkelt kommando:

ms app deploy

Hvis du vil installere en bestemt tidligere commit, skal du bestå:--commit <id>

ms app deploy --commit <commit-id>

Ved succes returnerer CLI live-appens URL-adresse. Åbn den for at bekræfte, at din app kører for brugerne som en Copilot Managed Runtime-app – styret af Microsoft Entra ID, betinget adgang og ACP-politikker med telemetri og driftstilstand, der flyder gennem værktøjer i Administration.

Tillykke! Du har installeret din første Copilot Managed Runtime-app.

Variationer

Brug disse valgfri stier, hvis du vil oprette forbindelse til et andet kildelager, onboarde et eksisterende projekt eller fortsætte udviklingen fra en anden maskine.

Automatiser udrulningen med GitHub-handlinger

Hvis du vil bygge og installere din app automatisk fra en GitHub Actions-arbejdsproces i stedet for terminalen, skal du oprette appen til ekstern artefaktudrulning med ms app create--repo none, og derefter følge Udrul Microsoft Copilot Managed Runtime-apps med GitHub Actions. Installation af eksterne artefakter er som standard ikke tilladt. Se Udrulning af eksterne artefakter.

Medbring dit eget GitHub-lager

Hvis dit team bruger GitHub, kan du binde din app til et af dine lagre på oprettelsestidspunktet ved at overføre:--repo

ms app create hello-world --display-name "Hello World" --repo https://contoso.ghe.com/team/hello-world

Platformen opbygger, scanner og installerer fra GitHub-lageret som den eneste kilde til sandhed. Dine eksisterende forgreningspolitikker og gennemgange af pull-anmodninger gælder fortsat.

Konvertere et eksisterende webprojekt

Hvis du vil gøre et allerede eksisterende projekt til en app, skal du køre ms app init det inde fra projektkataloget i stedet for ms app create:

cd my-existing-web-app
ms app init --display-name "My App"

ms app init Klargør en app-post, skriver ms.config.jsonog opretter og opretter enten et platformsadministreret Git-lager eller bevarer din eksisterende Git-ekstern, afhængigt af hvad den registrerer i arbejdsmappen.

Klon en app til en ny maskine

Hvis du vil arbejde med en eksisterende app fra en ny maskine, skal du slå lagerets URL-adresse op og klone den:

ms app info --app <app-id>
git clone <repo-url>
cd hello-world
npm install
ms app dev

ms app info Returnerer lagerets URL-adresse, ejerne og miljø-id'et for en app, du har adgang til.