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 — ми допоможемо уникнути типових помилок і прискорити розробку.