К статье
Практический материал

Администрирование · 9 мин

Что такое сборка 1С и как с ней работать

Разбираем, что такое сборка 1С, чем отличается от релиза и обновления, что входит в дистрибутив и как безопасно подготовить и проверить сборку конфигурации.

Сборка 1С — это подготовленный к установке или обновлению пакет файлов конфигурации, который содержит конкретную версию программного продукта на платформе 1С:Предприятие. В повседневной практике под сборкой понимают либо дистрибутив, полученный от поставщика, либо результат сборки конфигурации из исходных файлов внутри команды разработки. В обоих случаях речь идёт о зафиксированном, идентифицируемом состоянии прикладного решения.

Термин используется в трёх смыслах, и их важно различать. Первый — сборка платформы, то есть конкретная версия технологической платформы 1С:Предприятие с номером вида 8.3.x.xxxx. Второй — сборка конфигурации: файл поставки или обновления, содержащий метаданные, код и формы прикладного решения. Третий — процесс сборки: автоматизированная процедура, которая из исходного кода, хранящегося в системе контроля версий, формирует готовый дистрибутив.

Понимание того, что входит в сборку и как она формируется, критично для администраторов и разработчиков: от корректности сборки зависит, обновится ли база без ошибок, сохранятся ли данные и заработают ли доработки. Ошибка на этапе сборки или её применения способна остановить учёт в организации, поэтому работа со сборками всегда выполняется по регламенту с резервным копированием.

Что входит в состав сборки конфигурации

Типовая сборка прикладного решения включает файл поставки конфигурации (с расширением .cf), файл обновления (.cfu) для перехода с предыдущих версий, а также сопроводительные материалы: описание изменений, инструкцию по обновлению и, при необходимости, внешние обработки и шаблоны. В дистрибутив платформы дополнительно входят исполняемые файлы сервера и клиента, драйверы защиты и утилиты администрирования.

Ключевой элемент сборки — номер версии конфигурации. Он задаётся в свойствах конфигурации в конфигураторе и используется механизмом обновления для определения порядка применения. Если номер версии в сборке не соответствует ожидаемому, обновление либо не запустится, либо применится в неверной последовательности, что приведёт к ошибкам реструктуризации данных.

Чем сборка отличается от релиза, обновления и патча

В практике сопровождения 1С эти термины часто смешивают, хотя между ними есть различия. Релиз — официально опубликованная версия продукта, прошедшая проверку у поставщика. Сборка — технический результат упаковки этой версии в дистрибутив; один релиз может иметь несколько сборок, если в дистрибутив вносились исправления без смены номера версии. Обновление — процедура применения сборки к существующей базе с сохранением данных.

Отдельно стоит патч (исправление) — небольшое изменение, которое поставляется в виде расширения конфигурации и устанавливается без полного обновления. Патчи удобны для срочных исправлений, но накапливать их в большом количестве не рекомендуется: при выходе очередной сборки исправления обычно включаются в основной релиз, а патчи удаляются.

Сравнение вариантов поставки

Полная сборка (.cf)

Подходит для новой установки или полной замены конфигурации. Не применяется для штатного обновления рабочей базы с данными.

Файл обновления (.cfu)

Стандартный способ перехода на новую версию: применяется только к поддерживаемым предыдущим версиям, сохраняет данные.

Патч (расширение)

Точечное исправление без обновления. Ограничение: работает только для ошибок, исправимых механизмом расширений.

Как формируется сборка в команде разработки

В организациях с собственными доработками сборка конфигурации создаётся из системы хранения или контроля версий. Классический путь — хранилище конфигурации: разработчики захватывают объекты, вносят изменения, помещают их обратно, после чего ответственный специалист формирует файл поставки из актуального состояния хранилища. Современный подход использует выгрузку конфигурации в файлы XML или формат EDT и сборку дистрибутива скриптами.

Типовой порядок формирования сборки выглядит так: код фиксируется в хранилище, выполняется полная проверка конфигурации (синтаксический контроль, проверка логической целостности, поиск некорректных ссылок), затем конфигурация выгружается в файл поставки с указанием номера версии. Финальный шаг — тестовое обновление копии рабочей базы и проверка ключевых сценариев учёта.

Порядок формирования сборки
  1. 1
    Зафиксировать все изменения в хранилище конфигурации или системе контроля версий
  2. 2
    Выполнить полную проверку конфигурации в конфигураторе и устранить ошибки
  3. 3
    Установить корректный номер версии в свойствах конфигурации
  4. 4
    Сформировать файл поставки и файл обновления с поддерживаемых версий
  5. 5
    Применить сборку на копии рабочей базы и выполнить тестовое обновление
  6. 6
    Проверить критичные операции: проведение документов, формирование отчётов, обмены данными

