Устаревшие функции движка

На этой странице представлен обзор функций, которые устарели в Engine. Изменения в упаковке и поддерживаемых дистрибутивах (Linux) не включены. Чтобы узнать об окончании поддержки дистрибутивов Linux, обратитесь к примечания к выпуску.

Политика устаревания функций

По мере внесения изменений в Docker могут возникнуть ситуации, когда существующие функции необходимо удаляет или заменяет новыми функциями. Перед удалением существующей функции она помечается в документации как «устаревшая» и остаётся в Docker как минимум в течение одного стабильного релиза, если явно не указано иное. По истечении этого времени его можно удаляет.

Ожидается, что пользователи будут принимать к сведению список устаревших функций в каждом выпуске и планировать свой переход от данных функций к заменяющим функциям (если применимо) как можно скорее.

Устаревшие функции движка

В таблице далее представлен обзор текущего статуса устаревших функций:

  • Устарело: функция помечена как устаревшая и больше не должна использоваться. Данная функция может быть удалена, отключена или изменена в будущем выпуске. Столбец «Устаревший» содержит версию, в которой функция была помечена как устаревшая, тогда как столбец «Удаляет» содержит предварительную версию, в которой функция должна быть удалена. Если в столбце «Удаляет» релиз не указан, решение о выпуске ещё не принято.

  • Удалено: функция была удалена, отключена или скрыта. Подробнее см. в связанном разделе. Некоторые функции являются «мягкими» устаревшими, что означает, что они остаются функциональными для обратной совместимости и позволяют пользователям переходить на альтернативы. В таких случаях может быть напечатано предупреждение, и пользователям не следует полагаться на эту функцию.

Положение дел

Особенность

Устарело

Удалять

Устарело

Устаревший построитель образов Linux

v23.0.0

Устарело

Резервный опция устаревшего билдера

v23.0.0

Удаленный

Драйвер хранилища Btrfs в CentOS 7 и RHEL 7

v20.10

v23.0.0

Удаленный

Поддержка зашифрованных закрытых ключей TLS

v20.10

v23.0.0

Удаленный

Поддержка стека и контекста Kubernetes

v20.10

v23.0.0

Устарело

Извлечение образов из несовместимых реестров образов

v20.10

Удаленный

Контейнеры Linux в Windows (LCOW)

v20.10

v23.0.0

Устарело

Параметры веса BLKIO с cgroups v1

v20.10

Удаленный

Ограничение памяти ядра

v20.10

v23.0.0

Удаленный

Классический Swarm и оверлейные сети, использующие внешние хранилища ключей и значений

v20.10

v23.0.0

Удаленный

Поддержка устаревшего файла конфигурации ~/.dockercfg для проверки подлинности

v20.10

v23.0.0

Устарело

Поддержка плагинов CLI

v20.10

Устарело

Устаревший синтаксис Dockerfile ENV name value

v20.10

Удаленный

Флаг docker build --stream (экспериментальный)

v20.10

v20.10

Устарело

fluentd-async-connect бревно опц

v20.10

Удаленный

Параметры конфигурации для экспериментальных функций CLI

v19.03

v23.0.0

Устарело

Отправка и извлечение с помощью схемы 1 манифеста образа v2

v19.03

v20.10

Удаленный

Подкоманды docker engine

v19.03

v20.10

Удаленный

Подкоманда верхнего уровня docker deploy (экспериментальная)

v19.03

v20.10

Удаленный

docker stack deploy с использованием файлов «dab» (экспериментальный)

v19.03

v20.10

Неполноценный

Поддержка варианта хранения overlay2.override_kernel_check

v19.03

Неполноценный

Драйвер хранилища AuFS

v19.03

Неполноценный

Устаревший «оверлейный» драйвер хранилища

v18.09

Неполноценный

Драйвер хранилища картографа устройств

v18.09

Удаленный

Использование зарезервированных пространств имён в метках движка

v18.06

v20.10

Удаленный

--disable-legacy-registry переопределяет параметр демона

v17.12

v19.03

Удаленный

Взаимодействие с реестрами V1

v17.06

v17.12

Удаленный

Асинхронные service create и service update по умолчанию

v17.05

v17.10

Удаленный

Флаги -g и --graph на dockerd

v17.05

Устарело

Сетевые свойства верхнего уровня в NetworkSettings

v1.13

v17.12

Удаленный

Параметр filter для конечной точки /images/json

v1.13

v20.10

Удаленный

Ссылки на образы repository:shortid

v1.13

v17.12

Удаленный

Подкоманда docker daemon

v1.13

v17.12

Удаленный

Дублирующиеся ключи с конфликтующими значениями в метках движка

v1.13

v17.12

Устарело

MAINTAINER в Dockerfile

