Serverless Framework под ключ: конфигурация, CI/CD и оптимизация

Вы потратили неделю на настройку Serverless Framework, а при первом деплое Lambda функции не стартуют — ошибка 502, в CloudWatch пусто. Знакомо? Мы развернули 50+ serverless-проектов на AWS, GCP и Azure, и каждый раз сталкивались с одними и теми же граблями: кривые IAM-роли, забытые переменные окружения, неоптимальная сборка с гигантским cold start. По нашим данным, правильно настроенный serverless-стек снижает затраты на инфраструктуру в 3–5 раз, но только если конфигурация выполнена без ошибок. В этой статье мы разберём каждый шаг: от установки до CI/CD, с реальными конфигурациями и проверенными практиками. Вы узнаете, как избежать типичных ошибок, ускорить холодный старт на 40% и организовать безопасное хранение секретов. Мы опираемся на опыт 50+ проектов и постоянно обновляем конфигурации под последние версии плагинов и runtime.

Как настроить Serverless Framework за 1 день?

Установка и базовая структура

npm install -g serverless serverless --version # 3.x или 4.x serverless create --template aws-nodejs-typescript --path my-service cd my-service npm install 

Структура проекта включает папку src/functions/ с обработчиками и src/libs/ для вспомогательных модулей. Файл serverless.yml — сердце конфигурации.

Что такое холодный старт и как с ним бороться?

Холодный старт — время от первого запроса до выполнения handler'а, вызванное инициализацией runtime и загрузкой кода. Наши тесты показывают, что при неоптимальной сборке cold start достигает 500 мс. Используйте esbuild с tree shaking — это уменьшает бандл на 30% и снижает холодный старт до 100-200 мс. Исключайте встроенные зависимости, такие как @aws-sdk/*, которые уже есть в окружении Lambda. Для функций с высокими требованиями к скорости применяйте Provisioned Concurrency (до 300% стоимости, но cold start = 0).

serverless.yml — правильная конфигурация

service: my-web-service frameworkVersion: '3' plugins: - serverless-esbuild - serverless-offline - serverless-dotenv-plugin provider: name: aws runtime: nodejs20.x region: eu-west-1 stage: ${opt:stage, 'dev'} memorySize: 512 timeout: 10 logRetentionInDays: 14 environment: NODE_ENV: ${self:provider.stage} DB_PASSWORD: ${ssm:/my-service/${self:provider.stage}/db-password~true} API_KEY: ${ssm:/my-service/api-key~true} iam: role: statements: - Effect: Allow Action: [s3:GetObject, s3:PutObject] Resource: 'arn:aws:s3:::${self:custom.bucketName}/*' - Effect: Allow Action: [dynamodb:Query, dynamodb:PutItem, dynamodb:UpdateItem] Resource: !GetAtt UsersTable.Arn httpApi: cors: allowedOrigins: ['https://my-site.com', 'http://localhost:3000'] allowedHeaders: ['Content-Type', 'Authorization'] allowedMethods: [GET, POST, PUT, DELETE] custom: bucketName: my-service-${self:provider.stage}-assets esbuild: bundle: true minify: ${strToBool(${ssm:/my-service/minify, 'false'})} sourcemap: true target: node20 platform: node concurrency: 10 external: - '@aws-sdk/*' - 'pg-native' serverless-offline: httpPort: 3001 lambdaPort: 3002 functions: - ${file(src/functions/api/index.ts)} - ${file(src/functions/worker/index.ts)} resources: Resources: UsersTable: Type: AWS::DynamoDB::Table Properties: TableName: ${self:service}-${self:provider.stage}-users BillingMode: PAY_PER_REQUEST AttributeDefinitions: - AttributeName: pk AttributeType: S - AttributeName: sk AttributeType: S KeySchema: - AttributeName: pk KeyType: HASH - AttributeName: sk KeyType: RANGE TimeToLiveSpecification: AttributeName: ttl Enabled: true 

Конфигурация функции и middleware

// src/functions/api/index.ts import type { AWS } from '@serverless/typescript'; const apiFunction: AWS['functions'] = { api: { handler: 'src/functions/api/handler.main', events: [{ httpApi: { method: 'ANY', path: '/api/{proxy+}', authorizer: { name: 'jwtAuthorizer', type: 'jwt', identitySource: '$request.header.Authorization', issuerUrl: 'https://cognito-idp.eu-west-1.amazonaws.com/${env:COGNITO_POOL_ID}', audience: ['${env:COGNITO_CLIENT_ID}'], }, }, }], environment: {}, }, }; export default apiFunction; // src/libs/lambda.ts import middy from '@middy/core'; import middyJsonBodyParser from '@middy/http-json-body-parser'; import httpErrorHandler from '@middy/http-error-handler'; import cors from '@middy/http-cors'; import type { APIGatewayProxyEventV2, APIGatewayProxyStructuredResultV2 } from 'aws-lambda'; type Handler = (event: APIGatewayProxyEventV2) => Promise<APIGatewayProxyStructuredResultV2>; export const middyfy = (handler: Handler) => middy(handler) .use(middyJsonBodyParser()) .use(httpErrorHandler()) .use(cors({ origin: process.env.ALLOWED_ORIGIN ?? '*' })); 

Как управлять окружениями эффективно?

Используйте разные стейджи и SSM Parameter Store для безопасного хранения секретов. Параметры с шифрованием добавляются суффиксом ~true. Для локальной разработки запускайте serverless offline start, а для тестирования отдельной функции — serverless invoke local --function. Не храните секреты в Git — это одна из самых частых ошибок, приводящих к утечкам.

Почему esbuild — лучший выбор для сборки?

По данным AWS Serverless Developer Guide, esbuild с tree shaking уменьшает размер бандла до 40% и снижает cold start. В отличие от webpack, он работает в 10-100 раз быстрее и не требует сложной конфигурации. Для native-библиотек, таких как sharp, создавайте Lambda Layer — это позволяет держать их отдельно и обновлять независимо.

mkdir -p layer/nodejs cd layer/nodejs npm install sharp 

Подключение слоя:

layers: sharp: path: layer compatibleRuntimes: [nodejs20.x] 

Сравнение Serverless vs VPS

При нестабильной нагрузке serverless экономит до 5 раз по сравнению с VPS. Для постоянного трафика >1000 запросов/с VPS может быть дешевле.

Популярные плагины Serverless Framework

CI/CD для Serverless Framework

Настройте GitHub Actions или GitLab CI для автоматического деплоя на разные стейджи. В workflow укажите шаги: checkout, установка зависимостей, деплой через npx serverless deploy --stage prod. Секреты храните в GitHub Secrets или GitLab CI Variables. Типичный pipeline dev → staging → prod занимает 2-3 минуты.

Что входит в настройку под ключ?

• Конфигурация serverless.yml с IAM, VPC, окружениями
• Оптимизация сборки (esbuild, tree shaking, Lambda Layers)
• CI/CD (GitHub Actions / GitLab CI) для dev/staging/prod
• Управление секретами через SSM или Secrets Manager
• Документация с архитектурной схемой
• Обучение команды
• Поддержка после деплоя

Сроки

Базовая настройка с одной функцией и деплоем — 1 день. Полноценная инфраструктура с несколькими функциями, DynamoDB, SSM и CI/CD — 3–4 дня. Миграция с Express — 1–2 недели. Стоимость рассчитывается индивидуально в зависимости от сложности и объёма работ.

Свяжитесь с нами для аудита вашей serverless-архитектуры. Получите консультацию по настройке Serverless Framework — мы поможем избежать типичных ошибок и ускорить разработку.