pi-delivery 的安装和配置教程

1、项目的基础介绍和主要的编程语言 pi-delivery 是一个开源项目，它使用 Go 语言编写，并运行在 Google Cloud Functions 上。这个项目是 Google Cloud DevRel 团队为了庆祝 Pi Day 而创建的演示站点。

2、项目使用的关键技术和框架 pi-delivery 使用了多种关键技术和框架，包括：

• Go 语言：用于编写服务器端代码。
• Cloud Functions：Google Cloud Platform 的无服务器计算服务，用于运行 Go 语言编写的代码。
• Terraform：用于管理 Google Cloud Platform 的基础设施配置。
• Firebase Hosting：用于托管前端文件。

3、项目安装和配置的准备工作和详细的安装步骤 准备工作：

• 确保您有一个 Google Cloud Platform 账户，并且已经创建了相应的项目。
• 安装 Yarn、Ruby 和 Firebase CLI。
• 安装 gcloud 命令行工具。

安装步骤：

1. 克隆项目仓库：

   git clone https://github.com/GoogleCloudPlatform/pi-delivery.git
   cd pi-delivery
   

2. 配置 Google Cloud Functions：

   • 设置环境变量：

     export PROJECT=your-gcp-project-id
     export REGIONS=(us-central1 europe-west1 asia-northeast1)
     export STAGE_BUCKET=your-gcp-bucket
     export GCF_API_SA=your-gcp-service-account
     

   • 部署 staging 环境：

     gcloud beta functions deploy api-pi-staging --gen2 --runtime go116 --trigger-http --entry-point Get --source . --stage-bucket=$STAGE_BUCKET --ingress-settings=internal-and-gclb --region=$REGIONS[1] --allow-unauthenticated --service-account=$GCF_API_SA --project=$PROJECT
     

   • 部署 production 环境：

     for R in $REGIONS; do
       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=$R --allow-unauthenticated --service-account=$GCF_API_SA --min-instances=1 --project=$PROJECT
     done
     

3. 配置 Terraform：

   • 初始化 Terraform：

     terraform init
     

   • 应用 Terraform 配置：

     terraform apply
     

4. 配置 Firebase Hosting：

   • 安装 Firebase CLI：

     npm install -g firebase-tools
     

   • 登录 Firebase：

     firebase login
     

   • 生成前端文件：

     yarn prod
     

   • 在本地测试配置：

     export PROJECT=your-gcp-project-id
     firebase emulators:start --project=$PROJECT
     

   • 创建预览渠道：

     export CHANNEL_ID=preview
     firebase hosting:channel:deploy $CHANNEL_ID --project=$PROJECT
     

   • 发布预览：

     firebase hosting:clone $PROJECT:$CHANNEL_ID $PROJECT:live
     

完成以上步骤后，您的 pi-delivery 项目应该已经成功安装和配置。