254 lines
13 KiB
Markdown
254 lines
13 KiB
Markdown
---
|
||
date: '2026-04-26T04:58:44-04:00'
|
||
lastmod: '2026-04-26T04:58:44-04:00'
|
||
draft: false
|
||
title: 'Ansible в Windows 10 через WSL2: Debian, uv, VHDX и удобный рабочий процесс'
|
||
slug: 'ansible-controller-on-win10'
|
||
description: ''
|
||
|
||
categories:
|
||
- 'devops'
|
||
|
||
tags:
|
||
- 'devops'
|
||
- 'ansible'
|
||
- 'windows'
|
||
- 'iac'
|
||
|
||
keywords:
|
||
- 'wsl'
|
||
- 'win10'
|
||
- 'ansible'
|
||
- 'powershell'
|
||
- 'iac'
|
||
|
||
cover:
|
||
image: "hero.svg"
|
||
alt: "Ansible в Windows 10 через WSL2"
|
||
relative: true
|
||
---
|
||
|
||
На домашней машине у меня всё еще Winodws 10 стоит(домашние предпочитают удобные цепи закрытого софта вместо свободы), но доставать ноут каждый раз когда нужно управлять инфраструктурой через Ansible бывает сложно, самый практичный путь — поставить Debian в WSL2 и работать уже внутри него. Такой сценарий дает полноценную Linux-среду, не требует отдельной виртуальной машины и удобно бэкапится целиком через wsl --export в формат VHDX.
|
||
|
||
Ниже — полностью рабочая схема без Microsoft Store: ручная установка WSL2, импорт Debian, настройка uv, установка ansible-core, маппинг проекта на D:\ansible и резервное копирование через VHDX.
|
||
|
||
## Что понадобится
|
||
|
||
Для WSL2 на Windows 10 нужна версия 2004 и сборка 19041 или новее, а также включенная аппаратная виртуализация в BIOS/UEFI. Установка WSL и Debian выполняется из PowerShell от имени администратора.
|
||
|
||
- Windows 10 с поддержкой WSL2.
|
||
- PowerShell с правами администратора.
|
||
- Доступ к интернету для загрузки компонентов и пакетов.
|
||
- Папка для WSL, например D:\WSL\Debian.
|
||
- Папка для проектов, например D:\ansible.
|
||
|
||
## Включаем WSL2 вручную
|
||
|
||
Если Microsoft Store недоступен или вы не хотите им пользоваться, включите компоненты Windows вручную:
|
||
|
||
```powershell
|
||
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
|
||
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
|
||
```
|
||
|
||
После этого перезагрузи ПК. Эти два компонента нужны для работы WSL2, потому что дистрибутив запускается внутри легковесной виртуальной машины.
|
||
|
||
Затем задаём WSL2 как версию по умолчанию:
|
||
|
||
```powershell
|
||
wsl --set-default-version 2
|
||
```
|
||
|
||
## Устанавливаем Debian без Store
|
||
|
||
Для установки Debian без Microsoft Store удобнее использовать импорт rootfs-архива или готового VHDX-образа. Важно не искать случайные архивы по форумам, а брать Debian из официального источника или собирать rootfs на основе официального образа Debian.
|
||
|
||
На практике удобны два пути:
|
||
|
||
скачать официальный Debian-образ и подготовить из него rootfs;
|
||
|
||
либо сразу импортировать уже готовый rootfs-архив, если он у вас есть.
|
||
|
||
Пример импорта:
|
||
|
||
```powershell
|
||
mkdir D:\WSL\Debian
|
||
wsl --import Debian D:\WSL\Debian D:\Downloads\debian-rootfs.tar --version 2
|
||
```
|
||
|
||
После этого запускаем Debian так:
|
||
|
||
```powershell
|
||
wsl -d Debian
|
||
```
|
||
|
||
Если Debian уже был установлен из Store, его можно перенести в управляемый каталог через экспорт и повторный импорт, что особенно удобно для бэкапа и миграции.
|
||
|
||
## Перенос Debian из Store
|
||
|
||
Сценарий переноса простой: экспортируем текущий дистрибутив, затем импортируем его в нужную папку. Microsoft документирует wsl --export, wsl --unregister и wsl --import как штатный путь для переноса и резервного копирования WSL-дистрибутивов.
|
||
|
||
```powershell
|
||
|
||
# Смотрим имя дистрибутива:
|
||
wsl -l -v
|
||
|
||
#Останавливаем WSL
|
||
wsl --shutdown
|
||
|
||
#Экспортируем Debian в архив
|
||
wsl --export Debian D:\Backup\Debian.tar
|
||
|
||
#Удаляем старую регистрацию, если нужен чистый перенос
|
||
|
||
wsl --unregister Debian
|
||
|
||
#Импортируем в управляемую папку
|
||
wsl --import Debian D:\WSL\Debian D:\Backup\Debian.tar --version 2
|
||
```
|
||
|
||
После этого Debian будет жить в D:\WSL\Debian, а не в Store-профиле пользователя, и им станет проще управлять и делать бэкап.
|
||
|
||
## Настраиваем Ansible через uv
|
||
|
||
Для Ansible в WSL2 я рекомендую не системную установку и не pip в системный Python, а отдельное виртуальное окружение, управляемое через uv. Такой подход изолирует зависимости, не трогает системный Python Debian и позволяет легко воспроизводить окружение после восстановления из бэкапа.
|
||
|
||
ansible-core — это базовый движок Ansible. В отличие от полного пакета ansible, он содержит только ядро: выполнение playbook’ов, inventory-логику, CLI и основную инфраструктуру. Это делает установку легче, прозрачнее и удобнее для проектного workflow.
|
||
|
||
Минимальный набор для установки:
|
||
|
||
- uv;
|
||
- ansible-core;
|
||
- openssh-client;
|
||
- git;
|
||
- python3.
|
||
|
||
После входа в Debian:
|
||
|
||
```bash
|
||
sudo apt update
|
||
sudo apt install -y curl git openssh-client python3
|
||
curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/uv/releases/download/0.11.7/uv-installer.sh | sh
|
||
```
|
||
|
||
После установки uv нужно переоткрытьshell-сессию или добавьте uv в PATH, если установщик это не сделал автоматически. uv умеет создавать виртуальные окружения и ставить пакеты внутрь них, а также работать с выбранным Python-интерпретатором.
|
||
|
||
Создаем окружение
|
||
Если проект лежит в ~/ansible:
|
||
|
||
```bash
|
||
cd ~/ansible
|
||
uv venv
|
||
source .venv/bin/activate
|
||
uv pip install ansible-core
|
||
```
|
||
|
||
Если нужен линтер:
|
||
|
||
``` bash
|
||
uv pip install ansible-core ansible-lint
|
||
```
|
||
|
||
Такой workflow хорош тем, что версию Ansible можно менять независимо от системы, а зависимости проекта не смешиваются с Debian-пакетами.
|
||
|
||
Почему ansible-core удобнее
|
||
Для рабочей машины под Ansible ansible-core обычно удобнее, чем полный пакет ansible, по нескольким причинам. Во-первых, он меньше и чище, поэтому окружение проще поддерживать. Во-вторых, вы явно контролируете, какие коллекции и зависимости нужны именно вашему проекту. В-третьих, это снижает зависимость от версии, которую выдает системный репозиторий Debian.
|
||
|
||
Практически это означает следующее:
|
||
|
||
- ansible-core ставится в проектный venv;
|
||
- коллекции ставятся отдельно через ansible-galaxy или по requirements.yml;
|
||
- при необходимости окружение можно пересоздать за пару минут.
|
||
|
||
Рекомендуемый workflow
|
||
|
||
```bash
|
||
mkdir -p ~/ansible
|
||
cd ~/ansible
|
||
uv venv
|
||
source .venv/bin/activate
|
||
uv pip install ansible-core
|
||
```
|
||
|
||
Дальше в репозитории храним:
|
||
|
||
- playbook’и;
|
||
- inventory;
|
||
- requirements.yml;
|
||
- ansible.cfg.
|
||
Сами зависимости и .venv в Git не добавляем. Это делает проект переносимым и аккуратным.
|
||
|
||
## Маппинг ~/ansible в D:\ansible
|
||
Если хотите хранить проект на диске Windows, используйте стандартный путь WSL: D:\ansible в Linux виден как /mnt/d/ansible. Это штатный механизм WSL, а для обратного преобразования путей существует wslpath.
|
||
|
||
Самый простой вариант:
|
||
|
||
```bash
|
||
cd /mnt/d/ansible
|
||
```
|
||
|
||
Если хотите, чтобы в Linux путь был именно ~/ansible, создайте символическую ссылку:
|
||
|
||
```bash
|
||
rm -rf ~/ansible
|
||
ln -s /mnt/d/ansible ~/ansible
|
||
```
|
||
|
||
После этого ~/ansible будет указывать на D:\ansible. Это удобно: в Ansible-проектах вы работаете с привычным Linux-путем, а файлы физически лежат на Windows-диске.
|
||
|
||
|
||
## Команды управления WSL
|
||
Минимальный набор команд для повседневной работы:
|
||
|
||
```powershell
|
||
# Показать все дистрибутивы и их версию
|
||
wsl -l -v
|
||
|
||
# Запустить Debian
|
||
wsl -d Debian
|
||
|
||
# Сделать Debian дистрибутивом по умолчанию
|
||
wsl --set-default Debian
|
||
|
||
# Полностью остановить WSL2
|
||
wsl --shutdown
|
||
|
||
# Остановить только Debian
|
||
wsl --terminate Debian
|
||
|
||
# Перевести Debian в WSL2, если он вдруг оказался в WSL1
|
||
wsl --set-version Debian 2
|
||
```
|
||
|
||
## Бэкап через VHDX
|
||
Для WSL2 самый удобный резервный формат — VHDX. Microsoft прямо поддерживает экспорт дистрибутива в VHDX через wsl --export ... --vhd, а затем импорт обратно через wsl --import ... --vhd. Это сохраняет весь дистрибутив целиком, включая Ansible, Python-окружение, ключи, историю shell и рабочие файлы.
|
||
|
||
```powershell
|
||
# Перед бэкапом обязательно останавливаем WSL
|
||
wsl --shutdown
|
||
|
||
# Затем создаtv бэкап
|
||
wsl --export Debian D:\Backup\Debian\Debian.vhdx --vhd
|
||
```
|
||
|
||
Это удобнее ручного копирования ext4.vhdx, потому что команда сразу создает переносимый снимок дистрибутива в формате VHDX.
|
||
|
||
## Восстановление
|
||
Если нужно восстановить среду из такого бэкапа, импортируем VHDX как дистрибутив:
|
||
|
||
```powershell
|
||
wsl --import DebianRestored D:\WSL\DebianRestored D:\Backup\Debian\Debian.vhdx --vhd --version 2
|
||
```
|
||
|
||
Если мы храним дистрибутив в отдельной папке и используете import-in-place, можно подключить существующий VHDX без распаковки. Это особенно удобно при переносе среды на другой диск или другой компьютер.
|
||
|
||
## Практичная схема для работы
|
||
Для повседневного использования я бы рекомендовал такую схему:
|
||
|
||
- Debian живет в WSL2;
|
||
- Ansible ставится через uv в .venv;
|
||
- проекты лежат в D:\ansible и маппятся через /mnt/d/ansible;
|
||
- резервная копия делается через wsl --export ... --vhd;
|
||
- .venv в Git не хранится, а dependencies фиксируются в документации или requirements.yml.
|
||
|
||
Такой подход дает хорошую изоляцию, быстрый старт после восстановления и удобную миграцию между машинами. Для WSL2 это один из самых практичных способов использовать Ansible в Windows 10 без необходимости перезагрузки. |