Kļūdas 500.19 labošana: konfigurācijas lapa nederīga, izvietojot Blazor projektu IIS

Izpratne par konfigurācijas kļūdu IIS izvietošanā

Blazor projekta izvietošana IIS var būt vienmērīgs process, taču dažreiz rodas kļūdas, kuras var būt grūti diagnosticēt. Viena izplatīta problēma, ar ko saskaras izstrādātāji, ir Kļūda 500.19, kas parasti norāda uz problēmu ar konfigurācijas lapu. Šī kļūda neļauj lietojumprogrammai pareizi palaist.

Kļūda 500.19 parasti norāda uz nepareizu konfigurāciju web.config failu, taču pat pēc tā pārskatīšanas kļūda var saglabāties. Šī situācija var būt nomākta, ja pašā konfigurācijā nekas nav kārtībā. Izstrādātāji bieži ar to saskaras, mēģinot izvietot Blazor lietojumprogrammas, it īpaši, ja kļūdas ziņojums šķiet neskaidrs.

Papildus konfigurācijas problēmām var būt arī pamata atļauju problēmas vai serverī trūkst komponentu. Piemēram, šo kļūdu var izraisīt arī problēmas ar IIS atļaujām vai nepareizi konfigurēta vide. Veiksmīgai izvietošanai ir ļoti svarīgi nodrošināt, lai visi nepieciešamie moduļi un atļaujas ir ieviestas.

Šajā rakstā mēs izpētīsim darbības, kuras varat veikt, lai novērstu problēmu Kļūda 500.19 un atrisināt konfigurācijas problēmas. Pārbaudot failu web.config, pārbaudot atļaujas un pārbaudot servera vidi, varat precīzi noteikt problēmas galveno cēloni.

Izpratne par Blazor izvietošanas kļūdu skriptiem

Pirmais nodrošinātais skripts ir paredzēts, lai apstrādātu iespējamās nepareizās konfigurācijas web.config failu, kas bieži izraisa IIS kļūdu 500.19. Kritiskā sastāvdaļa šeit ir `apdarinātājs, kas integrē lietotni Blazor ar IIS vidi. Šis tags novirza IIS uz pareizo lietojumprogrammas ceļu un nodrošina, ka lietotne darbojas, izmantojot AspNetCoreModuleV2 mitināšanai procesa laikā. Ja šis modulis nav pareizi iestatīts vai konfigurēts, lietojumprogramma Blazor netiks startēta, izraisot kļūdu 500.19. Procesa ceļam un reģistrēšanas parametriem arī jābūt precīziem, jo ​​tie palīdz atrast izpildāmo failu un pārvaldīt žurnāla izvadi.

Otrajā risinājumā mēs risinām iespējamās atļauju problēmas, izmantojot PowerShell. The icacls komanda piešķir nepieciešamās atļaujas grupai IIS_IUSRS, kas ir ļoti svarīgi, lai lietotne Blazor varētu piekļūt saviem direktorijiem un failiem. Bez šīm atļaujām serveris var bloķēt lietojumprogrammas darbību, izraisot kļūdas, piemēram, 500.19. Izmantojot PowerShell, varat ātri iestatīt šīs atļaujas pakešu skriptā, nodrošinot, ka visiem nepieciešamajiem lietotājiem un grupām ir lasīšanas un rakstīšanas piekļuve lietotnes mapei.

Trešais risinājums ir vērsts uz atkļūdošanu, iespējojot standarta reģistrēšanu Blazor konfigurācijā. Iespējošana stdoutLogEnabled palīdz uztvert izpildlaika kļūdas, reģistrējot tās noteiktā failā. Šī metode ir ļoti svarīga izvietošanas laikā, jo šeit var tikt fiksētas daudzas kļūdas, kas nav redzamas pārlūkprogrammā vai IIS kļūdu žurnālos. Pārbaudot žurnālus mapē `./logs/stdout', izstrādātāji var izsekot konkrētas problēmas neatkarīgi no tā, vai tās ir saistītas ar lietojumprogrammas kodu vai vides konfigurācijas problēmām.

Visbeidzot, ceturtais skripts pārbauda, ​​vai AspNetCoreModuleV2 ir instalēts IIS. Tas tiek darīts, izmantojot PowerShell ar Get-WebGlobalModule komandu, kurā ir uzskaitīti visi serverī instalētie globālie moduļi. Ja moduļa trūkst, nākamā komanda, Instalēšana — Windows funkcija, instalē nepieciešamos IIS komponentus. Tas nodrošina, ka lietojumprogrammai Blazor ir visas nepieciešamās atkarības, lai tā darbotos pareizi. Bez šiem moduļiem Blazor lietotnes nevar darboties saskaņā ar IIS, kas izraisa konfigurācijas kļūdas, piemēram, 500.19. Vienības testēšanas skripts nodrošina, ka direktoriju atļaujas un IIS moduļa iestatījumi tiek pareizi lietoti, nodrošinot papildu validācijas slāni izvietošanas procesam.

<?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.

IIS konfigurācijas izpēte Blazor izvietošanai

Izvietojot Blazor projektu IIS, viena izplatīta problēma ir nepareiza IIS moduļu konfigurācija, jo īpaši AspNetCoreModuleV2. Šis modulis ir atbildīgs par .NET Core lietojumprogrammu mitināšanu IIS, un tas ir pareizi jāinstalē. Ja trūkst, tas var izraisīt kļūdas, piemēram, 500.19. Lai lietotne Blazor pareizi darbotos, ir svarīgi nodrošināt, ka ir iespējota pareizā šī moduļa versija. Turklāt, lai atrisinātu šīs problēmas, ir svarīgi pārbaudīt, vai mitināšanas modelis ir iestatīts uz "inprocess" vai "outofprocess".

Vēl viens faktors, kas var izraisīt kļūdu 500.19, ir nepieciešamo komponentu trūkums mērķa vidē. Piemēram, lietojumprogrammas Blazor palaišana serverī, kurā nav instalēta atbilstoša .NET izpildlaika versija, var izraisīt konfigurācijas problēmas. Veiksmīgai izvietošanai ir ļoti svarīgi nodrošināt, lai serverim būtu tāds pats izpildlaiks kā lietotnei Blazor. Turklāt administratoriem arī jāpārbauda, ​​vai vietnei IIS tiek izmantots pareizais lietojumprogrammu kopums, jo īpaši tāda, kas ir konfigurēta .NET Core lietošanai.

Papildus konfigurācijas problēmām izvietošanas procesā svarīga loma ir arī mapju atļaujām. Lai gan jūs esat piešķīris atļaujas IIS_IUSRS grupu, papildu drošības noteikumi var liegt piekļuvi konkrētiem failiem vai direktorijiem. Pārbaudot un modificējot šīs atļaujas, izmantojot tādus rīkus kā PowerShell vai IIS Manager, tiek nodrošināts, ka lietotnei Blazor ir pietiekama piekļuve nepieciešamajiem failiem izpildlaika darbībām. Moduļa iestatīšanas, izpildlaika saderības un atļauju kombinācija ir ļoti svarīga šīs kļūdas novēršanā.