Формат образа докера

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

Я просмотрел документацию Docker Registry API, но этой информации там нет.

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

Идея моего проекта заключается в реализации скрипта, который создает образ из скомпилированных мной атефактов и загружает его в реестр. Я хотел бы использовать OpenEmbedded для этой цели, по сути, это будет расширение для Bitbake.


yocto docker openembedded packer
person errordeveloper    schedule 30.08.2014    source источник

Ответы (2)


arrow_upward
16
arrow_downward

Формат образа Docker указан здесь: https://github.com/docker/docker/blob/master/image/spec/v1.md

Самый простой возможный образ — это tar-файл, содержащий следующее:

repositories
uniqid/VERSION
uniqid/json
uniqid/layer.tar

Где VERSION содержит 1.0, layer.tar содержит содержимое chroot, а json/репозитории — это файлы JSON, как указано в спецификации выше.

Полученный tar можно загрузить в докер через docker load < image.tar

person tmm1    schedule 22.04.2015

arrow_upward
10
arrow_downward

После прочтения блога Джеймса Койла, я понял, что мне нужны команды docker save и docker load.

> docker images
REPOSITORY          TAG                 IMAGE ID            CREATED             VIRTUAL SIZE
progrium/consul     latest              e9fe5db22401        11 days ago         25.81 MB
> docker save e9fe5db22401 | tar x
> ls e9fe5db22401*
VERSION  json  layer.tar

Файл VERSION содержит только 1.0, а json содержит довольно много информации:

{
  "id": "e9fe5db224015ddfa5ee9dbe43b414ecee1f3108fb6ed91add11d2f506beabff",
  "parent": "68f9e4929a4152df9b79d0a44eeda042b5555fbd30a36f98ab425780c8d692eb",
  "created": "2014-08-20T17:54:30.98176344Z",
  "container": "3878e7e9b9935b7a1988cb3ebe9cd45150ea4b09768fc1af54e79b224bf35f26",
  "container_config": {
    "Hostname": "7f17ad58b5b8",
    "Domainname": "",
    "User": "",
    "Memory": 0,
    "MemorySwap": 0,
    "CpuShares": 0,
    "Cpuset": "",
    "AttachStdin": false,
    "AttachStdout": false,
    "AttachStderr": false,
    "PortSpecs": null,
    "ExposedPorts": {
      "53/udp": {},
      "8300/tcp": {},
      "8301/tcp": {},
      "8301/udp": {},
      "8302/tcp": {},
      "8302/udp": {},
      "8400/tcp": {},
      "8500/tcp": {}
    },
    "Tty": false,
    "OpenStdin": false,
    "StdinOnce": false,
    "Env": [
      "HOME=/",
      "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
      "SHELL=/bin/bash"
    ],
    "Cmd": [
      "/bin/sh",
      "-c",
      "#(nop) CMD []"
    ],
    "Image": "68f9e4929a4152df9b79d0a44eeda042b5555fbd30a36f98ab425780c8d692eb",
    "Volumes": {
      "/data": {}
    },
    "WorkingDir": "",
    "Entrypoint": [
      "/bin/start"
    ],
    "NetworkDisabled": false,
    "OnBuild": [
      "ADD ./config /config/"
    ]
  },
  "docker_version": "1.1.2",
  "author": "Jeff Lindsay <[email protected]>",
  "config": {
    "Hostname": "7f17ad58b5b8",
    "Domainname": "",
    "User": "",
    "Memory": 0,
    "MemorySwap": 0,
    "CpuShares": 0,
    "Cpuset": "",
    "AttachStdin": false,
    "AttachStdout": false,
    "AttachStderr": false,
    "PortSpecs": null,
    "ExposedPorts": {
      "53/udp": {},
      "8300/tcp": {},
      "8301/tcp": {},
      "8301/udp": {},
      "8302/tcp": {},
      "8302/udp": {},
      "8400/tcp": {},
      "8500/tcp": {}
    },
    "Tty": false,
    "OpenStdin": false,
    "StdinOnce": false,
    "Env": [
      "HOME=/",
      "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
      "SHELL=/bin/bash"
    ],
    "Cmd": [],
    "Image": "68f9e4929a4152df9b79d0a44eeda042b5555fbd30a36f98ab425780c8d692eb",
    "Volumes": {
      "/data": {}
    },
    "WorkingDir": "",
    "Entrypoint": [
      "/bin/start"
    ],
    "NetworkDisabled": false,
    "OnBuild": [
      "ADD ./config /config/"
    ]
  },
  "architecture": "amd64",
  "os": "linux",
  "Size": 0
}

Файл layer.tar кажется пустым. Таким образом, проверенный родитель и дедушка и бабушка не содержали файла в своих layer.tar файлах.

Итак, предположим, что 4.0K — это стандартный размер пустого архива:

 for layer in $(du -hs */layer.tar | grep -v 4.0K | cut -f2)
 do (echo $layer:;tar tvf $layer)
 done

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

Таким образом, один из выводов заключается в том, что, вероятно, лучше просто использовать Docker для создания образа и отправки его в реестр, как это делает Packer.

Способ создания образа с нуля описан в документации.

Оказывается, docker import - scratch не волнует, что находится в архиве. Я просто предполагаю, что это rootfs.

> touch foo
> tar c foo | docker import - scratch
02bb6cd70aa2c9fbaba37c8031c7412272d804d50b2ec608e14db054fc0b9fab
> docker save 02bb6cd70aa2c9fbaba37c8031c7412272d804d50b2ec608e14db054fc0b9fab | tar x
> ls 02bb6cd70aa2c9fbaba37c8031c7412272d804d50b2ec608e14db054fc0b9fab/
VERSION  json  layer.tar
> tar tvf 02bb6cd70aa2c9fbaba37c8031c7412272d804d50b2ec608e14db054fc0b9fab/layer.tar    
drwxr-xr-x 0/0               0 2014-09-01 13:46 ./
-rw-r--r-- 500/500           0 2014-09-01 13:46 foo

Что касается интеграции с OpenEmbedded, вероятно, лучше всего собрать архив rootfs, который Yocto предоставляет из коробки, и использовать официальная библиотека Python, чтобы импортировать tar-архив rootfs с помощью import_image(src='rootfs.tar', repository='scratch'), а затем отправить его методом частного реестра.

Это не самое элегантное решение, но на данный момент оно должно работать именно так. В противном случае, вероятно, можно просто управлять и развертывать ревизии rootfs по-своему, и просто использовать docker import на целевом хосте, что все еще не очень подходит, но несколько просто.

person errordeveloper    schedule 01.09.2014