Kurz: Vytvoření a nasazení jednostrákové aplikace pomocí GitHub Sparku a Codespaces

Nová podpora jednostrákové aplikace poskytuje vývojářům větší flexibilitu: weby Power Pages můžete vytvářet, přizpůsobovat a spravovat zcela ve zdrojovém kódu. V nedávné verzi GitHub Sparku můžou vývojáři vytvářet web, upravovat ho přímo v GitHub Codespace a nasazovat ho do prostředí Power Pages, aniž by museli opustit svůj prohlížeč. Tento kurz vás provede úplným pracovním postupem.

GitHub Spark je nová platforma přirozeného jazyka využívající AI z GitHub Copilotu. Je navržená tak, aby vývojářům pomohla rychle spouštět moderní webové aplikace. V kombinaci s GitHub Codespaces pro úpravy kódu poskytuje Spark:

  • Úložiště šablon připravených k použití pro váš projekt
  • Předem nakonfigurované vývojové kontejnery pro konzistentní prostředí
  • Platforma využívající AI v přirozeném jazyce z GitHub Copilotu

Pro vývojáře Power Pages to znamená, že můžete začít s připravenou šablonou webu, přizpůsobit ji a nasadit bez tradičního místního nastavení.

Na konci tohoto článku budete vědět, jak:

  1. Vytvořte prototyp webu Power Pages pomocí GitHub Sparku.
  2. Nakonfigurujte codespace pro podporu .NET a PAC CLI.
  3. Sestavte a nahrajte jednostrákovou aplikaci do prostředí Power Pages.
  4. Znovu aktivujte a otestujte svůj web přímo ze stránek Power Pages.

Požadavky

Dříve začnete, ujistěte se, že máte:

  • Prostředí Power Pages s oprávněními správce.
  • Power Platform CLI (PAC CLI) verze 1.44.x nebo novější je instalované a ověřené.
  • Web Power Pages ve verzi 9.7.4.x nebo novější.
  • Licence GitHub Sparku s Codespaces pro vlastní front-endový projekt

Poznámka:

  • Pokud chcete používat GitHub Spark, ujistěte se, že máte odpovídající licence GitHubu.
  • Podpora Pro GitHub Spark nebo Codespaces je dostupná prostřednictvím týmu podpory Sparku.

Krok 1: Začínáme se šablonou GitHub Spark

  1. Přejděte do nástroje GitHub Spark a vygenerujte nový web pomocí přirozeného jazyka.
  2. Po vytvoření klikněte na Otevřít v Codespaces.

Získáte tak cloudové vývojové prostředí, ve kterém můžete pracovat na projektu Power Pages bez místního nastavení.

Krok 2: Aktualizace konfigurace vývojového kontejneru

V úložišti vyhledejte soubor:

.devcontainer/devcontainer.json

Upravte oddíl funkcí a přidejte podporu pro .NET 9.0. Vaše konfigurace by měla vypadat takto:

"features": {
  "ghcr.io/devcontainers/features/sshd:1": {
    "version": "latest"
  },
  "ghcr.io/devcontainers/features/dotnet:2.3.0": {
    "version": "9.0"
  }
}

Opětovné sestavení kontejneru

Po uložení změn:

  1. Stisknutím Ctrl + Shift + P (nebo Command + Shift + P na Macu) otevřete paletu příkazů.
  2. Zadejte Codespaces: Znovu sestavte kontejner a vyberte ho.
  3. Kontejner se restartuje. Během tohoto procesu se nainstalují .NET 9 a všechny ostatní závislosti.
  4. Než budete pokračovat, počkejte několik sekund, než se instalace dokončí.

Tento krok zajistí, že se prostředí Codespace aktualizuje novou konfigurací. Tím zajistíte, že Codespace zahrnuje potřebný runtime pro nástroje sestavení Power Pages.

Krok 3: Instalace nástrojů Power Platform

Z terminálu Codespaces:

  1. Nainstalujte nástroje Power Platform (dostupné jako rozšíření VS Code).
  2. Tato instalace také přináší rozhraní příkazového řádku PAC, které umožňuje ověřovat, stahovat a nahrávat weby.

Krok 4: Připojení k prostředí Power Platform

K ověření v cílovém prostředí použijte rozhraní příkazového řádku PAC:

pac auth create -u https://org12x34x45.crm.dynamics.com

Adresu URL nahraďte skutečnou adresou URL prostředí Power Platform.

Krok 5: Sestavení webu

Před nasazením sestavte kód lokality:

npm run build

Tento příkaz zkompiluje web a vypíše artefakty do dist složky.

Krok 6: Nahrání webu

Nasaďte web do prostředí Power Pages pomocí:

pac pages upload-code-site --rootPath "./spark-template" --compiledPath "./dist" --siteName "YourSiteName"

Parametry

Parameter Alias Description
--rootPath -rp Místní složka, která obsahuje zdrojové soubory vašeho webu
--compiledPath -cp Cesta ke zkompilovaným prostředkům, jako je React build
--siteName -sn Zobrazovaný název webu Power Pages

Krok 7: Opětovná aktivace a testování

  1. Po nahrání se váš web zobrazí v části Neaktivní weby na stránce Power Pages.
  2. Přejděte na Neaktivní weby, vyhledejte svůj web a vyberte Znovu aktivovat.
  3. Jakmile se web aktivuje, otevřete jeho adresu URL a potvrďte nasazení.

Další kroky: Zabezpečení a rozšíření webu

Teď, když je váš web nasazený:

  • Last updated on