Старый бежевый компьютер и современный ноутбук на столе, между ними светящаяся цепочка блоков и шестерёнок: автоматическая сборка и выкладка legacy-приложения

CI/CD для legacy-проекта на .NET Framework и VB.NET: сборка, тесты и выкладка без ручных шагов

РубрикаСопровождениеУровеньСредний Чтение13 минОпубликовано ТегиCI/CD.NET FrameworkMSBuildСопровождение

Сборка старого проекта на ноутбуке одного разработчика — риск для бизнеса. Разбираем, как перенести сборку .NET Framework, VB.NET и VB6 в GitLab CI или Azure Pipelines: контракт сборки, Windows-раннер, MSBuild и vswhere, тесты без ложного зелёного, выкладка на IIS и откат.

Главное. Чтобы старый проект на .NET Framework перестал зависеть от ноутбука одного разработчика, сначала запишите контракт сборки: решение, конфигурацию, SDK, внешние DLL, COM-компоненты и секреты. Затем поднимите Windows-раннер с Build Tools, находите MSBuild и vstest через vswhere, восстанавливайте пакеты из packages.config отдельным шагом и проверяйте, что тестов больше нуля. Веб-приложение собирайте один раз и выкладывайте на IIS этим же артефактом, с ручным подтверждением для прода и сохранённой предыдущей версией для отката. Библиотеки и WinForms переводятся на конвейер за несколько дней, проекты с COM и VB6 — за 2–4 недели.

В компаниях, где живёт legacy на .NET Framework, сборку для продакшена до сих пор часто делает один человек. Он открывает Visual Studio на своём ноутбуке, нажимает «Опубликовать», архивирует папку и копирует её на сервер по RDP. Пока этот человек на месте, схема работает. Когда он в отпуске или уволился, выясняется, что проект собирается только у него: на машине стоят нужный SDK, пара DLL из сетевой папки и зарегистрированный OCX, о котором никто не помнит. CI/CD здесь решает одну приземлённую задачу: сборка становится воспроизводимой, и ноутбук перестаёт быть единственным местом, где проект вообще собирается.

Если своего специалиста по инфраструктуре в команде нет, конвейер для старого проекта можно заказать у подрядчика вместе с настройкой DevOps-процессов: он поднимет Windows-раннер, опишет сборку в YAML и настроит выкладку на IIS. От вас нужны доступ к репозиторию, список серверов и человек, который знает, как проект собирают сейчас.

Ниже — практический порядок действий для проектов на VB.NET, ASP.NET Web Forms, WinForms и даже VB6. Если код ещё не покрыт тестами, параллельно прочитайте наш разбор о модульных тестах для legacy-кода на VB.NET: без них конвейер собирает, но ничего не проверяет.

Зачем legacy-проекту на .NET Framework CI/CD?

CI/CD нужен legacy-проекту, чтобы любая версия собиралась одной командой на чистой машине и попадала на сервер без ручных шагов. Новых функций в старом приложении может не быть годами, но исправления безопасности, смена сертификатов и обновления Windows приходят регулярно, и каждую такую правку надо собрать и выкатить.

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

.NET Framework 4.8 и 4.8.1 при этом никуда не уходят: по политике жизненного цикла Microsoft они поддерживаются как компонент Windows, на которой установлены. Поддержка версий 4.5.2, 4.6 и 4.6.1 закончилась 26 апреля 2022 года, поэтому проект на них стоит сначала перевести хотя бы на 4.6.2, а лучше на 4.8.

Что нужно сделать до того, как писать YAML?

До того как писать YAML, составьте контракт сборки: что именно собирается, какими командами и что нужно на машине, кроме исходников. Конвейеры для старых проектов обычно ломаются на зависимостях, которые есть только у одного разработчика. Синтаксис YAML тут виноват редко.

Что выписать в контракт сборки

  1. Решение и проекты. Путь к .sln, какие проекты в него входят, какие из них веб, какие десктоп, какие тестовые.
  2. Конфигурация и платформа. Обычно Release и Any CPU, но у проектов с COM-зависимостями часто только x86.
  3. Версия Visual Studio и SDK. Какие Targeting Pack нужны (4.7.2, 4.8), есть ли проекты WCF, Web Site Project или установщики .vdproj, которые MSBuild вообще не собирает.
  4. Внешние DLL. Библиотеки, на которые проект ссылается по пути вида C:\Libs\ или \\server\share\. Их надо либо положить в репозиторий, либо опубликовать во внутренний NuGet-фид.
  5. COM и OCX. Компоненты, которые должны быть зарегистрированы в системе, чтобы проект собрался.
  6. Секреты. Строки подключения, пароли и ключи подписи. В репозиторий они не попадают, в конвейер — только через защищённые переменные.

