Как запустить Docker контейнеры на Windows Server 2019

В этом руководстве мы рассмотрим, как настроить сервер Windows 2019 для запуска контейнеров Docker.

Docker изменил правила работы с контейнерами приложений и проектированием и развертыванием микросервисов.

Docker позволяет легко создавать, отправлять и запускать образы, содержащие приложения с их зависимостями, и избегать сумасшедших проблем с зависимостями, характерных для виртуальных машин.

Docker engine – это то, что заставляет работать контейнеры.

Первоначально он был написан для Linux, но была проделана большая работа, чтобы позволить пользователям Windows и macOS запускать контейнеры Docker.

Как запустить Docker контейнеры на Windows Server 2019

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

Шаг 1. Включите функцию контейнеров в Windows Server 2019

Первый шаг – включить функцию контейнеров Windows Server 2019. Откройте PowerShell от имени администратора.

Запустите следующие команды.

Это установит Docker-Microsoft PackageManagement Provider из галереи PowerShell.

Пример вывода, как показано ниже:

Шаг 2. Установите Docker на Windows Server 2019

как только функция «Контейнеры» будет включена в Windows Server 2019, установите последнюю версию Docker Engine и Client, выполнив следующую команду в сеансе PowerShell.

Согласитесь на установку, используя «yes», «Y» или «А», чтобы согласиться со всеми.

После завершения установки перезагрузите компьютер.

Установленную версию Docker можно проверить с помощью:

Тожe самое можно выполнить командой docker —version

Обновление можно выполнить в любое время, выполнив следующие команды в PowerShell.

Шаг 3: Запустите Docker контейнер

Запустить Docker Daemon

После запуска службы Docker Engine загрузите предварительно созданный образец образа .NET из реестра Docker Hub:

Затем разверните простой контейнер с приложением .Net Hello World.

Контейнер запустится, напечатает сообщение hello world и завершится.

Запуск контейнеров Linux на Windows Server 2019

Из коробки Docker в Windows запускает только контейнер Windows.

Чтобы использовать контейнеры Linux на Windows Server, вам нужно использовать Docker Enterprise Edition Preview, который включает в себя полную систему LinuxKit для запуска контейнеров Docker Linux.

Удалите ваш текущий Docker CE.

Включите вложенную виртуализацию, если вы используете Docker Containers с использованием виртуальной машины Linux, работающей в Hyper-V.

Затем установите текущую предварительную сборку Docker EE.

Включить систему LinuxKit для запуска контейнеров Linux

Перезапустите Docker Service после изменения.

Вытащите образ тестового докера.

Чтобы вернуться к работе с контейнерами Windows, выполните:

Наслаждайтесь работой контейнеров Linux и Windows на Windows Server 2019. Оставьте нам комментарий в случае каких-либо проблем.

Container host deployment: Windows Server

Deploying a Windows container host has different steps depending on the operating system and the host system type (physical or virtual). This document details deploying a Windows container host to either Windows Server 2016 or Windows Server Core 2016 on a physical or virtual system.

Install Docker

Docker is required in order to work with Windows containers. Docker consists of the Docker Engine and the Docker client.

To install Docker, we’ll use the OneGet provider PowerShell module. The provider will enable the containers feature on your machine and install Docker, which will require a reboot.

Open an elevated PowerShell session and run the following cmdlets.

Install the OneGet PowerShell module.

Use OneGet to install the latest version of Docker.

When the installation is complete, reboot the computer.

Install a specific version of Docker

There are currently two channels available for Docker EE for Windows Server:

• 17.06 — Use this version if you’re using Docker Enterprise Edition (Docker Engine, UCP, DTR). 17.06 is the default.
• 18.03 — Use this version if you’re running Docker EE Engine alone.

To install a specific version, use the RequiredVersion flag:

Installing specific Docker EE versions may require an update to previously installed DockerMsftProvider modules. To Update:

Update Docker

If you need to update Docker EE Engine from an earlier channel to a later channel, use both the -Update and -RequiredVersion flags:

