{"canonical_url":"https://engineer.company/uk/glossary/deployment/","content_markdown":"# Розгортання\n\n## Що це таке\n\nРозгортання — це послідовність кроків, яка забирає перевірену версію застосунку\nіз системи збирання й вводить її в роботу: зібраний образ або файли потрапляють\nна машини чи платформу, що їх виконуватиме, версія отримує конфігурацію саме\nцього середовища, запускається, і на неї переводять справжні запити. Англійською\nце deployment, а в робочих розмовах часто кажуть просто «деплой». Слово позначає\nі дію, і її результат: можна сказати, що розгортання зупинилося на кроці з базою\nданих, або спитати, що сталося з учорашнім розгортанням. Розгортати можна\nвебсайт, API, заплановане завдання, зміну в базі даних чи бекенд мобільного\nзастосунку.\n\nРозгортання й випуск часто розводять. Розгорнути — значить покласти новий код\nтуди, де він може працювати; випустити — вирішити, хто його побачить. Функцію,\nсховану за прапорцем, можна розгорнути в понеділок, а увімкнути для клієнтів у\nчетвер, не торкаючись серверів удруге. Такий поділ дає команді постачати код\nмалими й частими кроками, а рішення про терміни лишаються за тими, хто\nвідповідає за продукт.\n\nБагато розгортань сьогодні постачають контейнерний образ. Open Container\nInitiative, створена в червні 2015 року під егідою Linux Foundation, публікує\nнавколо нього три специфікації: як влаштований образ, як середовище виконання\nзапускає його після розпакування і як реєстри зберігають і віддають образи.\nОбраз ідентифікують за дайджестом — хешем від вмісту, тож той самий дайджест\nзавжди означає ті самі байти. Тег на кшталт `1.4.2` — це зручна для читання\nвказівка на образ, і якщо знову надіслати образ під тим самим тегом, тег\nвказуватиме вже на щось інше.\n\nМетодологія [The Twelve-Factor App](https://12factor.net/), на яку часто\nпосилаються, коли йдеться про вебсервіси, ділить шлях від коду до запущеного\nсервісу на три етапи, суворо відокремлені один від одного. Етап збирання\nперетворює коміт на виконуваний пакет. Етап випуску поєднує цей пакет із\nконфігурацією одного середовища. Етап виконання запускає процеси з обраного\nвипуску. Кожен випуск має унікальний ідентифікатор і після створення ніколи не\nзмінюється; будь-яка зміна дає новий випуск, тож відкат зводиться до вибору\nпопереднього.\n\nСаме перемикання відбувається по-різному, залежно від того, що витримує сервіс.\nСтратегія recreate зупиняє стару версію, а потім запускає нову, і між ними\nлишається пауза. Поступове розгортання замінює екземпляри по кілька за раз, тож\nякийсь час трафік обслуговують обидві версії; саме так за замовчуванням працює\nDeployment у Kubernetes. За схеми blue-green нова версія працює поруч зі старою,\nувесь трафік перемикають одним кроком, а стара лишається напоготові, щоб забрати\nйого назад. Канарковий реліз спершу спрямовує на нову версію невелику частку\nтрафіку й розширює її, доки частота помилок і затримки лишаються в нормі.\n\n## Чому це важливо\n\nСаме під час розгортання зміна починає приносити користь, і саме тоді помилка\nпочинає діставатися до користувачів. Команди, які розгортають рідко, зазвичай\nнакопичують у кожному релізі багато змін, тож кожне розгортання несе більший\nризик, а коли щось ламається, підозрюваних більше. Малі й часті розгортання\nтримають кожен крок зрозумілим і легким для скасування.\n\nРозгортання вручну послідовне рівно настільки, наскільки послідовна людина, яка\nйого виконує. Кроки пропускають, міняють місцями або виконують трохи інакше,\nколи підміняють колегу у відпустці. Конвеєр щоразу виконує ті самі кроки й лишає\nслід: який коміт, який артефакт, яке середовище і коли. З цього сліду\nпочинається розбір інциденту, і часто це найшвидший спосіб з'ясувати, що саме\nзмінилося.\n\nНайцінніша звичка — зібрати один раз і просувати результат. Артефакт,\nперевірений у staging, має бути байт у байт тим самим, що потрапляє в\nproduction, а відрізнятися може лише конфігурація, яку середовище надає\nартефактові, щойно той прибуває. Якщо записати дайджест під час збирання й\nрозгортати за дайджестом, цю обіцянку можна перевірити:\n\n```sh\npodman build -t registry.example.com/web:1.4.2 .\npodman push --digestfile web.digest registry.example.com/web:1.4.2\nkubectl -n staging set image deployment/web \\\n  web=registry.example.com/web@$(cat web.digest)\n# той самий дайджест іде в production, коли staging перевірено\nkubectl -n production set image deployment/web \\\n  web=registry.example.com/web@$(cat web.digest)\n```\n\nВідкат тримається на тій самій дисципліні. Коли випуски незмінні й мають\nідентифікатори, повернутися назад означає вказати на попередній, і це займає\nсекунди. Коли кожне середовище збирає все з вихідного коду, повернення означає\nнаново зібрати старий коміт і сподіватися, що залежності розв'яжуться так само,\nяк тоді.\n\n## Як це виглядає на практиці\n\n[За розгортання однієї платформи в Azure відповідали від початку до кінця](/uk/portfolio/owned-end-to-end-platform-deployments-to-azure/),\nі кожна зміна проходила тим самим шляхом через development, staging і\nproduction, а напряму в робоче середовище ніхто нічого не викладав. Конвеєр\nCI/CD збирає образи й доставляє їх, а шаблони Bicep тримають цільову\nінфраструктуру однаковою в усіх середовищах, тож кожне просування потрапляє на\nідентичну інфраструктуру. Налаштування, що різняться між середовищами,\nзберігають окремо від секретів, і тому одна збірка проходить усі етапи,\nпідхоплюючи налаштування кожного середовища на місці, без перезбирання дорогою.\nСторінка повідомляє, що зміни потрапляють у кожне середовище цим визначеним\nшляхом без імпровізованих ручних розгортань, а випуск став контрольованим\nкроком, який щоразу відбувається однаково.\n\nВагу такої послідовності в годинах показала раніша робота:\n[автоматизація конвеєрів збирання, тестування й розгортання заощадила приблизно 4 000 годин](/uk/portfolio/streamlined-ci-cd-processes-saving-4000-hours/),\nбо шлях від зміни до production став стандартним, а ручні кроки, що залежали від\nтого, хто їх виконував, зникли. Сторінка повідомляє, що випуски пришвидшилися й\nстали надійнішими.\n\nНа власній платформі компанії розгортання відокремлене від підготовки хоста.\n[Контейнерний шар на Podman і Quadlet](/uk/portfolio/ran-containers-on-podman-and-quadlet/)\nдає root один раз підготувати шлях розгортання. Після цього непривілейований\nкористувач випускає нову версію, запускаючи один фіксований скрипт через вузько\nокреслене правило, яке дозволяє лише цю одну команду, і то без аргументів.\nСкрипт збирає образ і перезапускає службу, тож звичайний реліз не потребує\nоболонки з правами root і не дає виконати довільну команду.\n\n## Де виникають проблеми\n\nБільшість проблем із розгортанням виникає в розриві між тим, що перевірили, і\nтим, що насправді змінилося.\n\n**У production працює те, чого staging не бачив.** Коли кожне середовище збирає\nвласну копію, діапазони залежностей розв'язуються в новіші версії, базовий образ\nзмінюється між двома збираннями або прапорець збирання стоїть інакше, і\nартефакт, що пройшов тести, — уже не той, який обслуговує клієнтів. Збирайте\nодин раз, записуйте дайджест, просувайте саме його, а все, що залежить від\nсередовища, тримайте в конфігурації, а не в артефакті.\n\n**Тег зсувається, і відкат потрапляє не на ту версію.** Розгортання, яке\nпосилається на `latest` або повторно використовує тег версії після перезбирання,\nзалежить від того, на що тег вказує в день запуску. Документація Kubernetes\nрадить не використовувати `:latest` у production, бо тоді важче зрозуміти, яка\nверсія працює, і важче правильно відкотитися. Беріть теги версій, які ніколи не\nвикористовуються повторно, і фіксуйте дайджест там, де платформа це дозволяє.\n\n**Конвеєр звітує про успіх раніше, ніж нова версія запрацювала.** Багато команд,\nякі запускають розгортання, завершуються, щойно платформа прийняла запит, а нові\nекземпляри ще стартують і можуть упасти за хвилину. Крок, який чекає, доки нова\nверсія повідомить про готовність, а тоді надсилає кілька справжніх запитів і\nперевіряє відповіді, перетворює тихий збій на червону збірку, поки попередній\nвипуск ще під рукою.\n\n**Новий код і стара схема зустрічаються посеред розгортання.** Під час\nпоступового чи канаркового розгортання старі й нові версії обслуговують трафік\nпліч-о-пліч з однією базою даних. Міграція, яка перейменовує чи видаляє\nстовпець, ламає старі екземпляри, що ще працюють, і робить відкат небезпечним,\nбо старий код очікує того, що вже прибрали. Розносьте такі зміни на кілька\nрозгортань: спершу додайте нову структуру, потім випустіть код, що працює з\nобома, і прибирайте стару структуру лише тоді, коли вона не потрібна жодній із\nзапущених версій.\n\n## Що почитати далі\n\n- [Build, release, run](https://12factor.net/build-release-run) — аргументи\n  Twelve-Factor App на користь трьох окремих етапів і випусків, які після\n  створення не змінюють.\n- [Open Container Initiative](https://opencontainers.org/) — проєкт під егідою\n  Linux Foundation, що стоїть за специфікаціями образів, середовищ виконання й\n  розповсюдження, на які спирається більшість контейнерних розгортань.\n- [OCI Image Format Specification](https://github.com/opencontainers/image-spec/blob/main/spec.md)\n  — маніфести, шари, конфігурація й дайджести вмісту, що ідентифікують образ.\n- [Kubernetes Deployments](https://kubernetes.io/docs/concepts/workloads/controllers/deployment/)\n  — поступові оновлення, стратегія recreate, граничний термін просування й\n  відкати.\n- [Kubernetes images](https://kubernetes.io/docs/concepts/containers/images/) —\n  теги, дайджести, політики завантаження образів і чому `:latest` ускладнює\n  відкат.\n\n\u003chttps://engineer.company/uk/glossary/deployment/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Що охоплює розгортання, чому та сама збірка має без змін пройти від staging до production і де релізи найчастіше ламаються.","formats":{"gemtext":"https://engineer.company/uk/glossary/deployment/index.gmi","gopher":"https://engineer.company/uk/glossary/deployment/gophermap","html":"https://engineer.company/uk/glossary/deployment/","json":"https://engineer.company/uk/glossary/deployment/index.json","markdown":"https://engineer.company/uk/glossary/deployment/index.md","pdf":"https://engineer.company/uk/glossary/deployment/index.pdf"},"kind":"page","language":"uk","title":"Що таке розгортання?","url":"https://engineer.company/uk/glossary/deployment/","version":1}