Wsl2 windows 10 установка docker

Что такое Docker Desktop

Docker Desktop — это инструмент для работы с Docker-контейнерами на локальной машине. Он упрощает процесс разработки, тестирования и развертывания приложений, позволяя взаимодействовать с контейнерами как через консоль, так и через удобный интерфейс. 

Ключевые особенности:

• понятный графический интерфейс,
• удобное управление образами и контейнерами,
• встроенные инструменты для мониторинга,
• возможность разработки и тестирования без привязки к серверу,
• поддержка работы с Docker Compose.

Если вы только начинаете изучение Docker и хотите разобраться в основах, рекомендуем ознакомиться с отдельным вводным обзором. В нем разобрали принципы работы Docker, его основные компоненты и решаемые задач. Из текста вы узнаете, как создать и запустить контейнер, а также какую роль играет Kubernetes в связке c Docker.

Картинка с сайта: selectel.ru

О системных требованиях

Перед установкой Docker Desktop важно выбрать подходящий бэкенд для работы с контейнерами: WSL 2 или Hyper-V. Оба имеют свои особенности, так что от выбора будут зависеть и системные требования. Далее в тексте разберемся, когда и какой бэкенд подойдет лучше.

Когда нужен WSL

WSL 2 (Windows Subsystem for Linux 2) — это усовершенствованная версия подсистемы Windows для Linux, которая использует виртуальную машину с реальным Linux-ядром. В отличие от первой версии, WSL 2 обеспечивает лучшую совместимость с Linux-инструментами, технологиями и приложениями, а также более высокую производительность. 

Преимущества использования WSL 2 с Docker Desktop

Работа с Linux-контейнерами. Docker изначально разрабатывали для работы в Linux-среде, поэтому большинство контейнеров в Docker Hub — это образы, ориентированные на Linux. Использование WSL 2 предоставляет Docker Desktop полноценную Linux-среду на Windows.

Повышенная производительность. WSL 2 значительно ускоряет выполнение контейнеров, что особенно заметно в сравнении с WSL 1 или Hyper-V, о котором мы расскажем дальше. Это преимущество обеспечивает полноценное Linux-ядро, которое позволяет Docker работать гораздо быстрее и с меньшими накладными расходами.
Работа с файловой системой Linux. В WSL 2 можно монтировать файловую систему Linux, что позволяет работать с кодом и данными в нативной Linux-среде. Это особенно важно при разработке приложений, которые будут запускаться в Linux-контейнерах и требуют специфической настройки среды — например, прав доступа или структуры каталогов.

Когда нужен Hyper-V

Рассмотрим ключевые сценарии, в которых предпочтительнее использовать Hyper-V. 

Если система не поддерживает WSL 2

Некоторые сборки системы не позволяют включать необходимые компонентов для работы WSL 2 В частности, это касается старых версий Windows, а также устройств, которые не поддерживают Windows 10 Pro или 11 Pro, — WSL 2 для них недоступна, так как требует включенной виртуализации на уровне системы. В таких случаях можно использовать Hyper-V для виртуализации контейнеров и запуска Docker Desktop.

Для работы с Windows-контейнерами

Docker Desktop поддерживает как Linux-, так и Windows-контейнеры. Однако последние требуют прямого взаимодействия с ядром Windows, а WSL 2 предоставляет только Linux-среду. Hyper-V позволяет запускать Windows-контейнеры благодаря виртуализации Windows-системы.

Для изоляции и обеспечения безопасности

Hyper-V создает полноценные виртуальные машины, обеспечивая строгую изоляцию контейнеров друг от друга и от хост-системы. Это может быть важно в корпоративной среде или при работе с чувствительными данными.

Разница между WSL 2 и Hyper-V

Если вам нужны Linux-контейнеры и высокая производительность — выбирайте WSL 2. Если же требуется строгая изоляция или работа с Windows-контейнерами, Hyper-V будет предпочтительнее. Подробнее о разнице по ключевым критериям — в таблице:

Системные требования Docker Desktop

При использовании WSL 2 в качестве бэкенда

• WSL версии 1.1.3.0 или новее.
• Windows 11 64-bit Home / Pro / Enterprise / Education, версия 22H2 или новее.
• Windows 10 64-bit Home / Pro / Enterprise / Education, версия 22H2  (сборка 19045) или новее.
• Включенная функция WSL 2 в Windows. Подробная инструкция есть в документации Microsoft;
• 4 ГБ ОЗУ.
• Включенная аппаратная виртуализация в BIOS на вашей локальной машине.

