Odpravljanje napake 500.19: Konfiguracijska stran je neveljavna med uvajanjem projekta Blazor v IIS

Razumevanje konfiguracijske napake pri uvajanju IIS

Uvajanje projekta Blazor v IIS je lahko gladek proces, vendar se včasih pojavijo napake, ki jih je težko diagnosticirati. Ena pogosta težava, s katero se srečujejo razvijalci, je Napaka 500.19, kar običajno kaže na težavo s konfiguracijsko stranjo. Ta napaka preprečuje pravilen zagon aplikacije.

Napaka 500.19 običajno kaže na napačno konfiguracijo v web.config datoteko, vendar se lahko napaka ponovi tudi po pregledu. Ta situacija je lahko frustrirajoča, če v sami konfiguraciji ni nič narobe. Razvijalci se pogosto soočajo s tem, ko poskušajo uvesti aplikacije Blazor, še posebej, če je sporočilo o napaki nejasno.

Poleg težav s konfiguracijo lahko pride do osnovnih težav z dovoljenji ali manjkajočih komponent na strežniku. To napako lahko na primer sprožijo tudi težave z dovoljenji IIS ali nepravilno konfigurirano okolje. Zagotavljanje vseh potrebnih modulov in dovoljenj je ključnega pomena za uspešno uvajanje.

V tem članku bomo raziskali korake, ki jih lahko uporabite za odpravljanje težav Napaka 500.19 in odpravite težave s konfiguracijo. Če pregledate datoteko web.config, preverite dovoljenja in preverite okolje strežnika, lahko natančno ugotovite glavni vzrok težave.

Razumevanje skriptov napake pri uvajanju Blazorja

Prvi ponujeni skript je zasnovan za obravnavanje morebitnih napačnih konfiguracij znotraj web.config ki pogosto povzroči napako 500.19 v IIS. Ključna komponenta tukaj je ``, ki integrira aplikacijo Blazor z okoljem IIS. Ta oznaka usmeri IIS na pravilno pot aplikacije in zagotovi, da se aplikacija izvaja z uporabo AspNetCoreModuleV2 za gostovanje v procesu. Če ta modul ni pravilno nastavljen ali konfiguriran, se aplikacija Blazor ne zažene, kar povzroči napako 500.19. Tudi pot procesa in parametri beleženja morajo biti natančni, saj pomagajo poiskati izvedljivo datoteko in upravljati izhode dnevnika.

V drugi rešitvi obravnavamo morebitne težave z dovoljenji z uporabo lupine PowerShell. The icacls ukaz dodeli potrebna dovoljenja skupini IIS_IUSRS, ki je ključnega pomena za dostop aplikacije Blazor do njenih imenikov in datotek. Brez teh dovoljenj lahko strežnik blokira delovanje aplikacije, kar vodi do napak, kot je 500.19. Z uporabo lupine PowerShell lahko ta dovoljenja hitro nastavite v paketnem skriptu, s čimer zagotovite, da imajo vsi potrebni uporabniki in skupine dostop za branje in pisanje v mapo aplikacije.

Tretja rešitev se osredotoča na odpravljanje napak z omogočanjem beleženja stdout znotraj konfiguracije Blazor. Omogočanje stdoutLogEnabled pomaga zajeti napake med izvajanjem tako, da jih zabeleži v določeno datoteko. Ta metoda je kritična med uvajanjem, saj je tukaj mogoče ujeti številne napake, ki niso vidne v brskalniku ali dnevnikih napak IIS. S preverjanjem dnevnikov v mapi `./logs/stdout` lahko razvijalci izsledijo določene težave, ne glede na to, ali so povezane s kodo aplikacije ali težavami s konfiguracijo okolja.

Nazadnje, četrti skript preveri, ali je AspNetCoreModuleV2 je nameščen v IIS. To se izvede s pomočjo PowerShell z Get-WebGlobalModule ukaz, ki navaja vse globalne module, nameščene na strežniku. Če modul manjka, naslednji ukaz, Install-WindowsFeature, namesti potrebne komponente IIS. To zagotavlja, da ima aplikacija Blazor vse zahtevane odvisnosti za pravilno delovanje. Brez teh modulov aplikacije Blazor ne morejo delovati pod IIS, kar vodi do konfiguracijskih napak, kot je 500.19. Skript za testiranje enote zagotavlja, da so dovoljenja za imenik in nastavitve modula IIS pravilno uporabljeni, kar zagotavlja dodatno plast preverjanja veljavnosti za postopek uvajanja.

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <location path="." inheritInChildApplications="false">
    <system.webServer>
      <handlers>
        <add name="aspNetCore" path="" verb="" modules="AspNetCoreModuleV2" resourceType="Unspecified" />
      </handlers>
      <aspNetCore processPath=".\BlazorApp2.exe" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout" hostingModel="inprocess" />
    </system.webServer>
  </location>
