安排 Filestore Enterprise 快照的创建时间

---

<ph type="x-smartling-placeholder">

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

本文档面向 IT 决策者、备份管理员和 希望了解或创建 安排的 Filestore 快照。

目标

• 配置 Cloud Run 函数和 JSON 配置文件。
• 创建 Cloud Scheduler 作业。
• 创建计划 Filestore 快照并为其添加标签。
• 监控快照创建过程。

费用

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

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

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

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

准备工作

1. 登录您的 Google Cloud 账号。如果您是 Google Cloud 新手，请创建一个账号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金，用于运行、测试和部署工作负载。

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. 确保您的 Google Cloud 项目已启用结算功能。

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. 确保您的 Google Cloud 项目已启用结算功能。

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 配置快照调度器时 实例时，请考虑以下限制：

• 该函数只会在需要时删除一个快照，即使 调度器快照的数量多于保留政策中定义的数量 或者保留政策配置文件是 以便保留比之前少的快照
• 如果您减少 snapshots 的数值， JSON 配置文件，则实例的冗余快照不会 自动删除如果您更改了此设置，则需要删除冗余的 手动创建快照
• 由于快照 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：Google Cloud 项目 ID，其中 您希望安装 Filestore Enterprise 实例、Cloud Run 函数、 以及 Cloud Scheduler。
  • GCP_REGION：您在创建集群时 安装 Filestore Enterprise 实例 Cloud Run 函数和 Cloud Scheduler
  • APP_ENGINE_REGION： 您要安装 App Engine 的 App Engine 位置列表。 请考虑以下要求： <ph type="x-smartling-placeholder">
    </ph>
    • 一个 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 企业版实例

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 项目。这让您可以创建一个 Cloud Scheduler 作业 详细介绍

一个 Google Cloud 项目只能有一个 App Engine，并且 区域。

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

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

创建 JSON 配置文件

JSON 配置文件最多可以有八个 Filestore 使用 Cloud Run 访问 Cloud Run 实例。如果您有超过 安排快照的八个 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 中，创建一个 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 的参考架构、图表和最佳做法。查看我们的云架构中心。