v1.13

Устарело

Вызовы API без версии

v1.13

v17.12

Удаленный

Резервная файловая система без поддержки d_type для оверлея/оверлея2

v1.13

v17.12

Удаленный

Флаги --automated и --stars при поиске докеров

v1.12

v20.10

Устарело

-h сокращение от --help

v1.12

v17.09

Удаленный

Флаги -e и --email на docker login

v1.11

v17.06

Устарело

Разделитель (:) флага --security-opt на docker run

v1.11

v17.06

Устарело

Неоднозначные поля событий в API

v1.10

Удаленный

Флаг -f на docker tag

v1.10

v1.12

Удаленный

HostConfig при запуске контейнера API

v1.10

v1.12

Удаленный

Флаги --before и --since на docker ps

v1.10

v1.12

Удаленный

Теги журнала для конкретных драйверов

v1.9

v1.12

Удаленный

Изменение имени переменных парольной фразы Docker Content Trust ENV

v1.9

v1.12

Удаленный

Конечная точка /containers/(id or name)/copy

v1.8

v1.12

Удаленный

Встроенный исполнительный драйвер LXC

v1.8

v1.10

Удаленный

Старые параметры командной строки

v1.8

v1.10

Удаленный

Флаг --api-enable-cors на dockerd

v1.6

v17.09

Удаленный

Флаг --run на docker commit

v0.10

v1.13

Удаленный

Три аргумента формируются в docker import

v0.6.7

v1.12

Устаревший построитель образов Linux

Устарело в выпуске: v23.0.0

Docker v23.0.0 теперь использует BuildKit по умолчанию для сборки образов Linux и использует компонент CLI Buildx для docker build. С этим изменением docker build теперь предоставляет все расширенные функции, которые предоставляет BuildKit и которые ранее были доступны только через подкоманды docker buildx.

Компонент Buildx устанавливается автоматически при установке CLI docker с использованием наших пакетов .deb или .rpm, а статически связанные бинарники предоставляются как на download.docker.com, так и через образ docker/buildx-bin на Docker Hub. Обратитесь к Раздел сборки для получения подробных инструкций по установке компонента Buildx.

Данный релиз знаменует собой начало цикла устаревания классического («устаревшего») компоновщика образов Linux. В классическом конструкторе не будет активной разработки (за исключением исправления ошибок). Разработка BuildKit началась пять лет назад, вышла из «экспериментальной» фазы с Docker 18.09 и уже является сборщиком по умолчанию для Docker Рабочий стол. Хотя мы уверены, что BuildKit стабилен для общего использования, в поведении могут быть некоторые изменения. Если у вас возникнут проблемы с BuildKit, мы рекомендуем вам сообщать о проблемах в Трекер проблем BuildKit на GitHub

Примечание

Классический конструктор для создания образов Windows

BuildKit (пока) не поддерживает создание образов Windows, а docker build продолжает использовать классический сборщик для создания собственных образов Windows на демонах Windows.

Резервный опция устаревшего билдера

Устарело в выпуске: v23.0.0

Docker v23.0.0 теперь использует BuildKit по умолчанию для сборки образов Linux, что требует компонента Buildx для сборки образов с помощью BuildKit. Могут возникнуть ситуации, когда компонент Buildx недоступен, а BuildKit использовать нельзя.

Чтобы обеспечить плавный переход к BuildKit в качестве сборщика по умолчанию, Docker v23.0.0 имеет автоматический резервный опция для некоторых ситуаций или вызывает ошибку, чтобы помочь пользователям решить проблему.

В ситуациях, когда пользователь не дал явного согласия на использование BuildKit (т. е. DOCKER_BUILDKIT=1 не задан), интерфейс командной строки автоматически возвращается к классическому компоновщику, но выводит предупреждение об устаревании:

DEPRECATED: The legacy builder is deprecated and will be removed in a future release.
            Install the buildx component to build images with BuildKit:
            https://docs.docker.com/go/buildx/

Такая ситуация может возникнуть, если CLI docker установлен с использованием статических двоичных файлов, а компонент Buildx не установлен или установлен неправильно. Данный запасной опция будет удален в будущем выпуске, поэтому мы рекомендуем установить компонент Buildx и использовать BuildKit для ваших сборок или отказаться от использования BuildKit с DOCKER_BUILDKIT=0 .

Если вы согласились использовать BuildKit ( DOCKER_BUILDKIT=1 ), но компонент Buildx отсутствует, вместо этого печатается ошибка, а команда docker build не выполняется:

ERROR: BuildKit is enabled but the buildx component is missing or broken.
       Install the buildx component to build images with BuildKit:
       https://docs.docker.com/go/buildx/

