Docker for windows server 2016

Today, Microsoft announced the general availability of Windows Server 2016, and with it, Docker engine running containers natively on Windows. This blog post describes how to get setup to run Docker Windows Containers on Windows 10 or using a Windows Server 2016 VM. Check out the companion blog posts on the technical improvements that have made Docker containers on Windows possible and the post announcing the Docker Inc. and Microsoft partnership.

Before getting started, It’s important to understand that Windows Containers run Windows executables compiled for the Windows Server kernel and userland (either windowsservercore or nanoserver). To build and run Windows containers, a Windows system with container support is required.

Windows 10 with Anniversary Update

For developers, Windows 10 is a great place to run Docker Windows containers and containerization support was added to the the Windows 10 kernel with the Anniversary Update (note that container images can only be based on Windows Server Core and Nanoserver, not Windows 10). All that’s missing is the Windows-native Docker Engine and some image base layers.

The simplest way to get a Windows Docker Engine is by installing the Docker for Windows public beta (direct download link). Docker for Windows used to only setup a Linux-based Docker development environment (slightly confusing, we know), but the public beta version now sets up both Linux and Windows Docker development environments, and we’re working on improving Windows container support and Linux/Windows container interoperability.

With the public beta installed, the Docker for Windows tray icon has an option to switch between Linux and Windows container development. For details on this new feature, check out Stefan Scherers blog post.

Switch to Windows containers and skip the next section.

Windows Server 2016

Windows Server 2016 is the where Docker Windows containers should be deployed for production. For developers planning to do lots of Docker Windows container development, it may also be worth setting up a Windows Server 2016 dev system (in a VM, for example), at least until Windows 10 and Docker for Windows support for Windows containers matures.

For Microsoft Ignite 2016 conference attendees, USB flash drives with Windows Server 2016 preloaded are available at the expo. Not at ignite? Download a free evaluation version and install it on bare metal or in a VM running on Hyper-V, VirtualBox or similar. Running a VM with Windows Server 2016 is also a great way to do Docker Windows container development on macOS and older Windows versions.

Once Windows Server 2016 is running, log in, run Windows Update to ensure you have all the latest updates and install the Windows-native Docker Engine directly (that is, not using “Docker for Windows”). Run the following in an Administrative PowerShell prompt:

Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force
Install-Module -Name DockerMsftProvider -Force
Install-Package -Name docker -ProviderName DockerMsftProvider -Force
Restart-Computer -Force

Docker Engine is now running as a Windows service, listening on the default Docker named pipe. For development VMs running (for example) in a Hyper-V VM on Windows 10, it might be advantageous to make the Docker Engine running in the Windows Server 2016 VM available to the Windows 10 host:

# Open firewall port 2375
netsh advfirewall firewall add rule name="docker engine" dir=in action=allow protocol=TCP localport=2375

# Configure Docker daemon to listen on both pipe and TCP (replaces docker --register-service invocation above)
Stop-Service docker
dockerd --unregister-service
dockerd -H npipe:// -H 0.0.0.0:2375 --register-service
Start-Service docker

The Windows Server 2016 Docker engine can now be used from the VM host by setting DOCKER_HOST:

$env:DOCKER_HOST = "<ip-address-of-vm>:2375"

See the Microsoft documentation for more comprehensive instructions.

Running Windows containers

First, make sure the Docker installation is working:

> docker version
Client:
Version:      1.12.1
API version:  1.24
Go version:   go1.6.3
Git commit:   23cf638
Built:        Thu Aug 18 17:32:24 2016
OS/Arch:      windows/amd64
Experimental: true

Server:
Version:      1.12.2-cs2-ws-beta
API version:  1.25
Go version:   go1.7.1
Git commit:   62d9ff9
Built:        Fri Sep 23 20:50:29 2016
OS/Arch:      windows/amd64

Next, pull a base image that’s compatible with the evaluation build, re-tag it and to a test-run:

