Настройка CI/CD пайплайна на TeamCity: Kotlin DSL, шаблоны и деплой

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

Разработка и обслуживание любых видов сайтов:

Информационные сайты или веб-приложения
Сайты визитки, landing page, корпоративные сайты, онлайн каталоги, квиз, промо-сайты, блоги, новостные ресурсы, информационные порталы, форумы, агрегаторы
Сайты или веб-приложения электронной коммерции
Интернет-магазины, B2B-порталы, маркетплейсы, онлайн-обменники, кэшбэк-сайты, биржи, дропшиппинг-платформы, парсеры товаров
Веб-приложения для управления бизнес-процессами
CRM-системы, ERP-системы, корпоративные порталы, системы управления производством, парсеры информации
Сайты или веб-приложения электронных услуг
Доски объявлений, онлайн-школы, онлайн-кинотеатры, конструкторы сайтов, порталы предоставления электронных услуг, видеохостинги, тематические порталы

Это лишь некоторые из технических типов сайтов, с которыми мы работаем, и каждый из них может иметь свои специфические особенности и функциональность, а также быть адаптированным под конкретные потребности и цели клиента

Услуги, которые мы предлагаем
Показано 1 из 1Все 2062 услуг
Настройка CI/CD пайплайна на TeamCity: Kotlin DSL, шаблоны и деплой
Средний
~2-3 дня
Часто задаваемые вопросы

Наши компетенции:

Этапы разработки

Последние работы

  • image_website-b2b-advance_0.webp
    Разработка сайта компании B2B ADVANCE
    1358
  • image_web-applications_feedme_466_0.webp
    Разработка веб-приложения для компании FEEDME
    1250
  • image_websites_belfingroup_462_0.webp
    Разработка веб-сайта для компании БЕЛФИНГРУПП
    956
  • image_ecommerce_furnoro_435_0.webp
    Разработка интернет магазина для компании FURNORO
    1188
  • image_crm_enviok_479_0.webp
    Разработка веб-приложения для компании Enviok
    929
  • image_bitrix-bitrix-24-1c_fixper_448_0.webp
    Разработка веб-сайта для компании ФИКСПЕР
    947

Представьте: интернет-магазин на Node.js с тремя окружениями (dev, staging, production). Каждая сборка — с нуля, зависимости тянутся из npm без кэша, тесты прогоняются последовательно. На деплой уходило 40 минут, а откат — ручной перезалив архива по SSH. После аудита мы настроили TeamCity: параллельные шаги, кэширование node_modules, автоматические тесты в контейнерах. Время сборки упало до 8 минут — в 5 раз быстрее. Разработчики перестали ждать, а релизы стали выходить каждый день. Такая экономия времени напрямую снижает TCO и ускоряет выход фич в прод. Наша команда с 10-летним опытом настроит CI/CD под ключ: от установки сервера до документации.

Типичные технические сложности

N+1 запрос в тестах — TeamCity собирает отчёты о покрытии и находит узкие места на этапе CI. Грязные окружения — каждый билд на чистом Docker-агенте, конфликты исключены. Долгие сборки — параллельные шаги и кэширование зависимостей (npm cache, Maven local) сокращают время до 70%. Для типового Node.js проекта сборка с кэшем занимает 2-3 минуты вместо 10. Среднее время восстановления после сбоя сокращается до 15 минут благодаря автоматическим откатам.

Настройка пайплайна: Kotlin DSL и шаги

Используем Kotlin DSL — конфигурация как код, версионируется в Git и проходит code review. TeamCity поддерживает сложные пайплайны с параллельными шагами. Ниже — типовой пайплайн для Node.js приложения:

// .teamcity/settings.kts
import jetbrains.buildServer.configs.kotlin.*
import jetbrains.buildServer.configs.kotlin.buildSteps.*
import jetbrains.buildServer.configs.kotlin.triggers.*

version = "latest"

project {
    buildType(Build)
    buildType(Test)
    buildType(Deploy)

    buildTypesOrder = arrayListOf(Build, Test, Deploy)
}

object Build : BuildType({
    name = "Build"
    vcs { root(DslContext.settingsRoot) }

    steps {
        nodeJS {
            shellScript = "npm ci && npm run build"
        }
    }

    artifactRules = "dist/** => dist.zip"
})