Проверить контракт просто: склонируйте репозиторий на чистую виртуальную машину и попробуйте собрать проект только по записанным шагам. Всё, что пришлось доустановить руками, допишите в список. Удобно совместить это с общим аудитом кода — порядок описан в чек-листе аудита legacy-кодовой базы на VB.NET.

Какой раннер нужен для сборки .NET Framework?

Для сборки .NET Framework нужен раннер на Windows: проекты старого формата собираются MSBuild из Visual Studio или Build Tools, а на Linux этих инструментов нет. Выбор — между облачным раннером, собственной виртуальной машиной и Windows-контейнером.

ВариантКогда подходитПлюсыМинусы
Облачный раннер GitHub Actions или Azure PipelinesКод в GitHub или Azure DevOps, нет COM и VB6Visual Studio уже установлена в образе, ничего не надо обслуживатьНельзя поставить OCX и старые SDK, образ меняется без вашего участия
Своя Windows-ВМ с GitLab Runner или агентом Azure DevOpsSelf-hosted GitLab, Azure DevOps Server, проекты с COM и VB6Полный контроль над окружением, доступ к внутренней сетиВМ надо обновлять, снимать снимки и не давать ей «зарастать» ручными правками
Windows-контейнер с образом .NET Framework SDKВеб-проекты и библиотеки без COMЧистое окружение на каждую сборкуБольшие образы, нужен Windows-хост с той же версией ядра

Как настроить свой раннер на Windows

Свой раннер на Windows-ВМ настраивают в три шага:

  1. Установите Visual Studio Build Tools с нагрузками «Средства сборки .NET» и «Средства сборки веб-приложений» и нужными Targeting Pack.
  2. Поставьте Git для Windows и nuget.exe.
  3. Установите GitLab Runner как службу Windows по инструкции GitLab и зарегистрируйте его с исполнителем shell и оболочкой PowerShell.

Для Azure DevOps Server вместо раннера ставят агент сборки — переход со старого TFS мы разбирали в статье об обновлении до Azure DevOps Server.

MSBuild после установки не попадает в PATH, и жёстко прописывать путь вроде C:\Program Files\Microsoft Visual Studio\2022\BuildTools\MSBuild\Current\Bin не стоит: он изменится при обновлении. Надёжнее находить его утилитой vswhere, которая ставится вместе с Visual Studio Installer.

Как собрать проект и восстановить пакеты из packages.config?

Проект с packages.config собирают в два шага: сначала nuget restore восстанавливает пакеты в папку packages, затем MSBuild собирает решение. Обычный msbuild -t:restore такие проекты пропускает, если не передать свойство RestorePackagesConfig=true.

Минимальный конвейер GitLab CI для решения на VB.NET выглядит так:

.gitlab-ci.ymlYAML
stages: [build, test, deploy]

variables:
  SOLUTION: "Billing.sln"
  CONFIG: "Release"

build:
  stage: build
  tags: [windows, dotnet-framework]
  script:
    - $vswhere = "${env:ProgramFiles(x86)}\Microsoft Visual Studio\Installer\vswhere.exe"
    - $msbuild = & $vswhere -latest -requires Microsoft.Component.MSBuild -find "MSBuild\**\Bin\MSBuild.exe" | Select-Object -First 1
    - nuget restore $env:SOLUTION
    - & $msbuild $env:SOLUTION /m /nologo /v:minimal /p:Configuration=$env:CONFIG
    - if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
  artifacts:
    paths: ["**/bin/$CONFIG/"]
    expire_in: 7 days

Строка с проверкой $LASTEXITCODE важна: в PowerShell ошибка внешней программы не всегда останавливает скрипт, и без неё задание может стать зелёным при упавшей сборке. Ключи командной строки MSBuild подробно описаны в справочнике Microsoft Learn.

Типичные ошибки первой сборки

  • MSB3644: не найдены эталонные сборки. На раннере нет Targeting Pack нужной версии. Доустановите его через Visual Studio Installer.
  • Не найден WebApplication.targets. Не установлены средства сборки веб-приложений. Без них проект ASP.NET не соберётся.
  • Ссылка на DLL по абсолютному пути. На ноутбуке разработчика файл есть, на раннере — нет. Переведите ссылку на NuGet-пакет или положите DLL в репозиторий рядом с проектом.
  • Проект установщика .vdproj. MSBuild его не собирает. Либо вызывайте devenv.com на раннере с полной Visual Studio, либо переходите на WiX.

Как запустить тесты в конвейере и не получить ложный зелёный?

Тесты для .NET Framework в конвейере запускают через vstest.console.exe с логгером TRX, а затем проверяют, что тестов было больше нуля. Самая частая ловушка — конвейер «прошёл», потому что адаптер тестов не нашёлся и не выполнился ни один тест.

