Skip to main content

准备升级

升级到新版本的 ArcGIS Enterprise on Kubernetes 将为您的组织提供新功能和改进功能。 了解新功能并确定可能影响组织成员的任何更改内容。

升级前,确保您的环境符合相关要求。 有些要求对所有环境都是必需的,而且根据您的配置,您可能还需要满足额外的环境特定要求。

提示:

可以设置或修改在更新或升级期间使用的 Pod 的节点亲和性和容忍度。 创建放置策略后,每次创建升级作业时都会应用此策略。 您设置的值将在未来的所有更新和升级中持续存在,直到对其进行重置为止。 有关详细信息,请参阅更新(升级配置)。

升级要求

在执行升级前,必须满足以下要求:

  • 您的环境必须满足本版本的系统要求。 支持的 Kubernetes 版本、工作节点磁盘大小、所需系统存储空间及其他系统要求在本版本中可能有所更改。 确保集群的 Kubernetes 版本同时支持当前版本的 ArcGIS Enterprise on Kubernetes 和此版本。

  • 您必须备份您的组织。 建议在升级前先做一个新的备份。

  • 您必须拥有此版本的统一 ArcGIS Enterprise on Kubernetes 许可。

  • 如果存在可用的必要更新,则您必须在升级到此版本之前应用此更新。 查看发布说明以了解有关最新必要更新的详细信息。

  • 您必须运行升级前脚本。 该脚本将检测和处理一切功能需求,以满足当前软件版本的要求。

  • 您必须更新命名空间中的资源配额值以满足当前要求。

  • 在进行升级之前,您的环境需要符合 Pod 安全性标准,例如 Pod 安全性准入标准。

  • 存储的卷大小必须满足要升级到的版本的最低要求。 如果存储类使用的配置程序无法进行卷扩展,请将备份还原到使用增加的卷配置的新组织。 不满足最低存储要求可能会导致加载组织的项目和启动服务时出现问题。

  • 要升级关系存储,在关系数据存储实例所在的持久卷中创建备份。 此备份要求至少 50% 的数据库空间可用。 例如,如果关系存储目前正在使用 100 GB 存储,相关 PV 在升级前必须至少具有 50 GB 可用空间,从而使得所需的卷总大小大于或等于 150 GB。 有关增加卷大小的说明,请参阅管理所需存储。

  • 考虑到升级过程中写入的额外数据,确保对象存储至少有 20 GB 可用空间,时空存储和索引存储至少有 20% 的可用空间。 这可以避免在升级过程中数据存储进入只读模式。

  • 您的组织成员必须已检入所有离线 ArcGIS Pro 许可。 可以查看许可活动以了解已检出其 ArcGIS Pro 许可以供离线使用的成员。 有关如何检入离线许可的信息,请参阅检入离线许可。

环境特定升级要求

根据环境配置,升级前可能需要满足额外要求:

  • 如果您的环境位于 Red Hat OpenShift 中,则必须满足当前的安全上下文限制。

  • 如果您已配置静态持久卷 (PV),则必须配置额外的存储才能满足升级要求。 有关详细信息,请参阅调整用于升级的静态 PV。

  • 如果您的已配置存储具有动态 PV,则必须有足够的存储空间可用于存储额外的项目包卷、对象卷和队列卷。

  • 如果您已为组织配置了 Web Adaptor,请查看安装和升级要求。

  • 如果您使用您的组织的容器注册表或者如果已在离线环境中进行部署,则在运行更新或升级之前,必须将所需的容器镜像从 Esri 资料档案库复制到您的注册表。

  • 如果部署使用了多个可用区,则每个可用区中必须有足够的容量才能支持有状态工作负载的其他复本。 这可能需要在更新或升级期间临时扩展节点组。

  • 如果您当前使用的是云关系存储,则数据库版本必须适用于 ArcGIS Enterprise on Kubernetes 的当前版本以及要升级到的版本。 这可能需要升级云关系存储数据库实例。

  • 如果您尚未这样做,建议您根据资源使用情况和集群容量来验证每个服务的请求和限制是否合适。 如有必要,垂直扩展服务资源。

    注:

    升级不会应用性能配置文件来调整资源请求和限制。

  • 如果您之前在 EKS 中为 IAM 身份验证配置了基于 pod 的身份,请查看更新后的 IAM 角色和 Pod 身份关联的服务账户要求。

调整用于升级的静态 PV

升级前,必须为 rest-portal-api、in-memory-store 和 queue-store StatefulSets 中的每个 Pod 配置一个额外的 PV。 必须使用与部署期间指定的规范等效的规范来配置每个 PV。 请参见相应的大小和标签要求。

例如,如果为 rest-portal-api 配置了两个 pod,您必须额外配置两个满足 item-packages-volume 大小和标注要求的卷。

升级完成后,rest-portal-api、内存存储和队列存储将使用新配置的 PV 和永久卷声明 (PVC)。 随后可以移除原始卷集。 强烈建议您移除所有处于已释放状态的 PV,因为绝对不能重复使用在先前的升级或更新期间释放的 PV。