jsam2412 / dockerfiles-windows

Various Dockerfiles for Windows

dockerfiles-windows

Various Dockerfiles for Windows. You probably have heard about Docker and that everyone uses Linux Containers. You can do this on Windows as well today with the Windows 10 1607 or Windows Server 2016 using Windows Containers.

Getting started

Windows 10

• Physical Machine / Virtual Machine
  • Install Docker for Windows Beta 26 on your Windows 10 1607 machine.
• Get a Windows 10 Virtual Machine
  • Packer and Vagrant
    • Use Packer with this packer-windows templates to build the windows_10 Vagrant box.
    • Use Vagrant and this docker-windows-beta Vagrantfile to have Docker for Windows and lots of Docker Tools installed.
• Clone this repo and create some Docker images. Both microsoft/nanoserver and microsoft/windowsservercore base images can be used on Windows 10.

Windows Server 2016

• Register to evaluate Windows Server 2016.
• Get a Windows Server 2016 Virtual Machine
  • Packer and Vagrant
    • Use Packer with this packer-windows templates to build the windows_2016_docker Vagrant box.
    • Use Vagrant and this docker-windows-box Vagrantfile to have Docker and lots of Docker Tools installed.
  • Azure
    • Deploy TP4 VM to Azure with docker-windows-azure template
    • Create a Windows Server 2016 Core with Containers TP4 Virtual Machine
  • Physical Machine / Virtual Machine
    • Read Preparing a physical machine or an existing virtual machine for Windows Server Containers to install Docker into Windows 2016 TP4.
• Clone this repo and create some Docker images

Further reading

• Performance Tuning Guidelines for Windows Server 2016
• Read the Quick Start: Windows Server Containers and Docker to get started with a first tutorial.
• Read my blog post Create a Node.js Container image for Windows for my first test drive with Docker on Windows.
• Image what will happen when Kitematic meets Windows Containers.
• More Dockerfiles for Windows: Buc Rogers: Dockerfiles-for-Windows
• Windows Server Containers Examples: https://github.com/Microsoft/Virtualization-Documentation/tree/master/windows-container-samples/windowsservercore
• Networking
  • Windows NAT (WinNAT) — Capabilities and limitations, 2016-05-25
  • Windows Container Networking, 2016-08-22
  • Docker Compose and Networking blog post, 2016-10-18
  • Published Ports On Windows Containers Don't Do Loopback, 2016-10-20

PowerShell tricks

Porting Dockerfiles from Linux to Windows I found it useful to use PowerShell at some points. Here are some PowerShell tricks that were useful for me.

Feedback and Pull Requests are welcome

If you have some improvements, bug fixes, some new Dockerfiles or more PowerShell tricks, just send me a PR. If you have questions or problems, open an issue for discussion.

Troubleshooting

If you have trouble running Windows Containers you should have a look at https://docs.microsoft.com/virtualization/windowscontainers/troubleshooting

Invoke-WebRequest https://aka.ms/Debug-ContainerHost.ps1 -UseBasicParsing | Invoke-Expression

License

MIT - for more details see the LICENSE file.