Tag та push образів

Якщо реєстр і тег не вказані явно:

• nginx трактують як docker.io/library/nginx:latest;

• myuser/web-app трактують як docker.io/myuser/web-app:latest;

• тег latest додається за замовчуванням.

Тег є локальним посиланням на образ. Команда docker tag не створює новий образ і не копіює його — вона створює ще одне ім’я для вже наявного образу.

Створення тегу

Спочатку перегляньте локальні образи:

Приклад результату:

Щоб створити тег для цього образу, використайте:

Тепер один і той самий образ має два імені:

Можна перевірити, що обидва теги посилаються на однаковий IMAGE ID:

Вибір тегу

Для версій образу часто використовують:

• семантичну версію: 1.4.2;

• основну та другорядну версію: 1.4;

• назву середовища: staging, production;

• ідентифікатор коміту: a1b2c3d;

• дату або номер збірки: 2026-09-02, build-142.

Наприклад:

Теги 1.4.2 і 1.4 можуть бути різними посиланнями на один образ у момент створення. Під час наступних збірок тег можна перемістити на інший образ.

Для відтворюваних розгортань краще використовувати конкретні версійні теги, а не покладатися лише на latest.

Підготовка до публікації

Перед публікацією образ потрібно позначити повним іменем, яке містить назву реєстру та простору імен.

Для Docker Hub формат зазвичай такий:

Наприклад:

Для приватного реєстру:

Якщо реєстр працює на нестандартному порту:

Назва образу, яку використовують у docker push, повинна збігатися з назвою, яку вказано під час docker tag.

Авторизація в реєстрі

Перед push виконайте вхід до реєстру:

Для Docker Hub Docker попросить ім’я користувача та пароль або токен.

Для іншого реєстру вкажіть його адресу:

Для реєстру на нестандартному порту:

Після успішного входу Docker зберігає облікові дані у конфігурації клієнта. Не передавайте пароль безпосередньо в командному рядку, оскільки він може потрапити до історії shell або списку процесів.

Публікація образу за допомогою docker push

Після створення тегу та авторизації опублікуйте образ:

Docker перевірить шари образу та завантажить до реєстру лише ті, яких там ще немає. Тому повторний push часто виконується швидше.

Приклад типової відповіді:

Повний тег образу в цьому прикладі:

Якщо реєстр не вказано, Docker використовує Docker Hub.

Повний приклад

Нижче наведено послідовність команд для локального образу. Для виконання потрібен обліковий запис у реєстрі та дозвіл на публікацію образів у просторі імен myuser.

Замість myuser потрібно використати власне ім’я користувача або назву організації.

Перевірка опублікованого образу

Після push образ можна отримати на іншій машині:

Запустити завантажений образ:

Команда docker pull завантажує образ за конкретним тегом. Якщо тег не вказати, Docker використає latest:

Для перевірки локальних тегів:

Тегування вже зібраного образу за ідентифікатором

docker tag може отримувати як джерело не лише ім’я, а й ідентифікатор образу:

Однак для робочих сценаріїв зручніше використовувати зрозуміле ім’я джерела, наприклад:

Публікація образу у приватний реєстр

Для приватного реєстру послідовність така сама, але повне ім’я містить адресу реєстру:

Якщо під час push Docker повідомляє про відсутність дозволу, перевірте:

• чи виконано docker login для правильного реєстру;

• чи має обліковий запис дозвіл на запис у потрібний репозиторій;

• чи правильно вказано простір імен team;

• чи існує такий репозиторій у реєстрі або чи дозволено його автоматичне створення.

Тег і digest

Реєстр повертає digest після успішної публікації:

Тег є змінним посиланням: у майбутньому його можна повторно призначити іншому образу. Digest ідентифікує конкретний вміст образу.

Отримати digest локального образу можна так:

Для розгортань, де потрібно точно зафіксувати вміст, можна використовувати посилання з digest:

Поширені помилки

Використано неправильне ім’я образу

Образ має локальний тег:

А команда публікації використовує інше ім’я:

У такому випадку Docker може повідомити, що локального образу з таким тегом не знайдено. Спочатку створіть потрібний тег:

Не вказано простір імен

Команда:

не створює тег для облікового запису Docker Hub. Для публікації в особистий репозиторій потрібно вказати ім’я користувача:

Використовується неправильний реєстр

Образ із тегом:

буде спрямовано до Docker Hub. Для приватного реєстру потрібно явно додати його адресу:

Відсутня авторизація або права доступу

Помилки unauthorized, denied або requested access to the resource is denied зазвичай означають, що:

• користувач не увійшов до реєстру;

• виконано вхід до іншого реєстру;

• немає дозволу на запис;

• назва репозиторію не належить цьому користувачу або організації.

Виконайте вхід до потрібного реєстру та перевірте повне ім’я образу:

Опубліковано лише latest

Тег latest не гарантує, що це найновіша версія, і може бути переміщений на інший образ. Для кожної версії створюйте окремий тег:

За потреби тегуйте цей самий образ як latest окремо:

Підсумок

• docker tag SOURCE_IMAGE[:TAG] TARGET_IMAGE[:TAG] створює нове ім’я для локального образу.

• Для публікації тег має містити адресу реєстру та простір імен, якщо вони потрібні.

• docker login авторизує Docker-клієнт у реєстрі.

• docker push IMAGE[:TAG] завантажує образ до реєстру.

• Повторно завантажуються лише відсутні шари.

• Для версій краще використовувати конкретні теги, наприклад 1.0.0, а не лише latest.

• Тег можна змінити, а digest однозначно ідентифікує конкретний вміст образу.