Налаштування CI/CD для сайту через TeamCity

Налаштування CI/CD для вашого сайту з TeamCity

TeamCity — CI/CD сервер від JetBrains. Він підтримує складні конвеєри, паралельні кроки, власну Kotlin DSL та тісну інтеграцію з IntelliJ IDEA. Популярний у корпоративному середовищі та проектах .NET.

Встановлення TeamCity

# Docker Compose
services:
  teamcity-server:
    image: jetbrains/teamcity-server:2024.03
    ports:
      - "8111:8111"
    volumes:
      - ./teamcity-data:/data/teamcity_server/datadir
      - ./teamcity-logs:/opt/teamcity/logs

  teamcity-agent:
    image: jetbrains/teamcity-agent:2024.03
    environment:
      SERVER_URL: "http://teamcity-server:8111"
      AGENT_NAME: "linux-agent-1"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock

Kotlin DSL — конфігурація як код

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

version = "2024.03"

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

// SSH Upload Step
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%"
        }
    }
}

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

// Шаблон для кількох середовищ
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 підтримує сповіщення в Slack, електронну пошту, Telegram:

// Електронна пошта при складанні
emailNotifier {
    sendTo = "[email protected]"
    events {
        buildFailed()
        firstSuccessAfterFailure()
    }
}

Терміни реалізації

Базовий конвеєр Build → Test → Deploy: 2–3 дні. Повна настройка з кількома середовищами, шаблонами та сповіщеннями: 5–7 днів.