Мы рекомендуем установить компонент Buildx продолжать использовать BuildKit для своих сборок, но в качестве альтернативы пользователи могут либо сбросить переменную среды DOCKER_BUILDKIT, чтобы вернуться к устаревшему компоновщику, либо отказаться от использования BuildKit с DOCKER_BUILDKIT=0 .

Имейте в виду, что классический конструктор устарел, поэтому автоматический отказ от использования BuildKit будет невозможен в будущем выпуске.

Драйвер хранилища Btrfs в CentOS 7 и RHEL 7

Удалено в выпуске: v23.0.0

Драйвер хранилища btrfs для CentOS и RHEL был предоставлен CentOS и RHEL в качестве предварительной версии технологии, но устарел с момента релиза Red Hat Enterprise Linux 7.4 и удален в CentOS 8 и RHEL 8. Пользователям драйвера хранилища btrfs в CentOS рекомендуется перейти на другой драйвер хранилища, например overlay2 , который теперь используется по умолчанию. драйвер хранилища. Docker 23.0 по-прежнему предоставляет драйвер хранилища btrfs, позволяющий пользователям перейти на альтернативный драйвер. В следующем выпуске Docker данный драйвер больше не будет предоставляться.

Поддержка зашифрованных закрытых ключей TLS

Устарело в выпуске: v20.10

Удалено в выпуске: v23.0.0

Использование зашифрованных закрытых ключей TLS устарело и было удалено. Golang не поддерживает устаревшее шифрование PEM (как указано в RFC 1423), поскольку оно небезопасно по своей конструкции (см. go 264159).

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

Поддержка стека и контекста Kubernetes

Устарело в выпуске: v20.10 Удалено в выпуске: v23.0.0

После прекращения поддержки Compose на Kubernetes поддержка Kubernetes в командах stack и context была удалена из cli, а параметры, связанные с этой функциональностью, теперь либо игнорируются, либо могут вызывать ошибку.

Следующие флаги командной строки удалены из подкоманд docker context:

  • --default-stack-orchestrator — swarm теперь является единственным (и используемым по умолчанию) оркестратором для стеков.

  • --kubernetes — конечная точка kubernetes больше не может храниться в docker context.

  • --kubeconfig — больше не поддерживается экспорт контекста в виде файла kubeconfig.

Выходные данные подкоманды docker context inspect больше не содержат информацию о конечных точках StackOrchestrator и Kubernetes для новых контекстов.

Следующие флаги командной строки удалены из подкоманд docker stack:

  • --kubeconfig — больше не поддерживается использование файла kubeconfig в качестве контекста.

  • --namespace — настройка пространства имён kubernetes для стеков больше не поддерживается.

  • --orchestrator — swarm теперь является единственным (и используемым по умолчанию) оркестратором для стеков.

Переменные среды DOCKER_STACK_ORCHESTRATOR , DOCKER_ORCHESTRATOR и KUBECONFIG , а также параметр stackOrchestrator в файле конфигурации ~/.docker/config.json cli больше не используются и игнорируются.

Извлечение образов из несовместимых реестров образов

Устарело в выпуске: v20.10

Docker Engine версии 20.10 и более поздних включает оптимизацию для проверки необходимости обновления образов в локальном кэше образов перед извлечением, что предотвращает отправку Docker Engine ненужных запросов API. Данные оптимизации требуют, чтобы реестр образов контейнеров соответствовал Спецификация распространения Open Container Initiative.

Хотя большинство реестров соответствуют спецификации, мы обнаружили, что некоторые реестры не соответствуют требованиям, что приводит к сбою docker pull.

В качестве временного решения Docker Engine v20.10 включает резервный механизм, позволяющий docker pull работать при использовании несовместимого реестра. В этой ситуации печатается предупреждающее сообщение:

WARNING Failed to pull manifest by the resolved digest. This registry does not
        appear to conform to the distribution registry specification; falling back to
        pull by tag. This fallback is DEPRECATED, and will be removed in a future
        release.

Резервный опция добавлен, чтобы позволить пользователям либо перенести свои образы в совместимый реестр, либо чтобы данные реестры стали совместимыми.

Обратите внимание, что данный запасной опция устраняет только сбои в docker pull . Другие команды, такие как docker stack deploy или получение образов с containerd, по-прежнему будут завершаться ошибкой.

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

Контейнеры Linux в Windows (LCOW) (экспериментальная версия)

Устарело в выпуске: v20.10 Удалено в выпуске: v23.0.0

Экспериментальная функция для запуска контейнеров Linux в Windows (LCOW) была представлена в качестве технической предварительной версии в Docker 17.09. Несмотря на то, что после его появления было внесено множество улучшений, данная функция так и не была завершена, и разработка теперь остановлена в пользу запуска Docker изначально в Linux в WSL2.