При использовании Hyper-V в качестве бэкенда

• Windows 11 64-разрядная Enterprise / Pro / Education, версия 22H2 или новее.
• Windows 10 64-разрядная Enterprise / Pro / Education, версия 22H2 (сборка 19045) или новее.
• Включенная функция Hyper-V. Подробнее об установке — в документации Microsoft;
• 4 ГБ ОЗУ.
• Включенная аппаратная виртуализация в BIOS на вашей локальной машине.

Установка WSL 2

1. Откройте PowerShell от имени администратора и введите команду wsl —install. Она выполняет следующие действия:

• включает дополнительные компоненты WSL и платформы виртуальных машин;
• скачивает и устанавливает последнюю версию ядра Linux;
• задает WSL 2 в качестве среды по умолчанию;
• скачивает и устанавливает дистрибутив Ubuntu Linux.

Картинка с сайта: selectel.ru

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

Картинка с сайта: selectel.ru

Первичная настройка

1. Откройте установленный дистрибутив с помощью меню Пуск — найдите установленный дистрибутив (Ubuntu).

2. При первом запуске системы нужно создать имя пользователя и пароль для дистрибутива Linux.

Картинка с сайта: selectel.ru

3. Первичная настройка завершена, можно приступать к использованию WSL 2.

Альтернативный вариант — запустить WSL через PowerShell. Для этого введите команду wsl и система предложит произвести первичную настройку.

Картинка с сайта: selectel.ru

Установка Hyper-V

Для установки компонентов Hyper-V откройте PowerShell от имени администратора и выполните команду:

    Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All

Она установит все компоненты для работы Hyper-V, после чего нужно будет перезапустить компьютер.

Картинка с сайта: selectel.ru

Проверить корректность установки Hyper-V можно с помощью команды:

    Get-WindowsOptionalFeature -Online -FeatureName *hyper*|ft

Картинка с сайта: selectel.ru

Установка Docker с бэкендом WSL 2

1. Скачайте дистрибутив Docker Desktop с официального сайта и запустите установщик. Галочки оставьте на всех пунктах.

Картинка с сайта: selectel.ru

1. После установки перезайдите в учетную запись и откройте ярлык Docker Desktop. 
2. Если все прошло успешно, вы увидите интерфейс инструмента:

Картинка с сайта: selectel.ru

Установка Docker с бэкендом Hyper-V

1. Скачайте дистрибутив Docker Desktop с официального сайта и запустите установщик. В инсталляционном окне уберите галочку Use WSL 2 instead of Hyper-V.

Картинка с сайта: selectel.ru

2. После установки перезайдите в учетную запись и откройте ярлык Docker Desktop. 

3. Если установка выполнена корректно, программа запустится без ошибок и вы увидите интерфейс:

Картинка с сайта: selectel.ru

Запуск контейнера

Рассмотрим запуск первого контейнера на примере самого популярного образа — hello-world. 

Поиск и скачивание образа

Поскольку вы только установили Docker Desktop, в системе нет образов контейнеров, которые можно запустить. Исправим это.

1. Перейдите в раздел Images и нажмите кнопку Search images to run.

Картинка с сайта: selectel.ru

1. Введите hello-world. В текущем окне на выбор есть две кнопки: Pull и Run. Если планируете для начала просто скачать образ, то выбирайте Pull. Если скачать и сразу запустить — Run.

Картинка с сайта: selectel.ru

1. Оставляем стандартные настройки для запуска.

Картинка с сайта: selectel.ru

Проверка работы контейнера

Чтобы посмотреть запущенные контейнеры, перейдите во вкладку Containers и выберите созданный на прошлом этапе. В нашем примере для него было автоматически сгенерировано имя determined_jennings. Открыв контейнер, вы увидите сообщение, если настройка установка прошла успешно.

Картинка с сайта: selectel.ru

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

Для автозапуска Docker Desktop при авторизации на компьютере достаточно поставить галочку в настройках: Settings → General → Start Docker Desktop when you sign in to your computer.

Картинка с сайта: selectel.ru

После этого Docker Desktop будет запускаться автоматически при включении устройства.

Запуск Docker в облаке

Docker Desktop — удобный инструмент для локальной работы, но в ряде случаев может потребоваться облачная инфраструктура:

• если мощности вашего ПК не хватает для работы с контейнерами;
• если нужна среда для тестирования без нагрузки на локальную машину;
• если вы работаете с ML/AI и нужны видеокарты для обучения моделей.

