Requirement: Need to deploy node web application to on premise IIS 8.5.
Steps:
1. Create a App Pool user and assign the user to IIS_IUSRS group. It’s easy to maintain permissions when we work with windows groups. This is a special group created for IIS and it makes life easy when we move applications to different windows servers.
2. Create Virtual directory for your application and give full permissions to IIS_IUSRS on this directory.
3. Now create a website or application for the virtual directory and set the app pool identity created in step 1.
4. Now download IISNode msiĀ here. please pay attention on documentation relation to url rewrite.
5. After you install msi, run the batch file with admin privileges “C:\Program Files\iisnode\setupsamples.bat”.
6. Open IIS manager and expand default website, you should see samples are deployed under node application. This gave me pretty good understanding for me.
7. I have two different node web applications
Node application is serving both static and Api.
Node application is serving api only and static files are served by IIS.
Node Serving both static file and APi
Create web.config file in the virtual directory and add these settings.
rewrite: Any request comes to web site will be served by app.js
handlers: iisnode is a http handler which will execute app.js using node.
Note: what if don’t have app.js in the root directory? please see next section.
Please remove any hardcode port number from the index.js. port should passed from process “server.listen(process.env.PORT);”
<configuration> | |
<system.webServer> | |
<handlers> | |
<add name="iisnode" path="app.js" verb="*" modules="iisnode" /> | |
</handlers> | |
<rewrite> | |
<rules> | |
<rule name="sample"> | |
<match url="/*" /> | |
<action type="Rewrite" url="app.js" /> | |
</rule> | |
</rules> | |
</rewrite> | |
</system.webServer> | |
</configuration> |
Node Serving APi and IIS serving static content
Create web.config file in the virtual directory and add these settings.
default document: IIS serves default document from subfolder (new). index.html will load all css and other files.
rewrite: url that ends with api will be served by index.js which is under subfolder (server).
Note: Please remove any hardcode port number from the index.js. port should passed from process “server.listen(process.env.PORT);”
<configuration> | |
<system.webServer> | |
<handlers> | |
<add name="iisnode" path="server/index.js" verb="*" modules="iisnode" /> | |
</handlers> | |
<rewrite> | |
<rules> | |
<rule name="sample"> | |
<match url="api/*" /> | |
<action type="Rewrite" url="server/index.js" /> | |
</rule> | |
</rules> | |
</rewrite> | |
<defaultDocument enabled="true"> | |
<files> | |
<add value="new/index.html" /> | |
</files> | |
</defaultDocument> | |
</system.webServer> | |
</configuration> |
Hope this helps.