Настройка AWS SAM и деплой Serverless-бэкенда

Почему AWS SAM, а не Serverless Framework?

Мы перевели пять проектов с Serverless Framework на AWS SAM и каждый раз получали выигрыш: меньше костылей, прозрачный CloudFormation стек, нативная интеграция с CDK. SAM — это не очередной абстрактор, а официальный инструмент AWS, полностью совместимый с CloudFormation: на выходе полноценный стек, который версионируется и откатывается. Вместо 50 строк CloudFormation для Lambda + API Gateway + IAM Role пишется 10 строк SAM. Это сокращает время разработки бэкенда на 40% и снижает риск ошибок конфигурации. Типичный проект на SAM стоит на 30–50% дешевле аналога на Serverless Framework за счёт меньшего объёма кода и отсутствия плагинов.

Сертифицированные AWS-инженеры имеют 5 лет опыта в serverless-архитектурах и реализовали более 30 проектов на SAM. Мы гарантируем совместимость с вашим стеком и оптимизацию расходов — например, за счёт Graviton2 экономия на Lambda достигает 20%, а стоимость инфраструктуры снижается на 40% при миграции с EC2 на Lambda. Как говорит AWS: "SAM is the easiest way to build serverless applications".

Сравнение SAM и Serverless Framework

Как настроить CI/CD для SAM?

Непрерывная интеграция и доставка — обязательная часть продакшен-архитектуры. SAM отлично встраивается в любой популярный пайплайн: GitHub Actions, GitLab CI, AWS CodePipeline. Типовой сценарий: на push в ветку main запускается сборка (sam build) и деплой в окружение prod с автоматическим утверждением Change Set.

# .github/workflows/deploy.yml (фрагмент) - name: Configure AWS credentials uses: aws-actions/configure-aws-credentials@v4 with: role-to-assume: arn:aws:iam::123456789012:role/GitHubActions aws-region: eu-west-1 - name: SAM build and deploy run: | sam build sam deploy --no-confirm-changeset --no-fail-on-empty-changeset 

Для многоокружечной конфигурации используйте samconfig.toml с разными профилями. Откат выполняется стандартной командой CloudFormation rollback-stack — нулевой downtime.

Что входит в настройку SAM-бэкенда?

Наша работа включает полный цикл: от аудита текущей архитектуры до передачи документации.

• Архитектурный документ: схема сервисов, выбор Lambda-рантайма, расчёт памяти и таймаутов.
• Шаблон template.yaml: все ресурсы (Lambda, API Gateway, DynamoDB, SQS, S3) с политиками и переменными окружения.
• Исходный код Lambda: обработчики на TypeScript/Node.js 20, авторизатор JWT, middlewares, тесты.
• Конфигурация окружений: dev/staging/prod с разными стейджами, SSM-параметрами для секретов.
• CI/CD пайплайн: готовый workflow для GitHub Actions или GitLab CI.
• Документация и обучение: README с примерами вызовов, описанием переменных, инструкцией для разработчиков.
• Гарантия: после деплоя — неделя поддержки для исправления возможных инцидентов.

Быстрый старт: установка и структура

brew tap aws/tap brew install aws-sam-cli # или: pip install aws-sam-cli sam --version # SAM CLI, version 1.x sam init --runtime nodejs20.x --dependency-manager npm --app-template hello-world --name my-backend 

Структура проекта:

• template.yaml — SAM-шаблон
• samconfig.toml — конфиг деплоя
• src/handlers/ — обработчики (api.ts, auth.ts, worker.ts)
• src/shared/ — общий код (db.ts, response.ts)
• events/ — тестовые события
• __tests__/ — тесты

Настройка шаблона и обработчиков

Ключевые элементы template.yaml:

AWSTemplateFormatVersion: '2010-09-31' Transform: AWS::Serverless-2016-10-31 Description: My Web Backend Globals: Function: Runtime: nodejs20.x Architectures: [arm64] MemorySize: 512 Timeout: 10 Api: Cors: AllowMethods: "'*'" Resources: ApiGateway: Type: AWS::Serverless::HttpApi Properties: StageName: !Ref Stage Auth: DefaultAuthorizer: LambdaAuthorizer Authorizers: LambdaAuthorizer: FunctionArn: !GetAtt AuthFunction.Arn ApiFunction: Type: AWS::Serverless::Function Properties: Handler: src/handlers/api.handler Events: AnyRoute: Type: HttpApi Properties: ApiId: !Ref ApiGateway Method: ANY Path: /api/{proxy+} Policies: - DynamoDBCrudPolicy: TableName: !Ref MainTable Metadata: BuildMethod: esbuild BuildProperties: Minify: true Target: es2022 

Пример Lambda Authorizer:

import { verify } from 'jsonwebtoken'; export const handler = async (event) => { const token = event.headers?.authorization?.replace('Bearer ', ''); if (!token) return { isAuthorized: false }; try { const payload = verify(token, process.env.JWT_SECRET!); return { isAuthorized: true, context: { userId: String(payload.sub) } }; } catch { return { isAuthorized: false }; } }; 

Как оптимизировать затраты на SAM?

• Используйте Graviton2 (arm64) — экономия до 20% на Lambda.
• Устанавливайте Provisioned Concurrency только для критических функций.
• Настройте CloudWatch Lambda Insights для мониторинга и выявления неэффективных запросов.
• Выносите статику в S3 + CloudFront, не нагружайте API Gateway.
• Оптимизируйте размер деплой-пакета: esbuild минификация, tree-shaking.

Локальная разработка и CI/CD

Для локального запуска используем sam local start-api с моком DynamoDB через Docker. Конфигурация окружений задаётся в samconfig.toml:

[default.deploy.parameters] stack_name = "my-backend-dev" s3_bucket = "artifacts-bucket" region = "eu-west-1" parameter_overrides = "Stage=dev" 

Деплой выполняется командами:

sam build && sam deploy --config-env dev # или для prod sam build && sam deploy --config-env prod 

Процесс включает сборку (esbuild минификация), генерацию Change Set и применение. Откат — стандартная CloudFormation команда rollback-stack.

Процесс и сроки

Базовый SAM-бэкенд с одним Lambda и DynamoDB — 1–2 дня. Полноценная архитектура с авторизатором, фоновыми воркерами и несколькими окружениями — 4–5 дней. Адаптация существующего кода на Express/Fastify — 3–5 дней.

Свяжитесь с нами для оценки вашего проекта — наши инженеры проанализируют текущую архитектуру и подготовят коммерческое предложение. Закажите настройку AWS SAM под ключ — мы возьмём на себя всю инфраструктуру, от шаблонов до CI/CD.