Aspnetcore.docs: Create an IIS 'first experience' tutorial

[NamedArray]

I can't get past "Deploy the App".

I ended up on this page after following the Tutorials to create a sample .NET Core 2.2 Web API, which I was successful! The "next steps" were to deploy the app.

So... I'm trying to deploy that app to an IIS box running ASP.net Core 2.2 (as per the first half of this guideline).

I'm attempting to follow the section "Deploy the app", but I'm totally lost. There is no context to any of this. This article is nothing but a bunch of words. Who is the intended audience? Do you plan to write something a little more concrete, and easy-to-follow?

IMHO, "installing" and "deploying" should be two separate articles, and they should tie in with the other tutorials.

I've been trying to nail up a sample .NET core site for weeks now. Where can I find a solid example to follow?

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: ec484002-18c1-6a0d-00de-820d56f038d3
• Version Independent ID: 7903ce53-2cbb-f083-7479-c8abc30211a0
• Content: Host ASP.NET Core on Windows with IIS
• Content Source: aspnetcore/host-and-deploy/iis/index.md
• Product: aspnet-core
• Technology: aspnetcore-hostdeploy
• GitHub Login: @guardrex
• Microsoft Alias: riande

[guardrex]

Hello @raydlevel5 ... I sort of agree. :smile:

If we get in the time machine and go back to earlier versions of the topic, that's pretty much what this topic was ... it was a fairly easy-to-consume, shorter!, general purpose, more tutorial-like experience. What's happened in the meantime is that so much more content ... detailed, advanced concept coverage with edge cases ... has been added. We may as well call this (large parts of it anyway) an advanced topic. The step-by-step explanations for set up, configuration, and deployment have been somewhat overtaken by quite a bit of advanced content.

WRT deploying the app, the problem with that section that you ran into is that there are _many ways to "deploy the app,"_ which really just means to place the app in a location that IIS can access (one of the server's hard drives, a network share, etc.). You can even (if using IIS locally on your dev machine or developing on the server itself) point IIS's physical path to the app right at the publish folder of the app in your development project (Yes! ... in the bin folder). That's not common, or recommended (i.e., you get file locks if you don't stop the app pool before you publish again), but it can be done.

Let's do this. I'll have some time later ... in a few weeks. I'll see about enhancing that section with straight-forward options and cross-links to those deployment options.

"installing" and "deploying" should be two separate articles

That's not likely to happen. Management has (to this point anyway) asked for one IIS-based host and deploy topic with hosting bundle installation, IIS config, and deployment, along with the more advanced concepts. However, they might be interested in a _tutorial_ that distills down the most common scenario for IIS as a separate topic. As you say, it would be the basics for a successful first-time experience with IIS. @danroth27 can say if he likes that idea.

WRT ...

I've been trying to nail up a sample .NET core site for weeks now.

If you mean hosted by IIS, you came to the right place. These are the critical (buried :cry:) steps from the topic for an OOB template-based app (such as the one from the tutorial that you worked through) ...

1. IIS configuration
2. Install the .NET Core Hosting Bundle
3. Create the IIS site
4. Deploy the app ... as I was saying ... just get the app into the folder that IIS is using as the Physical path.

Those sections cover the main aspects.

If you have additional questions, either ask me here on this issue or hit up the devs on a support forum, such as Stack Overflow, or a support chat, such as Slack or Gitter ...

• Slack ASP.NET Core Team
• Gitter ASP.NET

Leave this issue open. It will automatically close when I submit the PR to address the Deploy the app section of the topic.

[danroth27]

However, they might be interested in a tutorial that distills down the most common scenario for IIS as a separate topic. As you say, it would be the basics for a successful first-time experience with IIS. @danroth27 can say if he likes that idea.

Sounds great to me :+1:.

[NamedArray]

@guardrex @danroth27

Thank you both. I hope I didn't come across too aggressively. I really appreciate your responses. I plan to check out the gitter link you provided, which appears to be for beginners. I appreciate it.

Basically, I was getting an error when trying to deploy from my desktop to the IIS box. I probably don't have the Deploy Profile setup correctly. Additionally, I was confused about which associated config files to modify (for both IIS itself, and the project's files).

Anyway, I will keep trying, thanks for the links.

[guardrex]

Deploy Profile setup correctly

To test/confirm that that's the problem, do a folder publish of the app, move the app to the deployment folder on the server manually (from the publish folder in the project to the server via USB flash drive). If the app fires right up from IIS, then yes, it's likely the publish profile/WebDeploy setup/configuration that's breaking it.