创建实例

本页面介绍了如何使用 Google Cloud 控制台或 gcloud CLI 创建 Filestore 实例。

创建实例的说明

gcloud filestore instances create instance-id \
    [--project=project-id] \
    [--location=location] \
    --tier=tier \
    --file-share=name="file-share-name",capacity=file-share-size \
    --network=name="vpc-network",[connect-mode=connect-mode],[reserved-ip-range="reserved-ip-address"]
    [--labels=key=value,[key=value,…]]
    [--kms-key=kms-key]

gcloud filestore instances create render1 \
  --project=myproject \
  --zone=us-central1-c \
  --tier=BASIC_HDD \
  --network=name="default",reserved-ip-range="10.0.7.0/29"
  --flags-file=nfs-export-options.json

 {
"--file-share":
  {
    "capacity": "2048",
    "name": "my_vol",
    "nfs-export-options": [
      {
        "access-mode": "READ_WRITE",
        "ip-ranges": [
          "10.0.0.0/29",
          "10.2.0.0/29"
        ],
        "squash-mode": "ROOT_SQUASH",
        "anon_uid": 1003,
        "anon_gid": 1003
      },
      {
        "access-mode": "READ_ONLY",
        "ip-ranges": [
          "192.168.0.0/26"
        ],
        "squash-mode": "NO_ROOT_SQUASH"
      }
    ]
  }
}

了解实例和分享

Filestore 实例表示物理存储容量。

“共享”表示该存储空间中分配给该部分，其中包含一个单独的唯一接入点。

所有服务层级均提供 1:1 实例共享比的存储方案。另外，适用于 GKE 的 Filestore 多共享（仅适用于企业级实例）可让您访问单个实例上的多个共享。

管理员可使用实例名称或实例 ID 来管理实例。 客户端使用文件共享名称连接到从这些实例导出的共享。

指定实例名称

您的 Filestore 实例的名称（或实例 ID）用于标识实例并在 gcloud 命令中使用。实例 ID 必须符合 RFC 1035 的 <label> 元素。具体而言，他们必须：

• 长度在 1-63 个字符之间。
• 以小写字母开头。
• 由短划线、小写字母或数字组成。
• 以小写字母或数字结尾。

实例 ID 在该实例所在的 Google Cloud 项目和可用区中必须是唯一的。创建实例后，其实例 ID 便无法更改。

选择服务层级

选择最符合您需求的服务层级。实例创建完毕后，其服务层级便无法更改。下表汇总了各服务层级提供的功能：

针对地区、区域和企业实例的 Create 操作可能需要 15 分钟到一小时才能完成，具体取决于实例大小。

当实例创建开始时，即会消耗 Filestore 配额，但在此期间您无需为该实例付费。

性能

下表对各个服务层级的性能进行了更详细的比较：

如需详细了解性能，请参阅性能。

如需详细了解各服务层级提供的功能，请参阅服务层级。

分配容量

在创建实例时，根据需要分配容量。在接近容量限制时，您可以根据需要扩增容量，而不会影响运行时。如需了解如何监控实例的容量，请参阅监控实例。

在 gcloud CLI 中，您可以使用 GiB 或 TiB 指定容量（以整数表示）。默认单位为 GiB。

下表显示了每个层级可用的实例大小：

实例大小可以是实例大小下限和上限之间的任何整数 GiB 值，或其等效 TB 值，可被其增量步长整除。例如，对于容量范围较大的可用区级实例，有效大小包括 10 TiB、12.5 TiB 和 15 TiB。

创建后，基本层级实例只能进行扩容。所有其他服务层级的容量可以增加或减少。如需了解详情，请参阅修改实例和扩缩容量。

总容量配额

每个项目都分配有单独的容量配额，该配额由区域和服务层级定义。配额限制因服务层级而异。

达到配额限制后，您将无法创建更多 Filestore 实例，也无法增加现有实例的容量。如需查看可用配额，请转到 Google Cloud 控制台中的配额页面：

进入“配额”页面

如需了解如何申请更多配额，请参阅申请增加配额。

为文件共享命名

文件共享是存储所有共享文件的 Filestore 实例上的目录。它也是您在客户端虚拟机上装载或映射到的内容。

文件共享的名称必须符合以下要求：

• 可用区级、区域级和企业级层级的长度介于 1-32 个字符之间，基本层级的长度介于 1-16 个字符之间。
• 以字母开头。
• 由大写或小写字母、数字和下划线组成。
• 必须以字母或数字结尾。

选择 VPC 网络

您选择用于 Filestore 的网络可以是标准 VPC 网络，也可以是共享 VPC 网络。在这两种情况下，您选择的网络都必须具有足够的可用 IP 资源专用于 Filestore 实例，否则实例无法创建。

