Creare, visualizzare in anteprima e distribuire app Microsoft Copilot Managed Runtime

Il ciclo interno delle app di Copilot Managed Runtime è un flusso di lavoro veloce e nativo di Git per la compilazione, l'anteprima e la distribuzione di app. Modifica il codice nell'IDE, eseguine il commit e invialo e lascia che la piattaforma crei il commit inviato per l'endpoint di anteprima. Quando si è pronti per la pubblicazione, distribuire in modo esplicito usando ms app deploy.

Questo articolo descrive come funziona ogni fase del ciclo interno, cosa fa la piattaforma dietro le quinte e dove si trova il tuo lavoro in ogni fase. Integra Guida introduttiva: Creare un'app Microsoft Copilot Managed Runtime con GitHub Copilot e Guida introduttiva: Creare un'app con Copilot Managed Runtime SDK, che percorre lo stesso flusso end-to-end con i comandi.

In questo articolo vengono descritti i comandi dell'interfaccia della riga di comando (CLI) che è possibile immettere in una finestra del terminale basata sulla riga di comando. Agenti come GitHub Copilot hanno competenze simili e possono anche eseguire questi comandi secondo necessità. Ad esempio, è possibile chiedere a un agente di "distribuire" semplicemente ed eseguire l'equivalente di ms app deploy. Non è necessario imparare tutti questi comandi, ma sono sempre disponibili se ti servono.

Cosa aspettarsi

Pochi comportamenti modellano l'intera esperienza. Conoscerli in anticipo rende prevedibile il resto del ciclo interno.

  • È nativo di Git. L'interfaccia ms della riga di comando funziona con Git reale anziché sostituirlo. Si utilizza git add, git commit, allo git push stesso modo di qualsiasi progetto, in modo che gli agenti di codifica, i criteri di diramazione e i flussi di lavoro esistenti vengano tutti trasferiti.
  • Le build vengono eseguite quando serve. A git push aggiorna la tua fonte di verità, ma non costruisce nulla da solo. La piattaforma si basa su richiesta: quando apri l'anteprima, quando distribuisci o quando esegui una build manualmente.
  • L'anteprima è automatica; L'andare in diretta è intenzionale. Ogni build completata è disponibile per l'anteprima, per tutti i commit e i rami. Promuoverne uno nella tua app live è sempre un passo esplicito che fai.
  • Ogni build è indirizzabile. Ogni compilazione ha un ID stabile, uno stato e il commit da cui proviene, quindi puoi scegliere come destinazione qualsiasi compilazione usando --commit <sha> quando ne controlli lo stato o la distribuisci.

Modalità repository

Ogni app usa una delle tre modalità di repository. Scegli la modalità in ms app create o ms app init. La modalità è fissa per l'intera durata dell'app e il passaggio da una modalità all'altro è necessaria la creazione di una nuova app.

Modalità Attivazione Fonte di verità Quando si usano
Git gestito dalla piattaforma (impostazione predefinita) ms app create --repo senza bandiera Un repository di cui la piattaforma esegue il provisioning e lo gestisce per tuo conto Team che non hanno una configurazione del controllo del codice sorgente esistente o che vogliono una configurazione zero Git per impostazione predefinita.
Porta il tuo GitHub ms app create --repo <url> Un repository esterno di proprietà di un'organizzazione GitHub Enterprise Cloud Team che sono già standardizzati in GitHub Enterprise Cloud e vogliono che i criteri di ramo, le revisioni delle richieste di pull e l'integrazione continua esistenti vengano applicati all'app gestita.
Porta la tua build ms app create --repo none Non esiste alcun repository di cui la piattaforma sia a conoscenza. In questo caso, è necessario compilare manualmente il codice per distribuirlo nella piattaforma. Usare questa modalità se non si vuole gestire il codice sorgente tramite GitHub o git gestito dalla piattaforma.

Ambienti

Ogni sviluppatore e ogni agente di codifica che crea app per suo conto, atterra in un ambiente: una sandbox sicura su cui la piattaforma esegue il provisioning per primo ms app create o ms app init.

Un ambiente è dotato di ambito identità, ne viene eseguito automaticamente il provisioning ed eredita i criteri dell'organizzazione dal momento in cui esiste. Non lo richiedi; inizi a lavorare ed è lì. Questi ambienti sono preconfigurati con una baseline di criteri amministrativi gestita da Microsoft, quindi la governance si applica dal momento in cui si inizia a creare. Gli amministratori possono quindi convalidare e personalizzare la linea di base in base alle esigenze.

Aggiungi dipendenze

Dopo l'esecuzione ms app create, la directory dell'app contiene lo scaffolding per un'app. Il passaggio successivo consiste nell'aggiungere i pacchetti da cui dipende l'app usando npm install.

È necessario completare questo passaggio una sola volta, a meno che non si aggiungano altri pacchetti in un secondo momento.

Il loop interno