Install base container images

Before working with Windows containers, a base image needs to be installed. Base images are available with either Windows Server Core or Nano Server as the container operating system. For detailed information on Docker container images, see Build your own images on docker.com.

With effect from May 2018, delivering a consistent and trustworthy acquisition experience, almost all of the Microsoft-sourced container images are served from the Microsoft Container Registry, mcr.microsoft.com, while maintaining the current discovery process via Docker Hub.

Windows Server 2019 and newer

To install the ‘Windows Server Core’ base image run the following:

To install the ‘Nano Server’ base image run the following:

Windows Server 2016 (versions 1607-1803)

To install the Windows Server Core base image run the following:

To install the Nano Server base image run the following:

Please read the Windows containers OS image EULA, which can be found here – EULA.

Hyper-V isolation host

You must have the Hyper-V role to run Hyper-V isolation. If the Windows container host is itself a Hyper-V virtual machine, nested virtualization will need to be enabled before installing the Hyper-V role. For more information on nested virtualization, see Nested Virtualization.

Nested virtualization

The following script will configure nested virtualization for the container host. This script is run on the parent Hyper-V machine. Ensure that the container host virtual machine is turned off when running this script.

Enable the Hyper-V role

To enable the Hyper-V feature using PowerShell, run the following cmdlet in an elevated PowerShell session.

Развертывание узла контейнера: Windows Server Container host deployment: Windows Server

Чтобы развернуть узел контейнера Windows, нужно выполнить разные действия в зависимости от типа операционной системы виртуальной машины и операционной системы сервера виртуальных машин (виртуальная и физическая). Deploying a Windows container host has different steps depending on the operating system and the host system type (physical or virtual). Этот документ описывает развертывание узла контейнера Windows в Windows Server 2016 или Windows Server Core 2016 в физической или виртуальной системе. This document details deploying a Windows container host to either Windows Server 2016 or Windows Server Core 2016 on a physical or virtual system.

Установка Docker Install Docker

Docker необходим для работы с контейнерами Windows. Docker is required in order to work with Windows containers. Docker состоит из подсистемы Docker Engine и клиента Docker. Docker consists of the Docker Engine and the Docker client.

Для установки Docker будет использоваться модуль PowerShell поставщика OneGet. To install Docker, we’ll use the OneGet provider PowerShell module. Поставщик обеспечит работу контейнеров на компьютере и установит Docker. После этого потребуется перезагрузка. The provider will enable the containers feature on your machine and install Docker, which will require a reboot.

Откройте сеанс PowerShell с повышенными правами и выполните следующие командлеты. Open an elevated PowerShell session and run the following cmdlets.

Установите модуль OneGet PowerShell. Install the OneGet PowerShell module.

С помощью OneGet установите последнюю версию Docker. Use OneGet to install the latest version of Docker.

После завершения установки перезагрузите компьютер. When the installation is complete, reboot the computer.

Установка конкретной версии Docker Install a specific version of Docker

На данный момент для Docker EE для Windows Server доступно два канала: There are currently two channels available for Docker EE for Windows Server:

• 17.06 — используйте эту версию, если вы используете Docker Enterprise Edition (Docker Engine, UCP, DTR). 17.06 — Use this version if you’re using Docker Enterprise Edition (Docker Engine, UCP, DTR). 17.06 используется по умолчанию. 17.06 is the default.
• 18.03 — используйте эту версию, если вы используете только подсистему Docker EE Engine. 18.03 — Use this version if you’re running Docker EE Engine alone.

Чтобы установить конкретную версию, используйте флаг RequiredVersion . To install a specific version, use the RequiredVersion flag:

Для установки конкретных версий Docker EE может потребоваться обновление ранее установленных модулей DockerMsftProvider. Installing specific Docker EE versions may require an update to previously installed DockerMsftProvider modules. Чтобы его выполнить, воспользуйтесь следующей командой: To Update:

Обновление Docker Update Docker

