安排 Filestore Enterprise 快照的创建时间

部署模型

下图显示了支持 Filestore 快照 Cloud Run 函数的部署模型。

Cloud Scheduler 作业会与 Cloud Run 函数协同工作，以安排和生成 Filestore 快照和日志文件。快照可在 Filestore 共享中使用。

已知限制

准备为 Filestore 实例配置快照调度程序时，请考虑以下限制：

• 该函数仅在需要时删除单个快照，即使调度程序快照数量多于保留政策配置文件中定义的数量，或者保留政策配置文件已更新为保留的快照数量少于之前，也是如此。
• 如果您在 JSON 配置文件中降低 snapshots 的数值，系统不会自动删除实例中的多余快照。如果您更改此设置，则需要手动删除多余的快照。
• 由于快照 ID 的长度限制为 75 个字符，因此保留期限政策名称的长度限制为 50 个字符。

准备环境

在本部分中，您将设置环境变量、克隆代码库，并创建本教程所需的应用和文件。

设置环境变量

• 在 Cloud Shell 中，输入以下命令：

gcloud components update

• 在 Cloud Shell 中，创建以下变量：

  export PROJECT_ID=PROJECT_ID
  export GCP_REGION=GCP_REGION
  export APP_ENGINE_REGION=APP_ENGINE_REGION
  export FUNCTION_NAME=FUNCTION_NAME
  export SCHEDULER_NAME=SCHEDULER_NAME
  export SCHEDULER_EXPRESSION="SCHEDULER_EXPRESSION"
  export SCHEDULER_TZ=SCHEDULER_TZ
  export SERVICE_ACCOUNT_NAME=SERVICE_ACCOUNT_NAME
  

  替换以下内容：

  • PROJECT_ID：您要安装 Filestore Enterprise 实例、Cloud Run 函数和 Cloud 调度程序的 Google Cloud 项目 ID。
  • GCP_REGION：您要安装 Filestore Enterprise 实例、Cloud Run 函数和 Cloud Scheduler 的 Google Cloud 区域。
  • APP_ENGINE_REGION：您要安装 App Engine 的 App Engine 位置列表中的区域。请考虑以下要求：
    • 一个 Google Cloud 项目只能有一个 App Engine 实例，并且 App Engine 区域以后无法更改。
    • Cloud Scheduler 作业和 App Engine 实例必须位于同一区域。
      • 例如，如果 Cloud Scheduler 资源使用 us-central1，请使用 App Engine 等效的 us-central。
      • App Engine 会对某些区域采用独特的命名惯例。如需了解详情，请参阅 App Engine 位置列表。
  • FUNCTION_NAME：您要为 Cloud Run 函数指定的名称。
  • SCHEDULER_NAME：您要为 Cloud Scheduler 提供的名称。
  • SCHEDULER_EXPRESSION：Cloud Scheduler cron 表达式，例如 10 0 * * *。如需了解详情，请参阅配置 Cron 作业时间表。
  • SCHEDULER_TZ：Cloud Scheduler 的时区，采用 tz 数据库时区列表中的名称格式，例如 America/Los_Angeles。
  • SERVICE_ACCOUNT_NAME：新创建的服务账号名称，例如 scheduler-sa。

创建服务账号

在本部分中，您将创建一个专用服务账号，以便创建和管理 Cloud Run 函数和 Cloud Scheduler 作业。

执行此过程时，服务账号需要具有以下权限：

• file.instances.get
• file.snapshots.list
• file.snapshots.create
• file.operations.get
• file.snapshots.delete
• cloudfunctions.functions.invoke

如需了解详情，请参阅 Filestore IAM 权限或 Cloud Run Functions IAM 权限。

要创建服务账号，请执行以下操作：

1. 在 Cloud Shell 中，为快照调度程序创建一个具有所需权限的专用角色：

   gcloud iam roles create snapshot_scheduler --project $PROJECT_ID --permissions file.instances.get,file.snapshots.list,file.snapshots.create,file.operations.get,file.snapshots.delete,logging.logEntries.create,cloudfunctions.functions.invoke --stage GA
   

2. 创建服务账号：

   gcloud iam service-accounts create $SERVICE_ACCOUNT_NAME --project $PROJECT_ID
   

3. 将角色绑定到服务账号：

   gcloud projects add-iam-policy-binding $PROJECT_ID --member serviceAccount:$SERVICE_ACCOUNT_NAME@$PROJECT_ID.iam.gserviceaccount.com --role projects/$PROJECT_ID/roles/snapshot_scheduler
   

创建 Filestore Enterprise 实例

1. 如果您尚未为要使用的 Filestore Enterprise 实例创建环境变量，请在 Cloud Shell 中创建以下变量：

   export FILESTORE_INSTANCE_ID=FILESTORE_INSTANCE_ID
   export FILESTORE_SHARE_NAME=SHARE_NAME
   export FILESTORE_SHARE_SIZE=NUMERIC_IN_GB
   export NETWORK_NAME=VPC_NAME
   

   替换以下内容：

   • FILESTORE_INSTANCE_ID：Filestore Enterprise 实例名称
   • SHARE_NAME：Filestore Enterprise 实例共享名称
   • NUMERIC_IN_GB：Filestore Enterprise 实例共享大小，介于 1024 和 10240 之间的数字，增量为 256
   • VPC_NAME：您要安装 Filestore Enterprise 实例的 VPC 网络的名称

