nopCommerce Dokumentace

Nasazení na Azure pomocí Gitu a automatických buildů

Podrobný návod pro automatické nasazení nopCommerce pomocí gitu na Azure

  1. Nastavte si git repozitář

    Výchozím způsobem nasazení nopCommerce je použití funkce „Publish“ ve Visual Studio. Pro publikování na Azure však potřebujete vlastní repozitář. Můžete použít Bitbucket a udržovat jej synchronizovaný s oficiálním repozitářem. Nebo můžete nastavit git na Azure. K dispozici je skvělé video.

  2. Připravte se na lokální nasazení

    Jakmile ověříte, že automatický build funguje, můžeme přizpůsobit naše skripty pro nasazení. To je nutné, protože výchozí automatický build sestavuje pouze projekt Nop.Web. Problém je v tom, že nesestavuje žádný z pluginů. Jejich referenci nelze přidat ani do projektu `Nop.Web', protože by vznikly cyklické reference. Musíme tedy zprovoznit vlastní build; k tomu potřebujeme nainstalovat tyto nástroje:

  3. Zprovozněte NuGet na úrovni příkazového řádku.

    Výchozím chováním skriptu KUDU (což je nástroj pro generování skriptů nasazení pro Azure App Service) je kontrola balíčků NuGet.

    • Soubor Nuget.exe můžete získat tak, že jej stáhnete odsud. Ve Visual Studio můžete také zapnout „Enable automatic restore of NuGet packages“ a soubor bude do projektu přidán automaticky.

    • Ujistěte se, že je NuGet v proměnné PATH. Zkopírujte soubor nuget.exe do preferovaného umístění (např. c:/Program Files/Nuget/Nuget.exe). Přidejte jej do proměnné prostředí PATH.

    • Ověřte, že je NuGet v PATH, spuštěním cmd.exe a napsáním nuget. Měli byste vidět možnosti příkazu.

  4. Vygenerujte skripty nasazení lokálně

    • Otevřete „Microsoft Azure Command Prompt“

    • Přejděte do složky src svého projektu, jak byste to běžně udělali v okně shellu

    • Spusťte generátor skriptů kudu (wiki najdete na tomto odkazu nebo se podívejte na toto video).

      Napsali byste tedy něco jako:

      kuduscript site deploymentscript --aspNetCore Presentation\Nop.Web\Nop.Web.csproj -s NopCommerce.sln -y

    • Ověřte, že byly vygenerovány 2 soubory (v kořeni lokálního repozitáře):

      .deployment

      deploy.cmd

  5. Spusťte vygenerovaný skript

    • Soubory .deployment a deploy.cmd musíte ponechat v kořeni git repozitáře
    • Upravte deploy.cmd, protože proměnná %DEPLOYMENT_SOURCE% obsahuje kořen git repozitáře. Přidali bychom tedy %DEPLOYMENT_SOURCE%\src\Presentation\Nop.Web\Nop.Web.csproj místo %DEPLOYMENT_SOURCE%\Presentation\Nop.Web\Nop.Web.csproj. Všechny cesty v sekci nasazení musí být opraveny.
    • Spusťte deploy.cmd a ověřte, zda výchozí skript nasazení funguje lokálně. Měl by vytvořit složku \artifact hned vedle vašeho git repozitáře.
  6. Přizpůsobte skript nasazení

    Nyní jsme v závěrečné části. Tady se veškerá práce vyplatí. Chceme upravit následující část:

    ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
    :: Deployment
    :: ----------
    
    echo Handling ASP.NET Core Web Application deployment.
    
    :: 1. Restore nuget packages
    call :ExecuteCmd dotnet restore "%DEPLOYMENT_SOURCE%\NopCommerce.sln"
    IF !ERRORLEVEL! NEQ 0 goto error
    
    :: 2. Build and publish
    call :ExecuteCmd dotnet publish "%DEPLOYMENT_SOURCE%\Presentation\Nop.Web\Nop.Web.csproj" --output "%DEPLOYMENT_TEMP%" --configuration Release
    IF !ERRORLEVEL! NEQ 0 goto error
    
    :: 3. KuduSync
    call :ExecuteCmd "%KUDU_SYNC_CMD%" -v 50 -f "%DEPLOYMENT_TEMP%" -t "%DEPLOYMENT_TARGET%" -n "%NEXT_MANIFEST_PATH%" -p "%PREVIOUS_MANIFEST_PATH%" -i ".git;.hg;.deployment;deploy.cmd"
    IF !ERRORLEVEL! NEQ 0 goto error
    ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
    

    Mezi ::1 a ::2 umístíme naše příkazy pro sestavení pluginů.

    Příklad pro první plugin by vypadal takto:

    :: 1.01 Build plugin customer roles to temporary path
    call :ExecuteCmd dotnet build "%DEPLOYMENT_SOURCE%\src\Plugins\Nop.Plugin.DiscountRules.CustomerRoles\Nop.Plugin.DiscountRules.CustomerRoles.csproj" -c Release
    

Nyní se plugin sestaví při spuštění skriptů nasazení.