客户端必须与 Filestore 实例位于同一网络上，才能访问存储在该实例上的文件。创建实例后，便无法更改此网络选择。

共享 VPC 网络

如需在服务项目中的共享 VPC 网络上创建实例，网络管理员必须先为该共享 VPC 网络启用专用服务访问通道。如果您要在宿主项目中创建实例，则不需要专用服务访问通道。

共享 VPC 网络在 Google Cloud 控制台中以如下格式显示：

projects/HOST_PROJECT_ID/global/networks/SHARED_VPC_NAME

如需详细了解过程，请参阅在共享 VPC 网络上创建实例。

NFS 文件锁定

如果您计划与此 Filestore 实例搭配使用的应用需要 NFS 文件锁定，并且您选择了以下任一方式，则可能需要在您选择的网络中打开 Filestore 使用的端口：

• 除默认网络以外的 VPC 网络。
• 防火墙规则已改变的默认 VPC 网络。

如需了解详情，请参阅配置防火墙规则。

选择位置

位置是指 Filestore 实例所在的地区和区域。为获得最佳性能并避免跨地区网络费用，请确保 Filestore 实例与需要访问实例的 Compute Engine 虚拟机位于同一地区。

如需详细了解地区和区域，请参阅地理位置和地区。

配置基于 IP 的访问权限控制

默认情况下，Filestore 实例会授予对共享同一 Google Cloud 项目和 VPC 网络的所有客户端（包括 Compute Engine 虚拟机和 GKE 集群）的根级读写权限。如果要限制访问权限，您需要创建适当的规则，以根据客户端的 IP 地址向客户端授予特定的访问权限级别。添加规则后，系统将撤消未在规则中指定的所有 IP 地址和范围的访问权限。可用区级实例、区域级实例和企业实例支持针对重叠 IP 地址范围的配置设置。如需了解详情，请参阅权限重叠。

下表介绍了各个访问权限级别的权限。这些访问权限级别仅在 Google Cloud 控制台中使用。在 gcloud CLI 和 API 中，您必须直接指定规则配置。

root-squash 会将来自 uid 0 和 gid 0 的所有请求分别映射到 anon_uid 和 anon_gid。此配置会从尝试以根用户身份访问文件共享的客户端中移除根级访问权限。

创建基于 IP 的访问规则时：

• 您必须指定内部 IP 地址或范围以及授予的访问权限级别。
• 在创建实例时，必须至少有一条规则授予 admin 访问权限。 您可以在创建实例后移除此规则。
• 可用区、区域和企业实例支持针对重叠 IP 地址范围的配置设置。不支持基本层级实例。如需了解详情，请参阅权限重叠。

在 Google Cloud 控制台中，您最多可以创建 4 条不同的规则（admin、admin-viewer、editor、viewer），其中最多可涉及 64 个不同的 IP 地址或范围。

在 gcloud CLI 中，您可以跨最多 10 条不同的规则为每个 Filestore 实例配置多达 64 个不同的 IP 地址或 CIDR 地址块。规则定义为 access-mode、squash-mode 和 anon_uid/anon_gid 配置的组合。anon_uid 和 anon_gid 字段的默认值为 65534，只能通过 API 和 gcloud CLI 进行配置。

示例

下面是三个不同的基于 IP 的访问规则的示例：

• access-mode=READ_ONLY、squash-mode=ROOT_SQUASH、anon_uid=10000。
• access-mode=READ_WRITE、squash-mode=ROOT_SQUASH、anon_gid=150。
• access-mode=READ_WRITE、squash-mode=NO_ROOT_SQUASH。

如需使用 gcloud CLI 创建基于 IP 的访问权限控制规则，请将 --flags-file 标志与 instances create 或 instances update 命令结合使用，并将其指向 JSON 配置文件。例如，如果 JSON 配置文件名为 nfs-export-options.json，则该标志将为：

--flags-file=nfs-export-options.json

JSON 配置文件示例：

   {
  "--file-share":
    {
      "capacity": "2048",
      "name": "my_vol",
      "nfs-export-options": [
        {
          "access-mode": "READ_WRITE",
          "ip-ranges": [
            "10.0.0.0/29",
            "10.2.0.0/29"
          ],
          "squash-mode": "ROOT_SQUASH",
          "anon_uid": 1003,
          "anon_gid": 1003
        },
         {
          "access-mode": "READ_ONLY",
          "ip-ranges": [
            "192.168.0.0/26"
          ],
          "squash-mode": "NO_ROOT_SQUASH"
        }
      ]
    }
}