Если необходимо обновить более раннюю версию канала подсистемы Docker EE Engine до более поздней, используйте флаги -Update и -RequiredVersion . If you need to update Docker EE Engine from an earlier channel to a later channel, use both the -Update and -RequiredVersion flags:

Установка базовых образов контейнеров Install base container images

Перед началом работы с контейнерами Windows необходимо установить базовый образ. Before working with Windows containers, a base image needs to be installed. Базовые образы доступны при использовании Windows Server Core и Nano Server в качестве операционной системы контейнера. Base images are available with either Windows Server Core or Nano Server as the container operating system. Подробные сведения об образах контейнеров Docker см. в разделе Создание собственных образов на сайте docker.com. For detailed information on Docker container images, see Build your own images on docker.com.

Начиная с мая 2018 года, для обеспечения единообразных и надежных возможностей приобретения почти все образы контейнеров, полученные от Майкрософт, обслуживаются из Реестра контейнеров Майкрософт, mcr.microsoft.com. При этом текущий процесс обнаружения через Docker Hub остается неизменным. With effect from May 2018, delivering a consistent and trustworthy acquisition experience, almost all of the Microsoft-sourced container images are served from the Microsoft Container Registry, mcr.microsoft.com, while maintaining the current discovery process via Docker Hub.

Windows Server 2019 и более поздних версий Windows Server 2019 and newer

Чтобы установить базовый образ Windows Server Core, выполните следующую команду: To install the ‘Windows Server Core’ base image run the following:

Чтобы установить базовый образ Nano Server, выполните следующую команду: To install the ‘Nano Server’ base image run the following:

Windows Server 2016 (версии 1607–1803) Windows Server 2016 (versions 1607-1803)

Чтобы установить базовый образ Windows Server Core, выполните следующую команду: To install the Windows Server Core base image run the following:

Чтобы установить базовый образ Nano Server, выполните следующую команду: To install the Nano Server base image run the following:

Прочтите лицензионное соглашение для образов ОС контейнеров Windows на странице Лицензионное соглашение. Please read the Windows containers OS image EULA, which can be found here – EULA.

Узел с изоляцией Hyper-V Hyper-V isolation host

Для запуска изоляции Hyper-V необходима роль Hyper-V. You must have the Hyper-V role to run Hyper-V isolation. Если сам узел контейнера Windows является виртуальной машиной Hyper-V, перед установкой роли Hyper-V необходимо включить вложенную виртуализацию. If the Windows container host is itself a Hyper-V virtual machine, nested virtualization will need to be enabled before installing the Hyper-V role. Дополнительные сведения о вложенной виртуализации см. в статье Вложенная виртуализация. For more information on nested virtualization, see Nested Virtualization.

Вложенная виртуализация Nested virtualization

Приведенный ниже сценарий настраивает вложенную виртуализацию для узла контейнера. The following script will configure nested virtualization for the container host. Этот сценарий выполняется на родительском компьютере Hyper-V. This script is run on the parent Hyper-V machine. Перед запуском сценария убедитесь, что виртуальная машина узла контейнера отключена. Ensure that the container host virtual machine is turned off when running this script.

Включение роли Hyper-V Enable the Hyper-V role

Чтобы включить компонент Hyper-V с помощью PowerShell, выполните приведенный ниже командлет в сеансе PowerShell с повышенными правами. To enable the Hyper-V feature using PowerShell, run the following cmdlet in an elevated PowerShell session.

Часто задаваемые вопросы о контейнерах Frequently asked questions about containers

Если у вас есть вопрос о контейнерах Windows Server, возможно, ответ на него вы найдете ниже. Have a question about Windows Server containers, see if it’s answered in the list below.

В чем отличие контейнеров Linux и контейнеров Windows Server? What’s the difference between Linux and Windows Server containers?

В ядрах и базовых операционных системах Linux и Windows Server реализованы сходные технологии. Linux and Windows Server both implement similar technologies within their kernel and core operating systems. Отличие заключается в платформе и рабочих нагрузках, выполняющихся в контейнерах. The difference comes from the platform and workloads that run within the containers.