Dalla creazione all'utilizzo affidabile e a lungo termine, le app si susseguono ciclicamente:

  1. Modifica ed esegui in locale: Crea l'app ed esegui l'iterazione in un ciclo ristretto modificando e visualizzando rapidamente i risultati di una modifica. L'app esiste solo per un collaboratore in un singolo computer.
  2. Salva nel controllo del codice sorgente: Usa i comandi di aggiunta, commit e push di Git per preservare le modifiche e collaborare con altri collaboratori.
  3. Build e anteprima della piattaforma: Compilare l'app sulla piattaforma e visualizzarla in anteprima dal cloud.
  4. Distribuire nell'ambiente di produzione: Condividere l'app con gli utenti finali per l'uso in produzione. L'app è live.
  5. Monitorare l'integrità e l'utilizzo: Assicurati che l'app rimanga disponibile e valuta l'utilizzo per ulteriori investimenti.

Il ciclo si ripete con il feedback degli utenti, nuove idee, cambiamenti nei requisiti e innumerevoli altri motivi.

Se si verifica un problema, il controllo del codice sorgente consente di distribuire una versione valida nota in precedenza e sbloccare gli utenti finali. Per altre informazioni, vedere la sezione sul ripristino di una versione precedente.

Modifica ed esegui in locale

Modifica il codice nel tuo IDE preferito e riproduci l'app in locale con ms app dev. Questo comando non restituisce; invece, inizia a funzionare e può spegnersi con una combinazione di tasti Ctrl+C . Se avvii questo comando con un agente, come GitHub Copilot, indica che è in esecuzione un'attività in background.

Mentre funziona, questo comando esegue due attività:

  • Funge da server Web nel computer locale per riprodurre l'app. Stampa l'URL che è possibile usare per visualizzare l'anteprima dell'app in modalità locale e potrebbe anche aprire un browser per questo URL.
  • Monitora le modifiche nell'app mentre si continua ad apportare modifiche. Se ne rileva uno, aggiorna automaticamente il browser con l'aggiornamento.

L'URL fornito ms app dev inizia con https://play.managedapps.cloud.microsoft/..., che è diverso dall'URL che potresti vedere con altri sviluppi locali basati su nodi. Questo URL remoto richiama il computer locale per la maggior parte del contenuto Web, ma fornisce anche un gateway per accedere a servizi dati remoti e connettori. Questa configurazione consente la riproduzione di un'app locale con dati in un'origine dati remota, ad esempio Dataverse, SharePoint o da qualsiasi altro connettore.

A questo punto:

  • Il tuo lavoro risiede solo nel computer locale e solo tu puoi riprodurlo. Aggiungere, eseguire commit e push nella fase successiva per mantenere e collaborare con altri collaboratori, incluso se stessi su un altro computer.
  • Non è richiesta alcuna compilazione o distribuzione. Il server Web esegue i file di origine non elaborati, il che facilita lo sviluppo rapido.

Salva nel controllo del codice sorgente

Quando l'app si comporta nel modo desiderato in locale, salvare questa versione nel controllo del codice sorgente per mantenerla e collaborare con altri collaboratori.

Nella directory principale dell'app, segui questa procedura per imbottigliare questa versione dell'app e inviarla al repository Git remoto.

  • git add . Aggiunge tutti i file modificati al commit successivo. Dice . a git di includere tutti i file in questa directory e nelle sottodirectory. È possibile ignorare in modo sicuro qualsiasi avviso sulle terminazioni delle linee LF e CRLF.
  • git commit Crea il commit. Un commit è una versione specifica dell'app a cui è possibile fare riferimento in un secondo momento con un ID commit. Git chiede un messaggio per etichettare questo commit, in modo che tu e gli altri sappiate cosa è cambiato con questa versione.
  • git push Invia il commit al server per la custodia e per l'anteprima. Il push aggiorna il repository remoto, ovvero il repository Git gestito dalla piattaforma o il repository GitHub esterno associato.

A questo punto:

  • Il tuo lavoro ora vive sia sulla tua macchina locale che nel repository remoto. Le modifiche vengono archiviate in modo sicuro sulla piattaforma e non sono più isolate in un computer. Gli altri collaboratori possono visualizzare e visualizzare in anteprima le modifiche. È comunque possibile utilizzarli ms app dev come si ritiene opportuno per ulteriori modifiche.
  • Il push non attiva una compilazione da solo. Il telecomando ha ora un nuovo commit che la piattaforma considera una versione compilabile.

Se usi la modalità "porta la tua build", questi comandi potrebbero essere diversi per te.

Build e anteprima della piattaforma

Quando salvi un commit sulla piattaforma, tu e gli altri contributori potete giocarci direttamente. Immetti il comando ms app play --mode preview per visualizzare l'URL per l'anteprima. Tenere premuto CTRL e selezionare l'URL oppure copiarlo e incollarlo in un browser.

