나노 서버에 ASP.NET Core 응용 프로그램 배포하기

개요

나노 서버(Nano Server)는 서버 코어(Server Core) 및 일반적인 GUI 기반의 서버에 비해 극단적으로 작은 풋 프린트와 향상된 보안, 그리고 더 나은 서비스를 제공해주는 Windows Server 2016의 설치 옵션 중 하나입니다. 보다 자세한 내용은 공식 나노 서버 문서를 참고하시기 바랍니다. 직접 나노 서버를 사용해볼 수 있는 방법에는 다음과 같은 세 가지 방법이 존재합니다:

1. Windows Server 2016 Technical Preview 5 ISO 파일을 다운로드 받아서 직접 나노 서버 이미지를 빌드합니다.
2. 나노 서버 개발자 VHD를 다운로드 받습니다.
3. Azure Gallery에서 제공해주는 나노 서버 이미지를 이용해서 Azure에 가상 머신(VM)을 생성합니다. 만약 Azure 계정이 없다면 무료 Azure 계정을 만들 수 있습니다.

본문에서는 Windows Server Technical Preview 5를 기반으로 미리 빌드된 나노 서버 개발자 VHD를 사용합니다.

본 자습서의 내용을 따라해보려면 기존 ASP.NET Core 응용 프로그램의 게시된 출력이 필요합니다. 준비된 응용 프로그램이 64 비트 프로세스에서 실행되도록 빌드됐는지 확인하시기 바랍니다.

Install-PackageProvider NanoServerPackage
Import-PackageProvider NanoServerPackage
Install-NanoServerPackage -Name Microsoft-NanoServer-IIS-Package -ToVhd <vhd-file-path>

나노 서버 인스턴스 구성하기

다운로드 받은 VHD 파일을 이용해서 개발 머신에 새로운 Hyper-V 가상 머신을 생성하고 실행합니다. 생성한 가상 머신에 로그인하려면 먼저 관리자 비밀번호를 설정해야 합니다. 가상 머신의 콘솔에서 F11을 눌러서 관리자 비밀번호를 설정합니다.

로컬 비밀번호의 설정을 마친 뒤부터는, PowerShell Remoting을 이용해서 나노 서버를 구성하게 됩니다.

$nanoServerIpAddress = "10.83.181.14"
Set-Item WSMan:\localhost\Client\TrustedHosts "$nanoServerIpAddress" -Concatenate -Force

$nanoServerSession = New-PSSession -ComputerName $nanoServerIpAddress -Credential ~\Administrator
Enter-PSSession $nanoServerSession

파일 공유 생성하기

게시된 응용 프로그램을 나노 서버로 복사하려면 파일 공유를 생성해야 합니다. 원격 세션에서 다음 명령을 실행합니다:

