Granite项目快速部署指南：5分钟将应用上线AWS

前言

在现代移动应用开发中，快速部署和全球分发能力至关重要。Granite项目提供了一套完整的解决方案，让开发者能够在5分钟内将应用部署到AWS云平台，并借助CloudFront CDN实现全球分发。本文将详细介绍如何使用Granite工具链完成这一过程。

部署原理概述

Granite的部署过程基于以下核心技术组件：

1. AWS S3存储桶：作为静态资源的存储后端
2. CloudFront CDN：实现全球内容分发网络
3. 微服务架构：应用被打包为优化的微服务bundle

部署后，您的应用将具备以下特性：

• 全球内容分发加速
• 即时更新能力
• 按版本灰度发布

准备工作

在开始部署前，请确保已完成以下步骤：

1. 项目初始化：已完成Granite应用的创建和本地开发
2. AWS基础设施配置：已设置好S3存储桶和CloudFront分发

详细部署步骤

第一步：构建生产版本

构建过程会将您的应用代码优化为适合生产环境的bundle：

# 根据您使用的包管理器选择相应命令
npm run build
# 或
yarn build
# 或
pnpm run build

成功构建后，项目目录下会生成dist/文件夹，包含优化后的bundle文件。理想情况下，每个bundle大小应控制在300KB以内，这是Granite微服务架构的优势之一。

第二步：安装Granite Forge CLI

Forge CLI是Granite的部署工具，提供简洁的命令行接口：

npm install @granite-js/forge-cli --save-dev
# 或使用其他包管理器对应命令

第三步：执行部署命令

使用Forge CLI将bundle部署到AWS：

npx granite-forge deploy --bucket 您的S3存储桶名称

部署过程会显示详细日志，包括：

• 部署状态检查
• bundle上传进度
• 部署ID生成

成功部署后，您将获得CDN访问URL，这是后续访问应用的入口。

第四步：测试已部署应用

Granite提供了测试应用来验证部署结果。您需要提供以下信息：

1. CDN URL：部署命令输出的访问地址
2. URL Scheme：格式为{scheme}://{appName}，可在项目的granite.config.ts配置文件中找到

// granite.config.ts示例
export default defineConfig({
  scheme: 'granite',    // 自定义scheme
  appName: 'showcase',  // 应用名称
  // 其他配置...
});

测试应用会加载CDN上的bundle，验证部署是否成功。

部署架构详解

URL结构设计

Granite采用智能URL路由机制，结构如下：

https://<cdn-domain>/[platform]/[appName]/[version]/bundle

其中：

• platform：平台标识（ios/android）
• appName：应用名称
• version：版本号（1-1000）

版本控制机制

Granite的版本号系统支持精细的灰度发布：

• 版本号范围1-1000对应0.1%-100%的用户覆盖率
• 可通过简单调整版本号实现渐进式发布
• 支持多版本共存，便于A/B测试

部署后管理

成功部署后，您可以：

1. 即时更新：修改代码后重新构建部署，用户无需等待应用商店审核
2. 全球内容分发：借助CloudFront的全球节点，用户无论身处何地都能获得快速响应
3. 版本回滚：通过调整版本号快速回退到稳定版本

最佳实践建议

1. 保持bundle精简：定期检查bundle大小，确保不超过300KB
2. 版本管理策略：建议采用渐进式发布，先小范围测试再全量
3. CDN缓存策略：Granite已配置最优缓存策略，无需额外调整

结语

通过Granite的部署系统，开发者可以轻松实现企业级应用的全球分发。整个过程简单高效，无需复杂的基础设施管理经验。现在，您的应用已经准备好面向全球用户了！