Lambda-Serverless-Search 使用教程

本指南将引导您了解 Lambda-Serverless-Search 项目，一个利用 AWS Lambda 实现的无服务器全文搜索服务。此项目旨在提供一种成本效益高的搜索解决方案，特别适合那些不需要复杂搜索引擎功能的场景。

1. 项目目录结构及介绍

项目的基本目录布局如下：

.
├── README.md                # 项目说明文件
├── LICENSE                  # 许可证文件
├── template.yaml             # AWS Serverless Application Model (SAM) 配置模板
├── src                      # 源代码目录
│   ├── handlers              # 包含处理程序的目录，如搜索、索引构建等
│       └── indexBuild.js     # 负责当新CSV文件上传至S3时触发的索引构建函数
│       └── ...               # 其它处理程序文件
├── s3                       # 可选，可能用于存放S3相关的配置或示例文件
├── imgs                     # 图片资源（如果有的话）
├── sample-indexer           # 示例索引数据或脚本
├── movies.json               # 示例数据文件
├── serverless-search-details.pptx # 项目详细演示或讲解PPT（非源码相关）
└── ...

• README.md: 提供了项目概述和快速入门指引。
• LICENSE: 项目使用的开源许可协议。
• template.yaml: 核心配置文件，定义AWS Lambda函数、API Gateway等云资源和服务。
• src/handlers: 包含所有Lambda函数逻辑的代码，如用于创建索引的处理程序。
• sample-indexer: 可能包含了用于测试或初始化索引的数据或脚本。

2. 项目的启动文件介绍

在本项目中，虽然没有单一的“启动文件”，但关键的执行起点是通过部署template.yaml定义的服务到AWS环境中。以下是简化的操作流程，以模拟一个“启动”过程：

1. 环境准备：确保安装了AWS CLI，Node.js及其NPM（用于管理依赖），以及Serverless Framework (serverless命令行工具)。

2. 安装依赖：在项目根目录运行npm install来获取必要的库和框架。

3. 部署：使用Serverless框架进行部署，命令为：

   sls deploy
   

   此命令会依据template.yaml文件中的定义，在AWS上部署Lambda函数和相关的资源。

3. 项目的配置文件介绍

template.yaml

• 核心配置：此文件是AWS Serverless Application Model (SAM) 的配置文件，它描述了整个应用的云资源，包括AWS Lambda函数、API Gateway、事件触发器（如S3上传事件）等。

• 资源定义：

  • AWS::S3::Bucket: 定义存储CSV文件和索引的S3桶，并启用EventBridge监听新文件上传。
  • AWS::Lambda::Function: 定义Lambda函数，包括其运行时、内存大小、执行时间限制、关联的处理程序路径等。
  • AWS::ApiGateway::RestApi: 创建API网关，使得外部可以通过HTTP请求触发Lambda函数实现搜索功能。

• 事件绑定：如何让Lambda响应特定事件，例如S3的新对象创建事件自动触发索引重建过程。

完成上述步骤后，您的无服务器搜索服务即部署完毕，能够响应查询并从索引中返回结果。请参考项目中的具体文档和注释，对每个部分进行更详细的调整和优化以满足实际需求。