Контейнеры Windows Server можно интегрировать с существующими технологиями Windows, например .NET, ASP.NET, PowerShell. When a customer uses Windows Server containers, they can integrate with existing Windows technologies, such as .NET, ASP.NET, and PowerShell.

Каковы предварительные требования для запуска контейнеров в Windows? What are the prerequisites for running containers on Windows?

Контейнеры были введены для этой платформы начиная с версии Windows Server 2016. Containers were introduced to the platform with Windows Server 2016. Для использования контейнеров требуется Windows Server 2016 или Windows 10 Anniversary update (версия 1607) или более поздней версии. To use containers, you’ll need either Windows Server 2016 or the Windows 10 Anniversary update (version 1607) or newer. Чтобы узнать больше, ознакомьтесь с системными требованиями. Read the System Requirements to learn more.

Какие ОС Windows поддерживаются? What Windows operating systems are supported?

AKS в Azure Stack HCI использует Windows Server 2019 в качестве версии ОС для узла контейнеров и поддерживает только изоляцию процессом. AKS on Azure Stack HCI uses Windows Server 2019 as the container host OS version and only supports process isolation. Сведения о совместимости версий контейнеров Windows см. в этой статье. For Windows container version compatibility, see Windows container version compatibility.

Как поставить заплаты для моих узлов Windows? How do I patch my Windows nodes?

Для узлов Windows Server на AKS в Azure Stack HCI нужно установить обновления, чтобы вы могли получить последние исправления. Windows Server nodes in AKS on Azure Stack HCI must be upgraded to get the latest patch fixes and updates. Центр обновлений Windows не включен на узлах Windows на AKS в Azure Stack HCI. Windows Updates are not enabled on Windows nodes in AKS on Azure Stack HCI. Но AKS в Azure Stack HCI обеспечивает доступ к Центру обновлений Windows, периодически обновляя образы узлов Windows Server. However, AKS on Azure Stack HCI makes Windows Updates available by periodically updating the Windows Server node images.

Могут ли мои контейнеры Windows Server использовать gMSA? Can my Windows Server containers use gMSA?

Да, gMSA поддерживается для подключенных к доменам рабочим узлов Windows. Yes, gMSA is supported with domain-joined Windows worker nodes. Дополнительные сведения об использовании gMSA с контейнерами Windows см. в статье Подготовка узлов Windows для gMSA. To learn more about using gMSA with Windows containers, see Prepare Windows nodes for gMSA.

Что такое WCOW и LCOW? What are WCOW and LCOW?

WCOW — сокращение для «Windows containers on Windows» (контейнеры Windows в Windows). WCOW is short for «Windows containers on Windows.» LCOW — сокращение для «Linux containers on Windows» (контейнеры Linux в Windows). LCOW is short for «Linux containers on Windows.»

Как осуществляется лицензирование контейнеров? How are containers licensed? Существует ли ограничение на количество контейнеров, которые я могу запустить? Is there a limit to the number of containers I can run?

Лицензионное соглашение для образа контейнера Windows описывает использование, которое зависит от наличия у пользователя действительной лицензии на ОС узла. The Windows container image EULA describes a usage that depends on a user having a validly licensed host OS. Количество контейнеров, которые может запустить пользователь, зависит от выпуска ОС узла и режима изоляции, с которым выполняется контейнер, а также от того, запускаются ли эти контейнеры в целях разработки/тестирования или в рабочей среде. The number of containers a user is allowed to run depends upon the host OS edition and the isolation mode a container is being run with, as well as whether these containers are running for dev/test purposes or in production.

