Serverless функции на Swift в AWS Lambda: полное руководство

Введение в Serverless функции на Swift с AWS Lambda

Serverless-архитектура продолжает набирать популярность среди разработчиков, и теперь Swift — не исключение. Благодаря поддержке Swift на платформе AWS Lambda, разработчики iOS и macOS могут писать облачные функции на родном языке, используя всю мощь экосистемы Swift. В этой статье мы разберём, как создать, настроить и развернуть serverless функцию на Swift с нуля.

Serverless-функции позволяют запускать код без управления серверами. Вы платите только за время выполнения, а масштабирование происходит автоматически. AWS Lambda поддерживает Swift через официальные runtime-образы, что делает его отличным выбором для backend-задач в экосистеме Apple.

Подготовка окружения для разработки Swift на AWS Lambda

Установка необходимых инструментов

Перед началом работы убедитесь, что у вас установлены:

• Swift 5.9+ — скачать можно с swift.org
• Docker — для сборки в Linux-окружении
• AWS CLI — для деплоя
• Xcode 15+ (опционально, для macOS)

Создание проекта Swift Package

Создадим новый Swift Package с поддержкой AWS Lambda:

mkdir MyLambdaFunction
cd MyLambdaFunction
swift package init --type executable

Откройте Package.swift и добавьте зависимость от AWSLambdaRuntime:

// swift-tools-version: 5.9
import PackageDescription

let package = Package(
    name: "MyLambdaFunction",
    platforms: [.macOS(.v13)],
    dependencies: [
        .package(url: "https://github.com/swift-server/swift-aws-lambda-runtime.git", from: "1.0.0")
    ],
    targets: [
        .executableTarget(
            name: "MyLambdaFunction",
            dependencies: [
                .product(name: "AWSLambdaRuntime", package: "swift-aws-lambda-runtime")
            ]
        )
    ]
)

Написание первой Serverless функции на Swift

Базовая структура Lambda-функции

Создадим файл Sources/MyLambdaFunction/main.swift со следующим содержимым:

import AWSLambdaRuntime
import AWSLambdaEvents

// Определяем структуру запроса
struct GreetingRequest: Codable {
    let name: String
}

// Определяем структуру ответа
struct GreetingResponse: Codable {
    let message: String
    let timestamp: String
}

// Основной обработчик
@main
struct MyLambdaHandler: SimpleLambdaHandler {
    typealias Event = GreetingRequest
    typealias Output = GreetingResponse
    
    func handle(_ event: GreetingRequest, context: LambdaContext) async throws -> GreetingResponse {
        let dateFormatter = DateFormatter()
        dateFormatter.dateFormat = "yyyy-MM-dd HH:mm:ss"
        
        return GreetingResponse(
            message: "Привет, \(event.name)! Добро пожаловать в мир Serverless на Swift.",
            timestamp: dateFormatter.string(from: Date())
        )
    }
}

Обработка HTTP-запросов (API Gateway)

Для работы с API Gateway используем APIGatewayV2Request:

import AWSLambdaRuntime
import AWSLambdaEvents

@main
struct HTTPHandler: SimpleLambdaHandler {
    typealias Event = APIGatewayV2Request
    typealias Output = APIGatewayV2Response
    
    func handle(_ event: APIGatewayV2Request, context: LambdaContext) async throws -> APIGatewayV2Response {
        // Получаем данные из query-параметров
        let name = event.queryStringParameters?["name"] ?? "Гость"
        
        let responseBody = """
        {
            "message": "Hello, \(name)!",
            "path": "\(event.rawPath)"
        }
        """
        
        return APIGatewayV2Response(
            statusCode: .ok,
            headers: ["Content-Type": "application/json"],
            body: responseBody
        )
    }
}

Сборка и деплой Swift-функции в AWS Lambda

Сборка для Linux (Amazon Linux 2)

Поскольку Lambda работает на Linux, нам нужно собрать бинарник под Linux. Используем Docker:

docker run --rm \
  -v "$PWD":/workspace \
  -w /workspace \
  swift:5.9-amazonlinux2 \
  swift build -c release --static-swift-stdlib

После сборки бинарник будет находиться в .build/release/MyLambdaFunction.

Упаковка и деплой

Создадим ZIP-архив с бинарником:

zip -j lambda_function.zip .build/release/MyLambdaFunction

Теперь загрузим функцию в AWS Lambda:

aws lambda create-function \
  --function-name MySwiftFunction \
  --runtime provided.al2 \
  --role arn:aws:iam::YOUR_ACCOUNT_ID:role/lambda-execution-role \
  --handler provided \
  --zip-file fileb://lambda_function.zip

Важно: Укажите правильный ARN IAM-роли с правами на выполнение Lambda.

Обновление существующей функции

aws lambda update-function-code \
  --function-name MySwiftFunction \
  --zip-file fileb://lambda_function.zip

Продвинутые техники и лучшие практики

Работа с окружением и секретами

Используйте переменные окружения для конфигурации:

struct Config {
    static let databaseURL: String = {
        guard let url = ProcessInfo.processInfo.environment["DATABASE_URL"] else {
            fatalError("DATABASE_URL not set")
        }
        return url
    }()
}

@main
struct SecureHandler: SimpleLambdaHandler {
    typealias Event = APIGatewayV2Request
    typealias Output = APIGatewayV2Response
    
    func handle(_ event: APIGatewayV2Request, context: LambdaContext) async throws -> APIGatewayV2Response {
        // Используем конфигурацию
        let dbURL = Config.databaseURL
        // ... логика работы с БД
        return APIGatewayV2Response(statusCode: .ok, body: "{\"status\": \"OK\"}")
    }
}

Обработка ошибок

enum LambdaError: Error {
    case invalidInput(String)
    case databaseError(String)
}

@main
struct ErrorHandlingHandler: SimpleLambdaHandler {
    typealias Event = [String: String]
    typealias Output = APIGatewayV2Response
    
    func handle(_ event: [String: String], context: LambdaContext) async throws -> APIGatewayV2Response {
        guard let userId = event["userId"], !userId.isEmpty else {
            throw LambdaError.invalidInput("userId обязателен")
        }
        
        // Логируем ошибки
        context.logger.error("Processing request for user: \(userId)")
        
        return APIGatewayV2Response(statusCode: .