object Test : BuildType({
    name = "Test"
    dependencies {
        snapshot(Build) {}
    }

    steps {
        script {
            scriptContent = """
                npm ci
                npm test -- --coverage --ci
            """.trimIndent()
        }
    }

    failureConditions {
        testFailure = true
        errorMessage = true
    }
})

object Deploy : BuildType({
    name = "Deploy to Production"
    type = Type.DEPLOYMENT

    dependencies {
        snapshot(Test) {}
        artifacts(Build) {
            artifactRules = "dist.zip => ."
        }
    }

    params {
        param("deploy.env", "production")
    }

    steps {
        script {
            scriptContent = """
                unzip dist.zip -d /var/www/app/
                sudo systemctl reload nginx
            """.trimIndent()
        }
    }

    triggers {
        vcs {
            branchFilter = "+:refs/heads/main"
        }
    }
})

Деплой через SSH

Для PHP-проектов (Laravel, Symfony) добавили SSH-шаг:

sshExec {
    commands = """
        cd /var/www/app
        git pull origin main
        composer install --no-dev --optimize-autoloader
        php artisan migrate --force
        php artisan config:cache
        php artisan route:cache
        php artisan view:cache
        sudo systemctl reload php8.3-fpm
    """.trimIndent()
    targetUrl = "deploy-server.example.com"
    authMethod = uploadedKey {
        username = "deploy"
        key = "deploy_key"
    }
}

Docker-сборка в TeamCity

Контейнеризация унифицирует окружение и избавляет от ошибок «на моей машине работает».

steps {
    dockerCommand {
        commandType = build {
            source = file { path = "Dockerfile" }
            namesAndTags = "registry.example.com/myapp:%build.counter%"
            commandArgs = "--no-cache"
        }
    }
    dockerCommand {
        commandType = push {
            namesAndTags = "registry.example.com/myapp:%build.counter%"
        }
    }
}

Параметры и шаблоны

Многоокруженные проекты (staging, production) настраиваем через шаблоны. Один шаблон — три окружения, минимум кода.

template("DeployTemplate") {
    params {
        param("env.name", "")
        param("env.url", "")
        param("ssh.host", "")
    }
    steps {
        script {
            scriptContent = "deploy.sh %env.name% %env.url%"
        }
    }
}

object DeployStaging : BuildType({
    templates(DeployTemplate)
    params {
        param("env.name", "staging")
        param("env.url", "https://staging.example.com")
        param("ssh.host", "staging.server.com")
    }
})

Почему TeamCity выигрывает у Jenkins?

TeamCity быстрее при параллельных сборках — в два раза, благодаря встроенному артефакто-хранилищу и умному планировщику. Kotlin DSL даёт типизацию и автодополнение в IDE, тогда как Jenkins Pipeline — Groovy с динамической типизацией, что часто ведёт к ошибкам рантайма. Нативные шаблоны и параметры окружений TeamCity упрощают масштабирование на десятки проектов. Для наглядности:

Критерий TeamCity Jenkins
Конфигурация Kotlin DSL (статическая типизация) Groovy (динамическая)
Параллельные сборки Встроенный планировщик, быстрее в 2 раза Требует настройки
Шаблоны окружений Нативные параметры и шаблоны Через библиотеки
Артефакты Встроенное хранилище Плагин

Закажите настройку TeamCity — получите готовый пайплайн с документацией за 5-7 дней.

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

Используем шаблоны с параметрами: env.name, env.url, ssh.host. Каждое окружение — отдельный build type с привязкой к шаблону. VCS triggers на main запускают автоматический деплой на staging; production — только вручную через UI. Это исключает случайный деплой на прод.

Типичные ошибки при настройке CI/CD
  • Игнорирование artifactRules — артефакты не попадают в следующий билд, деплой ломается
  • Отсутствие изоляции агентов — библиотеки конфликтуют, тесты падают непредсказуемо
  • Хардкод credentials — ключи в коде, утечка безопасности. Используем параметры TeamCity и хранилище паролей
  • Слишком длинные пайплайны — все шаги в одном билде, нет параллелизации. Делим на Build → Test → Deploy
  • Нет уведомлений — команда узнаёт о падении сборки через несколько часов

Какие проекты требуют автоматизации CI/CD?

Любой проект, где релизы чаще раза в месяц, а деплой делают вручную. Особенно если в команде больше двух разработчиков. TeamCity окупается за счёт сокращения времени на сборку и исключения человеческих ошибок. Наши клиенты — от финтех-стартапов до enterprise-порталов — экономят от 10 до 40 часов в месяц на операциях деплоя.