Как применить сборку к рабочей базе без потери данных

Обновление рабочей базы новой сборкой выполняется через конфигуратор: «Конфигурация — Поддержка — Обновить конфигурацию» с указанием файла обновления или через загрузку конфигурации из файла в особых случаях. Перед началом все пользователи должны завершить работу, а фоновые задания — остановлены. Для клиент-серверных баз обновление выполняется в монопольном режиме.

После загрузки сборки конфигуратор предложит обновить конфигурацию базы данных — на этом этапе выполняется реструктуризация: изменение таблиц, индексов и служебных структур. На больших базах реструктуризация может занимать значительное время, поэтому обновление планируют на нерабочие часы. Прерывать процесс нельзя: это приводит к повреждению структуры базы.

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

После обновления нужно убедиться, что сборка применилась корректно. Базовые контрольные точки: номер версии конфигурации в разделе «О программе» соответствует сборке, информационная база запускается без ошибок, регламентные задания выполняются, обмены с другими системами проходят штатно. Дополнительно проверяют формирование регламентированной отчётности и проведение типовых документов.

Отдельное внимание — доработкам и расширениям. После обновления расширения могут оказаться несовместимыми с новой версией: конфигуратор помечает их как неприменимые. Каждое расширение нужно проверить и при необходимости адаптировать, иначе часть функциональности молча перестанет работать.

Контрольные точки

Как проверить результат

Номер версии конфигурации
Норма

Совпадает с номером применённой сборки

Тревожный признак

Остался прежним — обновление не применилось

Расширения конфигурации
Норма

Все расширения активны и проходят проверку применимости

Тревожный признак

Расширение отключено или помечено как несовместимое

Регламентные задания и обмены
Норма

Выполняются по расписанию без ошибок в журнале

Тревожный признак

Ошибки в журнале регистрации, задания не запускаются

Типичные ошибки при работе со сборками

Самая распространённая ошибка — обновление через несколько версий с пропуском промежуточных релизов, когда файл обновления рассчитан только на соседние версии. Результат — отказ в обновлении или некорректная реструктуризация. Вторая типичная проблема — конфигурация снята с поддержки или изменена без документирования: тогда типовая сборка затирает доработки, и учётные механизмы перестают работать.

Ещё одна группа ошибок связана с несоответствием версий платформы и конфигурации: сборка, собранная под новую платформу, может некорректно работать на старой. Перед применением сборки всегда сверяйте требования к версии платформы, указанные поставщиком в сопроводительной документации.

Типичные ошибки
01
Обновление без резервной копии — при сбое данные восстановить не из чего
02
Пропуск промежуточных версий — файл обновления не предназначен для такого перехода
03
Загрузка .cf вместо применения .cfu — теряется история поддержки и возникают конфликты доработок
04
Игнорирование несовместимых расширений — часть функциональности отключается незаметно
05
Обновление в рабочее время — блокировка базы и остановка учёта

Часто задаваемые вопросы о сборках 1С

Чем сборка платформы отличается от сборки конфигурации?

Сборка платформы — это версия самой среды исполнения 1С:Предприятие (сервер, клиент, конфигуратор). Сборка конфигурации — версия прикладного решения, которое работает на этой платформе. Они обновляются независимо, но у конфигурации есть требования к минимальной версии платформы.

Можно ли откатить сборку после обновления?

Штатного механизма отката нет: обратная реструктуризация не предусмотрена. Единственный надёжный способ вернуться на предыдущую версию — восстановить базу из резервной копии, сделанной до обновления. Поэтому копия перед применением сборки обязательна.

Что делать, если конфигурация доработана и типовая сборка не встаёт?

Нужно выполнить объединение конфигураций через режим сравнения и объединения в конфигураторе, вручную перенеся доработки в новую версию. Снимать конфигурацию с поддержки и загружать .cf целиком нельзя — все доработки будут потеряны.

Как узнать, из какой сборки развёрнута текущая база?

Откройте в режиме 1С:Предприятие раздел «О программе» — там указаны версия конфигурации и версия платформы. В конфигураторе номер версии виден в свойствах корневого узла конфигурации, а историю обновлений можно отследить по журналу регистрации.

Нужно ли тестировать сборку, если обновление типовое и небольшое?

Да. Даже минорная сборка может затронуть доработки, расширения и настройки обменов. Минимальный контур проверки — обновление копии базы, запуск, проведение нескольких типовых документов и формирование ключевых отчётов.

Итог

Что важно запомнить

Сборка 1С — зафиксированная версия платформы или конфигурации, готовая к установке или обновлению. Работайте со сборками по регламенту: резервная копия, тестовое обновление на копии, проверка версии, расширений и обменов после применения. Отката без резервной копии не существует.