Перед переносом выпишите для каждого Compose-сервиса образ, команду запуска, зависимости, точки входа и каталоги записи. Отметьте, какие данные должны пережить замену контейнера. Первый результат работы — карта приложения, по которой можно поднять изолированную копию и проверить обычный пользовательский сценарий.
Автоматическая конвертация файла помогает получить начальные ресурсы. Однако готовность приложения определяется тем, как оно подключается к базе, хранит файлы и переживает временный отказ соседнего компонента. Документация Kubernetes о переводе Compose через Kompose проверена 6 ноября 2026 года.
Начните с предположений, скрытых в Compose
Условное приложение состоит из API, фонового обработчика и базы. В разработке все они видят один каталог на компьютере. При переносе запишите отдельно путь загрузки API и путь чтения обработчика. Два одинаковых пути внутри разных контейнеров ещё требуют общего, согласованного хранилища.
Для каждого соединения укажите имя назначения, порт, способ авторизации и ожидаемое поведение при недоступности. Запуск процесса базы и готовность выполнить прикладной запрос — разные наблюдения. Приложение должно уметь пережить согласованный период недоступности зависимости с ограниченными повторами.
| Объект переноса | Что подтвердить |
|---|---|
| Образ и команда | Повторяемый запуск |
| Файлы | Путь записи и повторного чтения |
| База | Единственный писатель при переключении |
| Вход | Обычный пользовательский маршрут |
Секреты исключите из публикуемых манифестов и отчётов. Для репетиции используйте тестовые учётные данные и обезличенный набор. Сохраните перечень параметров окружения, но значения доступа передавайте по принятому в команде защищённому процессу.
Репетиция заканчивается проверкой чтения и записи
Выберите один законченный сценарий. Например, пользователь загружает файл, получает идентификатор, а фоновая задача создаёт результат. Проведите его через будущую публичную точку входа. Сопоставьте идентификатор запроса, запись в базе и объект в хранилище, затем откройте результат повторно.
Повторите сценарий после замены экземпляра приложения на стенде. Эта проверка обнаруживает локальные файлы, память процесса и адреса, привязанные к старому контейнеру. До теста определите, какие пользовательские состояния обязаны сохраниться, и зафиксируйте фактический результат каждого шага.
Условная карта
API -> upload storage -> worker
API -> database
public entry -> API
cutover -> one confirmed writerСверьте конфигурацию с документацией версии вашего кластера, драйвера хранения и сетевого компонента. У преобразованного ресурса должны быть понятны владелец, способ обновления и место хранения данных. Сгенерированный YAML проходит тот же обзор, что и вручную написанный.
Переключение требует единой истории изменений
Составьте порядок остановки новых записей, финальной синхронизации и смены входа. Если обе площадки смогут писать одновременно, заранее выберите механизм согласования данных. Для обычного переноса с одним писателем команда должна точно знать, когда старое приложение прекратило запись и когда новое получило это право.
Возврат на старый вход после новых записей требует плана обратной доставки изменений. Сохранённый адрес старой площадки сам по себе не восстанавливает актуальные данные. Проведите репетицию возврата с контрольной записью, созданной уже в новом окружении, и зафиксируйте допустимую потерю данных.
- Составить карту сервисов.
- Поднять изолированную копию.
- Проверить сценарий после замены экземпляра.
- Отрепетировать переключение и возврат.
Для согласования подготовьте карту сервисов, схему хранилищ, результаты пользовательского сценария и протокол переключения. Такой набор позволяет оценить готовность переноса по наблюдаемому поведению. Неисправный шаг получает владельца и критерий исправления до назначения рабочего окна.