.gitlab-ci.yml (фрагмент)YAML
test:
  stage: test
  tags: [windows, dotnet-framework]
  needs: [build]
  script:
    - $vstest = & $vswhere -latest -find "**\vstest.console.exe" | Select-Object -First 1
    - & $vstest "Billing.Tests\bin\Release\Billing.Tests.dll" /Logger:trx /ResultsDirectory:TestResults
    - if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
    - $trx = Get-ChildItem TestResults\*.trx | Select-Object -First 1
    - $total = ([xml](Get-Content $trx)).TestRun.ResultSummary.Counters.total
    - if ([int]$total -eq 0) { Write-Error "Не найдено ни одного теста"; exit 1 }

Переменную $vswhere в этом задании нужно объявить так же, как в задании сборки, или вынести в общий блок before_script. Для тестов на MSTest v1 и NUnit 2 проверьте, что в проекте подключён адаптер: без него vstest.console.exe молча не найдёт тесты.

Как упаковать и выложить ASP.NET-приложение на IIS?

ASP.NET-приложение на .NET Framework упаковывают через публикацию MSBuild в папку или в пакет Web Deploy, а на IIS выкладывают из этого артефакта без повторной сборки. Принцип «собери один раз, выкладывай много раз» здесь важнее инструмента: тестовый и боевой серверы получают одинаковые файлы, отличаются только настройки.

  1. Опубликуйте в папку. Добавьте к вызову MSBuild ключи /p:DeployOnBuild=true /p:WebPublishMethod=FileSystem /p:PublishUrl=publish и сохраните папку publish как артефакт.
  2. Вынесите настройки из сборки. Преобразования Web.Release.config подходят для того, что одинаково во всех средах. Строки подключения и ключи лучше хранить на сервере в отдельном файле через атрибут configSource или подставлять при выкладке.
  3. Выкладывайте с остановкой пула. Положите в корень сайта app_offline.htm, скопируйте файлы через robocopy или Web Deploy и удалите его. Так IIS не держит заблокированные DLL.
  4. Сохраняйте предыдущую версию. Перед копированием переименуйте текущую папку сайта или храните последние три сборки на сервере. Откат — смена пути сайта на предыдущую папку.
  5. Поставьте ручное подтверждение на прод. В GitLab это задание с when: manual и защищённой средой: на тестовый сервер выкладка идёт автоматически, на боевой — по кнопке.

Раннер, который выкладывает на прод, не должен быть тем же, на котором собираются ветки разработчиков. Лучше отдельный раннер с тегом deploy и доступом только к нужным серверам.

Можно ли собирать в CI десктоп на WinForms и VB6?

Десктоп на WinForms собирается в CI так же, как библиотеки, а VB6 тоже можно собирать, но только на своей ВМ с установленной средой VB6. Облачные раннеры для VB6 не подходят: IDE там нет, а OCX не зарегистрировать.

Как собрать WinForms на VB.NET и опубликовать ClickOnce

Обычную сборку WinForms делает тот же MSBuild. Для ClickOnce добавьте цель /t:Publish и параметры PublishUrl и ApplicationVersion, чтобы номер версии рос с каждой сборкой.

Подписывайте исполняемые файлы утилитой signtool с сертификатом из защищённой переменной: Windows SmartScreen реже ругается на подписанные программы.

Как собрать проект VB6 из командной строки

VB6 собирают из командной строки: VB6.EXE /make Project.vbp /out build.log. Ошибки компиляции попадают в лог, а не в консоль, поэтому скрипт должен читать build.log и падать, если в нём есть ошибка. На ВМ сборки заранее регистрируют все OCX и DLL, на которые ссылается проект, и после настройки делают снимок машины. Подробнее о сборочной машине для VB6 — в статье о сопровождении VB6-приложения в 2026 году.

GitLab CI, Azure Pipelines или Jenkins: что выбрать?

Инструмент выбирают по тому, где уже лежит код: конвейер в той же системе, что и репозиторий, проще поддерживать. Для сборки .NET Framework все три варианта подходят одинаково, различается обвязка.

ИнструментГде хорошСборка .NET Framework
GitLab CISelf-hosted GitLab в компанииGitLab Runner на Windows, исполнитель shell, скрипты PowerShell
Azure PipelinesAzure DevOps Services или Server, бывший TFSГотовые задачи NuGetCommand, VSBuild и VSTest, облачный или свой агент
GitHub ActionsКод в GitHubОблачный раннер Windows с Visual Studio в образе или свой раннер
JenkinsУже есть Jenkins для других проектовWindows-агент и плагин MSBuild, больше ручной настройки