Что входит в работу

  • Аудит текущего процесса сборки и деплоя (1 день)
  • Установка сервера и агентов TeamCity (Docker или bare metal) — 1 день
  • Настройка VCS triggers, сборки, тестов и артефактов
  • Шаблоны для окружений (dev/staging/production)
  • Уведомления о статусе сборок (Slack, email)
  • Тестирование пайплайна и исправление ошибок
  • Документация и обучение вашей команды
  • Гарантия работоспособности в течение месяца после сдачи

Сроки и стоимость

Стоимость рассчитывается индивидуально после анализа проекта. Ориентировочные сроки:

Компонент Время
Установка и базовая конфигурация 1 день
Kotlin DSL и шаблоны 1–2 дня
Интеграция с VCS и тестами 1 день
Деплой на окружения 1–2 дня
Уведомления и документация 1 день

Получите консультацию по настройке TeamCity под ваш проект. Свяжитесь с нами — мы поможем автоматизировать деплой без головной боли. Также вы можете запросить чек-лист по настройке CI/CD.

Мы регулярно сталкиваемся с ситуацией: «Сайт не открывается» в 3 часа ночи — и выясняется, что disk full на VPS, потому что логи nginx не ротировались полгода. Или сервер лёг под нагрузкой в день запуска рекламной кампании, потому что на shared хостинге стоял лимит в 50 одновременных соединений. Настройка хостинга и деплоя — это не про «где дешевле», это про то, что происходит в момент, когда что-то идёт не так. Наша команда помогает избежать таких инцидентов, проектируя инфраструктуру с учётом реальных паттернов нагрузки.

Когда выбирать Vercel и Netlify?

Vercel создан под Next.js — деплой в один push, preview deployments для каждого PR, автоматический CDN, Edge Functions, ISR без конфигурации. Для фронтенд-проектов и JAMstack это оптимальный выбор: нет операционной нагрузки, time-to-deploy измеряется минутами.

Ограничения реальные: Vercel Serverless Functions запускаются в us-east-1 по умолчанию (latency для Европы +80–100ms), Function timeout 300 секунд на Pro, Bandwidth 1TB/месяц на Pro. Для тяжёлого backend — нужны воркеры или отдельный сервер.

Netlify ближе к статике и Edge Functions на базе Deno Deploy. Build minutes — основное ограничение на бесплатном тарифе.

Критерий Vercel Netlify
Основная специализация Next.js, фреймворки Статика, JAMstack
Edge Functions V8 isolates (Node.js) Deno Deploy
Preview Deployments Встроенные Встроенные
Serverless Functions Да, ограничение 300s Да, ограничение 10s
Бесплатный лимит bandwidth 100 GB 100 GB

Почему Docker — основа предсказуемого деплоя?

«Работает на моей машине» — классика. Docker решает это через контейнеризацию окружения. Но плохой Dockerfile создаёт новые проблемы.

Типичная ошибка: копировать всё в образ без .dockerignore, получать 800MB образ вместо 80MB. node_modules внутри образа весит столько же. Правильно: multi-stage build.

FROM node:20-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .
RUN npm run build

FROM node:20-alpine AS runner
WORKDIR /app
COPY --from=builder /app/.next ./.next
COPY --from=builder /app/node_modules ./node_modules
COPY --from=builder /app/package.json ./package.json
EXPOSE 3000
CMD ["npm", "start"]

Итоговый образ: 180MB вместо 1.2GB. Время сборки CI сокращается из-за layer caching — если package.json не изменился, слой с npm ci берётся из кэша.

Docker Compose для локальной разработки и простых продакшен-сценариев: приложение + PostgreSQL + Redis в одной конфигурации. Для production на одном сервере — вполне рабочий вариант, если нет требований горизонтального масштабирования.

Подробнее о контейнеризации — Wikipedia: Docker.

Как настроить Nginx как reverse proxy?

Nginx перед приложением — стандарт для VPS и выделенных серверов. Основные функции: SSL termination, gzip, static files, rate limiting, upstream балансировка.

Конфигурация, которую часто делают неправильно: worker_processes auto — количество процессов равно числу CPU. worker_connections 1024 — это 1024 на каждый воркер-процесс. При 4 CPU и 1024 connections = 4096 одновременных соединений. Для высоконагруженного сайта нужно worker_connections 4096 и настройка keepalive_timeout 65.

