Docs: [NewTopic] Run an ASP.NET Core app in a Docker container

[JRAlexander]

[NewTopic] Run an ASP.NET Core app in a Docker container

1. Table of Contents.
   
   
   
   • TBD
   
   
2. Abstract
   Get started with ASP.NET Core apps in Docker.
3. Outline
   -[ ] Either CLI or VS oriented. Maybe docs for both?
4. Reviewer Requests
   @Rick-Anderson @scottaddie @rachelappel @erickson-doug

[mairaw]

@JRAlexander why is this one external? Will this one be done on aspnet/docs repo instead?

[JRAlexander]

Yes, just placed here for tracking

[mairaw]

Do we have an issue in the aspnet/docs too or just here @JRAlexander?

[scottaddie]

For anything Docker-related in ASP.NET Core that John isn't already working on, feel free to create an issue and assign to me. I don't see any issues there right now.

[danroth27]

We have a bunch of docker content already: https://docs.microsoft.com/en-us/aspnet/core/publishing/docker. What would this cover that isn't already covered?

[mairaw]

Not sure if we need new ones. @JRAlexander and @kendrahavens can probably comment on this.

However, folks seem to be complaining that the topic linked from the ASP.NET TOC (https://docs.microsoft.com/en-us/azure/vs-azure-tools-docker-hosting-web-apps-in-docker) is outdated. @mlearned seems to be the author of that. @CamSoper would you be the one responsible for updating that one? (The topic also seems to be not connected to the TOC)

[kendrahavens]

If a user want to learn how to Dockerize a .NET Core or ASP.NET Core app and they landed here: https://docs.microsoft.com/en-us/aspnet/core/publishing/docker. They would probably click on this link: Building Docker Images for .NET Core Applications which is quite outdated. Also, I like this topic name more. It answers the question "How do I run my app in a container?" better than "Building Docker Images for .NET Core Apps" does.

@JRAlexander, Some of the other links under https://docs.microsoft.com/en-us/dotnet/standard/microservices-architecture do overlap with other topics, though I think there should still be easy an cli getting started example. The VS docs here look fairly up-to-date. It'd be good to peruse these and link where necessary in our .NET specific docs. I think Intro to Containers and Docker may take "Intro to .NET and Docker".

[JRAlexander]

@danroth27, @scottaddie - I think the https://docs.microsoft.com/en-us/dotnet/core/docker/visual-studio-tools-for-docker article would satisfy this issue from a VS point of view, but it probably needs to be moved to the asp.net repo, as it's asp.net centric. I don't think it really belongs in it's current location.

[scottaddie]

@JRAlexander I would be okay with your proposed move. We already link to this doc from the Hosting and deployment/Host in Docker/Visual Studio Tools for Docker TOC node.

@danroth27 Thoughts?

[danroth27]

Yup, I'm fine with that.

[JRAlexander]

Cool! I will sync up with @scottaddie on how best to make that happen smoooothly! :)