docker pull microsoft/windowsservercore
docker run microsoft/windowsservercore hostname
69c7de26ea48

Building and pushing Windows container images

Pushing images to Docker Cloud requires a free Docker ID. Storing images on Docker Cloud is a great way to save build artifacts for later user, to share base images with co-workers or to create build-pipelines that move apps from development to production with Docker.

Docker images are typically built with docker build from a Dockerfile recipe, but for this example, we’re going to just create an image on the fly in PowerShell.

"FROM microsoft/windowsservercore `n CMD echo Hello World!" | docker build -t <docker-id>/windows-test-image -

Test the image:

docker run <docker-id>/windows-test-image
Hello World!

Login with docker login and then push the image:

docker push <docker-id>/windows-test-image

Images stored on Docker Cloud available in the web interface and public images can be pulled by other Docker users.

Using docker-compose on Windows

Docker Compose is a great way develop complex multi-container consisting of databases, queues and web frontends. Compose support for Windows is still a little patchy and only works on Windows Server 2016 at the time of writing (i.e. not on Windows 10).

To develop with Docker Compose on a Windows Server 2016 system, install compose too (this is not required on Windows 10 with Docker for Windows installed):

Invoke-WebRequest https://dl.bintray.com/docker-compose/master/docker-compose-Windows-x86_64.exe -UseBasicParsing -OutFile $env:ProgramFiles\docker\docker-compose.exe

To try out Compose on Windows, clone a variant of the ASP.NET Core MVC MusicStore app, backed by a SQL Server Express 2016 database. A correctly tagged microsoft/windowsservercore image is required before starting.

git clone https://github.com/friism/Musicstore
...
cd Musicstore
docker-compose -f .\docker-compose.windows.yml build
...
docker-compose -f .\docker-compose.windows.yml up
...

To access the running app from the host running the containers (for example when running on Windows 10 or if opening browser on Windows Server 2016 system running Docker engine) use the container IP and port 5000. localhost will not work:

docker inspect -f "{{ .NetworkSettings.Networks.nat.IPAddress }}" musicstore_web_1
172.21.124.54

If using Windows Server 2016 and accessing from outside the VM or host, simply use the VM or host IP and port 5000.

Summary

This post described how to get setup to build and run native Docker Windows containers on both Windows 10 and using the recently published Windows Server 2016 evaluation release. To see more example Windows Dockerfiles, check out the Golang, MongoDB and Python Docker Library images.
Please share any Windows Dockerfiles or Docker Compose examples your build with @docker on Twitter using the tag #windows. And don’t hesitate to reach on the Docker Forums if you have questions.

More Resources:

• Sign up to be notified of GA and the Docker Datacenter for Windows Beta
• Docker for Windows Server
• Learn more about the Docker and Microsoft partnership

Enterprise servers are not always exposed to the internet and are often sitting behind firewalls with restrictions to prohibit any malicious activity on an internet-facing server. But to install a Docker image from the Docker Hub, you need internet access. To overcome this, you can configure a Docker client to use a proxy server if one is available, but there is another way around this, which we will discuss in the following high-level steps.

Install Docker with internet access

Log in to a Windows 10 machine that has internet access, probably your laptop or workstation, and use the following URL for instructions to install Docker on Windows 10.

Once the installation is complete, run a PowerShell console and verify the Docker installation on Windows 10:

docker --version
Get-Service *docker*

Pull the image from the Docker Hub and export it

Now use Docker to download or pull a Docker test image from the Docker Hub. We’ll later use this image to test a Docker installation on Windows Server 2016.

docker pull hello-world:nanoserver-sac2016

After downloading the image, use the docker save command to export and save the image to a file («nano.tar» for example).

docker save -o nano.tar hello-world:nanoserver-sac2016

This will save the image as «nano.tar» in your current working directory.

Download Docker Enterprise

Now that we have a Docker image, let’s use PowerShell to download «Docker Enterprise Edition» to our local workstation as a zip file. We will need this because we don’t have internet access on Windows Server 2016.