Для статических ассетов с хешем в имени файла:

location ~* \.(js|css|woff2|png|webp)$ {
    expires 1y;
    add_header Cache-Control "public, immutable";
}

immutable сообщает браузеру: не проверяй этот файл даже при hard refresh. Правильно работает только с content-hashed именами файлов (что делает Vite/webpack по умолчанию). Документация — Wikipedia: Nginx.

AWS: гибкость и сложность

EC2 + Auto Scaling Group — классика для горизонтального масштабирования. AMI с предустановленным приложением, Launch Template, ASG с min/desired/max instances, Application Load Balancer. При CPU > 70% на 3 минуты — scale out, при CPU < 30% на 15 минут — scale in. Health check через ALB исключает нездоровые инстансы из ротации.

ECS Fargate — контейнеры без управления EC2. Деплой Docker-образа, задаёте CPU/память (512 CPU units = 0.5 vCPU, от 512MB памяти), Fargate запускает. Дороже Lambda, но нет cold start и нет timeout-ограничений. Подходит для long-running процессов, WebSocket-серверов, тяжёлых воркеров.

RDS для PostgreSQL с Multi-AZ: автоматический failover за 1–2 минуты при падении primary. Read Replicas для масштабирования чтения. RDS Proxy для connection pooling — Lambda-функции не умеют держать долгосрочные соединения, прокси буферизует это.

Kubernetes: когда это оправдано

K8s добавляет значительную операционную сложность. Оправдан, когда: несколько команд деплоят независимые сервисы, нужна тонкая настройка ресурсов на сервис, canary deployments и blue/green без простоя — требование.

AWS EKS, GKE или managed k8s от Hetzner (дешевле). Helm charts для стандартных сервисов. Horizontal Pod Autoscaler по CPU и custom metrics (RPS через Prometheus).

Для большинства стартапов и средних проектов — Kubernetes избыточен. ECS или Fly.io дают 80% возможностей при 20% операционной сложности.

Мониторинг и alerting

Сервер без мониторинга — это ожидание инцидента. Минимальный стек: Prometheus + Grafana (или Grafana Cloud для managed), alerting на disk > 80%, memory > 85%, CPU > 90% за 5 минут, error rate > 1%. Uptime через Better Uptime или Upptime (self-hosted).

Logs: Loki + Grafana или CloudWatch Logs Insights. Структурированные JSON-логи (winston, pino) — обязательно, иначе поиск по логам превращается в боль.

Что входит в настройку хостинга

  • Аудит текущей инфраструктуры и профилирование нагрузки
  • Выбор целевой архитектуры (VPS, AWS, serverless, Kubernetes)
  • Настройка CI/CD pipeline (GitHub Actions, GitLab CI) с автоматическим деплоем
  • IaC через Terraform или Pulumi (инфраструктура как код)
  • Конфигурация Nginx, SSL-сертификаты, HTTP/2, brotli
  • Мониторинг и алертинг (Prometheus + Grafana, PagerDuty)
  • Документация runbooks и обучение команды

Дополнительно: пишите, если нужна миграция с текущего хостинга или интеграция с внешними сервисами.

Процесс работы

  1. Аудит текущей инфраструктуры (2–5 дней)
  2. Выбор целевой архитектуры с обоснованием по нагрузке и бюджету (1–3 дня)
  3. Настройка CI/CD pipeline (GitHub Actions, GitLab CI) (2–5 дней)
  4. IaC через Terraform или Pulumi (3–10 дней)
  5. Настройка мониторинга и alerting (2–5 дней)
  6. Документация runbooks и обучение команды (1–3 дня)

Наш опыт — 7 лет на рынке, более 50 проектов, гарантия работоспособности после деплоя.

Сроки

  • Базовый деплой на VPS с Docker + Nginx + CI/CD: 1–2 недели.
  • Настройка AWS инфраструктуры с Auto Scaling, RDS, CDN: 3–6 недель.
  • Миграция на EKS с нуля: 6–12 недель.
  • Настройка Vercel/Netlify для JAMstack: 3–5 дней.

Стоимость рассчитывается индивидуально в зависимости от сложности и объёма работ. Получите консультацию — оценим вашу архитектуру за один день.