1. В панели управления в верхнем меню перейдем в раздел Продукты → Облачные серверы.

Картинка с сайта: selectel.ru

2. Нажмем кнопку Создать сервер. 

Картинка с сайта: selectel.ru

3. Выберем имя, регион и сегмент пула. Важно учесть, что от сегмента зависят доступные конфигурации и стоимость. После создания сервера менять сегмент пула нельзя. 

Картинка с сайта: selectel.ru

4. В качестве источника выберите готовый образ, приложение, свой образ, сетевой диск или снапшот. В нашем случае — приложение Containers Ready с настроенной Ubuntu 22.04. Оно содержит:

• Docker версии 27.0.3;
• плагины для запуска Docker Compose версии 2.11.1;
• Portainer версии 2.20.3 — графический интерфейс для мониторинга и управления Docker-контейнерами, образами и сетью Docker.

Картинка с сайта: selectel.ru

5. Конфигурацию для примера возьмем базовую — 2 vCPU и 2 ГБ RAM, а в поле Диски выберем SSD Быстрый на 20 ГБ. Важно: это минимальные требования. Рекомендуем выбирать параметры серверы, исходя из ваших задач. 

Помимо прочего, на этапе создания сервера или позже вы можете добавить GPU. При этом объем ОЗУ, который выделяется серверу, может быть меньше указанного в конфигурации — ядро ОС резервирует ее часть. Выделенный объем на сервере можно посмотреть с помощью команды sudo dmesg | grep Memory. 

Картинка с сайта: selectel.ru

6. Для работы Containers Ready сервер должен быть доступен из интернета. Для этого создадим приватную подсеть и подключим публичный IP-адрес. В поле Сеть выберем Приватная подсеть и добавим новый публичный адрес. Подробнее о настройке подсети можно узнать в документации.

Картинка с сайта: selectel.ru

6. Добавьте SSH-ключ в поле Доступ. Подробнее о его генерации можно узнать в отдельной инструкции.

Картинка с сайта: selectel.ru

7. Ознакомьтесь с ценой и нажмите кнопку Создать сервер. 

Картинка с сайта: selectel.ru

Сервер готов к использованию! Подробности о создании сервера с Сontainers Ready вы можете найти в документации. Если вам нужно запускать контейнеры с ML-моделями на мощных видеокартах, развернуть облачные серверы с GPU можно за несколько минут. Они помогут ускорить обучение нейросетей без закупки дорогого оборудования.

Есть два варианта установки платформы контейнеризации Docker на Windows 10 и 11: в виде нативного win приложения Docker Desktop for Windows (используется встроенные компоненты Hyper-V + контейнеры Windows), или в виде полноценной установки Docker Engine в дистрибутив Linux в подсистеме Windows Subsystem for Linux (WSL2). В этой статье мы рассмотрим процесс установки и базовой настройки Docker в среде WSL без использования Docker Desktop.

Итак, предполагаем что у вас есть компьютер с Windows 10 и 11, на котором вы установили среду Windows Subsystem for Linux (WSL2) и скачали один из доступных Linux образов (Ubuntu 24.04 в этом примере). Выведите список доступны дистрибутивов WSL:

wsl --list

Чтобы задать образ WSL, который будет использоваться по-умолчанию, выполните команду:

wsl --setdefault Ubuntu-24.04

Картинка с сайта: winitpro.ru

Убедитесь, что используется версия WSL2:

wsl --version

Если нет, выполните команду:

wsl --set-default-version 2

Чтобы подключиться к вашему дистрибутиву Linux в среде WSL, выполните:

wsl.exe

Обновите пакеты в дистрибутиве Linux (Ubuntu в этом случае):

$ sudo apt-get update && sudo apt-get upgrade -y

Затем выполните установку Docker Engine в Linux с помощью универсального официального скрипта:

$ curl -fsSL https://get.docker.com -o get-docker.sh
$ sudo sh get-docker.sh

Игнорируйте появившееся предупреждение об установке Docker в среде WSL.

Картинка с сайта: winitpro.ru

Добавьте вашего пользователя в группу docker чтобы получить возможность запускать команды docker без повышения привилегий и ввода пароля через sudo:

$ sudo usermod -aG docker $USER

Проверьте, что Docker desktop и compose установлены успешно:

$ docker --version
$ docker compose version

Картинка с сайта: winitpro.ru

Теперь нужно настроить автоматически запуск docker в WSL. В современных дистрибутивах Linux для WSL2 добавлена полноценная поддержка systemd. Проверьте, что он включен:

