Как переименовать образ

Переименование Docker образа: методы и практика

Переименование Docker образа — это операция создания нового тега для существующего образа, которая часто требуется при работе с различными реестрами, изменении версионирования или подготовке образов для продакшн-развертывания.

Основные методы переименования

1. Стандартная команда docker tag

Наиболее распространенный и рекомендуемый способ:

# Базовый синтаксис
docker tag ИСТОЧНИК ЦЕЛЬ

# Пример: переименование локального образа
docker tag myapp:1.0 myapp:latest

# Пример: подготовка для отправки в реестр
docker tag myapp:1.0 registry.company.com/myteam/myapp:1.0

2. Сохранение и загрузка с новым именем

Полезно для офлайн-работы или миграции:

# Сохраняем образ в архив
docker save -o old_image.tar myapp:1.0

# Загружаем с новым именем
docker load -i old_image.tar
docker tag myapp:1.0 newapp:2.0

Ключевые аспекты переименования

Структура имени образа

Имя образа состоит из трех компонентов:

• [registry/][namespace/]name:tag
• Реестр (опционально): docker.io, gcr.io, registry.company.com
• Пространство имен (опционально): организация или команда
• Имя: основное название приложения
• Тег: версия, окружение или метка (latest, v1.2.3, staging)

Работа с удаленными реестрами

# Аутентификация в реестре
docker login registry.company.com

# Тегирование для удаленного реестра
docker tag localapp:dev registry.company.com/production/app:1.0

# Отправка в реестр
docker push registry.company.com/production/app:1.0

Практические сценарии

Сценарий 1: Подготовка для продакшн-развертывания

# Разработка с тегом dev
docker build -t myapp:dev .

# Тестирование и создание стабильной версии
docker tag myapp:dev myapp:staging
docker run myapp:staging --run-tests

# Фиксация версии для продакшна
docker tag myapp:staging myapp:1.2.3
docker tag myapp:1.2.3 registry.prod.com/app:1.2.3
docker push registry.prod.com/app:1.2.3

Сценарий 2: Миграция между реестрами

# Из старого реестра
docker pull old-registry.com/app:1.0
docker tag old-registry.com/app:1.0 new-registry.com/app:1.0
docker push new-registry.com/app:1.0

# Очистка старых тегов
docker rmi old-registry.com/app:1.0

Важные особенности

1. Теги — это указатели: При переименовании через docker tag создается новый указатель на тот же слой изображения, а не копируются данные
2. Идентификаторы образов: Оригинальный и переименованный образы имеют одинаковый Image ID
3. Управление версиями: Рекомендуется использовать семантическое версионирование (major.minor.patch)

Лучшие практики

• Избегайте тега latest в продакшне: Используйте конкретные версии для воспроизводимости
• Очищайте неиспользуемые теги: Регулярно удаляйте старые теги для экономии места
• Автоматизируйте процесс: Используйте CI/CD пайплайны для автоматического тегирования
• Проверяйте целостность: После переименования убедитесь, что образ работает корректно

Скрипт для массового переименования

#!/bin/bash
# Скрипт для переименования нескольких образов

OLD_PREFIX="dev/"
NEW_PREFIX="prod/"
VERSION="1.0"

for image in $(docker images --format "{{.Repository}}:{{.Tag}}" | grep "^${OLD_PREFIX}")
do
    new_name=$(echo $image | sed "s/^${OLD_PREFIX}/${NEW_PREFIX}/")
    docker tag $image $new_name:$VERSION
    echo "Переименован: $image -> $new_name:$VERSION"
done

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