앱 오프라인 파일(app_offline.htm)
참고 항목
이 문서의 최신 버전은 아닙니다. 현재 릴리스는 이 문서의 .NET 9 버전을 참조 하세요.
Important
이 정보는 상업적으로 출시되기 전에 실질적으로 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적, 또는 묵시적인 보증을 하지 않습니다.
현재 릴리스는 이 문서의 .NET 9 버전을 참조 하세요.
앱 오프라인 파일(app_offline.htm)은 ASP.NET Core 모듈에서 앱을 종료하는 데 사용됩니다.
애플리케이션의 루트 디렉터리에서 이름이 app_offline.htm인 파일이 검색되면 ASP.NET Core 모듈은 앱을 자동으로 종료하고 들어오는 요청 처리를 중지하려고 합니다. shutdownTimeLimit에 정의된 시간(초) 후에도 앱이 계속 실행되면 ASP.NET Core 모듈은 실행 중인 프로세스를 중지합니다.
app_offline.htm 파일이 있는 동안 ASP.NET Core 모듈은 파일의 app_offline.htm 내용을 다시 전송하여 요청에 응답합니다. app_offline.htm은 4GB 미만이어야 합니다. app_offline.htm 파일이 제거되면 다음 요청이 앱을 시작합니다.
Out-of-Process 호스팅 모델을 사용할 때 열린 연결이 있으면 앱이 즉시 종료되지 않을 수 있습니다. 예를 들어 WebSocket 연결은 앱 종료를 지연시킬 수 있습니다.
배포 파일이 잠겨 있음
앱이 실행 중이면 배포 폴더의 파일이 잠겨 있습니다. 잠긴 파일은 배포 중에 덮어쓸 수 없습니다.
app_offline.htm은 잠긴 파일을 릴리스하는 기본 메커니즘입니다. app_offline.htm은 웹 배포에서 앱을 제대로 중지 및 시작하는 데 사용됩니다.
app_offline.htm을 수동으로 사용하여 앱을 시작 및 중지할 수 있습니다(PowerShell 5 이상 필요).
$pathToApp = '{PATH TO APP}'
New-Item -Path $pathToApp -Name "app_offline.htm" -ItemType "file"
# Provide script commands here to deploy the app
Remove-Item -Path $pathToApp\app_offline.htm
이전 PowerShell 스크립트에서:
- 자리 표시자
{PATH TO APP}은 앱의 경로입니다. New-Item명령은 앱 풀을 중지합니다.Remove-Item명령은 앱 풀을 시작합니다.New-Item명령과Remove-Item명령 사이에 있는 명령은 개발자가 앱을 배포하기 위해 제공합니다.
서버의 IIS 관리자에서 앱 풀을 수동으로 중지하여 파일의 잠금을 해제할 수도 있습니다. IIS 관리자를 사용하여 앱 풀을 중지하고 다시 시작하는 경우 app_offline.htm 파일을 사용하지 마세요.
ASP.NET Core