使用Granite项目快速搭建AWS基础设施指南

前言

Granite项目提供了一套完整的React Native应用CDN基础设施解决方案。本文将详细介绍如何在AWS上快速部署Granite所需的基础设施，包括S3存储桶和CloudFront CDN等核心组件。整个过程仅需约15分钟即可完成。

准备工作

在开始之前，请确保您已具备以下条件：

1. 有效的AWS账户
2. 管理员权限的IAM用户凭证
3. 本地开发环境（推荐使用Node.js 16+）

第一步：安装Pulumi CLI

Pulumi是一款基础设施即代码(IaC)工具，我们将使用它来定义和部署AWS资源。

根据您的操作系统选择安装方式：

# macOS用户
brew install pulumi

# Windows用户
winget install pulumi

# Linux用户
curl -fsSL https://get.pulumi.com | sh

安装完成后，验证安装是否成功：

pulumi version

第二步：配置AWS凭证

Pulumi需要访问您的AWS账户，有两种配置方式：

推荐方式：使用AWS CLI

1. 安装AWS CLI：

# macOS
brew install awscli

# Windows
winget install Amazon.AWSCLI

# Linux
apt install awscli

2. 配置凭证：

aws configure

按照提示输入您的AWS访问密钥、密钥、默认区域等信息。

替代方式：环境变量

临时设置凭证：

export AWS_ACCESS_KEY_ID="您的访问密钥ID"
export AWS_SECRET_ACCESS_KEY="您的密钥"
export AWS_REGION="您选择的区域"

第三步：创建基础设施项目

1. 创建项目目录：

mkdir granite-infra
cd granite-infra

2. 初始化Pulumi项目：

pulumi new aws-typescript

按照交互式提示输入项目名称、描述等信息。

第四步：安装Granite基础设施包

根据您使用的包管理器选择安装命令：

# npm用户
npm install @granite-js/pulumi-aws --save-dev

# pnpm用户
pnpm add @granite-js/pulumi-aws --save-dev

# yarn用户
yarn add @granite-js/pulumi-aws --dev

第五步：配置基础设施代码

修改项目中的index.ts文件，内容如下：

import * as pulumi from '@pulumi/pulumi';
import { ReactNativeBundleCDN } from '@granite-js/pulumi-aws';

const config = new pulumi.Config();

// 创建Granite CDN基础设施
const cdn = new ReactNativeBundleCDN('granite-cdn', {
  bucketName: config.require('bucketName'),
  region: config.require('region'),
});

// 导出CDN域名和存储桶名称
export const cdnUrl = cdn.cloudfrontDomain;
export const bucketName = cdn.bucketName;

第六步：设置配置参数

配置存储桶名称和区域（注意存储桶名称必须全局唯一）：

pulumi config set bucketName your-unique-bucket-name
pulumi config set region your-preferred-region

第七步：部署基础设施

执行部署命令：

pulumi up

Pulumi会显示将要创建的资源预览，确认无误后输入yes开始部署。

部署结果验证

成功部署后，您将获得：

1. 一个专用的S3存储桶，用于存储应用包
2. CloudFront CDN分发，确保全球快速访问
3. 完整的输出信息，包括CDN域名

资源清理（可选）

如需删除已部署的资源，执行：

pulumi destroy

最佳实践建议

1. 命名规范：为资源使用一致的命名前缀，便于管理
2. 区域选择：根据用户分布选择最近的AWS区域
3. 访问控制：为生产环境配置适当的IAM策略
4. 监控设置：启用CloudFront和S3的访问日志

常见问题解答

Q：为什么需要全局唯一的存储桶名称？ A：S3存储桶名称在AWS全局命名空间中必须唯一，这是AWS S3的设计要求。

Q：如何选择合适的AWS区域？ A：考虑因素包括：用户地理位置、区域服务可用性和成本差异。

Q：部署失败怎么办？ A：检查错误信息，常见原因包括权限不足或资源配额限制。

后续步骤

完成基础设施部署后，您可以：

1. 配置CI/CD流水线实现自动化部署
2. 设置缓存策略优化性能
3. 实现多环境部署（开发/测试/生产）

通过本指南，您已经成功搭建了Granite项目所需的AWS基础设施，为后续的应用部署打下了坚实基础。