Разработчикам, которые хотят запускать рабочие нагрузки Linux на хосте Windows, рекомендуется вместо этого использовать Docker Desktop с WSL2.

Параметры веса BLKIO с cgroups v1

Устарело в выпуске: v20.10

Указание веса blkio ( docker run --blkio-weight и docker run --blkio-weight-device ) теперь помечено как устаревшее при использовании cgroups v1, поскольку соответствующие функции были удалены в ядре Linux версии 5.0 и выше 15 с >`__ . При использовании cgroups v2 параметры --blkio-weight реализуются с помощью io.weight .

Ограничение памяти ядра

Устарело в выпуске: v20.10 Удалено в выпуске: v23.0.0

Указание ограничения памяти ядра ( docker run --kernel-memory ) больше не поддерживается, поскольку ядро Linux устарело kmem.limit_in_bytes в v5.4 . Спецификация среды выполнения OCI теперь помечает данный параметр (а также --kernel-memory-tcp) как «НЕ РЕКОМЕНДУЕМЫЙ», а среды выполнения OCI, такие как runc, больше не поддержите данный опция.

Docker API версии 1.42 и выше теперь игнорирует данный параметр, если он установлен. Более старые версии API продолжают принимать данный параметр, но в зависимости от используемой среды выполнения OCI он может не действовать.

Примечание

Хотя в Docker он ещё не объявлен устаревшим, в спецификации среды выполнения OCI также объявлена устаревшей опция memory.kmem.tcp.limit_in_bytes. При использовании runc в качестве среды выполнения данный параметр не действует. Ядро Linux не объявляло эту функцию явно устаревшей, и в системе отслеживания проблем runc есть отслеживающий билет, чтобы определить, следует ли восстановить эту опцию или это было недосмотром сопровождающих ядра Linux (см. открытые контейнеры/runc#3174).

Параметр memory.kmem.tcp.limit_in_bytes поддерживается только cgroups v1 и недоступен в установках, работающих с cgroups v2. Данный параметр поддерживается только API и не отображается в командной строке docker.

Классический Swarm и наложенные сети с использованием хранилища кластеров

Устарело в выпуске: v20.10 Удалено в выпуске: v23.0.0

Автономный («классический») Swarm устарел, а вместе с ним и использование оверлейных сетей с использованием внешнего хранилища ключей/значений. Соответствующие параметры демона --cluster-advertise , --cluster-store и --cluster-store-opt удалены.

Поддержка наследия

Устарело в выпуске: v20.10 Удалено в выпуске: v23.0.0

Docker CLI до версии 1.7.0 использовал файл ~/.dockercfg для хранения учетных данных после аутентификации в реестре ( docker login ). Docker v1.7.0 заменил данный файл новым файлом конфигурации CLI, расположенным в ~/.docker/config.json. При внедрении нового файла конфигурации старый файл (и формат файла) был сохранен в качестве запасного варианта, чтобы помочь существующим пользователям перейти на новый файл.

Учитывая, что старый формат файла поощряет небезопасное хранение учетных данных (учетные данные хранятся в незашифрованном виде) и что ни одна версия CLI, начиная с Docker v1.7.0, не создавала данный файл, поддержка этого файла и его формата была удалена.

Предупреждение печатается в ситуациях, когда CLI возвращается к старому файлу, уведомляя пользователя о том, что устаревший файл присутствует, но игнорируется.

Параметры конфигурации для экспериментальных функций CLI

Устарело в выпуске: v19.03

Удалено в выпуске: v23.0.0

Переменная среды DOCKER_CLI_EXPERIMENTAL и соответствующее поле experimental в файле конфигурации CLI устарели. Экспериментальные функции включены по умолчанию, и данные параметры конфигурации больше не работают.

Начиная с версии 23.0.0, интерфейс командной строки Docker больше не печатает Experimental для клиента в выводе docker version, а это поле удалено из формата JSON.

Поддержка плагинов CLI

Устарело в выпуске: v20.10

CLI Plugin API теперь помечен как устаревший.

Наследие Dockerfile

Устарело в выпуске: v20.10

Оператор Dockerfile ENV позволяет задавать значения с помощью ENV name=value или ENV name value . Последняя ( ENV name value ) форма может быть неоднозначной, например, следующее определяет одну переменную env ( ONE ) со значением "TWO= THREE=world" , но может предназначаться для установки трёх переменных env:

ENV ONE TWO= THREE=world

Данный формат также не позволяет устанавливать несколько переменных среды в одной строке ENV в Dockerfile.

Использование синтаксиса ENV name value не рекомендуется и может быть удалено в будущем выпуске. Пользователям рекомендуется обновить свои файлы Docker, например, чтобы использовать синтаксис ENV name=value:

ENV ONE="" TWO="" THREE="world"

docker build --stream

Устарело в выпуске: v20.10 Удалено в выпуске: v20.10

Docker v17.07 представил экспериментальный флаг --stream на docker build, который позволял постепенно отправлять контекст сборки демону вместо безусловной отправки всего контекста сборки.

Эта функциональность была повторно реализована как часть BuildKit, который по умолчанию использует потоковую передачу, а параметр --stream будет игнорироваться при использовании классического компоновщика, вместо этого печатая предупреждение об устаревании.

Пользователям, которые хотят использовать эту функцию, рекомендуется включить BuildKit, установив переменную среды DOCKER_BUILDKIT=1 или через демон или файлы конфигурации CLI.

fluentd-async-connect

Устарело в выпуске: v20.10

Параметр --log-opt fluentd-async-connect для драйвера fluentd logging — устарел в пользу –log-opt fluentd-async . Сообщение об устаревании регистрируется в журналах демона, если используется старая опция:

fluent#New: AsyncConnect is now deprecated, please use Async instead

Пользователям рекомендуется использовать опция fluentd-async в будущем, т. к. поддержка старого параметра будет удалена в будущем выпуске.

Отправка и извлечение с помощью схемы 1 манифеста образа v2

Устарело в выпуске: v19.03

Цель для удаления в выпуске: v20.10

Формат манифеста образа v2 схема 1 устарел, вместо него используется формат v2 схема 2.

Если используемый вами реестр по-прежнему поддерживает схему v2 1, попросите его администраторов перейти на схему v2 2.

docker engine

Устарело в выпуске: v19.03

Удалено в выпуске: v20.10

docker engine activate , docker engine check и docker engine update предоставили альтернативный метод установки для обновления ядер Docker Community до Docker Enterprise с использованием дистрибутива Docker Engine на основе образа.

Данная функция была доступна только в Linux и только при выполнении на локальном узле. Учитывая ограничения этой функции и то, что данная функция не получила широкого распространения, подкоманды docker engine будут удалены в пользу установки через стандартные менеджеры пакетов.

Верхний уровень

Устарело в выпуске: v19.03

Удалено в выпуске: v20.10

Команда верхнего уровня docker deploy (с использованием формата файла «Docker Application Bundle» (.dab) была введена в качестве экспериментальной функции в Docker 1.13/17.03, но заменена поддержкой файлов Docker Compose с использованием подкоманды docker stack deploy.

docker stack deploy

Устарело в выпуске: v19.03

Удалено в выпуске: v20.10

Поскольку данная функция не разрабатывается и активно не используется формат файла, поддержка формата файла DAB и команда развертывания Docker верхнего уровня (скрытая по умолчанию в 19.03) будет удалена в пользу docker stack deploy с использованием compose. файлы.

Поддержка

Устарело в выпуске: v19.03 Отключено в выпуске: v19.03

Данный параметр конфигурации демона отключил проверку версии ядра Linux, используемую для определения того, поддерживает ли ядро OverlayFS с несколькими нижними каталогами, что требуется для драйвера хранилища overlay2. Начиная с Docker v19.03.7, обнаружение было улучшено, чтобы оно больше не зависело от версии ядра, поэтому данный параметр больше не использовался.

Docker v23.0.0 регистрирует предупреждение в журналах демона, если данный параметр установлен, и пользователи должны удаляет данный параметр из своей конфигурации демона.

Драйвер хранилища AuFS

Устарело в выпуске: v19.03 Отключено по умолчанию в выпуске: v23.0.0

Драйвер хранилища aufs устарел в пользу overlay2 и будет удален в следующем выпуске. Пользователям драйвера хранилища aufs рекомендуется перейти на другой драйвер хранилища, например overlay2, который теперь является драйвером хранилища по умолчанию.

Драйвер хранилища aufs облегчает запуск Docker в дистрибутивах, не поддерживающих OverlayFS, таких как Ubuntu 14.04 LTS, который изначально поставлялся с ядром 3.14.

Теперь, когда Ubuntu 14.04 больше не является поддерживаемым дистрибутивом для Docker, а overlay2 доступен для всех поддерживаемых дистрибутивов (поскольку они либо на ядре 4.x, либо имеют поддержку нескольких нижних каталогов), нет причин продолжать обслуживание Драйвер хранилища aufs.

Отключено по умолчанию в v23.0.0

Docker уже предотвратил автоматический выбор устаревших драйверов хранилища при новых установках, но продолжал использовать данные драйверы при обновлении существующих установок. Начиная с релиза v23.0.0, Docker Engine не запустится, если используется устаревший драйвер хранилища (см. Моби#43378 :

failed to start daemon: error initializing graphdriver: prior storage driver
aufs is deprecated and will be removed in a future release; update the the daemon
configuration and explicitly choose this storage driver to continue using it;
visit https://docs.docker.com/go/storage-driver/ for more information.

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

Устаревший «оверлейный» драйвер хранилища

Устарело в выпуске: v18.09 Отключено по умолчанию в выпуске: v23.0.0

Драйвер хранилища overlay устарел в пользу драйвера хранилища overlay2, который обладает всеми преимуществами overlay без его ограничений (чрезмерное потребление inode). Устаревший драйвер хранилища overlay будет удален в будущем выпуске. Пользователи драйвера хранилища overlay должны перейти на драйвер хранилища overlay2.

Устаревший драйвер хранилища overlay позволял использовать файловые системы с поддержкой overlayFS в ядрах до версии 4.x. Теперь, когда все поддерживаемые дистрибутивы могут запускать overlay2 (поскольку они либо на ядре 4.x, либо имеют поддержку нескольких нижних каталогов), нет причин продолжать поддерживать драйвер хранилища overlay.

Отключено по умолчанию в v23.0.0

Docker уже предотвратил автоматический выбор устаревших драйверов хранилища при новых установках, но продолжал использовать данные драйверы при обновлении существующих установок. Начиная с релиза v23.0.0, Docker Engine не запустится, если используется устаревший драйвер хранилища (см. Моби#43378 :

failed to start daemon: error initializing graphdriver: prior storage driver
overlay is deprecated and will be removed in a future release; update the the daemon
configuration and explicitly choose this storage driver to continue using it;
visit https://docs.docker.com/go/storage-driver/ for more information.

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

Драйвер хранилища картографа устройств

Устарело в выпуске: v18.09 Отключено по умолчанию в выпуске: v23.0.0

Драйвер хранилища devicemapper устарел в пользу overlay2 и будет удален в следующем выпуске. Пользователям драйвера хранилища devicemapper рекомендуется перейти на другой драйвер хранилища, например overlay2, который теперь является драйвером хранилища по умолчанию.

Драйвер хранилища devicemapper облегчает запуск Docker на старых (3.x) ядрах, которые не поддерживают другие драйверы хранилища (например, overlay2 или AUFS).

Теперь, когда поддержка overlay2 добавлена во все поддерживаемые дистрибутивы (поскольку они либо на ядре 4.x, либо поддерживают несколько бэкпортированных нижних каталогов), нет причин продолжать обслуживание драйвера хранилища devicemapper.

Отключено по умолчанию в v23.0.0

Docker уже предотвратил автоматический выбор устаревших драйверов хранилища при новых установках, но продолжал использовать данные драйверы при обновлении существующих установок. Начиная с релиза v23.0.0, Docker Engine не запустится, если используется устаревший драйвер хранилища (см. Моби#43378 :

failed to start daemon: error initializing graphdriver: prior storage driver
devicemapper is deprecated and will be removed in a future release; update the the daemon
configuration and explicitly choose this storage driver to continue using it;
visit https://docs.docker.com/go/storage-driver/ for more information.

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

Использование зарезервированных пространств имён в метках движка

Устарело в выпуске: v18.06

Удалено в выпуске: v20.10

Пространства имён com.docker.* , io.docker.* и org.dockerproject.* в метках двигателя всегда документировались как зарезервированные, но никогда не применялось принудительное исполнение.

Использование данных пространств имён теперь будет вызывать предупреждение в журналах движка, препятствующее их использованию, и будет вызывать ошибку в версии 20.10 и выше.

--disable-legacy-registry

Отключено в выпуске: v17.12

Удалено в выпуске: v19.03

Флаг --disable-legacy-registry был отключён в Docker 17.12, и при его использовании будет отображаться ошибка. Чтобы эта ошибка была напечатана, сам флаг все ещё присутствует, но скрыт. Флаг был удален в Docker 19.03.

Взаимодействие с реестрами V1

Отключено по умолчанию в выпуске: v17.06

Удалено в выпуске: v17.12

В версии 1.8.3 добавлен флаг ( --disable-legacy-registry=false ), который предотвращает операции демона докеров pull , push и login с реестрами v1. Хотя это включено по умолчанию, это сигнализирует о намерении отказаться от поддержки протокола v1.

Поддержка протокола v1 для общедоступного реестра была удалена в версии 1.13. Любые зеркальные конфигурации, использующие v1, должны быть обновлены для использования зеркало реестра v2 .

Начиная с Docker 17.12, поддержка реестров V1 удалена, флаг --disable-legacy-registry больше нельзя использовать, а dockerd не запустится, если он установлен.

Асинхронный

Устарело в выпуске: v17.05

Отключено по умолчанию в выпуске: v17.10

В Docker 17.05 добавлен необязательный параметр --detach=false, чтобы docker service create и docker service update работали синхронно. Данный параметр будет включён по умолчанию в Docker 17.10, после чего можно будет использовать флаг --detach для использования предыдущего (асинхронного) поведения.

Значение по умолчанию для этого параметра также будет соответствующим образом изменено для docker service rollback и docker service scale в Docker 17.10.

-g

Устарело в выпуске: v17.05

Удалено в выпуске: v23.0.0

Флаг -g или --graph для команды dockerd или docker daemon использовался для указания каталога, в котором хранятся постоянные данные и конфигурация ресурсов, и был заменен более описательным флагом --data-root. Данные флаги устарели и скрыты в версии 17.05 и удалены в версии 23.0.0.

Сетевые свойства верхнего уровня в NetworkSettings

Устарело в выпуске: v1.13.0

Цель для удаления в выпуске: v17.12

При проверке контейнера NetworkSettings содержит информацию верхнего уровня о сети по умолчанию («мост»);

EndpointID, Gateway, GlobalIPv6Address, GlobalIPv6PrefixLen, IPAddress, IPPrefixLen, IPv6Gateway и MacAddress.

Данные свойства устарели в пользу сетевых свойств в NetworkSettings.Networks . Данные свойства уже были «устарели» в докере 1.9, но сохранены для обратной совместимости.

Дополнительную информацию см. в №17538.

filter

Устарело в выпуске: v1.13.0

Удалено в выпуске: v20.10

Параметр filter для фильтрации списка образов по ссылке (имя или имя:тег) теперь реализован как обычный фильтр с именем reference.

repository:shortid

Устарело в выпуске: v1.13.0

Удалено в выпуске: v17.12

Синтаксис repository:shortid для ссылок на образы очень мало используется, конфликтует со ссылками на теги и может быть перепутан со ссылками на дайджесты.

Поддержка нотации repository:shortid для ссылок на образы была удалена в Docker 17.12.

docker daemon

Устарело в выпуске: v1.13.0

Удалено в выпуске: v17.12

Демон перемещен в отдельный двоичный файл ( dockerd ) и должен использоваться вместо него.

Дублирующиеся ключи с конфликтующими значениями в метках движка

Устарело в выпуске: v1.13.0

Удалено в выпуске: v17.12

При установке повторяющихся ключей с конфликтующими значениями будет выдана ошибка, и демон не запустится.

MAINTAINER

Устарело в выпуске: v1.13.0

MAINTAINER был ранней очень ограниченной формой LABEL, которую следует использовать вместо нее.

Вызовы API без версии

Устарело в выпуске: v1.13.0

Цель для удаления в выпуске: v17.12

Версии API должны предоставляться для всех вызовов API, чтобы обеспечить совместимость с будущими версиями Engine. Вместо того, чтобы просто запрашивать, например, URL-адрес /containers/json, теперь вы должны запросить /v1.25/containers/json.

Резервная файловая система без

Устарело в выпуске: v1.13.0

Удалено в выпуске: v17.12

Драйвер хранилища overlay и overlay2 не работает должным образом, если резервная файловая система не поддерживает d_type . Например, XFS не поддерживает d_type, если он отформатирован с параметром ftype=0.

Поддержка данных настроек была удалена, и Docker версии 23.0.0 и выше теперь не запускается при попытке использовать драйвер хранилища overlay2 или overlay в резервной файловой системе без поддержки d_type.

Подробную информацию см. в №27358.

--automated

Устарело в выпуске: v1.12.0

Удалено в выпуске: v20.10

Параметры docker search --automated и docker search --stars устарели. Вместо этого используйте docker search --filter=is-automated=<true|false> и docker search --filter=stars=....

-h

Устарело в выпуске: v1.12.0

Цель удаления в выпуске: v17.09

Сокращение ( -h ) менее распространено, чем --help в Linux, и не может использоваться во всех подкомандах (из-за конфликта, например, с -h / --hostname в docker create ). По этой причине сокращение -h не печаталось в выводе «использование» подкоманд, не документировалось и теперь помечено как «устаревшее».

-e

Устарело в выпуске: v1.11.0

Удалено в выпуске: v17.06

Команда docker login удаляет возможность автоматической регистрации учетной записи в целевом реестре, если данное имя пользователя не существует. В связи с этим изменением флаг электронной почты больше не требуется и будет объявлен устаревшим.

Разделитель (

Устарело в выпуске: v1.11.0

Цель для удаления в выпуске: v17.06

Флаг --security-opt больше не использует разделитель двоеточия ( : ) для разделения ключей и значений, он использует символ равенства ( = ) для согласованности с другими подобными флагами, такими как --storage-opt .

Неоднозначные поля событий в API

Устарело в выпуске: v1.10.0

Поля ID , Status и From в API событий устарели в пользу более богатой структуры. См. документацию API событий для нового формата.

-f

Устарело в выпуске: v1.10.0

Удалено в выпуске: v1.12.0

Чтобы обеспечить единообразие тегов для различных команд docker, флаг -f в команде docker tag устарел. Больше не нужно указывать -f для перемещения тега с одного образа на другое. Также docker не выдаст ошибку, если флаг -f отсутствует, а указанный тег уже используется.

HostConfig при запуске контейнера API

Устарело в выпуске: v1.10.0

Удалено в выпуске: v1.12.0

Передача HostConfig в POST/containers/{name}/start устарела в пользу определения его при создании контейнера ( POST/containers/create ).

--before

Устарело в выпуске: v1.10.0

Удалено в выпуске: v1.12.0

Параметры docker ps --before и docker ps --since устарели. Вместо этого используйте docker ps --filter=before=... и docker ps --filter=since=....

Теги журнала для конкретных драйверов

Устарело в выпуске: v1.9.0

Удалено в выпуске: v1.12.0

Теги журнала теперь генерируются стандартным способом для разных драйверов ведения журнала. Из-за этого параметры тега журнала драйвера syslog-tag , gelf- tag и fluentd-tag устарели в пользу общего параметра tag.

$ docker --log-driver=syslog --log-opt tag="{{.ImageName}}/{{.Name}}/{{.ID}}"

Изменение имени переменных парольной фразы Docker Content Trust ENV

Устарело в выпуске: v1.9.0

Удалено в выпуске: v1.12.0

Начиная с версии 1.9, автономный ключ Docker Content Trust был переименован в корневой ключ, а ключ тегирования был переименован в ключ репозитория. Из-за этого переименования мы также меняем соответствующие переменные среды

  • DOCKER_CONTENT_TRUST_OFFLINE_PASSPHRASE теперь называется DOCKER_CONTENT_TRUST_ROOT_PASSPHRASE

  • DOCKER_CONTENT_TRUST_TAGGING_PASSPHRASE теперь называется DOCKER_CONTENT_TRUST_REPOSITORY_PASSPHRASE

/containers/(id or name)/copy

Устарело в выпуске: v1.8.0

Удалено в выпуске: v1.12.0

Конечная точка /containers/(id or name)/copy устарела в пользу /containers/(id or name)/archive .

Встроенный исполнительный драйвер LXC

Устарело в выпуске: v1.8.0

Удалено в выпуске: v1.10.0

Встроенный драйвер выполнения LXC, флаг lxc-conf и поля API были удалены.

Старые параметры командной строки

Устарело в выпуске: v1.8.0

Удалено в выпуске: v1.10.0

Флаги -d и --daemon устарели в пользу подкоманды daemon:

docker daemon -H ...

Следующий опция с одним дефисом ( -opt ) некоторых параметров командной строки устарел и заменен параметрами с двойным дефисом ( --opt ):

docker attach -nostdin
docker attach -sig-proxy
docker build -no-cache
docker build -rm
docker commit -author
docker commit -run
docker events -since
docker history -notrunc
docker images -notrunc
docker inspect -format
docker ps -beforeId
docker ps -notrunc
docker ps -sinceId
docker rm -link
docker run -cidfile
docker run -dns
docker run -entrypoint
docker run -expose
docker run -link
docker run -lxc-conf
docker run -n
docker run -privileged
docker run -volumes-from
docker search -notrunc
docker search -stars
docker search -t
docker search -trusted
docker tag -force

Следующие параметры с двойным тире устарели и не имеют замены:

docker run --cpuset
docker run --networking
docker ps --since-id
docker ps --before-id
docker search --trusted

Устарело в выпуске: v1.5.0

Удалено в выпуске: v1.12.0

Одиночный тире ( -help ) был удален в пользу двойного тире --help

docker -help
docker [COMMAND] -help

--api-enable-cors

Устарело в выпуске: v1.6.0

Удалено в выпуске: v17.09

Флаг --api-enable-cors устарел, начиная с версии 1.6.0. Вместо этого используйте флаг --api-cors-header.

--run

Устарело в выпуске: v0.10.0

Удалено в выпуске: v1.13.0

Флаг --run коммита Docker (и его короткая версия -run) устарел в пользу флага --changes, который позволяет передавать команды Dockerfile.

Формируются три аргумента

Устарело в выпуске: v0.6.7

Удалено в выпуске: v1.12.0

Формат команды docker import file|URL|- [REPOSITORY [TAG]] устарел с ноября 2013 г. Он больше не поддерживается.