|
1 | | -# Supported Windows Server, version 1903 amd64 tags |
2 | | - |
3 | | - `docker pull mcr.microsoft.com/dotnet/framework/aspnet:4.8-windowsservercore-1903` |
4 | | - |
5 | | -- 4.8-windowsservercore-1903, 4.8, latest ([4.8-windowsservercore-1903/runtime/Dockerfile](https://github.com/Microsoft/aspnet-docker/blob/master/4.8-windowsservercore-1903/runtime/Dockerfile)) |
6 | | - |
7 | | - `docker pull mcr.microsoft.com/dotnet/framework/aspnet:3.5-windowsservercore-1903` |
8 | | - |
9 | | -- 3.5-windowsservercore-1903, 3.5 ([3.5-windowsservercore-1903/runtime/Dockerfile](https://github.com/Microsoft/aspnet-docker/blob/master/3.5-windowsservercore-1903/runtime/Dockerfile)) |
10 | | - |
11 | | -# Supported Windows Server 2019 amd64 tags |
12 | | - |
13 | | - `docker pull mcr.microsoft.com/dotnet/framework/aspnet:4.8-windowsservercore-ltsc2019` |
14 | | - |
15 | | -- 4.8-windowsservercore-ltsc2019, 4.8, latest ([4.8-windowsservercore-ltsc2019/runtime/Dockerfile](https://github.com/Microsoft/aspnet-docker/blob/master/4.8-windowsservercore-ltsc2019/runtime/Dockerfile)) |
16 | | - |
17 | | - `docker pull mcr.microsoft.com/dotnet/framework/aspnet:4.7.2-windowsservercore-ltsc2019` |
18 | | - |
19 | | -- 4.7.2-windowsservercore-ltsc2019, 4.7.2 ([4.7.2-windowsservercore-ltsc2019/runtime/Dockerfile](https://github.com/Microsoft/aspnet-docker/blob/master/4.7.2-windowsservercore-ltsc2019/runtime/Dockerfile)) |
20 | | - |
21 | | - `docker pull mcr.microsoft.com/dotnet/framework/aspnet:3.5-windowsservercore-ltsc2019` |
22 | | - |
23 | | -- 3.5-windowsservercore-ltsc2019, 3.5 ([3.5-windowsservercore-ltsc2019/runtime/Dockerfile](https://github.com/Microsoft/aspnet-docker/blob/master/3.5-windowsservercore-ltsc2019/runtime/Dockerfile)) |
24 | | - |
25 | | -# Windows Server, version 1803 amd64 tags |
26 | | - |
27 | | - `docker pull mcr.microsoft.com/dotnet/framework/aspnet:4.8-windowsservercore-1803` |
28 | | - |
29 | | -- 4.8-windowsservercore-1803, 4.8, latest ([4.8-windowsservercore-1803/runtime/Dockerfile](https://github.com/Microsoft/aspnet-docker/blob/master/4.8-windowsservercore-1803/runtime/Dockerfile)) |
30 | | - |
31 | | - `docker pull mcr.microsoft.com/dotnet/framework/aspnet:4.7.2-windowsservercore-1803` |
32 | | - |
33 | | -- 4.7.2-windowsservercore-1803, 4.7.2, latest ([4.7.2-windowsservercore-1803/runtime/Dockerfile](https://github.com/Microsoft/aspnet-docker/blob/master/4.7.2-windowsservercore-1803/runtime/Dockerfile)) |
34 | | - |
35 | | - `docker pull mcr.microsoft.com/dotnet/framework/aspnet:3.5-windowsservercore-1803` |
36 | | - |
37 | | -- 3.5-windowsservercore-1803, 3.5 ([3.5-windowsservercore-1803/runtime/Dockerfile](https://github.com/Microsoft/aspnet-docker/blob/master/3.5-windowsservercore-1803/runtime/Dockerfile)) |
38 | | - |
39 | | -# Windows Server 2016 amd64 tags |
40 | | - |
41 | | - `docker pull mcr.microsoft.com/dotnet/framework/aspnet:4.8-windowsservercore-ltsc2016` |
42 | | - |
43 | | -- 4.8-windowsservercore-ltsc2016, 4.8, latest ([4.8-windowsservercore-ltsc2016/runtime/Dockerfile](https://github.com/Microsoft/aspnet-docker/blob/master/4.8-windowsservercore-ltsc2016/runtime/Dockerfile)) |
44 | | - |
45 | | - `docker pull mcr.microsoft.com/dotnet/framework/aspnet:4.7.2-windowsservercore-ltsc2016` |
46 | | - |
47 | | -- 4.7.2-windowsservercore-ltsc2016, 4.7.2, latest ([4.7.2-windowsservercore-ltsc2016/runtime/Dockerfile](https://github.com/Microsoft/aspnet-docker/blob/master/4.7.2-windowsservercore-ltsc2016/runtime/Dockerfile)) |
48 | | - |
49 | | - `docker pull mcr.microsoft.com/dotnet/framework/aspnet:4.7.1-windowsservercore-ltsc2016` |
50 | | - |
51 | | -- 4.7.1-windowsservercore-ltsc2016, 4.7.1 ([4.7.1-windowsservercore-ltsc2016/runtime/Dockerfile](https://github.com/Microsoft/aspnet-docker/blob/master/4.7.1-windowsservercore-ltsc2016/runtime/Dockerfile)) |
52 | | - |
53 | | - `docker pull mcr.microsoft.com/dotnet/framework/aspnet:4.7-windowsservercore-ltsc2016` |
54 | | - |
55 | | -- 4.7-windowsservercore-ltsc2016, 4.7 ([4.7-windowsservercore-ltsc2016/runtime/Dockerfile](https://github.com/Microsoft/aspnet-docker/blob/master/4.7-windowsservercore-ltsc2016/runtime/Dockerfile)) |
56 | | - |
57 | | - `docker pull mcr.microsoft.com/dotnet/framework/aspnet:4.6.2-windowsservercore-ltsc2016` |
58 | | - |
59 | | -- 4.6.2-windowsservercore-ltsc2016, 4.6.2 ([4.6.2-windowsservercore-ltsc2016/runtime/Dockerfile](https://github.com/Microsoft/aspnet-docker/blob/master/4.6.2-windowsservercore-ltsc2016/runtime/Dockerfile)) |
60 | | - |
61 | | - `docker pull mcr.microsoft.com/dotnet/framework/aspnet:3.5-windowsservercore-ltsc2016` |
62 | | - |
63 | | -- 3.5-windowsservercore-ltsc2016, 3.5 ([3.5-windowsservercore-ltsc2016/runtime/Dockerfile](https://github.com/Microsoft/aspnet-docker/blob/master/3.5-windowsservercore-ltsc2016/runtime/Dockerfile)) |
64 | | - |
65 | | - |
66 | | ->**Note:** Multi-arch tags, such as 4.7.1, have been updated to use windowsservercore-1709 images if your host is Windows Server 1709 or higher or Windows 10 Fall Creators Update (Version 1709) or higher. You need Docker 17.10 or later to take advantage of these updated tags. |
67 | | -
|
68 | | -These images are updated via [pull requests to the `microsoft/aspnet-docker` GitHub repo](https://github.com/microsoft/aspnet-docker/pulls). |
69 | | - |
70 | | -[](https://hub.docker.com/r/microsoft/aspnet) |
71 | | -[](https://hub.docker.com/r/microsoft/aspnet) |
72 | | - |
73 | | -# What is ASP.NET |
74 | | - |
75 | | -ASP.NET is a high productivity framework for building Web Applications using Web Forms, MVC, Web API and SignalR. |
76 | | - |
77 | | -This repository contains `Dockerfile` definitions for ASP.NET Docker images. These images use the [IIS image](https://hub.docker.com/r/microsoft/iis/) as their base. |
78 | | - |
79 | | -This image contains: |
80 | | -- Windows Server Core as the base OS |
81 | | -- IIS 10 as Web Server |
82 | | -- .NET Framework (multiple versions available) |
83 | | -- .NET Extensibility for IIS |
84 | | - |
85 | | -# How to use these Images |
86 | | - |
87 | | -Copy `4.7\sample\Dockerfile` to your app directory. You would then be able to build and run the site from the app directory. |
88 | | - |
89 | | -``` |
90 | | -$ docker build -t aspnet-site --build-arg site_root=/ . |
91 | | -$ docker run -d -p 8000:80 --name my-running-site aspnet-site |
92 | | -``` |
93 | | - |
94 | | -There is no need to specify an `ENTRYPOINT` in your Dockerfile since the `microsoft/aspnet` base image already includes an entrypoint application that monitors the status of the IIS World Wide Web Publishing Service (W3SVC). |
95 | | - |
96 | | -### Verify in the browser |
97 | | - |
98 | | -> With the current release, you can't use `http://localhost` to browse your site from the container host. This is because of a known behavior in WinNAT, and will be resolved in future. Until that is addressed, you need to use the IP address of the container. |
99 | | -
|
100 | | -Once the container starts, you'll need to finds its IP address so that you can connect to your running container from a browser. You use the `docker inspect` command to do that: |
101 | | - |
102 | | -`docker inspect -f "{{ .NetworkSettings.Networks.nat.IPAddress }}" my-running-site` |
103 | | - |
104 | | -You will see an output similar to this: |
105 | | - |
106 | | -``` |
107 | | -172.28.103.186 |
108 | | -``` |
109 | | - |
110 | | -You can connect the running container using the IP address and configured port, `http://172.28.103.186` in the example shown. |
111 | | - |
112 | | -For a comprehensive tutorial on running an ASP.NET app in a container, check out [the tutorial on the docs site](https://docs.microsoft.com/en-us/dotnet/articles/framework/docker/aspnetmvc). |
113 | | - |
114 | | -## Image variants |
115 | | - |
116 | | -The `microsoft/aspnet` images come in different flavors, each designed for a specific use case. |
117 | | - |
118 | | -### `4.7.2` |
119 | | - |
120 | | -This is the primary image. If you are unsure about what your needs are, you probably want to use this one. |
121 | | - |
122 | | -This image is for ASP.NET applications built for the .NET Framework 4.0 and later versions. It is based on the [dotnet-framework:4.7](https://hub.docker.com/r/microsoft/dotnet-framework/) image and includes .NET Framework Extensibility for IIS. |
123 | | - |
124 | | -### `4.7.1`, `4.7`, `4.6.2` |
125 | | - |
126 | | -These images are for ASP.NET applications that need a specific .NET Framework version and have not been tested with .NET Framework 4.7.2. They are based on the corresponding [dotnet-framework](https://hub.docker.com/r/microsoft/dotnet-framework/) images and include .NET Framework Extensibility for IIS. |
127 | | - |
128 | | -### `3.5` |
129 | | - |
130 | | -This image is for ASP.NET applications built for the .NET Framework 3.5. It is based on the [dotnet-framework:3.5](https://hub.docker.com/r/microsoft/dotnet-framework/) image and includes .NET Framework Extensibility for IIS. |
131 | | - |
132 | | -# Related Repos |
133 | | - |
134 | | -See the following related repos for other application types: |
135 | | - |
136 | | -- [microsoft/dotnet-framework](https://hub.docker.com/r/microsoft/dotnet-framework/) for .NET Framework applications. |
137 | | -- [microsoft/aspnetcore](https://hub.docker.com/r/microsoft/aspnetcore/) for ASP.NET Core applications. |
138 | | -- [microsoft/dotnet](https://hub.docker.com/r/microsoft/dotnet/) for .NET Core images. |
139 | | - |
140 | | -# License |
141 | | - |
142 | | -View [license information](https://www.microsoft.com/net/dotnet_library_license.htm) for the software contained in this image. |
143 | | - |
144 | | -Windows Container images are licensed per the Windows license: |
145 | | - |
146 | | -MICROSOFT SOFTWARE SUPPLEMENTAL LICENSE TERMS |
147 | | - |
148 | | -CONTAINER OS IMAGE |
149 | | - |
150 | | -Microsoft Corporation (or based on where you live, one of its affiliates) (referenced as “us,” “we,” or “Microsoft”) licenses this Container OS Image supplement to you (“Supplement”). You are licensed to use this Supplement in conjunction with the underlying host operating system software (“Host Software”) solely to assist running the containers feature in the Host Software. The Host Software license terms apply to your use of the Supplement. You may not use it if you do not have a license for the Host Software. You may use this Supplement with each validly licensed copy of the Host Software. |
151 | | - |
152 | | -# Supported Docker versions |
153 | | - |
154 | | -This image is officially supported on Docker version 1.12.2. |
155 | | - |
156 | | -Please see [the Docker installation documentation](https://docs.docker.com/installation/) for details on how to upgrade your Docker daemon. |
157 | | - |
158 | | - |
159 | | -# User Feedback |
160 | | - |
161 | | - |
162 | | -## Notes on ASP.NET container images for Windows Server 2019 |
163 | | - |
164 | | -Now that Windows Server 2019 is generally available, we have published ASP.NET container images for Windows Server 2019. You can pull the new Windows Server Image via- |
165 | | -``` |
166 | | -docker pull mcr.microsoft.com/dotnet/framework/aspnet:4.7.2-windowsservercore-ltsc2019 |
167 | | -``` |
168 | | -As you may have noticed in the `docker pull` command, the image is now being served from the Microsoft Container Registry (MCR). Starting with Windows Server 2019 and going forwards, all new tags will be published exclusively to MCR. All existing tags have been syndicated from DockerHub to MCR. |
169 | | -If your existing Dockerfile begins by specifying microsoft/aspnet as the base layer as shown below- |
170 | | -```Dockerfile |
171 | | -FROM microsoft/aspnet:4.7.2-windowsservercore-ltsc2016 |
172 | | -… |
173 | | -``` |
174 | | -Our guidance is to move to adopting MCR as your base layer. You should change your Dockerfile to what’s shown below- |
175 | | -```Dockerfile |
176 | | -FROM mcr.microsoft.com/dotnet/framework/aspnet:4.7.2-windowsservercore-ltsc2016 |
177 | | -… |
178 | | -``` |
179 | | -As part of this transition, we are only changing the source from where you download your images to MCR. DockerHub continues to be the preferred medium for container image discovery. The Microsoft Container Registry does not have its own catalog experience and is meant to support existing catalogs such as Docker Hub, Red Hat Container Catalog, and Azure Marketplace. This syndication model, enabling multiple channels of discovery, with a single download source for Microsoft’s container images. |
180 | | - |
181 | | -## Issues |
182 | | - |
183 | | -If you have any problems with or questions about this image, please contact us through a [GitHub issue](https://github.com/microsoft/aspnet-docker/issues). |
184 | | - |
185 | | -## Documentation |
186 | | - |
187 | | -You can read [documentation for ASP.NET](https://docs.microsoft.com/aspnet/overview), including Docker usage in the [.NET docs](https://docs.microsoft.com/dotnet/framework/docker/aspnetmvc). |
188 | | - |
189 | | -The docs are also [open source on GitHub](https://github.com/dotnet/docs). Contributions are welcome! |
| 1 | +The microsoft/aspnet-docker GitHub project has been archived. Ongoing development of Docker images for ASP.NET can be found in [Microsoft/dotnet-framework-docker](https://github.com/Microsoft/dotnet-framework-docker). |
0 commit comments