SuperAPI AI 工具集

privatelink

部署与运维

查看项目

更新于 10-16 06:51

技能介绍

用途:通过 zilliz CLI 管理集群的 PrivateLink 连接,使集群可经云厂商私网(AWS PrivateLink、GCP Private Service Connect、Azure Private Link)访问,而非公网。端点按项目和区域划分。

前置条件:已安装并登录 CLI(见 setup 技能);需有可挂载端点的项目(见 project-region 技能)。

主要能力与命令:

  • 列出可用端点服务:zilliz privatelink list-services,可选 --region-id <filter-by-cloud-region>。
  • 按项目列出端点:zilliz privatelink list --project-id <project-id>,无全局限定。
  • 创建端点:zilliz privatelink create --project-id <project-id> --region-id <cloud-region> --endpoint-id <vpc-endpoint-id>,GCP 需加 --gcp-project-id <gcp-project-id>。
  • 删除端点:zilliz privatelink delete --project-id <project-id> --endpoint-id <endpoint-id-to-delete>。
  • 添加区域白名单:zilliz privatelink add-whitelist --project-id <project-id> --region-id <cloud-region-to-whitelist>。

新端点流程:先用 list-services --region-id 找到该区域的 endpointService 值及 whitelistRequired;若为 true,先 add-whitelist;再在自有云账号控制台或 IaC 中创建 VPC 端点并获取端点 ID(如 vpce-xxxx);最后用 create 注册,GCP 需附 --gcp-project-id。

限制:删除不可逆,需与用户确认,删除后该端点的现有连接立即中断,生产环境尤其谨慎。启用 PrivateLink 后集群端点 URL 会切换为私有 DNS 形式,需重新运行 zilliz cluster describe --cluster-id <id> 获取更新后的端点并更新消费方配置。