Pi-Delivery 开源项目最佳实践教程

1. 项目介绍

Pi-Delivery 是 Google Cloud DevRel 团队为庆祝 Pi 日而创建的一个演示网站项目。该项目包括一个运行在 Google Cloud Functions 中的 Go 服务器，使用 Terraform 管理云配置，前端则是使用 Jekyll 和 React 开发的。该项目旨在展示如何将不同技术栈和 Google Cloud 服务集成到一个项目中。

2. 项目快速启动

环境准备

• 安装 Go
• 安装 Yarn
• 安装 Ruby
• 安装 Firebase CLI

部署服务器

# 初始化 Terraform
terraform init

# 应用 Terraform 配置
terraform apply

# 设置环境变量
export PROJECT=piaas-gcp
export REGIONS=(us-central1 europe-west1 asia-northeast1)
export STAGE_BUCKET=piaas-gcp-gcf-staging
export GCF_API_SA=[e-mail]

# 部署到 Cloud Functions
gcloud beta functions deploy api-pi --gen2 --runtime go116 --trigger-http --entry-point Get --source . --stage-bucket $STAGE_BUCKET --ingress-settings=internal-and-gclb --region $REGIONS --allow-unauthenticated --service-account $GCF_API_SA --project $PROJECT

构建和部署前端

# 安装依赖
yarn
bundle

# 启动开发服务器
yarn serve

# 构建生产环境文件
yarn prod

# 部署到 Firebase Hosting
firebase login
export PROJECT=piaas-gcp
firebase hosting:channel:deploy preview --project $PROJECT

3. 应用案例和最佳实践

• 持续集成与持续部署（CI/CD）：使用 Cloud Build 或 GitHub Actions 自动化构建和部署流程。
• 日志与监控：通过 Stackdriver Logging 和 Monitoring 对应用进行日志记录和监控。
• 安全性：利用 Cloud Functions 的 IAM 角色和权限管理，确保最小权限原则。
• 性能优化：利用 Terraform 进行基础设施即代码管理，优化资源分配。

4. 典型生态项目

• 前端框架：使用 React 或 Vue.js 等现代前端框架构建用户界面。
• 后端服务：利用 Node.js 或 Python 等语言构建 RESTful API。
• 云数据库：使用 Firestore 或 MongoDB Atlas 等云数据库服务存储数据。
• 云存储：利用 Google Cloud Storage 存储静态文件和媒体内容。