$URL = ‘https://download.docker.com/components/engine/windows-server/17.06/docker-17.06.2-ee-16.zip’

invoke-webrequest -UseBasicparsing -Outfile docker-17.06.2-ee-16.zip -Uri $URL

We can now copy the two files: Docker Enterprise Edition for Windows Server 2016 as a zipped file and a test Docker image we have saved as «nano.tar» in the previous step to the target Windows 2012 Server.

Install Docker Enterprise on Windows Server 2016

Let’s switch to the Windows 2012 Server and assume you have placed the Docker Enterprise installation files and the image on D:\. So the first step required is installing the container feature on the Windows 2012 Server and then rebooting the machine when prompted.

# Install Docker
Install-WindowsFeature containers | Out-Null

Once the machine is up and running again, launch a PowerShell console. Then unzip the compressed file and move the Docker executables to the system’s program files.

# cd <path to the zip file and docker image>
cd d:\

# Extract the archive.
Expand-Archive docker-17.06.2-ee-16.zip -DestinationPath $Env:ProgramFiles  Force

Next, use the following PowerShell commands to add the Docker folder location to the system’s PATH variable and run the Docker executable as a service.

# Add Docker to the path for the current session and to PATH to persist across sessions.
$env:path += ";$env:ProgramFiles\docker"

$newPath = "$env:ProgramFiles\docker;" +
[Environment]::GetEnvironmentVariable("PATH",
[EnvironmentVariableTarget]::Machine)

[Environment]::SetEnvironmentVariable("PATH", $newPath,
[EnvironmentVariableTarget]::Machine)

# Register the Docker daemon as a service.
dockerd --register-service

# Start the Docker service.
Start-Service docker

This will complete the Docker Enterprise setup on Windows Server 2016.

Load and run the image

From the PowerShell console, use the docker load command to load the «nano.tar» file (the Docker image) into our current session. Verify the image is loaded and available and the Docker service is running.

# docker load image offline
docker load -i nano.tar

# list all available images
docker images

# make sure docker service is running
Get-Service *docker

Now run the test container image using the docker run command. If you get results like in the following screenshot, this means installation was successful and the container is running properly.

Subscribe to 4sysops newsletter!

# run the test container
docker run hello-world:nanoserver-sac2016

Conclusion

Downloading Docker container images from the Docker Hub or Registry is often restricted on enterprise servers. One workaround is to set up a proxy server to allow such access. But in case this is not available or allowed, you can pull and save a Docker image to a machine (Windows 10) that has internet access. Later, you can export the image as a compressed file and move it to the enterprise server (Windows Server 2016) that cannot access the internet. Once you have the image as a compressed file, you can directly load it using the docker load -i <image file name> command on Windows Server 2016 and run containers with the image.

This multi-part blog series will show how to configure, build, and run Docker containers on Windows. The first part showed how to setup Windows Server 2016 on Virtual Box for Docker Containers. This part will install the operating system images and configure Docker. Instructions are available at msdn.microsoft.com/virtualization/windowscontainers/deployment/deployment.

How to Install Docker in Windows Server 2016 Container Feature

Start PowerShell:

Install the container feature:

Restart the Virtual Machine:

Install Windows Server 2016 Base Docker Image

Base operating system can be installed using ContainerImage PowerShell module. Install the module as:

See the list of operating system images that are available:

Install the Windows Server Core base OS image:

Install Docker on Windows Server 2016

Download the script to install Docker:

Run the script:

Check Docker version:

Check the list of images and tag the base OS image to latest:

Check docker --help command:

Subsequent blogs will show how other fun things with Docker on Windows Server 2016!

Some further topics to read …

• Windows Server Containers – Quick Start
• Windows Server 2016 Technology Preview 5
• Docker Documentation
• Getting Started with Docker for Java developers

Posted by Arun Gupta, VP, Developer Advocacy, Couchbase

