An entrypoint process for running IIS in Windows containers
Clone or download

README.md

Microsoft IIS Service Monitor

ServiceMonitor is a Windows executable designed to be used as the entrypoint process when running IIS inside a Windows Server container.

ServiceMonitor monitors the status of the w3svc service and will exit when the service state changes from SERVICE_RUNNING to either one of SERVICE_STOPPED, SERVICE_STOP_PENDING, SERVICE_PAUSED or SERVICE_PAUSE_PENDING.

Additionally, ServiceMonitor will promote environment variables from process environment it's own process environment block to the DefaultAppPool. We achieve this by naively copying all variables in our process environment block except for those Environment variable / value pairs present in this list below.

Environment variable exclusion list

Environment Variable Value
TMP "C:\Users\ContainerAdministrator\AppData\Local\Temp"
TEMP "C:\Users\ContainerAdministrator\AppData\Local\Temp"
USERNAME "ContainerAdministrator"
USERPROFILE "C:\Users\ContainerAdministrator"
APPDATA "C:\Users\ContainerAdministrator\AppData\Roaming"
LOCALAPPDATA "C:\Users\ContainerAdministrator\AppData\Local"
PROGRAMDATA "C:\ProgramData"
PSMODULEPATH "%ProgramFiles%\WindowsPowerShell\Modules;C:\Windows\system32\WindowsPowerShell\v1.0\Modules"
PUBLIC "C:\Users\Public"
USERDOMAIN "User Manager"
ALLUSERSPROFILE "C:\ProgramData"
PATHEXT ".COM;.EXE;.BAT;.CMD;.VBS;.VBE;.JS;.JSE;.WSF;.WSH;.MSC"
PATH *
COMPUTERNAME *
COMSPEC *
OS *
PROCESSOR_IDENTIFIER *
PROCESSOR_LEVEL *
PROCESSOR_REVISION *
PROGRAMFILES *
PROGRAMFILES(X86) *
PROGRAMW6432 *
SYSTEMDRIVE *
WINDIR *
NUMBER_OF_PROCESSORS *
PROCESSOR_ARCHITECTURE *
SYSTEMROOT *
COMMONPROGRAMFILES *
COMMONPROGRAMFILES(X86) *
COMMONPROGRAMW6432 *
DRIVERDATA *

Build

.\build.cmd

Usage

.\ServiceMonitor.exe w3svc

ServiceMonitor is currently distributed as part of the IIS, ASP.NET, and WCF images on DockerHub. We recommend layering your project on top of those official images as running ServiceMonitor directly in your Dockerfile.

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.