</configuration>
<!--Ensure the right handler is mapped, and the processPath is correct.-->

# PowerShell script to set proper permissions for the application directory
param (
  [string]$path = "C:\inetpub\wwwroot\BlazorApp"
)
# Grant read and write permissions to IIS_IUSRS
icacls $path /grant "IIS_IUSRS:(OI)(CI)RX"
icacls $path /grant "IIS_IUSRS:(OI)(CI)(F)"
Write-Host "Permissions set successfully on $path"
# Make sure this script is run with administrative privileges.

<configuration>
  <system.webServer>
    <aspNetCore processPath=".\BlazorApp2.exe" stdoutLogEnabled="true" stdoutLogFile=".\logs\stdout" hostingModel="inprocess" />
  </system.webServer>
</configuration>
# After enabling logging, ensure that the "logs" folder exists in the application directory.
# Check the logs for further information on what's causing the deployment issue.
# Disable stdout logging in production to avoid performance issues.

# PowerShell script to check if IIS modules are installed
Import-Module WebAdministration
$modules = Get-WebGlobalModule | Where-Object {$_.Name -eq "AspNetCoreModuleV2"}
if ($modules -eq $null) {
  Write-Host "AspNetCoreModuleV2 is missing. Installing the module..."
  Install-WindowsFeature -Name Web-Asp-Net45
} else {
  Write-Host "AspNetCoreModuleV2 is already installed."
}

using NUnit.Framework;
namespace BlazorApp.Tests
{
  public class DeploymentTests
  {
    [Test]
    public void TestPermissionsAreSetCorrectly()
    {
      var directory = "C:\\inetpub\\wwwroot\\BlazorApp";
      var permissions = new System.Security.AccessControl.DirectorySecurity(directory, System.Security.AccessControl.AccessControlSections.All);
      Assert.IsTrue(permissions.AreAccessRulesProtected == false, "Permissions are incorrect!");
    }
  }
}
# This unit test validates whether the directory permissions are correctly set.

Raziskovanje konfiguracije IIS za uvedbe Blazor

Pri uvajanju projekta Blazor v IIS je pogosta težava neustrezna konfiguracija modulov IIS, zlasti AspNetCoreModuleV2. Ta modul je odgovoren za gostovanje aplikacij .NET Core znotraj IIS in mora biti pravilno nameščen. Če manjka, lahko povzroči napake, kot je 500.19. Zagotavljanje, da je omogočena pravilna različica tega modula, je ključnega pomena za pravilno delovanje aplikacije Blazor. Poleg tega je lahko ključno za rešitev teh težav preverjanje, ali je model gostovanja nastavljen na »inprocess« ali »outofprocess«.

Drug dejavnik, ki lahko vodi do napake 500.19, je pomanjkanje potrebnih komponent v ciljnem okolju. Na primer, zagon aplikacije Blazor na strežniku, ki nima nameščene ustrezne različice izvajalnega okolja .NET, lahko povzroči težave s konfiguracijo. Zagotavljanje, da ima strežnik enak čas izvajanja kot aplikacija Blazor, je ključnega pomena za uspešno uvedbo. Poleg tega bi morali skrbniki tudi preveriti, ali se za spletno mesto v IIS uporablja pravilno področje aplikacij, zlasti tisto, ki je konfigurirano za uporabo .NET Core.

Poleg težav s konfiguracijo igrajo dovoljenja za mape pomembno vlogo v procesu uvajanja. Čeprav ste podelili dovoljenja za IIS_IUSRS skupine, lahko dodatna varnostna pravila preprečijo dostop do določenih datotek ali imenikov. Preverjanje in spreminjanje teh dovoljenj z orodji, kot sta PowerShell ali IIS Manager, zagotavlja, da ima aplikacija Blazor zadosten dostop do potrebnih datotek za operacije med izvajanjem. Kombinacija nastavitve modula, združljivosti med izvajanjem in dovoljenj je ključnega pomena za odpravljanje te napake.