$ cat /etc/wsl.conf

[boot]
systemd=true

Картинка с сайта: winitpro.ru

Затем проверьте, что systemd используется в качестве системы инициализации Linux:

$ stat /sbin/init

В данном используется systemd, т.к. процесс /sbin/init это символьная ссылка на /lib/systemd/systemd.

Картинка с сайта: winitpro.ru

Запустите сервис docker engine и включите автоматический запуск:

$ sudo systemctl enable --now docker.service
$ systemctl status docker.service

Картинка с сайта: winitpro.ru

[boot]
command = "/usr/sbin/service docker start"

WSL2 по-умолчанию может использовать следующие ресурсы компьютера:

• 50% оперативной памяти
• 25% файла подкачки (swap)
• 100% ресурсов процессора

Если вы хотите ограничить использование ресурсов хоста подсистемой WSL2, создайте в профиле текущего пользователя текстовый файл
%UserProfile%\.wslconfig
. В этом файле можно задать глобальные ограничения для всех дистрибутивов в WSL. Например:

[wsl2]
memory=8GB
processors=4
swap=2GB

Перезапустите образ WSL из командой строки Windows:

wsl --shutdown

Попробуйте запустить тестовый docker образ в WSL:

$ docker run hello-world

Docker Engine скачает и запустит демонстрационный контейнер hello-world из Docker Hub.

Для обеспечения максимального производительности WSL2, храните все файлы контейнеров внутри WSL (а не в директориях, которые пробрасываются с Windows, таких как /mnt/c).

В современных версиях Linux (Ubuntu 22.04, Debian 10+) для управления встроенным файрволом используется nftables, а не iptables. Для нативной поддержки nftables в WSL требуется ядро Linux 5.8 или выше. В старых версиях ядра для корректной работы сети придется включать совместимость с iptables:

$ sudo update-alternatives --config iptables

Картинка с сайта: winitpro.ru

Нажмите 1 для выбора режима iptables-legacy.

Теперь вы можете выполнять команды к docker в WSL из командной строки Windows. Перед командами docker нужно указывать wsl. Например, вывести список доступных образов в Docker:
wsl docker images

Картинка с сайта: winitpro.ru

Теперь вы можете разрабатывать и запускать Docker контейнеры непосредственно на своем Windows компьютере.

WSL and WSL2

Make sure that

• You have Windows 10 version 1903 or higher, with Build 18362 or higher. If not, update it.
  • Check it by using Win+R, command winver
• Virtualization is enabled inside of your computer’s BIOS

Enable WSL on Windows 10

• Run the commands below, using PowerShell on Admin mode:

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

• Open your PowerShell once again and try typing wsl, and if doesn’t work, restart your machine

Upgrade to WSL2

• Download and install the WSL2 kernel to update

• Set the WSL default version to 2, via Powershell:

wsl --set-default-version 2

(in case of error, ignore it this time)

Linux Distro

Install the Ubuntu distro (or any other you like)

• Open your Microsoft Store, search for the Ubuntu App, select the Ubuntu app (which is the latest) and install it
• After installed, configure your root user and password

Upgrade WSL version for Ubuntu

• List your distro using wsl --list, via Powershell
• Set your distro to WSL version 2

wsl --set-version <distro_name> 2

Tips

• Access your WSL «machine» through the wsl command (via Powershell or cmd), which stands for:

C:\Windows\System32\wsl.exe

• Access your WSL «space» on Windows through: (Win+R or explorer):

\\wsl$

• Find your Windows «space» on Linux:

/mnt/c/

• You can also run Windows programs from WSL (try explorer.exe, or code . for VS Code, for example), however it doesn’t mean all of them will work alright

• Have in mind that WSL performance is strictly related to Linux usage, i.e., using WSL to manage and work with your files in /mnt/c won’t help

• Find your WSL «disk» on Windows:

  • in the case of Ubuntu, we have something like this:

C:\Users\<User>\AppData\Local\Packages\CanonicalGroupLimited.Ubuntu...\LocalState

• Backup your WSL state:

wsl --export <distro> <output_file>                        # export
wsl --import <distro> <installation_location> <input_file> # import

or even, create a backup of the WSL «disk» file (previous item)

• WSL2 uses almost all your machines resources, by default:

  • Disk and CPU
  • 80% of your available RAM
  • 25% of your available memory for Swap

• You can set up limits, by creating a config file (example):

  • C:\Users\<User>\.wslconfig >

