Windows контейнеры вручную. Часть 4: Скачиваем образ и готовим слои без containerd
Все части серии «Windows контейнеры вручную»В третьей части мы разобрали работающий контейнер и выяснили, что containerd сам контейнер не собирает: он скачивает образ, раскладывает слои по папкам и передаёт shim описание, а silo, диск C: и реестр создаёт HCS. Сегодня сделаем работу containerd руками. Скачаем образ из реестра обычными HTTP-запросами, проверим каждый байт по контрольным суммам, разложим слои утилитой wclayer из hcsshim, подключим записываемый слой как обычную папку и посмотрим, что containerd передаёт shim. В следующей части то же самое мы передадим HCS сами, уже без containerd.
Скрипт из этой части лежит в репозитории windows-containers-by-hand в папке 04-image.
Как реестр отдаёт образ
Реестр образов — это HTTP-сервер, который говорит по протоколу OCI Distribution. Его прародитель — Docker Registry HTTP API V2, поэтому все адреса начинаются с /v2/. Для скачивания образа хватает трёх видов запросов:
GET /v2/— проверка, что это реестр и какая нужна авторизация;GET /v2/<репозиторий>/manifests/<тег или digest>— описание образа, манифест или индекс;GET /v2/<репозиторий>/blobs/<digest>— содержимое: конфигурация образа или архив слоя.
Digest — это sha256: и хеш SHA-256 содержимого. Реестр хранит всё по содержимому: тег ltsc2025 — изменяемый ярлык, а digest однозначно называет конкретные байты, и клиент обязан проверить, что получил именно их. Какой документ клиент готов принять, он сообщает заголовком Accept, а реестр отвечает его типом в Content-Type.
Образ — это цепочка документов:
GET /v2/windows/nanoserver/manifests/ltsc2025
│
▼
индекс: по манифесту на каждую платформу
│ digest варианта windows 10.0.26100.*
▼
манифест: конфигурация и слои
│ │
│ config.digest │ layers[].digest
▼ ▼
конфигурация образа архивы слоёв tar.gz
os.version, Cmd, diff_ids GET /v2/.../blobs/<digest>
Проверим, что mcr.microsoft.com — реестр и пускает без авторизации. Подготовим рабочую папку:
Set-Location (New-Item -ItemType Directory C:\lab\image -Force)
curl.exe -si https://mcr.microsoft.com/v2/ | Select-String '^(HTTP|Content-Length|Docker-Distribution)'
HTTP/1.1 200 OK
Content-Length: 2
Docker-Distribution-Api-Version: registry/2.0
Код 200: можно скачивать без токена. Реестр, которому нужна авторизация, отвечает 401 с заголовком WWW-Authenticate — к этому вернёмся, когда дойдём до скрипта.
Индекс
Запросим тег ltsc2025 и скажем, что принимаем индекс в формате OCI и в формате Docker:
$reg = 'https://mcr.microsoft.com/v2/windows/nanoserver'
curl.exe -s -o index.json -H 'Accept: application/vnd.oci.image.index.v1+json, application/vnd.docker.distribution.manifest.list.v2+json' "$reg/manifests/ltsc2025"
$index = Get-Content index.json | ConvertFrom-Json
$index.mediaType
$index.manifests | ForEach-Object { [pscustomobject]@{ os = $_.platform.os; version = $_.platform.'os.version'; mediaType = $_.mediaType; digest = $_.digest } } | Format-List
application/vnd.docker.distribution.manifest.list.v2+json
os : windows
version : 10.0.26100.33674
mediaType : application/vnd.docker.distribution.manifest.v2+json
digest : sha256:6020b6edd804e7cf8cbca9142c351f597a59f53c5c7f07a6caa2261dcc1d8e8f
Индекс (у Docker он называется списком манифестов) перечисляет варианты образа для разных платформ. У тега ltsc2025 вариант один — Windows, сборка 26100, номер обновления 33674. У хоста номер обновления другой:
Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion' | Format-List CurrentBuild, UBR
CurrentBuild : 26100
UBR : 33650
Для изоляции процессов важно совпадение сборки (26100), а номер обновления может отличаться: контейнер работает на ядре хоста, и ядро одной сборки совместимо с её пользовательской частью. Отсюда правило выбора, которое containerd применяет сам: из индекса берётся вариант с os.version вида 10.0.<сборка хоста>.*. Подробно правила совместимости версий разобраны в части 39 серии о Kubernetes.
Манифест и конфигурация
Манифест запрашиваем по digest из индекса и сразу проверяем, что пришли именно эти байты:
$m = $index.manifests | Where-Object { $_.platform.'os.version' -like '10.0.26100.*' }
curl.exe -s -o manifest.json -H "Accept: $($m.mediaType)" "$reg/manifests/$($m.digest)"
'sha256:' + (Get-FileHash manifest.json).Hash.ToLower()
$manifest = Get-Content manifest.json | ConvertFrom-Json
$manifest.config | Format-List
$manifest.layers | Format-List
sha256:6020b6edd804e7cf8cbca9142c351f597a59f53c5c7f07a6caa2261dcc1d8e8f
mediaType : application/vnd.docker.container.image.v1+json
size : 640
digest : sha256:bd66d3cd23188368edf1629b326ae63d85cc339df59a695da701782a6568b62f
mediaType : application/vnd.docker.image.rootfs.diff.tar.gzip
size : 194222443
digest : sha256:a7eba7a59d48cb7e97e4eeb9fc22cf6a070f73a398171e5da84ae4aecc15cbde
Хеш файла совпал с digest из индекса. Манифест ссылается на два объекта: конфигурацию образа (640 байт) и единственный слой — архив tar, сжатый gzip, 194 МБ. Конфигурацию скачиваем как blob:
curl.exe -sL -o config.json "$reg/blobs/$($manifest.config.digest)"
'sha256:' + (Get-FileHash config.json).Hash.ToLower()
$config = Get-Content config.json | ConvertFrom-Json
$config | Format-List os, 'os.version', created
$config.config | Format-List User, Cmd
$config.rootfs.diff_ids
$config.history.created_by
sha256:bd66d3cd23188368edf1629b326ae63d85cc339df59a695da701782a6568b62f
os : windows
os.version : 10.0.26100.33674
created : 2026-10-24T23:26:15.8743218Z
User : ContainerUser
Cmd : {c:\windows\system32\cmd.exe}
sha256:9a4c0752c6bda5fc00f886a9acf0c0afed0750082f7999c331df978fb9f97d2a
Apply image 10.0.26100.33674
Ключ -L разрешает переход по перенаправлению: многие реестры отдают blob не сами, а перенаправляют на хранилище. mcr.microsoft.com тоже так делает: на запрос blob он отвечает кодом 307 с адресом на хосте вида *.data.mcr.microsoft.com, так что без -L файл не скачается.
В конфигурации то, что нужно для запуска: пользователь ContainerUser и команда по умолчанию cmd.exe. Сюда же попадают переменные окружения и рабочая папка, если они заданы при сборке. В rootfs.diff_ids — по хешу на слой, и этот хеш другой, не тот, что в манифесте.
Слой: digest и diff_id
Скачаем слой и проверим digest:
$layer = $manifest.layers[0]
curl.exe -sL -o base.tar.gz "$reg/blobs/$($layer.digest)"
'sha256:' + (Get-FileHash base.tar.gz).Hash.ToLower()
sha256:a7eba7a59d48cb7e97e4eeb9fc22cf6a070f73a398171e5da84ae4aecc15cbde
Digest в манифесте — хеш сжатого архива, каким его хранит реестр. diff_id в конфигурации — хеш того же архива без сжатия. Посчитаем его, распаковывая gzip на лету:
$gz = [IO.Compression.GZipStream]::new([IO.File]::OpenRead("$PWD\base.tar.gz"), [IO.Compression.CompressionMode]::Decompress)
$hash = [Security.Cryptography.SHA256]::Create().ComputeHash($gz); $gz.Dispose()
'sha256:' + (($hash | ForEach-Object { $_.ToString('x2') }) -join '')
sha256:9a4c0752c6bda5fc00f886a9acf0c0afed0750082f7999c331df978fb9f97d2a
Совпало с rootfs.diff_ids. Два хеша нужны, потому что один и тот же слой можно сжать по-разному. Образ примера ASP.NET от Microsoft построен на том же Nano Server, но его базовый слой в реестре весит 199 959 116 байт, а не 194 222 443, — другой gzip, другой digest. При этом diff_id у него тот же 9a4c0752…. Именно этот хеш стоял в корне ctr snapshots tree в третьей части: у базового слоя идентификатор цепочки совпадает с diff_id. containerd узнаёт слой по содержимому без сжатия и не хранит его дважды.
Заглянем в архив:
$files = tar -tzf base.tar.gz
$files | Group-Object { ($_ -split '/')[0] } | Format-Table Count, Name
$files | Where-Object { $_ -cmatch '^Files/Windows/System32/config/[A-Z]+$' }
Count Name
----- ----
8166 Files
2150 UtilityVM
Files/Windows/System32/config/BBI
Files/Windows/System32/config/COMPONENTS
Files/Windows/System32/config/DEFAULT
Files/Windows/System32/config/DRIVERS
Files/Windows/System32/config/ELAM
Files/Windows/System32/config/SAM
Files/Windows/System32/config/SECURITY
Files/Windows/System32/config/SOFTWARE
Files/Windows/System32/config/SYSTEM
В архиве две папки: Files — файловая система контейнера, и UtilityVM — файлы служебной виртуальной машины для изоляции Hyper-V, о ней поговорим в шестой части. Папки Hives, которую мы видели в слоях containerd, в архиве нет: кусты реестра лежат там же, где в обычной Windows, — в Files/Windows/System32/config. tar есть в Windows с 2018 года, это bsdtar.
wclayer
Простой распаковки архива мало: базовому слою нужны кусты реестра в Hives и заготовки виртуальных дисков, а файлы в архиве лежат со своими правами и атрибутами, которые надо восстановить. Всё это делает функция импорта слоя в HCS, а вызывает её утилита wclayer из hcsshim — той же библиотеки, на которой построен shim containerd. Готового wclayer.exe в релизах hcsshim нет, соберём его из исходников. Понадобится Go:
New-Item -ItemType Directory C:\build -Force | Out-Null; Set-Location C:\build
curl.exe -sLo go.zip https://go.dev/dl/go1.27.3.windows-amd64.zip
if ((Get-FileHash go.zip).Hash -ne 'f26081f438319757f8a1b46d7d0b2c5ec7583d4038e485e0aa725cfde7885fff') { throw 'go.zip: sha256 mismatch' }
Expand-Archive go.zip C:\build\tools
curl.exe -sLo hcsshim.zip https://github.com/microsoft/hcsshim/archive/refs/tags/v0.15.0.zip
Expand-Archive hcsshim.zip C:\build\src
Set-Location C:\build\src\hcsshim-0.15.0
C:\build\tools\go\bin\go.exe build -o C:\hcs\ ./cmd/wclayer
$p = [Environment]::GetEnvironmentVariable('Path', 'Machine')
[Environment]::SetEnvironmentVariable('Path', "$p;C:\hcs", 'Machine')
$env:Path += ';C:\hcs'
Хеш архива Go опубликован на go.dev/dl. Короче было бы go install github.com/Microsoft/hcsshim/cmd/wclayer@v0.15.0, но так не выйдет: в go.mod hcsshim есть директива replace, а go install с версией такие модули не собирает. Поэтому скачиваем архив исходников тега и собираем go build.
У wclayer семь команд, нам понадобятся четыре:
wclayer --help
...
COMMANDS:
create creates a new writable container layer
export exports a layer to a tar file
import imports a layer from a tar file
makebaselayer converts a directory containing 'Files/' into a base layer
mount activates a scratch, optionally mounted to provided target
remove permanently removes a layer directory in its entirety
unmount deactivates a scratch, optionally unmounting
help, h Shows a list of commands or help for one command
...
Импорт слоя
Set-Location C:\lab\image
wclayer import -i base.tar.gz C:\layers\nanoserver
Get-ChildItem C:\layers\nanoserver -Force | Format-Table Mode, Length, Name
Get-ChildItem C:\layers\nanoserver\Hives | Format-Table Length, Name
Get-Content C:\layers\nanoserver\layout
Mode Length Name
---- ------ ----
d----- Files
d----- Hives
d----- UtilityVM
-a---- 16384 bcd.bak
-a---- 16384 bcd.log.bak
-a---- 0 bcd.log1.bak
-a---- 0 bcd.log2.bak
-a---- 41943040 blank-base.vhdx
-a---- 4194304 blank.vhdx
-a---- 15 layout
Length Name
------ ----
8192 DEFAULTUSER_BASE
8192 SAM_BASE
8192 SECURITY_BASE
4190208 SOFTWARE_BASE
2781184 SYSTEM_BASE
vhd-with-hives
wclayer принимает сжатый архив и делает из него ровно то, что снапшоттер containerd кладёт в папку базового слоя. В Hives — кусты реестра базового слоя, их импорт готовит из кустов в Files\Windows\System32\config. blank.vhdx и blank-base.vhdx — заготовки пустых виртуальных дисков для записываемых слоёв. layout с содержимым vhd-with-hives описывает, как устроен слой. Файлы bcd*.bak относятся к данным загрузки служебной ВМ.
Остальные слои образа импортируются так же, только с ключами -l: каждый слой ложится поверх родителей, и wclayer нужно знать их всех. Это сделает скрипт ниже.
Записываемый слой
wclayer create -l C:\layers\nanoserver C:\layers\c1
Get-ChildItem C:\layers\c1 | Format-Table Length, Name
Length Name
------ ----
4194304 sandbox.vhdx
Тот самый sandbox.vhdx на 4 МБ, который мы видели рядом с работающим контейнером. Пока это пустой диск. Подключим его вместе со слоем образа к папке:
New-Item -ItemType Directory C:\mnt\c1 -Force | Out-Null
wclayer mount -l C:\layers\nanoserver C:\layers\c1 C:\mnt\c1
Get-ChildItem C:\mnt\c1 -Force | Format-Table Mode, Name
Get-Item C:\mnt\c1 | Format-List LinkType, Target
Get-ChildItem C:\mnt\c1\WcSandboxState -Recurse -File -Force | Format-Table Length, FullName
C:\mnt\c1
Mode Name
---- ----
d--h-- ProgramData
d-r--- Users
d--hs- WcSandboxState
d----- Windows
-a---- License.txt
LinkType : Junction
Target : {Volume{ee82a57b-3830-4167-8b04-5c2863dc20fd}\}
Length FullName
------ --------
0 C:\mnt\c1\WcSandboxState\initialized
8192 C:\mnt\c1\WcSandboxState\Hives\DefaultUser_Delta
8192 C:\mnt\c1\WcSandboxState\Hives\Sam_Delta
8192 C:\mnt\c1\WcSandboxState\Hives\Security_Delta
8192 C:\mnt\c1\WcSandboxState\Hives\Software_Delta
8192 C:\mnt\c1\WcSandboxState\Hives\System_Delta
Без папки-цели mount выводит только путь тома \\?\Volume{…}\. С целью папка становится точкой подключения тома, и в ней видна будущая файловая система C: контейнера: файлы слоя образа и WcSandboxState с пустыми разностными кустами реестра. Это то же, что shim делает перед запуском контейнера: подключает sandbox.vhdx и ставит на том фильтр wcifs со слоями. Фильтр видно:
fltmc volumes | Select-String -SimpleMatch 'C:\mnt'
fltmc instances -f wcifs
C:\mnt\c1 \Device\VhdHardDisk{ee82a57b-3830-4167-8b04-5c2863dc20fd} NTFS
Instances for wcifs filter:
Volume Name Altitude Instance Name Frame VlStatus
------------------------------------- ------------ ---------------------- ----- --------
C: 189900 wcifs Instance 0
C: 189899 wcifs Outer Instance 0
C:\mnt\c1 189900 wcifs Instance 0
C:\mnt\c1 — наш том. Контейнера здесь нет, но диск для него уже собран, и копирование при записи работает так же, как в третьей части:
$hosts = 'Windows\System32\drivers\etc\hosts'
Add-Content "C:\mnt\c1\$hosts" '10.0.0.5 changed-in-layer'
Get-Content "C:\mnt\c1\$hosts" -Tail 1
Get-Content "C:\layers\nanoserver\Files\$hosts" -Tail 1
10.0.0.5 changed-in-layer
# ::1 localhost
Через подключённую папку видна новая строка, а файл в слое образа не изменился: wcifs скопировал hosts в sandbox.vhdx. Отключим:
mountvol C:\mnt\c1 /D
wclayer unmount C:\layers\c1
(Get-Item C:\layers\c1\sandbox.vhdx).Length
11534336
sandbox.vhdx вырос с 4 до 11 МБ. Сначала снимаем точку подключения, потом wclayer unmount деактивирует слой. wclayer unmount с папкой вторым аргументом делает и то и другое сам, но на стенде он однажды сообщил «UnprepareLayer failed in Win32: The device is not ready» (хотя том при этом отключился), поэтому снимаю точку подключения отдельно. После повторного mount строка в hosts на месте: записываемый слой хранит всё, что в него записали, пока его не удалят командой wclayer remove.
Образ целиком: pull-image.ps1
У Nano Server один слой. У образов приложений их больше, и каждый надо скачать, проверить и импортировать поверх предыдущих. Это делает скрипт pull-image.ps1, он повторяет шаги выше:
- запрашивает тег с
Acceptдля индекса и манифеста; если пришёл индекс, выбирает вариантwindows/amd64для сборки хоста; - скачивает манифест и конфигурацию, сверяя digest каждого документа;
- для каждого слоя скачивает blob, сверяет digest и
diff_idи импортируетwclayer importс ключами-lдля всех нижележащих слоёв; - записывает
manifest.json(манифест),image.json(конфигурацию) иlayers.json— папки слоёв сверху вниз, в том порядке, в каком их ждутwclayer -lи HCS.
Сборку Windows скрипт берёт с хоста, а ключ -Build позволяет выбрать из индекса другую — это понадобится в седьмой части.
Скачаем скрипт в C:\hcs, к wclayer.exe, а им — образ примера ASP.NET от Microsoft:
curl.exe -sSLo C:\hcs\pull-image.ps1 https://raw.githubusercontent.com/vitaliy-leschenko/windows-containers-by-hand/main/04-image/pull-image.ps1
pull-image.ps1 mcr.microsoft.com/dotnet/samples:aspnetapp-nanoserver-ltsc2025 C:\images\samples
layer 1/13 sha256:9a4c0752c6bda5fc00f886a9acf0c0afed0750082f7999c331df978fb9f97d2a imported, 199959116 bytes
layer 2/13 sha256:1ccca4faa1fd48b30b12b03949c7cfcd9fd8a8feb5f4a11fafd554f260539bfa imported, 1006 bytes
layer 3/13 sha256:a1bcfaf182cf90cf3cfb6bb45fb9ab14d606bf062b326bd58f3be65b2fb4a972 imported, 1033 bytes
layer 4/13 sha256:0ad7102766069a128eef445c2d8b18885f9a7a4b0b3e2f6c2d89520062d7875b imported, 76140 bytes
layer 5/13 sha256:9487ccd8505172053f0fabff9f17ac700f987adbbb0553f94097a7a0a2dc853b imported, 1004 bytes
layer 6/13 sha256:8c4be1711ee2c9b5a130ee6bf912e66f710b5c38d7e415158e2044980a4c4e5e imported, 39443598 bytes
layer 7/13 sha256:fcbb4b24f1613c5b0f6094018844d4dfaf4b49a89340fbb2d241753d82f680ec imported, 1006 bytes
layer 8/13 sha256:10f876ddcb18f3447e9ff2d05fd8889f16b2c4d6de76a85750e1f66ea8735bf0 imported, 13276405 bytes
layer 9/13 sha256:ccd9cce9ded83b318000841197b3e659b78c8209d44fec4c2e5a5e5473703bc6 imported, 1009 bytes
layer 10/13 sha256:4b2fc071b094e3faef94b1bb8aed91d8606953b0c9c3c5ec011475e9c9652456 imported, 1240 bytes
layer 11/13 sha256:0819b5a7014851744e8b2ce6cd6616e184e1448dea994ae40a400d47e83c371c imported, 5465816 bytes
layer 12/13 sha256:1af6674ae0862643ef080f90b1bd5628326de142698cd628330a7aa700739a26 imported, 1004 bytes
layer 13/13 sha256:3d76ac9a2cbce3a19d3f5d553423e52ea9bf5dd9317664524f7cb75f402291b2 imported, 1010 bytes
mcr.microsoft.com/dotnet/samples:aspnetapp-nanoserver-ltsc2025 -> C:\images\samples, 13 layers
Когда тег ведёт на индекс, скрипт печатает строку index. Здесь её нет: этот тег ведёт прямо на манифест. Слоёв тринадцать, и большинство — по килобайту. Это не ошибка: образ собран так, что слоем стала каждая инструкция Dockerfile, даже ENV, EXPOSE и ENTRYPOINT — в истории образа 13 записей, и ни одна не помечена как запись без слоя. Слой от такой инструкции содержит только разностные кусты реестра в Hives, без файлов.
Анонимный токен
mcr.microsoft.com отдаёт образы без авторизации. Большинство других реестров, даже для публичных образов, требует токен, и скрипт его получает. Протокол такой:
- Реестр отвечает на запрос кодом 401 и заголовком
WWW-Authenticate: Bearer realm="https://auth.example.com/token",service="registry.example.com",scope="repository:library/hello-world:pull". - Клиент делает
GET <realm>?service=…&scope=…и получает JSON с полемtoken— для публичного образа без логина и пароля. - Клиент повторяет запрос с заголовком
Authorization: Bearer <токен>.
Docker Hub работает именно так:
pull-image.ps1 docker.io/hello-world:nanoserver-ltsc2025 C:\images\hello
index sha256:e78dec6982395f4f83172fd5473e2f0a3cb00e2f2bfd2c2b8854c2e4ff1aa625 -> 10.0.26100.33674 sha256:20e26fb7982c0d02a2bf39d3eb60a64baf70e96892c28259ba477b335db24a4e
layer 1/3 sha256:9a4c0752c6bda5fc00f886a9acf0c0afed0750082f7999c331df978fb9f97d2a imported, 199959116 bytes
layer 2/3 sha256:16ead3e57b23384a31f3303741aba8b0d6e7402c76ea83845a8034cbafacac52 imported, 1800 bytes
layer 3/3 sha256:30713c3b5279166a80970fbd9a80cb7cb60c37de665062dc3c5158c8eb8213b3 imported, 1009 bytes
docker.io/hello-world:nanoserver-ltsc2025 -> C:\images\hello, 3 layers
И здесь в основании тот же слой 9a4c0752…. Скрипт складывает слои каждого образа в его собственную папку, поэтому базовый слой у нас лежит трижды. containerd хранит его один раз, а образы ссылаются на общий снапшот.
Файлы образа
Подключим записываемый слой поверх всех тринадцати слоёв:
$layers = Get-Content C:\images\samples\layers.json | ConvertFrom-Json
$l = foreach ($p in $layers) { '-l'; $p }
wclayer create @l C:\layers\web
New-Item -ItemType Directory C:\mnt\web -Force | Out-Null
wclayer mount @l C:\layers\web C:\mnt\web
Get-ChildItem C:\mnt\web -Force | Format-Table Mode, Name
Get-ChildItem C:\mnt\web\app -Filter *.exe | Format-Table Length, Name
(Get-Content C:\images\samples\image.json | ConvertFrom-Json).config | Format-List User, Entrypoint, WorkingDir, Env
mountvol C:\mnt\web /D
wclayer unmount C:\layers\web
C:\mnt\web
Mode Name
---- ----
d----- app
d----- Program Files
d--h-- ProgramData
d-r--- Users
d--hs- WcSandboxState
d----- Windows
-a---- License.txt
Length Name
------ ----
73728 AspNetCoreRazorApp.exe
User : ContainerUser
Entrypoint : {AspNetCoreRazorApp}
WorkingDir : C:\app
Env : {ASPNETCORE_HTTP_PORTS=8080, DOTNET_RUNNING_IN_CONTAINER=true, DOTNET_VERSION=11.0.0-rc.3.26522.148, ASPNET_VERSION=11.0.0-rc.3.26522.148}
wcifs склеил все слои: C:\app с приложением, Program Files\dotnet со средой .NET и Windows из базового слоя. Из конфигурации известно, что запускать: AspNetCoreRazorApp в C:\app от ContainerUser с четырьмя переменными окружения. Диск, команда и окружение готовы. Не хватает самого контейнера: silo, сети и процесса внутри.
Что containerd передаёт shim
Посмотрим, как ту же работу делает containerd. Запустим через него тот же пример ASP.NET и заглянем в метаданные контейнера:
nerdctl run -d --name web -p 8080:8080 mcr.microsoft.com/dotnet/samples:aspnetapp-nanoserver-ltsc2025
$id = (nerdctl inspect web | ConvertFrom-Json).Id
$info = ctr containers info $id | ConvertFrom-Json
$info | Format-List Runtime, Snapshotter, SnapshotKey
Runtime : @{Name=io.containerd.runhcs.v1; Options=}
Snapshotter : windows
SnapshotKey : 1107b8f92b9a659e90bcf754a29d4e914ad08a22adaba342167a9e084b3299d7
Рантайм io.containerd.runhcs.v1 — это containerd-shim-runhcs-v1.exe. Диск контейнера — снапшот с ключом, совпадающим с идентификатором контейнера. Что этот снапшот означает, ctr покажет в виде команды mount:
ctr snapshots mounts C:\mnt\x $info.SnapshotKey
mount -t windows-layer C:\ProgramData\containerd\root\io.containerd.snapshotter.v1.windows\snapshots\111 C:\mnt\x -o rw,parentLayerPaths=["C:\\ProgramData\\containerd\\root\\io.containerd.snapshotter.v1.windows\\snapshots\\109","C:\\ProgramData\\containerd\\root\\io.containerd.snapshotter.v1.windows\\snapshots\\108","C:\\ProgramData\\containerd\\root\\io.containerd.snapshotter.v1.windows\\snapshots\\107","C:\\ProgramData\\containerd\\root\\io.containerd.snapshotter.v1.windows\\snapshots\\106","C:\\ProgramData\\containerd\\root\\io.containerd.snapshotter.v1.windows\\snapshots\\105","C:\\ProgramData\\containerd\\root\\io.containerd.snapshotter.v1.windows\\snapshots\\104","C:\\ProgramData\\containerd\\root\\io.containerd.snapshotter.v1.windows\\snapshots\\103","C:\\ProgramData\\containerd\\root\\io.containerd.snapshotter.v1.windows\\snapshots\\102","C:\\ProgramData\\containerd\\root\\io.containerd.snapshotter.v1.windows\\snapshots\\101","C:\\ProgramData\\containerd\\root\\io.containerd.snapshotter.v1.windows\\snapshots\\100","C:\\ProgramData\\containerd\\root\\io.containerd.snapshotter.v1.windows\\snapshots\\99","C:\\ProgramData\\containerd\\root\\io.containerd.snapshotter.v1.windows\\snapshots\\98","C:\\ProgramData\\containerd\\root\\io.containerd.snapshotter.v1.windows\\snapshots\\97"]
Это наш wclayer mount, записанный по-другому: snapshots\111 с sandbox.vhdx — записываемый слой, parentLayerPaths — слои образа сверху вниз, как -l и layers.json. ctr snapshots mounts ничего не подключает, а только печатает. Такое описание containerd передаёт shim вместе с запросом на создание контейнера, а подключает слои уже shim.
Вторая половина — спецификация OCI, config.json из стандарта OCI Runtime. Её собирает nerdctl из конфигурации образа и ключей nerdctl run:
$info.Spec | Select-Object ociVersion, process, root, windows | ConvertTo-Json -Depth 5
{
"ociVersion": "1.3.0",
"process": {
"user": {
"uid": 0,
"gid": 0,
"username": "ContainerUser"
},
"args": [
"AspNetCoreRazorApp"
],
"env": [
"ASPNETCORE_HTTP_PORTS=8080",
"DOTNET_RUNNING_IN_CONTAINER=true",
"DOTNET_VERSION=11.0.0-rc.3.26522.148",
"ASPNET_VERSION=11.0.0-rc.3.26522.148",
"HOSTNAME="
],
"cwd": "C:\\app"
},
"root": {
"path": ""
},
"windows": {
"layerFolders": null,
"ignoreFlushesDuringBoot": true,
"network": {
"allowUnqualifiedDNSQuery": true,
"networkNamespace": "ab27b154-916c-4b72-b91a-6078a5d23833"
}
}
}
Остальное в спецификации — аннотации nerdctl/*, в которых nerdctl хранит имя, порты и прочие свои настройки. Разберём поля:
process— что запустить: команда изEntrypoint, переменные изEnvи папка изWorkingDirконфигурации образа, пользователь по имени.uidиgidна Windows не используются.root.pathпуст, аwindows.layerFoldersравенnull. Стандарт OCI позволяет перечислить слои прямо вlayerFolders, но containerd так не делает: слои приходят отдельно, тем описаниемwindows-layer, что мы видели выше.windows.network.networkNamespace— идентификатор пространства имён HNS. Сеть к этому моменту уже готова: nerdctl создал пространство, CNI-плагинnat— конечную точку в нём, а shim только привязывает пространство к контейнеру.
hnsdiag list endpoints
Endpoint : ba8fa62b-4f5a-44b4-a1ad-c2c9255a2ac9
Name : 1107b8f92b9a659e90bcf754a29d4e914ad08a22adaba342167a9e084b3299d7_nat
IP Address : 172.30.0.10
Получив спецификацию и слои, shim подключает слои (как наш wclayer mount), превращает спецификацию OCI в JSON-документ HCS и вызывает HCS: создать вычислительную систему (compute system), запустить её, запустить в ней процесс. Этот документ HCS мы и напишем сами в следующей части.
А runhcs?
В hcsshim есть ещё одна программа — runhcs.exe, рантайм с командной строкой как у runc. Он принимает OCI bundle: папку с config.json, где слои перечислены в windows.layerFolders. Казалось бы, это и есть следующий шаг вниз. Я собрал его так же, как wclayer, и проверил на стенде:
- в hcsshim 0.13 и новее, включая 0.15.0,
runhcsне подключает слои изlayerFoldersи падает с ошибкой «failed to mount container storage: invalid layer type <nil>»: новый код подключения слоёв ждёт описание, которое готовит только containerd; - в 0.12.9 слои подключаются, но сам
runhcsпадает с обращением по нулевому указателю; - 0.11.8 запускает контейнер,
exec,psиkillработают, подключённые папки тоже. Но вывод контейнера до терминала не доходит, после сбоев остаются подключённые дискиsandbox.vhdx, а контейнер, запущенныйrun -dиз сеанса WinRM, завершается вместе с сеансом.
runhcs — ранняя попытка дать Windows рантайм в духе runc. Сейчас hcsshim развивается вокруг shim containerd, новый код подключения слоёв рассчитан на него, а runhcs отстал. Поэтому в серии его нет: вместо рантайма, который прячет HCS за OCI bundle и делает это плохо, обратимся к HCS напрямую.
Убираем за собой
Контейнер, образ containerd, слои и рабочие папки этой части больше не понадобятся. Папки слоёв удаляет wclayer remove, остальное — обычный Remove-Item:
Set-Location C:\
nerdctl rm -f web
nerdctl rmi mcr.microsoft.com/dotnet/samples:aspnetapp-nanoserver-ltsc2025
foreach ($d in 'C:\layers\web', 'C:\layers\c1', 'C:\layers\nanoserver') { wclayer remove $d }
Get-ChildItem C:\images\*\layers -Directory | ForEach-Object { wclayer remove $_.FullName }
Remove-Item C:\images, C:\layers, C:\mnt, C:\lab -Recurse -Force
wclayer, pull-image.ps1 и Go остаются на сервере.
Итог
- Реестр — HTTP-сервер с тремя видами запросов:
/v2/,manifestsиblobs. Тег ведёт на индекс или манифест, манифест — на конфигурацию и слои, и всё адресуется хешем содержимого. - Из индекса берётся вариант для сборки хоста. Номер обновления может отличаться.
- У слоя два хеша: digest сжатого архива в манифесте и
diff_idнесжатого в конфигурации. containerd узнаёт одинаковые слои по несжатому содержимому: снапшоты называются идентификаторами цепочек, построенными изdiff_id. wclayer importпревращает архив слоя в папку сFilesиHives,createделаетsandbox.vhdx,mountподключает его со слоями черезwcifs— к папке, если её указать.- containerd передаёт shim слои описанием
windows-layerсparentLayerPaths, а спецификацию OCI — с пустымlayerFoldersи готовым пространством имён HNS.
Источники
- OCI Distribution Specification — протокол реестра: манифесты, blob, digest,
Accept. - OCI Image Specification — индекс, манифест, конфигурация образа,
diff_ids. - Docker Registry v2 authentication — получение токена по
WWW-Authenticate. - OCI Runtime Specification: Windows — раздел
windowsвconfig.json,layerFolders,network. - microsoft/hcsshim — исходники
wclayer,runhcsи shim containerd. - Windows container version compatibility — Microsoft Learn: совместимость сборок хоста и образа.
Дальше — контейнер без рантайма: пишем JSON-документ HCS для слоёв из этой части, создаём вычислительную систему через computecore.dll, подключаем конечную точку HNS и запускаем в контейнере процесс с перенаправленным выводом.
Оставить комментарий могут только зарегистрированные пользователи.
Войдите на сайт или зарегистрируйтесь, чтобы оставить комментарий.