命名空间管理

最近更新时间:2026-02-10 16:52:52

我的收藏

简介

GooseFS 通过命名空间组织和管理缓存数据。GooseFS 的命名空间是 GooseFS 集群访问数据的统一访问接口,可以挂载多种底层存储系统,包括对象存储 COS、云 HDFS 等。该页面用于配置命名空间的基本属性及元数据发现能力。

命名空间基本配置

通过命名空间管理支持创建、更新、删除命名空间,为 GooseFS 集群关联 COS 存储桶并设置缓存读写策略。
2. 在左侧导航中,选择 GooseFS > 实例列表,进入 GooseFS 集群列表页面。
3. 选择需要创建命名空间的 GooseFS 集群,进入集群详情页面,在侧边栏中单击命名空间,进入命名空间子页面。
4. 在命名空间页面,单击新增命名空间 ,填写如下字段。



存储桶来源:可选择本账号或其他账号的存储桶。
注意:
选择其他账号存储桶请保证该账号有对应存储桶读写权限。
COS 存储桶:选择需要挂载的存储桶。
空间名称:命名空间的名称。
挂载范围:可选择整个存储桶/指定目录前缀。
UFS URI:用于访问和操作 UFS 文件系统中文件的地址。
读策略:用于管理从 GooseFS 读数据时,数据在 GooseFS 集群中的缓存策略。当前只支持 CACHE。
写策略:用于管理通过 GooseFS 写数据时,数据在 GooseFS 集群中的缓存策略。当前支持 CACHE_THROUGH 和 THROUGH。
UFS 属性:用于设置访问底层存储的配置信息,如访问密钥等。
fs.cosn.bucket.region:所选存储桶地域,如 ap-beijing。
fs.cosn.flush.enabled:是否启用 数据刷新机制,默认为 true。
fs.cosn.upload.part.size:分块上传的单个分片大小,默认为8MB。
fs.cosn.userinfo.secretId:用于标识 API 调用者身份。一个 APPID 可以创建多个云 API 密钥。
fs.cosn.userinfo.secretKey:腾讯云账户的加密签名密钥,用于验证请求合法性。
说明:
SecretId 和 SecretKey 合称为云 API 密钥,是用户访问腾讯云 API 进行身份验证时需要用到的安全凭证, 请在 访问管理 页面创建。在左侧导航栏选择访问密钥 > API 密钥管理,单击新建密钥获取。
5. 按需填入各项操作所需参数,确认无误后单击确定执行, 即可创建命名空间。
6. 命名空间管理。
进入命名空间页面,在对应命名空间的操作项中进行管理。



更新操作:支持修改写策略UFS 属性,命名空间名称创建后无法修改。



删除操作:支持删除当前命名空间。请注意,删除命名空间后您的缓存数据及业务将会中断。请确定您不再使用此命名空间后再进行删除。

元数据发现

元数据发现是 GooseFS 推出的元数据主动同步服务,能够自动化解决缓存层与底层存储的一致性问题,释放客户侧手动进行元数据预热的压力。您可在元数据发现配置中指定具体的 COS 事件,由 GooseFS 主动将事件同步至缓存层中。元数据发现可实现近实时的元数据同步,在高 QPS 的 COS 请求负载下,元数据变更可在分钟级同步至 GooseFS。
说明:
当前元数据发现为公测功能,公测期间暂不收费,请 联系我们 申请公测资格。
元数据发现需要 GooseFS 集群版本 ≥ 1.5.1,如您需要升级集群版本,请 联系我们
仅全托管模式、Master 托管模式的 GooseFS 集群支持开启元数据发现,暂不支持管控面托管模式。
元数据发现暂不支持 元数据加速桶云 HDFS
若您的 COS 桶开启过 版本控制,覆盖及删除场景的表现如下:
覆盖上传文件:元数据发现可正常进行同步,将每次写入文件的元数据同步至 GooseFS。
删除:当前版本 GooseFS 暂不支持将删除事件同步至 GooseFS。
元数据发现的时效性取决于具体的业务模式,实际的同步时间请以线上表现为准。
您可通过如下步骤开启元数据发现功能:
2. 在左侧导航中,选择 GooseFS > 实例列表,进入 GooseFS 集群列表页面。
3. 选择需要创建命名空间的 GooseFS 集群,进入集群详情页面,在侧边栏中单击命名空间,进入命名空间子页面。
4. 在命名空间页面,单击新增命名空间 ,在弹窗中填写如下字段。

字段
说明
建议配置
元数据发现
元数据发现能力开关
打开
COS 请求事件
需要同步到 GooseFS 的事件类型,支持以下选项:
全选
按事件类型选择
通过任意方式上传对象完成后触发
仅删除对象内容后触发
按具体事件选择
仅通过 PUT Object 接口上传对象完成后触发
仅通过 POST Object 接口上传对象完成后触发
仅通过 PUT Object - Copy 接口上传对象完成后触发
仅通过 Complete Multipart Upload 接口上传对象完成后触发
按需选择,例如:全选
同步范围
触发元数据发现的命名空间范围,可选整个命名空间的挂载范围,或命名空间的挂载范围下的子目录
按需选择,例如:命名空间的挂载范围
若您需要修改元数据发现配置,可在命名空间列表页点击更新已配置的命名空间,重新编辑配置或关闭命名空间。需要注意的是,关闭元数据发现或删除命名空间时,GooseFS 会立刻停止元数据同步,若仍有 COS 的请求未同步至 GooseFS,该请求事件可能丢失。因此关闭元数据发现功能前,请确定需要的元数据已同步至 GooseFS 中。

后续步骤

创建命名空间后,您可以通过新增客户端在您的节点上管理命名空间,详细请参见 客户端管理