[wsl2] 
options=metadata,umask=22,fmask=11 
memory=8GB 
processors=4 
swap=2GB 

• Your custom configs are applied after a WSL restart:

wsl --shutdown

Windows Terminal

Windows Terminal is a new feature from Microsoft, improving your experience with terminals in Windows.

Install via Microsoft Store, by searching for Windows Terminal

With Windows Terminal you can:

• have multiple terminals opened in separate tabs (instances)
• different terminals running along (Ubuntu, git bash, Powershell, etc)
• customize it by applying themes, configuring colors and shortcuts, etc
  • change file settings.json by hitting Ctrl+, on Windows Terminal
  • OR, open file from default dir:

C:\Users\<User>\AppData\Local\Packages\Microsoft.WindowsTerminal...\LocalState\settings.json

• you can change e.g. your Linux starting directory and default shell, when opening Windows Terminal:

"defaultProfile": "{xxxxx-xxxx-xxxx-xxxx}",
...
{ 
    "guid": "{xxxxx-xxxx-xxxx-xxxx}",
    "name": "Ubuntu-18.04", 
    "startingDirectory" : "//wsl$/Ubuntu/home/<ubuntu_user>", 
}

Docker

3 ways to use Docker on Windows

• Docker Toolbox — bad

  • Uses Oracle VirtualBox
  • Very bad performance
  • Difficult setup and usage

• Docker Desktop com Hyper-V — better

  • Uses Microsoft Hyper-V instead of VirtualBox
  • Requires Windows 10 PRO
  • Better performance but a heavy consumer of host resources
  • Docker will drop support in the future, as announced

• Docker Desktop com WSL2 — recommended *

  • Uses Microsoft Virtual Machine Platform
  • Integrates with WSL2 and its distros
  • Better performance and consumes less resources
  • Usage as running on Linux natively

*Download and install Docker Desktop
https://hub.docker.com/editions/community/docker-ce-desktop-windows

Enable Docker on WSL2 distro
— Docker Desktop > Settings > Resources > WSL Integration
> Enable integration with additional distros > Check distro

Play with docker on WSL
— Open WSL and hit docker ps or try out docker run hello-world

WSL Linux GUI

Optional

A way to run Linux apps using WSL «builtin GUIs» is on the way, as one of the WSL improvements of Microsoft’s roadmap.

While it still unavailable, we can still install a GUI and use RDP (Remote desktop), to access the Linux VM.

First of all, update and upgrade your Linux:

sudo apt update && sudo apt -y upgrade

Install (or overwrite) X-RDP:

sudo apt-get purge xrdp
sudo apt install -y xrdp

Install a GUI:

sudo apt install -y xfce4 # check 'gdm3' option
sudo apt install -y xfce4-goodies

XFCE is a lightweight GUI for testing purposes

Configure access, create a backup, improve RDP session quality and define session:

sudo cp /etc/xrdp/xrdp.ini /etc/xrdp/xrdp.ini.bak
sudo sed -i 's/3389/3390/g' /etc/xrdp/xrdp.ini
sudo sed -i 's/max_bpp=32/#max_bpp=32\nmax_bpp=128/g' /etc/xrdp/xrdp.ini
sudo sed -i 's/xserverbpp=24/#xserverbpp=24\nxserverbpp=128/g' /etc/xrdp/xrdp.ini
echo xfce4-session > ~/.xsession

Edit XRDP startup script:

sudo nano /etc/xrdp/startwm.sh

• Comment these last lines:

# test -x /etc/X11/Xsession && exec /etc/X11/Xsession 
# exec /bin/sh /etc/X11/Xsession 

• Add these lines:

# xfce
startxfce4

Start RDP session:

sudo /etc/init.d/xrdp start

Access it from your Windows:

• Run command mstsc (Win+R)

localhost:3390

Dev Projects

There are many softwares that already works integrated with WSL:

• on VS Code for example, you can find add-ons to work «remotely» with your projects in WSL, as you can see here
• IntelliJ also have its ways to deal with WSL integration and run along with your projects, as you can see here
• on the other hand, there may be softwares that are more complex to integrate with WSL (or even don’t)

If you have any further info, specially about dev workspaces with WSL, just drop me a line below and help everyone enjoy and experience the benefits of this tool.

See ya.

Source
https://docs.microsoft.com/en-us/windows/wsl/install-win10#manual-installation-steps
https://github.com/codeedu/wsl2-docker-quickstart (pt-br)
https://github.com/davidbombal/wsl2/blob/main/ubuntu_gui_youtube