Docker-образы
Вы можете самостоятельно настроить окружение проекта DataSphere с помощью Docker-образа
Созданные Docker-образы нельзя изменить.
Важно
С 31 января 2026 года все Docker-образы, созданные в DataSphere до 3 декабря 2025 года, перестанут работать. Чтобы использовать их в проектах, создайте их заново или используйте инструмент миграции.
Способы хранения Docker-образов
Существует два способа хранения пользовательских образов:
- в Yandex Container Registry;
- в DataSphere.
Хранение в Container Registry
По умолчанию Docker-образы хранятся в Container Registry. Образ собирается на ВМ DataSphere и в случае успеха загружается в реестр, указанный в настройках сообщества, а его версия фиксируется в соответствующем ресурсе DataSphere. При каждом запуске проекта с таким образом DataSphere будет скачивать эту версию из реестра. Если удалить эту версию образа из реестра, Docker-образ в проекте останется, но его больше нельзя будет оптимизировать, активировать и использовать в проекте.
Хранение образов в Container Registry обходится дешевле, но они увеличивают время запуска проекта. Кроме того, образом из реестра нельзя поделиться в сообществе.
Чтобы ускорить запуск проекта, вы можете создать оптимизированную копию Docker-образа, хранящегося в Container Registry. Оптимизированная копия хранится на отдельном диске в DataSphere и значительно ускоряет запуск проекта, но ее хранение дополнительно тарифицируется. Оптимизированный Docker-образ можно опубликовать в сообществе, чтобы использовать его в нескольких проектах.
После создания оптимизированной копии вы можете удалить оригинальную версию образа из реестра, чтобы не платить за хранение оригинала и копии. Когда вы удалите оптимизированную копию Docker-образа, DataSphere снова попробует скачать Docker-образ из Container Registry при запуске проекта. Если оригинальная версия в Container Registry сохранится, проект продолжит использовать ее.
Совет
Чтобы пользователи проектов могли собирать и хранить Docker-образы в Container Registry, администратор сообщества должен указать нужный реестр в настройках сообщества и включить сервисного агента.
Хранение в DataSphere
Если при создании образа выбрать хранение в DataSphere, после сборки Docker-образ останется храниться на выделенном диске в DataSphere и не будет загружен в Container Registry. Такой образ сразу считается оптимизированным и тарифицируется соответственно.
Удаленный Docker-образ, хранящийся в DataSphere, нельзя восстановить.
Docker-образ, хранящийся в DataSphere, можно опубликовать в сообществе, чтобы использовать его в нескольких проектах. Для этого вам необходимы роли не ниже Editor в проекте и Developer в сообществе, в котором вы хотите его опубликовать. Открыть доступ можно на вкладке Доступ на странице просмотра Docker-образа. Ресурс, доступный для сообщества, появится на странице сообщества в разделе Ресурсы сообщества. Пока образ опубликован, его нельзя удалить.
Подробнее о работе с Docker-образами см. на странице Работа с Docker-образами.
Требования к Docker-образу
Чтобы Docker-образ запускался и корректно работал в DataSphere, он должен содержать:
- установку Python 3.8, 3.9, 3.10 или 3.11;
- установку pip;
- пользователя
--uid 1000 jupyter.
Совет
Библиотека образов Docker Hub
- Создайте подсеть.
- Создайте NAT-шлюз для доступа в интернет.
- Создайте сервисный аккаунт с ролью
vpc.user. - В настройках проекта добавьте подсеть и сервисный аккаунт.
Вы также можете использовать базовые образы из других библиотек.
Примечание
Шаблоны Docker-образов, представленные в DataSphere, уже удовлетворяют требованиям. Если вы загружаете образ из стороннего источника или пишете свой, добавьте в него необходимые команды.