Встановлення Docker на WSL 2 – перше налаштування контейнера

Спочатку перевірте свій ПК

Docker Desktop із серверною частиною WSL 2 потребує трьох речей, і пропуск цієї двохвилинної перевірки — це те, як люди втрачають вечір. По-перше, версія Windows: вам потрібна Windows 10 версії 2004 або пізнішої, або Windows 11. Натисніть Win + R, введіть winver і натисніть Enter, щоб переглянути точну версію.

winver

По-друге, віртуалізація має бути ввімкнена в BIOS або UEFI. Відкрийте диспетчер завдань, перейдіть до Продуктивність, потім ЦП і знайдіть Віртуалізацію: увімкнено. Якщо вказано Disabled, жодні налаштування програмного забезпечення вас не врятують — спочатку ввімкніть Intel VT-x або AMD SVM у BIOS. По-третє, зберігайте близько 4 ГБ вільної оперативної пам’яті та кілька ГБ вільного диска: WSL 2 і Docker спільно використовують вашу машину, вони не замінюють її.

Встановіть WSL 2 перед будь-чим іншим

Більшість невдалих інсталяцій Docker у Windows зазнають невдачі з однієї нудної причини: неправильний порядок. Docker Desktop очікує робочого WSL 2 під собою, тому спочатку створіть основу. Відкрийте PowerShell як адміністратор і виконайте одну команду:

wsl --install

Дочекайтеся завершення, а потім перезавантажте ПК — перезавантаження необов’язкове, воно завантажує компоненти віртуалізації. Після перезапуску Ubuntu (дистрибутив за замовчуванням) завершує власне налаштування та просить вас створити ім’я користувача та пароль Linux.

Переконайтеся, що WSL 2 справді готовий

Перш ніж Docker наблизиться до машини, підтвердьте основу за допомогою двох команд:

wsl --status
wsl -l -v

Ваш дистрибутив має відображати ВЕРСІЮ 2 у списку. Якщо відображається 1, установіть версію за замовчуванням і конвертуйте дистрибутив, як підказує вихід команди:

wsl --set-default-version 2

Кожен рівень перевіряється перед наступним, тож якщо пізніше щось не вийде, ви точно знаєте, на якому рівні проблема.

Встановіть Docker Desktop зверху

Завантажуйте Docker Desktop лише з docker.com — сторонні сайти завантажень об’єднують сміття з популярними інсталяторами. Запустіть інсталятор і позначте опцію Використовувати WSL 2 замість Hyper-V; на більшості комп'ютерів він позначений за замовчуванням.

Коли інсталятор запитає, закрийте його та вийдіть із системи або перезапустіть, якщо буде запропоновано. Docker додає ваш обліковий запис Windows до локальної групи docker-users, а членство в групі набуває чинності лише після нового входу — це чесна перевірка, яку більшість посібників пропускає, і саме тому Docker іноді відмовляється запускатися, доки ви не вийдете та не ввійдете знову.

Запустіть Docker Desktop і зачекайте, доки піктограма кита в системному лотку осяде, а на інформаційній панелі з’явиться повідомлення Engine running. Перший старт повільний; дайте йому пару хвилин. Чесно прийміть екран угоди про підписку на обслуговування Docker — це справжня ліцензія.

Запустіть свій перший контейнер — Hello World

Відкрийте нове вікно PowerShell або терміналу та виконайте дві команди, які підтвердять, що весь ланцюжок працює:

docker --version
docker run hello-world

docker --version підтверджує, що клієнт встановлено та знаходиться на вашому PATH. docker run hello-world підтверджує все інше: Docker не може знайти зображення локально, завантажує його з Docker Hub, створює з нього контейнер, запускає його та друкує повідомлення Hello from Docker!. Якщо з’являється це повідомлення, ваш ланцюжок працює наскрізно — термінал, клієнт, система всередині WSL 2, мережа та реєстр.