Arun Gupta is the vice president of developer advocacy at Couchbase. He has built and led developer communities for 10+ years at Sun, Oracle, and Red Hat. He has deep expertise in leading cross-functional teams to develop and execute strategy, planning and execution of content, marketing campaigns, and programs. Prior to that he led engineering teams at Sun and is a founding member of the Java EE team.

Gupta has authored more than 2,000 blog posts on technology. He has extensive speaking experience in more than 40 countries on myriad topics and is a JavaOne Rock Star for three years in a row. Gupta also founded the Devoxx4Kids chapter in the US and continues to promote technology education among children. An author of several books on technology, an avid runner, a globe trotter, a Java Champion, a JUG leader, NetBeans Dream Team member, and a Docker Captain, he is easily accessible at @arungupta.

Windows Server 2016 предоставляет возможность использования Docker-контейнеров для упрощения разработки, тестирования и развёртывания приложений. Docker является одним из самых популярных инструментов для контейнеризации приложений, позволяющим запускать и управлять приложениями и их зависимостями в изолированной среде, гарантируя их надежность и переносимость.

Чтобы начать использовать Docker в Windows Server 2016, необходимо установить Docker Engine, который является основой для работы с Docker-контейнерами. Docker Engine можно скачать с официального сайта проекта Docker. Установщик Docker Engine для Windows Server 2016 предоставляет простой интерфейс для установки и настройки Docker и его зависимостей.

После установки Docker Engine в Windows Server 2016, можно начать создавать и запускать Docker-контейнеры. Для этого необходимо использовать Docker CLI (Command Line Interface), который позволяет управлять Docker-контейнерами с помощью команд в командной строке. Docker CLI предоставляет широкий набор команд для управления Docker-контейнерами, таких как создание, запуск, остановка и удаление контейнеров, а также управление Docker-образами и сетями.

Важно отметить, что Docker в Windows Server 2016 поддерживает две разные технологии контейнеризации: контейнеры Windows и контейнеры Linux. Контейнеры Windows позволяют запускать приложения, разработанные для Windows, в контейнерах, работающих на Windows Server 2016. Контейнеры Linux позволяют запускать приложения, разработанные для Linux, в контейнерах, работающих на Windows Server 2016.

Установка Docker на Windows Server 2016

Для установки Docker на Windows Server 2016, следуйте этим шагам:

1. Откройте браузер и перейдите на официальный сайт Docker: https://www.docker.com/products/docker-desktop.
2. На странице загрузки, найдите раздел «Download Docker Desktop for Windows» и нажмите на кнопку «Download Docker Desktop».
3. Ожидайте завершения загрузки файла установки Docker и запустите его.
4. В появившемся окне установки Docker, выберите параметры установки, оставив значения по умолчанию, и нажмите кнопку «Install».
5. После установки Docker, запустите Docker Desktop из списка установленных программ.
6. Дождитесь, пока Docker Desktop завершит инициализацию и запустит Docker на вашей системе Windows Server 2016.
7. Веб-интерфейс Docker будет доступен по адресу http://localhost.

Теперь вы успешно установили Docker на Windows Server 2016 и можете начать использовать его для создания и управления контейнерами.

Выбор версии Docker для Windows Server 2016

Windows Server 2016 предоставляет разные варианты версий Docker для удовлетворения различных потребностей и требований.

Версия Docker Engine может быть установлена на Windows Server 2016 с помощью двух основных подходов: Docker Community Edition (CE) и Docker Enterprise Edition (EE).

Docker Community Edition (CE) является бесплатной версией Docker, разработанной для разработчиков и компаний малого и среднего бизнеса.

Существует две основные ветки Docker Community Edition для Windows Server 2016: stable (стабильная) и edge (экспериментальная).

Ветка stable содержит новейшие стабильные выпуски Docker, поддерживаемые Docker Inc., с гарантированной стабильностью и обновлениями безопасности. Эта версия рекомендуется для продакшн окружений.