ОС узла Host OS	Количество контейнеров при изоляции на уровне процессов Process-isolated container limit	Количество контейнеров при изоляции с помощью Hyper-V Hyper-V-isolated container limit
Windows Server Standard Windows Server Standard	Без ограничений Unlimited	2 2
Windows Server Datacenter Windows Server Datacenter	Без ограничений Unlimited	Без ограничений Unlimited
Windows 10 Профессиональная и Windows 10 Корпоративная Windows 10 Pro and Enterprise	Без ограничений (только для целей тестирования или разработки) Unlimited (for test or development purposes only)	Без ограничений (только для целей тестирования или разработки) Unlimited (for test or development purposes only)
Windows 10 IoT Базовая и Windows 10 Корпоративная Windows 10 IoT Core and Enterprise	Без ограничений Unlimited*	Без ограничений Unlimited*

Использование образа контейнера Windows Server определяется путем считывания количества гостевых виртуальных машин, поддерживаемых в этом выпуске. Windows Server container image usage is determined by reading the number of virtualization guests supported for that edition.

*Использование рабочих контейнеров в выпусках Windows IoT зависит от того, согласились ли вы с коммерческими условиями использования образов среды выполнения Windows 10 Базовая или с лицензией для устройств Windows 10 IoT Корпоративная («коммерческое соглашение Windows IoT»). *Production usage of containers on an IoT edition of Windows depend on if you have agreed to the Microsoft Commercial Terms of Use for Windows 10 Core Runtime Images or the Windows 10 IoT Enterprise Device License (“Windows IoT Commercial Agreement”). Дополнительные условия и ограничения для коммерческих соглашений по Windows IoT применяются к использованию образа контейнера в рабочей среде. Additional terms and restrictions in the Windows IoT Commercial Agreements apply to your use of Container Image in a production environment. Ознакомьтесь с лицензионным соглашением для образа контейнера, чтобы точно понимать, что разрешено, а что нет. Please read the container image EULA to understand exactly what is permitted and what is not.

Нужно ли разработчику переписывать приложение под каждый тип контейнера? As a developer, do I have to rewrite my app for each type of container?

Нет. No. Контейнеры Windows Server и изоляция Hyper-V используют общие образы. Windows container images are common across both Windows Server containers and Hyper-V isolation. Вы выбираете тип при запуске контейнера. The choice of container type is made when you start the container. С точки зрения разработчика между контейнерами Windows Server и изоляцией Hyper-V нет принципиальных различий. From a developer standpoint, Windows Server containers and Hyper-V isolation are two flavors of the same thing. Открытые и расширяемые, они предусматривают одинаковые возможности для разработки, программирования и управления, а также одинаковый уровень интеграции и поддержки с помощью Docker. They offer the same development, programming, and management experience, and are open and extensible and include the same level of integration and support with Docker.

Разработчик может создать образ контейнера с помощью контейнера Windows Server и развернуть его в изоляции Hyper-V, или наоборот, не внося изменений, лишь установив флажок необходимой среды выполнения. A developer can create a container image using a Windows Server container and deploy it in Hyper-V isolation or vice-versa without any changes other than specifying the appropriate runtime flag.

Контейнеры Windows Server обеспечивают более высокую плотность и производительность (меньшее время раскрутки, когда ключевым фактором является скорость, более высокую производительность среды выполнения по сравнению с вложенными конфигурациями). Windows Server containers offer greater density and performance for when speed is key, such as lower spin-up time and faster runtime performance compared to nested configurations. Изоляция Hyper-V, в полном соответствии со своим названием, обеспечивает лучшую изоляцию, чтобы код, выполняющийся в одном контейнере, не мог нарушить безопасность или стабильность операционной системы узла или других запущенных на нем контейнеров. Hyper-V isolation, true to its name, offers greater isolation, ensuring that code running in one container can’t compromise or impact the host operating system or other containers running on the same host. Это удобно при обслуживании одним экземпляром приложения нескольких развертываний (необходимо размещение кода без доверия), в том числе размещении приложений SaaS и среды выполнения приложений. This is useful for multitenant scenarios with requirements for hosting untrusted code, including SaaS applications and compute hosting.