Если проект живёт в старом TFS с XAML-сборками, их всё равно придётся переписать: в Azure DevOps Server XAML-сборки не поддерживаются, и переход — хороший момент описать конвейер в YAML.

Сколько времени занимает настройка конвейера?

Настройка CI/CD для одного legacy-решения обычно занимает от нескольких дней до нескольких недель, и почти всё время уходит на контракт сборки, а не на YAML. Оценочные ориентиры для типичных проектов:

ПроектЧто мешаетСрок
Библиотеки и WinForms на VB.NET, пакеты из NuGetПочти ничего1–3 дня
ASP.NET Web Forms с выкладкой на IISНастройки в Web.config, ручные шаги на сервере1–2 недели
Смешанный проект с COM, VB6 и установщикомOCX, .vdproj, DLL из сетевых папок2–4 недели

Своими силами конвейер имеет смысл настраивать, если в команде есть человек, который знает и проект, и выбранную CI-систему. Подрядчик выгоднее, когда сборку держит один уходящий сотрудник или когда вместе с конвейером нужны мониторинг серверов и регламент обновлений.

Типичные ошибки при внедрении CI/CD в legacy

  • Собирать заново для каждой среды. Тест и прод получают разные бинарники, и ошибка, пойманная на тесте, не гарантирует ничего для прода.
  • Хранить пароли в Web.config в репозитории. Конвейер делает их доступными всем, у кого есть доступ к артефактам.
  • Настраивать раннер руками без записи. Через год он превращается в тот же незаменимый ноутбук, только в серверной.
  • Выкатывать на прод автоматически с первого дня. Сначала месяц автоматической выкладки на тест и ручной кнопки на прод.

Чек-лист CI/CD для проекта на .NET Framework

  1. контракт сборки записан и проверен на чистой ВМ;
  2. все внешние DLL перенесены в NuGet-фид или репозиторий;
  3. раннер на Windows описан скриптом установки или снимком ВМ;
  4. MSBuild и vstest находятся через vswhere, а не по жёсткому пути;
  5. пакеты восстанавливаются nuget restore или с RestorePackagesConfig=true;
  6. конвейер падает при ненулевом коде выхода и при нуле тестов;
  7. артефакт собирается один раз и выкладывается во все среды;
  8. секреты хранятся в защищённых переменных и на серверах, не в репозитории;
  9. выкладка на прод — по ручному подтверждению, предыдущая версия сохраняется для отката;
  10. у раннера и серверов выкладки есть ответственный и график обновлений Windows.

Как это делают сегодня

В конце 2026 года legacy-проекты на .NET Framework 4.8 собирают на Windows-раннерах в GitLab CI, Azure Pipelines или GitHub Actions, а проекты с VB6 и COM держат на отдельной ВМ со снимком. Конвейер обычно появляется не сам по себе, а как первый шаг перед переводом проекта на современный .NET: без воспроизводимой сборки миграцию не проверить.

Вопросы и ответы о CI/CD для .NET Framework

Можно ли собирать проект на .NET Framework на Linux?

Проекты старого формата и веб-приложения ASP.NET — нет, им нужен Windows-раннер с MSBuild из Visual Studio или Build Tools. Библиотеки в SDK-формате с пакетом Microsoft.NETFramework.ReferenceAssemblies собираются и на Linux, но тесты, которые обращаются к Windows API, всё равно запускают на Windows.

Нужна ли полная Visual Studio на сервере сборки?

Обычно нет: хватает Visual Studio Build Tools с нагрузками для .NET и веб-приложений. Полная Visual Studio нужна, если в решении есть проекты установщиков .vdproj, которые MSBuild не собирает. Для VB6 на сборочной машине нужна установленная среда VB6.

Почему конвейер зелёный, хотя тесты не запускались?

Чаще всего vstest.console.exe не нашёл адаптер тестов и завершился без ошибки, выполнив ноль тестов. Включите логгер TRX и добавьте в скрипт проверку, что общее число тестов больше нуля, а также проверку кода выхода после каждой внешней программы.

Как откатить неудачную выкладку на IIS?

Храните на сервере несколько последних версий в отдельных папках и переключайте путь сайта на предыдущую. Тогда откат занимает минуту и не требует повторной сборки. Конфигурацию со строками подключения держите вне папки сборки, чтобы она не терялась при переключении.

Сколько времени занимает настройка CI/CD для legacy-проекта?

Для библиотек и WinForms с пакетами из NuGet — 1–3 дня, для ASP.NET Web Forms с выкладкой на IIS — 1–2 недели, для смешанного проекта с COM, VB6 и установщиком — 2–4 недели. Основное время уходит на поиск неописанных зависимостей, а не на YAML.

Читайте также