Per impostazione predefinita, l'anteprima seleziona il ramo Git corrente. Se l'interfaccia della riga di comando non è in grado di identificare il ramo, avvisa ed esegue il fallback a main. Utilizzo ms app play --mode preview --branch <name> per un particolare ramo o ms app play --mode preview --commit <sha> per un particolare commit. --branch e --commit si escludono a vicenda.

Se non hai mai giocato a questa versione dell'app prima, la piattaforma crea l'app su richiesta. Se è presente una build precedente, la piattaforma riproduce la build precedente durante l'attesa e chiede di aggiornare al termine.

Tutti i commit Git salvati sulla piattaforma sono eseguibili da qualsiasi collaboratore, in qualsiasi momento. Usa questa funzionalità per confrontare le modifiche tra le versioni con due finestre del browser separate. Per accedere a un particolare commit, usa questi URL:

  • https://play.managedapps.cloud.microsoft/apps/<appId>/commit/<commitSHA> dove si sostituisce <appId> con il GUID dell'ID app visualizzato da ms app info e <commitSHA> con il codice SHA completo visualizzato da git log -1.
  • https://play.managedapps.cloud.microsoft/apps/<appId>/branch/<branchName>. Il nome predefinito del ramo è main , ma puoi riprodurre l'intestazione di qualsiasi ramo Git in questo modo.

Oltre a creare app su richiesta tramite anteprima, usare il ms app build comando per avviare in modo esplicito una compilazione.

Se una build ha esito negativo, gli endpoint di anteprima continuano a fornire l'ultima build riuscita per l'app. Per scoprire perché non è riuscito, esegui ms app build-status. L'output segnala la compilazione non riuscita e il motivo dell'errore, in modo da poter correggere il codice ed eseguire nuovamente il push.

Se si usa la modalità "bring your own build", questi endpoint URL di anteprima non sono disponibili. Sei responsabile della creazione della build e dell'invio alla piattaforma.

Effettuare la distribuzione nell'ambiente di produzione.

Quando l'anteprima è buona, usala ms app deploy per promuoverla alla versione di produzione che condividi con gli utenti finali. Ulteriori sviluppi, commit e anteprime non influiscono sulla versione distribuita fino a quando non si esegue un'altra distribuzione.

L'URL per la versione di produzione live dell'app non include un identificatore di commit o ramo. Ad esempio, un URL di produzione valido potrebbe essere simile a https://play.managedapps.cloud.microsoft/apps/00000000-0000-0000-0000-000000000000. Questo URL non cambia con le distribuzioni successive. Finché non si completa la prima distribuzione, il portale mostra un messaggio di non distribuzione agli utenti finali.

Inizialmente, solo i proprietari dell'app possono riprodurre l'app distribuita. Da usare ms app share per condividere con altri utenti. È inoltre possibile gestire gli utenti e https://managedapps.cloud.microsoft generare URL condivisibili.

Per le applicazioni supportate da Git, senza opzioni, ms app deploy seleziona il Git HEADlocale corrente. Se sono presenti modifiche non confermate o commit locali prima del telecomando, la CLI chiede conferma in modalità interattiva e si interrompe con un errore di utilizzo in modalità non interattiva o JSON, a meno che non si superi --force. Esaminare il flusso di aggiunta, commit e push per includere le modifiche previste. --force bypassa solo il preflight; Non carica origine non approvata o non inviata.

Usa ms app deploy --commit <commitSHA> per distribuire un commit specifico. Usare questo comando per ripristinare una versione precedente dell'app in caso di problemi con una nuova distribuzione.

La distribuzione riutilizza una build memorizzata nella cache o invia una build per il commit selezionato e attende il completamento. Se la compilazione ha esito negativo o viene annullata, la distribuzione si interrompe; non si ripiega su una build precedente di successo. La versione distribuita precedente rimane invariata.

Monitorare l'integrità e l'utilizzo

Dopo aver distribuito un'app, monitorala per assicurarti che funzioni correttamente e per misurarne l'utilizzo. Per ulteriori informazioni, vedere Monitorare le app.

Ripristinare una versione precedente

A volte, una modifica non funziona nel modo in cui pensavi e vorresti tornare alla versione precedente.

Puoi distribuire qualsiasi commit da qualsiasi ramo in qualsiasi momento. Esamina git log per capire chi ha apportato modifiche, quando e il messaggio fornito sulla modifica. Usa queste informazioni per identificare un ID commit a cui vuoi tornare. Quindi usa ms app deploy --commit <commitID> per ripristinare quella versione.

La modifica che non era perfetta è ancora lì perché nulla viene perso nel controllo del codice sorgente. Ripristinando l'app per gli utenti finali, è possibile esaminare il commit problematico e quello noto buono e decidere come procedere. Potresti apportare piccole modifiche alla punta o alla testa del ramo o semplicemente eseguire il commit della vecchia versione prima di quella nuova. Quando sei pronto, crea un nuovo commit in cima al tuo main o all'altro ramo e distribuiscilo.