Почему 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".
Почему Graviton2?
Процессоры AWS Graviton2 на архитектуре ARM64 обеспечивают до 20% лучшей производительности за ту же цену по сравнению с x86. SAM позволяет выбрать архитектуру в шаблоне одной строкой.Сравнение SAM и Serverless Framework
| Критерий | AWS SAM | Serverless Framework |
|---|---|---|
| Абстракция | Прямое расширение CloudFormation | Собственный синтаксис с провайдерами |
| Размер шаблона | 10 строк для простой функции | 15–20 строк с плагинами |
| Интеграция с AWS | Нативная, полная поддержка сервисов | Требуются плагины для некоторых сервисов |
| Локальная разработка | SAM CLI + Docker | serverless-offline |
| Версионирование стека | CloudFormation Change Sets | Отдельные инструменты |
Как настроить 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.
Процесс и сроки
| Этап | Длительность | Результат |
|---|---|---|
| Анализ архитектуры | 0.5–1 день | Документ с рекомендациями |
| Проектирование SAM-шаблонов | 1–2 дня | template.yaml, samconfig.toml |
| Реализация Lambda-функций | 2–3 дня | handlers, shared-слой, тесты |
| Интеграция с сервисами | 1–2 дня | DynamoDB, SQS, S3, API Gateway |
| Тестирование и отладка | 1–2 дня | Unit и интеграционные тесты |
| Деплой и CI/CD | 1 день | Pipeline (GitHub Actions / GitLab CI) |
| Документация и обучение | 0.5 дня | README, примеры вызовов |
Базовый SAM-бэкенд с одним Lambda и DynamoDB — 1–2 дня. Полноценная архитектура с авторизатором, фоновыми воркерами и несколькими окружениями — 4–5 дней. Адаптация существующего кода на Express/Fastify — 3–5 дней.
Свяжитесь с нами для оценки вашего проекта — наши инженеры проанализируют текущую архитектуру и подготовят коммерческое предложение. Закажите настройку AWS SAM под ключ — мы возьмём на себя всю инфраструктуру, от шаблонов до CI/CD.