AWS AppSync实时参考架构指南

AWS AppSync实时参考架构指南

1. 项目介绍

AWS AppSync 实时参考架构 是一个基于 AWS 的示例项目，展示了如何利用 GraphQL 和 WebSocket 实现两种类型的实时数据广播：从无服务器后端到所有客户端的一对多广播以及客户端之间的多对多交互。该项目集成了 Amazon DynamoDB、AWS Lambda 和 AWS AppSync 本地解析器（用于 Pub/Sub，不涉及数据持久化）。通过模拟电影票选与聊天室场景，演示了实时应用的构建方法，使用户能够投票并实时查看其他用户的活动。

2. 快速启动

准备工作

确保你有以下环境配置：

• TMDb API Key（免费非商业用途）
• AWS 账户及相应权限
• Node.js 及 NPM
• 配置为 JSON 输出的 AWS CLI
• AWS Amplify CLI
• AWS SAM CLI
• Create React App
• JQ 工具（Windows 用户需启用 WSL）

一键部署

点击此链接访问 GitHub 仓库，并在 README 中查找“快速链接”部分执行一键部署至 AWS Amplify Console。连接你的 GitHub 账号，授予必要的 IAM 角色，整个部署过程大约需要 10 分钟。

完成部署后，在 AWS AppSync 控制台中执行以下GraphQL mutation来设置初始数据结构：

mutation {
  createReviews(input: [
    {id: 1, type: "love", votes: 0, topMovie: "N/A", topVotes: 0},
    {id: 2, type: "like", votes: 0, topMovie: "N/A", topVotes: 0},
    // 同理创建其余三种情感的votes记录
  ]) {
    id
    type
    votes
    topMovie
    topVotes
  }
}

如果遇到速率限制问题，请使用个人的 TMDb API 导入本地项目，并参照手动设置流程进行。

手动设置

1. 克隆仓库：git clone https://github.com/aws-samples/appsync-refarch-realtime.git
2. 安装依赖：运行 npm install
3. 初始化 Amplify 项目：使用 amplify init 并选择React框架。
4. 云资源部署：执行 amplify push 接受默认选项。
5. 环境变量配置，包括TMDb API Key及AWS相关配置。

3. 应用案例和最佳实践

本项目展示了在不认证环境下使用公共API实现实时互动的策略，适用于如社交应用、协同编辑工具等场景。最佳实践包括使用AWS Secrets Manager或Parameter Store保护敏感信息，并在生产环境中实施IAM角色认证。

4. 典型生态项目

虽然此项目本身是作为一个独立的参考架构，但它融入了广泛的AWS服务生态系统，可以与AWS Lambda、Amazon DynamoDB和其他服务深度集成。开发者可以在自己的应用程序中复用这些模式，比如结合Amazon Cognito进行用户身份验证，或是利用AWS Lambda处理复杂的业务逻辑，构建高度可扩展且响应迅速的实时应用程序。

以上就是关于 AWS AppSync 实时参考架构 的概览，提供了快速上手的指导，以及如何将其应用于实际案例中。通过这个项目，开发者可以学习到如何有效利用AWS的服务来创建高效、实时的应用程序。