Edge-версия является более рискованной, но более инновационной веткой, предназначенной для тестирования последних функций Docker до их выпуска в стабильную версию. Эта версия может содержать нестабильные или экспериментальные функции и потенциально нестабильна. Она подходит для случаев, когда требуется более новый функционал Docker.

Docker Enterprise Edition

Docker Enterprise Edition (EE) — это коммерческая подписка, которая предоставляет обширный набор инструментов и функций для развертывания и управления большими производственными бизнес-средами.

Docker EE включает несколько предложений, которые могут быть подходящими для развертывания в Windows Server 2016:

• Docker EE Advanced – рекомендовано для команд, которым требуются расширенные функции и сквозная поддержка Windows Server 2016.
• Docker EE Standard – рекомендуется для команд, которым требуются основные функции и поддержка Windows Server 2016.

Выбор версии Docker для Windows Server 2016 зависит от ваших конкретных потребностей и бизнес-требований. При выборе версии Docker важно учитывать стабильность, поддержку и доступность необходимых функций.

Версия	Преимущества	Недостатки
Stable (стабильная)	Стабильность и надежность Гарантированные обновления безопасности	Не содержит последние инновации Может быть более ограниченной в функциональности
Edge (экспериментальная)	Последние инновации и экспериментальные функции Docker	Может быть нестабильной или содержать ошибки Не рекомендуется для продакшн окружений
Docker EE Advanced	Расширенные функции и возможности Сквозная поддержка Windows Server 2016	Требует коммерческой подписки Может быть излишней для некоторых пользователей
Docker EE Standard	Основные функции и поддержка Windows Server 2016	Требует коммерческой подписки Может быть несколько ограниченной в функциональности

В результате, при выборе версии Docker для Windows Server 2016, рекомендуется тщательно оценить свои требования и выбрать версию, которая соответствует вашим потребностям и бизнес-целям, учитывая потенциальные преимущества и недостатки каждой версии.

Требования к системе для Docker на Windows Server 2016

Установка и использование Docker на Windows Server 2016 требует соответствия определенным системным требованиям.

1. Операционная система:

Для установки Docker на Windows Server 2016 необходимо использовать 64-разрядную версию операционной системы. Также необходима наличие последних обновлений системы.

2. Процессор и память:

Для использования Docker рекомендуется иметь 4-ядерный процессор и не менее 4 ГБ оперативной памяти.

3. Виртуализация:

На компьютере должна быть включена поддержка виртуализации в BIOS, например, Intel VT-x или AMD-V. Docker будет использовать Hyper-V для виртуализации контейнеров, поэтому также необходимо убедиться, что Hyper-V включен в Windows Server 2016.

4. Дисковое пространство:

Для установки Docker на Windows Server 2016 необходимо иметь как минимум 20 ГБ свободного дискового пространства.

5. Сеть:

Для использования Docker на Windows Server 2016 необходимо иметь подключение к сети с доступом в Интернет.

Соблюдение этих требований позволит успешно установить и использовать Docker на Windows Server 2016, открывая широкие возможности виртуализации и контейнеризации для вашей системы.

Установка Docker на Windows Server 2016 через PowerShell

Шаг 1: Первым шагом необходимо установить PowerShell, если его еще нет на вашем сервере. Убедитесь, что вы используете PowerShell версии 5.1 и выше.

Шаг 2: Запустите PowerShell с правами администратора.

Шаг 3: Введите следующую команду, чтобы скачать и установить Docker посредством PowerShell:

Install-Module -Name DockerMsftProvider -Repository PSGallery -Force

Шаг 4: Затем выполните следующую команду, чтобы установить Docker:

Install-Package -Name docker -ProviderName DockerMsftProvider -Force

Шаг 5: После успешной установки Docker введите команду:

Restart-Computer -Force

Шаг 6: После перезагрузки проверьте, что Docker успешно установлен, введя команду:

docker version

Если вы видите информацию о версии Docker и его компонентах, значит, установка прошла успешно.