mkdir C:\PublishedApps\AspNetCoreSampleForNano
netsh advfirewall firewall set rule group="File and Printer Sharing" new enable=yes
net share AspNetCoreSampleForNano=c:\PublishedApps\AspNetCoreSampleForNano /GRANT:EVERYONE`,FULL

이 명령을 실행하고 나면 호스트 머신의 윈도우 탐색기에서 \\<nanoserver-ip-address>\AspNetCoreSampleForNano로 이동해서 공유에 접근할 수 있습니다.

방화벽 포트 열기

원격 세션에서 다음 명령을 실행해서 TCP 트래픽을 수신할 수 있도록 방화벽의 포트를 엽니다.

New-NetFirewallRule -Name "AspNet5 IIS" -DisplayName "Allow HTTP on TCP/8000" -Protocol TCP -LocalPort 8000 -Action Allow -Enabled True

IIS 설치하기

PowerShell 갤러리를 이용해서 NanoServerPackage 공급자를 추가합니다. 이 공급자를 설치한 다음 임포트하면, Windows 패키지를 설치할 수 있습니다.

열어 놓은 원격 PowerShell 세션에서 다음 명령을 실행합니다:

Install-PackageProvider NanoServerPackage
Import-PackageProvider NanoServerPackage
Install-NanoServerPackage -Name Microsoft-NanoServer-IIS-Package

정상적으로 IIS가 설치됐는지 확인할 수 있는 가장 간단한 방법은 http://<nanoserver-ip-address>/ URL을 방문해서 환영 페이지가 나타나는지를 살펴보는 것입니다. IIS가 설치되면 기본적으로 80번 포트를 수신하는 Default Web Site라는 웹 사이트가 만들어집니다.

ASP.NET Core Module(ANCM) 설치하기

ASP.NET Core Module은 ASP.NET Core HTTP 리스너의 프로세스 관리와 이 모듈이 관리하는 프로세스에 대한 프록시 요청을 담당하는 IIS 7.5+ 모듈입니다. 현재 릴리즈에서는 IIS에 ASP.NET Core Module을 설치하는 작업은 직접 수작업으로 처리해야 합니다. 먼저 일반적인 머신에 (나노 서버가 아닌) .NET Core Windows Server Hosting 번들 버전을 설치합니다. 그런 다음, 일반적인 머신에 설치된 다음 파일들을 앞의 절에서 만들었던 파일 공유에 복사합니다.

일반 머신에서 (나노 서버가 아닙니다) 다음 명령들을 실행합니다:

copy C:\windows\system32\inetsrv\aspnetcore.dll \\<nanoserver-ip-address>\AspNetCoreSampleForNano
copy C:\windows\system32\inetsrv\config\schema\aspnetcore_schema.xml \\<nanoserver-ip-address>\AspNetCoreSampleForNano

그런 다음, 나노 머신에서 방금 파일 공유에 복사해 놓은 파일들을 다시 적절한 위치로 복사합니다. 다음과 같은 복사 명령을 실행합니다:

copy C:\PublishedApps\AspNetCoreSampleForNano\aspnetcore.dll C:\windows\system32\inetsrvcopy C:\PublishedApps\AspNetCoreSampleForNano\aspnetcore_schema.xml C:\windows\system32\inetsrv\config\schema\

그리고 원격 세션에서 다음 스크립트를 실행합니다:

# Backup existing applicationHost.config
copy C:\Windows\System32\inetsrv\config\applicationHost.config C:\Windows\System32\inetsrv\config\applicationHost_BeforeInstallingANCM.config

Import-Module IISAdministration

# Initialize variables
$aspNetCoreHandlerFilePath="C:\windows\system32\inetsrv\aspnetcore.dll"
Reset-IISServerManager -confirm:$false
$sm = Get-IISServerManager

# Add AppSettings section 
$sm.GetApplicationHostConfiguration().RootSectionGroup.Sections.Add("appSettings")

# Set Allow for handlers section
$appHostconfig = $sm.GetApplicationHostConfiguration()
$section = $appHostconfig.GetSection("system.webServer/handlers")
$section.OverrideMode="Allow"

# Add aspNetCore section to system.webServer
$sectionaspNetCore = $appHostConfig.RootSectionGroup.SectionGroups["system.webServer"].Sections.Add("aspNetCore")
$sectionaspNetCore.OverrideModeDefault = "Allow"
$sm.CommitChanges()

# Configure globalModule
Reset-IISServerManager -confirm:$false
$globalModules = Get-IISConfigSection "system.webServer/globalModules" | Get-IISConfigCollection
New-IISConfigCollectionElement $globalModules -ConfigAttribute @{"name"="AspNetCoreModule";"image"=$aspNetCoreHandlerFilePath}

# Configure module
$modules = Get-IISConfigSection "system.webServer/modules" | Get-IISConfigCollection
New-IISConfigCollectionElement $modules -ConfigAttribute @{"name"="AspNetCoreModule"}

# Backup existing applicationHost.config
copy C:\Windows\System32\inetsrv\config\applicationHost.config C:\Windows\System32\inetsrv\config\applicationHost_AfterInstallingANCM.config

.NET Core 프레임워크 설치하기

이식 가능한 응용 프로그램(Portable Application)을 게시하기 위해서는 대상 머신에 .NET Core가 설치되어 있어야만 합니다. 원격 Powershell 세션에서 다음 Powershell 스크립트를 실행해서 나노 서버에 .NET 프레임워크를 설치합니다.

$SourcePath = "https://go.microsoft.com/fwlink/?LinkID=809115"
$DestinationPath = "C:\dotnet"

$EditionId = (Get-ItemProperty -Path 'HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion' -Name 'EditionID').EditionId

if (($EditionId -eq "ServerStandardNano") -or
    ($EditionId -eq "ServerDataCenterNano") -or
    ($EditionId -eq "NanoServer") -or
    ($EditionId -eq "ServerTuva")) {

    $TempPath = [System.IO.Path]::GetTempFileName()
    if (($SourcePath -as [System.URI]).AbsoluteURI -ne $null)
    {
        $handler = New-Object System.Net.Http.HttpClientHandler
        $client = New-Object System.Net.Http.HttpClient($handler)
        $client.Timeout = New-Object System.TimeSpan(0, 30, 0)
        $cancelTokenSource = [System.Threading.CancellationTokenSource]::new()
        $responseMsg = $client.GetAsync([System.Uri]::new($SourcePath), $cancelTokenSource.Token)
        $responseMsg.Wait()
        if (!$responseMsg.IsCanceled)
        {
            $response = $responseMsg.Result
            if ($response.IsSuccessStatusCode)
            {
                $downloadedFileStream = [System.IO.FileStream]::new($TempPath, [System.IO.FileMode]::Create, [System.IO.FileAccess]::Write)
                $copyStreamOp = $response.Content.CopyToAsync($downloadedFileStream)
                $copyStreamOp.Wait()
                $downloadedFileStream.Close()
                if ($copyStreamOp.Exception -ne $null)
                {
                    throw $copyStreamOp.Exception
                }
            }
        }
    }
    else
    {
        throw "Cannot copy from $SourcePath"
    }
    [System.IO.Compression.ZipFile]::ExtractToDirectory($TempPath, $DestinationPath)
    Remove-Item $TempPath
}

응용 프로그램 게시하기

파일 공유에 기존 응용 프로그램의 게시된 출력을 복사합니다.

그러나 그 전에 먼저, 나노 서버에 추출된 dotnet.exe 파일의 위치를 바라보도록 web.config 파일의 구성을 변경해야 합니다. 또는 Path에 dotnet.exe의 경로를 추가할 수도 있습니다.

가령 다음은 Path에 dotnet.exe의 경로가 존재하지 않는 경우를 가정하고 구성한 web.config 파일의 한 예입니다:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <system.webServer>
    <handlers>
      <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModule" resourceType="Unspecified" />
    </handlers>
    <aspNetCore processPath="C:\dotnet\dotnet.exe" arguments=".\AspNetCoreSampleForNano.dll" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout" forwardWindowsAuthToken="true" />
  </system.webServer>
</configuration>

원격 세션에서 다음 명령들을 실행해서 IIS에 게시된 응용 프로그램을 위한 새로운 사이트를 생성합니다. 참고로 이 스크립트는 편의를 위해서 DefaultAppPool을 사용하고 있습니다. 응용 프로그램 풀에 대한 추가적인 고려사항들에 대해서는 Application Pools 문서를 참고하시기 바랍니다.

Import-module IISAdministration
New-IISSite -Name "AspNetCore" -PhysicalPath c:\PublishedApps\AspNetCoreSampleForNano -BindingInformation "*:8000:"

나노 서버에서 .NET Core CLI 실행시 발생하는 알려진 문제점 및 해결방안

나노 서버 Technical Preview 5 버전에서 .NET Core CLI를 사용하기 위해서는 c:\windows\system32\forwarders 폴더의 모든 DLL 파일들을 c:\windows\system32 폴더에 복사해야 합니다. 이 버그는 이후 릴리즈에서 해결되었습니다.

그리고 dotnet publish 명령을 사용하는 경우에도 역시 c:\windows\system32\forwarders 폴더의 모든 DLL 파일들을 게시 디렉터리에 복사해야 합니다.

만약 사용 중인 나노 서버 Preview 5 빌드가 업데이트 되거나 서비스 된다면, 해당 DLL들 중 일부도 업데이트 되었을 수 있으므로, 반드시 이 작업을 다시 수행해주시기 바랍니다.

응용 프로그램 실행하기

이제 브라우저에서 http://<nanoserver-ip-address>:8000 URL로 이동하면 게시된 웹 응용 프로그램에 정상적으로 접근할 수 있어야 합니다. Log creation and redirection 문서의 설명대로 로깅을 구성하면 C:\PublishedApps\AspNetCoreSampleForNano\logs 에서 로그를 확인할 수도 있습니다.

Failed to load the dll from [C:\dotnet\shared\Microsoft.NETCore.App\1.0.0\hostpolicy.dll], HRESULT: 0x8007007E
An error occurred while loading required library hostpolicy.dll from [C:\dotnet\shared\Microsoft.NETCore.App\1.0.0]