Можно ли запускать контейнеры Windows в режиме изоляции процессов в Windows 10? Can I run Windows containers in process-isolated mode on Windows 10?

Начиная с обновления Windows 10 за октябрь 2018 года можно запустить контейнер Windows в изолированном процессе, но сначала необходимо напрямую запросить изоляцию процесса с помощью флага —isolation=process при запуске контейнеров с docker run . Starting with the Windows 10 October 2018 update, you can run a Windows container with process isolation, but you must first directly request process isolation by using the —isolation=process flag when running your containers with docker run . Изоляция процессов поддерживается в Windows 10 Pro, Windows 10 Корпоративная, Windows 10 IoT Базовая и Windows 10 IoT Корпоративная. Process-isolation is compatible on Windows 10 Pro, Windows 10 Enterprise, Windows 10 IoT Core and Windows 10 IoT Enterprise.

Если вы хотите выполнять контейнеры Windows таким образом, необходимо убедиться, что узел работает под управлением Windows 10 Build 17763+ и у вас установлена версия Docker с ядром версии 18.09 или более поздней. If you want to run your Windows containers this way, you’ll need to make sure your host is running Windows 10 build 17763+ and you have a Docker version with Engine 18.09 or newer.

Эта функция предназначена только для разработки или тестирования, но не на узлах под управлением версий IoT Базовая и IoT Корпоративная (после принятия дополнительных условий и ограничений). Aside from on IoT Core and IoT Enterprise hosts (after accepting additional terms and restrictions), this feature is only meant for development and testing. Для развертывания в рабочей среде в качестве узла следует продолжать использовать Windows Server. You should continue to use Windows Server as the host for production deployments. С помощью этой функции необходимо также убедиться, что теги версии узла и контейнера совпадают, в противном случае контейнер может не запуститься или продемонстрировать неожиданное поведение. By using this feature, you must also ensure that your host and container version tags match, otherwise the container may fail to start or exhibit undefined behavior.

Как можно сделать образы контейнеров доступными на территориально разнесенных компьютерах? How do I make my container images available on air-gapped machines?

Базовые образы контейнера Windows содержат артефакты, разнесение которых ограничено лицензией. Windows container base images contain artifacts whose distribution is restricted by license. Когда вы создадите эти образы и отправите их в закрытый или общедоступный реестр, вы заметите, что базовый уровень никогда не передается. When you build on these images and push them to a private or public registry, you’ll notice the base layer is never pushed. Вместо этого мы используем концепцию внешнего слоя, который ссылается на реальный базовый уровень, находящийся в облачном хранилище Azure. Instead, we use the concept of a foreign layer that points to the real base layer residing in Azure cloud storage.

Это может усложнить работу при наличии территориально удаленного компьютера, который может получать образы только из закрытого реестра контейнеров. This can complicate things when you have an air-gapped machine that can only pull images from the address of your private container registry. В этом случае попытки выполнить внешний слой для получения базового образа не будут работать. In this case, attempts to follow the foreign layer to get the base image won’t work. Чтобы переопределить поведение внешнего слоя, можно использовать флаг —allow-nondistributable-artifacts в управляющей программе Docker. To override the foreign layer behavior, you can use the —allow-nondistributable-artifacts flag in the Docker daemon.

Использование этого флага не исключает обязательства в соответствии с условиями лицензии на базовый образ контейнера Windows; не следует публиковать содержимое Windows для общедоступного распространения или для передачи третьим сторонам. Usage of this flag shall not preclude your obligation to comply with the terms of the Windows container base image license; you must not post Windows content for public or third-party redistribution. Использование в собственной среде разрешено. Usage within your own environment is allowed.

Хотите оставить дополнительный отзыв? Additional feedback

Хотите добавить что-нибудь в часто задаваемые вопросы? Want to add something to the FAQ? Создайте новый отзыв в разделе комментариев или подайте запрос на включение внесенных изменений для этой страницы с помощью GitHub. Open a new feedback issue in the comments section or set up a pull request for this page with GitHub.