安排 Filestore Enterprise 快照的创建时间

---

本文档介绍了如何使用 Cloud Scheduler 安排时间 以保护 Filestore 快照。

本文档面向想要了解或创建定期 Filestore 快照的 IT 决策者、备份管理员和灾难恢复 (DR) 管理员。

目标

• 配置 Cloud Run 函数和 JSON 配置文件。
• 创建 Cloud Scheduler 作业。
• 创建和标记定期 Filestore 快照。
• 监控快照创建过程。

费用

在本文档中，您将使用 Google Cloud 的以下收费组件：

• Filestore Enterprise
• Cloud Scheduler
• Cloud Run functions
• App Engine

您可使用价格计算器根据您的预计使用情况来估算费用。 Google Cloud 新用户可能有资格申请免费试用。

完成本教程后，您可以删除 您创建的资源如需了解详情，请参阅清理。

准备工作

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Filestore, Cloud Scheduler, Cloud Functions, App Engine, and Cloud Build APIs.

   Enable the APIs

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the Filestore, Cloud Scheduler, Cloud Functions, App Engine, and Cloud Build APIs.

   Enable the APIs

部署模型

下图显示的部署模型支持 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
  • 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，并且该区域以后无法更改。

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

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

创建 JSON 配置文件

由于 Cloud Run 函数限制，JSON 配置文件最多可以包含 8 个 Filestore 实例。如果您有超过 安排快照的八个 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 [e-mail] --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 [e-mail] --time-zone America/Los_angeles --project project1

验证安排的 Filestore 快照

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

   前往 Cloud Scheduler

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

3. 点击刷新。

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

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

     1. 前往 Cloud Functions 页面。

        前往 Cloud Functions

     2. 在您创建的函数对应的行中，点击 操作 >查看日志。

     3. 查看错误消息并相应地排查问题。

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

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

   sched-RETENTION_NAME-DATE-TIME
   

   例如 sched-daily-20220315-120640。

清理

为避免因本教程中使用的资源导致您的 Cloud Platform 账号产生费用，请删除包含这些资源的项目。

删除项目

注意：删除项目会产生以下影响：

• 项目中的所有内容都会被删除。如果您将现有项目用于本文档中的任务，则删除该项目后，还将删除您已在该项目中完成的任何其他工作。
• 自定义项目 ID 丢失。创建此项目时，您可能创建了要在将来使用的自定义项目 ID。要保留使用该项目 ID 的网址（例如 appspot.com 网址），请删除项目内的所选资源，而不是删除整个项目。

如果您打算探索多个架构、教程或快速入门，则重复使用项目可以帮助您避免超出项目配额限制。

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

后续步骤

• 详细了解 Filestore 快照。
• 详细了解 Filestore 备份。
• 探索有关 Google Cloud 的参考架构、图表和最佳做法。查看我们的云架构中心。