2. 如果您还没有 Filestore 实例，请创建一个：

   gcloud filestore instances create $FILESTORE_INSTANCE_ID --network name=$NETWORK_NAME --file-share=capacity=$FILESTORE_SHARE_SIZE,name=$FILESTORE_SHARE_NAME --tier ENTERPRISE --project=$PROJECT_ID --location=$GCP_REGION
   

如需了解详情，请参阅创建实例。

创建 App Engine

在本部分中，您将为 Google Cloud 项目创建 App Engine。这样，您就可以在本教程稍后部分创建 Cloud Scheduler 作业。

一个 Google Cloud 项目只能有一个 App Engine，并且该区域以后无法更改。

• 如果您还没有 App Engine，请在 Cloud Shell 中创建一个：

  gcloud app create --region=$APP_ENGINE_REGION --project=$PROJECT_ID
  

创建 JSON 配置文件

由于 Cloud Run functions 函数的限制，JSON 配置文件最多可以包含 8 个 Filestore 实例。如果您有超过 8 个 Filestore 实例需要安排快照，请使用其他 Cloud Scheduler 作业。

• 在 Cloud Shell 中，创建一个名为 request.json 的新文件，并根据您的环境修改内容：

  {
              "retention_policy": "RETENTION_NAME",
              "instances": [
                  {"instance_path": "projects/PROJECT_ID/locations/GCP_REGION/instances/FILESTORE_INSTANCE_ID/",
                      "snapshots": NUMBER_OF_SNAPSHOTS
                  }
              ]
  }
  

  替换以下内容：

  • RETENTION_NAME：快照保留类型的名称，该名称将成为快照名称的一部分，例如 daily。
  • NUMBER_OF_SNAPSHOTS：快照数量。

克隆存储库

克隆实验代码库，然后进入该目录：

1. 在 Cloud Shell 中，克隆实验代码库：

   git clone https://github.com/GoogleCloudPlatform/Filestore-Snapshot-Scheduler
   

   输出类似于以下内容：

   Cloning into Filestore-Snapshot-Scheduler
   

2. 进入该目录：

   cd Filestore-Snapshot-Scheduler
   

创建 Cloud Run 函数

在 Cloud Shell 中，创建 Cloud Run 函数解决方案：

gcloud functions deploy $FUNCTION_NAME --region $GCP_REGION --runtime=python39 --trigger-http --source scheduler/ --timeout 540 --service-account $SERVICE_ACCOUNT_NAME@$PROJECT_ID.iam.gserviceaccount.com --entry-point main --project $PROJECT_ID

例如：

gcloud functions deploy scheduler_func --region us-central1 --runtime=python39 --trigger-http --source scheduler/ --timeout 540 --service-account scheduler-sa@project1.iam.gserviceaccount.com --entry-point main --project project1

创建 Cloud Scheduler 作业

Cloud Scheduler 作业必须位于与 App Engine 区域相同的区域。

在 Cloud Shell 中，在同一 Filestore 实例上创建一个包含一个或多个调度程序的 Cloud Scheduler 作业：

gcloud scheduler jobs create http $SCHEDULER_NAME --schedule "$SCHEDULER_EXPRESSION" --uri "https://$GCP_REGION-$PROJECT_ID.cloudfunctions.net/$FUNCTION_NAME"  --http-method POST --message-body-from-file ../request.json --oidc-service-account-email $SERVICE_ACCOUNT_NAME@$PROJECT_ID.iam.gserviceaccount.com --time-zone $SCHEDULER_TZ --project $PROJECT_ID

在以下示例中，每日调度程序会在晚上 8:00 运行：

gcloud scheduler jobs create http daily_scheduler --schedule "0 20 * * *" --uri "https://us-central1-project1.cloudfunctions.net/scheduler_func"  --http-method POST --message-body-from-file ../request.json --oidc-service-account-email scheduler-sa@project1.iam.gserviceaccount.com --time-zone America/Los_angeles --project project1

验证安排的 Filestore 快照

1. 在 Google Cloud 控制台中，前往 Cloud Scheduler 页面。

   前往 Cloud Scheduler

2. 在您创建的作业所在的行中，依次点击 more_vert 操作 > 强制运行作业。

3. 点击刷新。

   • 如果作业成功运行，上次运行结果列会显示上次成功作业的时间戳。

   • 如果作业失败，请执行以下操作：

     1. 前往 Cloud Functions 页面。

        前往 Cloud Functions

     2. 在您创建的函数所在的行中，依次点击 more_vert 操作 > 查看日志。

     3. 查找错误消息，然后进行相应问题排查。

4. 在 Google Cloud 控制台中，前往 Filestore 实例页面。

5. 在实例列表中，选择您的实例，并确保其具有以下名称格式的快照：

   sched-RETENTION_NAME-DATE-TIME
   

   例如 sched-daily-20220315-120640。