• ip-ranges 是要向其中授予访问权限的 IP 地址或范围。您可以指定多个 IP 地址或范围，只需用英文逗号分隔即可。只有可用区级实例、区域级实例和企业实例支持重叠 IP 地址范围的配置设置。如需了解详情，请参阅权限重叠。
• access-mode 是授予 IP 地址在 ip-range 范围内的客户端的访问权限级别。它可以有值 READ_WRITE 或 READ_ONLY。默认值为 READ_WRITE。
• squash-mode 可以具有值 ROOT_SQUASH 或 NO_ROOT_SQUASH。ROOT_SQUASH 移除 IP 地址在 ip-range 范围内的客户端的根级访问权限，而 NO_ROOT_SQUASH 启用根访问权限。默认值为 NO_ROOT_SQUASH。
• anon_uid 是您要映射到 anon_uid 的用户 ID 值。默认值为 65534。
• anon_gid 是您要映射到 anon_gid 的群组 ID 值。默认值为 65534。

非 RFC 1918 范围上的客户端

如果您计划将非 RFC 1918 客户端连接到 Filestore 实例，则必须使用基于 IP 的访问权限控制明确授权这些客户端访问 Filestore 实例。

可选字段

以下部分介绍了可选字段。

添加实例说明

通过实例说明，您可以为自己和其他用户撰写说明、备注或说明。例如，您可以添加以下信息：

• 实例中存储的文件类型。
• 谁有权访问该实例。
• 关于如何访问实例的说明。
• 实例的用途。

实例说明的长度上限为 2048 个字符。对允许的字符没有任何限制。创建 Filestore 实例后，您可以根据需要随时更新其实例说明。如需了解如何更新实例说明，请参阅修改实例。

添加标签

标签采用键值对形式，可用于对相关实例进行分组并存储实例的相关元数据。 您可以随时添加、删除或修改标签。如需了解详情，请参阅管理标签。

配置预留的 IP 地址范围

每个 Filestore 实例都必须具有与之关联的 IP 地址范围。RFC 1918 和非 RFC 1918 IP 地址范围 (GA) 均受支持。

一旦指定，实例的 IP 地址范围便无法再改变。

建议用户让 Filestore 自动确定免费的 IP 地址范围并将其分配给实例。在选择自己的范围时，请考虑以下 Filestore IP 资源要求：

• 必须使用 CIDR 表示法。

• 必须是有效的 VPC 子网范围。

• 基本实例要求的块大小为 29。例如 10.123.123.0/29。

• 可用区级实例、区域级实例和企业实例要求块大小为 26。例如，172.16.123.0/26。

• IP 地址范围不得与以下范围重叠：

  • Filestore 实例使用的 VPC 网络中的现有子网。

  • 与 Filestore 实例使用的网络对等互连的 VPC 网络中的现有子网。如需了解详情，请参阅在对等互连时重叠子网。

  • 分配给该网络中任何其他现有 Filestore 实例的 IP 地址范围。

  • 172.17.0.0/16 地址范围是为内部 Filestore 组件预留的。因此，存在以下限制：

    • 此范围内的客户端无法连接到 Filestore 实例。

    • 无法在此 IP 范围内创建 Filestore 实例。如需了解详情，请参阅已知问题。

• 每个 VPC 必须至少有一个 VPC 网络对等互连或专用服务访问通道连接。

您可以转到 Google Cloud Console 中的“VPC 网络”页面，查看网络子网的 IP 地址范围：

转到“VPC 网络”页面

您可以在 Google Cloud 控制台的“Filestore 实例”页面上获取任何 Filestore 实例的预留 IP 地址范围：

转到“Filestore 实例”页面

如果要使用专用服务访问通道并指定预留的 IP 地址范围，则必须为连接指定分配的地址范围的名称。如果未指定范围名称，则 Filestore 会自动使用与专用服务访问通道连接关联的任何已分配范围。

使用客户管理的加密密钥

默认情况下，Google Cloud 会使用 Google 管理的加密密钥自动加密静态数据。如果您需要更好地控制用于保护数据的密钥，则可以为 Filestore 使用客户管理的加密密钥 (CMEK)。如需了解详情，请参阅使用客户管理的加密密钥加密数据。

后续步骤

• 了解如何配置实例以使用 NFSv4.1 协议。
• 了解如何将实例连接到客户端：
  • 在 Compute Engine 虚拟机实例上装载 Filestore 文件共享。
  • 使用 Filestore CSI 驱动程序访问 Filestore 实例。
  • 使用 Filestore 实例作为 VMware Engine 中 VMware ESXi 主机的外部数据存储区。
  • 在远程客户端上装载文件共享。
  • 将 Filestore 实例装载到 Cloud Run 服务以在容器和服务之间共享数据。
• 了解如何检索实例详细信息（例如实例的 IP 地址），以便可以从客户端访问 Filestore 文件共享。
• 排查与 Filestore 相关的实例创建问题。
• 详细了解 Virtual Private Cloud (VPC) 网络和子网。
• 详细了解 Filestore 的网络和 IP 资源要求。