Prepararse para la actualización
La actualización a una versión nueva de ArcGIS Enterprise on Kubernetes proporciona a la organización nuevas características y una funcionalidad mejorada. Conozca las nuevas características e identifique cualquier cambio que pueda afectar a los miembros de su organización.
Antes de actualizar, asegúrese de que su entorno cumple los requisitos. Algunos requisitos son necesarios para todos los entornos y existen requisitos adicionales específicos de los entornos que es posible que también tenga que cumplir en función de su configuración.
Sugerencia:
Puede establecer o modificar la afinidad de nodos y las tolerancias para los pods que se utilizan durante actualizaciones o mejoras. Una vez creada una política de ubicación, se aplicará siempre que se cree un trabajo de actualización. Los valores que establezca persistirán para todas las futuras actualizaciones hasta que se restablezcan. Consulte Actualizar (configuración de actualizaciones) para obtener información detallada.
Requisitos de actualización
Antes de realizar una actualización, deben cumplirse los siguientes requisitos:
Su entorno debe cumplir los requisitos del sistema de esta versión. La versión de Kubernetes compatible, el tamaño de disco del nodo trabajador, el almacenamiento requerido del sistema y otros requisitos del sistema pueden haber cambiado en esta versión. Asegúrese de que la versión de Kubernetes de su clúster sea compatible tanto con su versión actual de ArcGIS Enterprise on Kubernetes como con esta versión.
Debe tener una copia de seguridad de su organización. Se recomienda hacer una copia de seguridad nueva antes de actualizar.
Debe tener una licencia unificada de ArcGIS Enterprise on Kubernetes para esta versión.
Si hay una actualización requerida disponible, debe aplicarla antes de actualizar a esta versión. Consulte las notas de la versión para obtener detalles sobre la última actualización requerida.
Debe ejecutar el script de actualización previa. Este script detectará y abordará cualquier requisito funcional para cumplir con la versión actual del software.
Debe actualizar los valores de cuota de recursos en su espacio de nombres para cumplir con los requisitos actuales.
Su entorno debe cumplir las normas de seguridad de pods, como las normas de admisión de seguridad de pods, antes de llevar a cabo la actualización.
El tamaño de los volúmenes de los almacenes debe cumplir los requisitos mínimos para la versión a la que va a actualizar. Si la expansión de volumen no está disponible para el proveedor utilizado por la clase de almacenamiento, restaure una copia de seguridad en una nueva organización configurada con volúmenes mayores. Si no se cumplen los requisitos mínimos de almacenamiento, podrían producirse problemas al cargar los elementos de su organización y al iniciar los servicios.
Para actualizar el almacén relacional, se crea una copia de seguridad en el mismo volumen persistente que la instancia del almacén de datos relacional. Esta copia de seguridad requiere que al menos el 50 % del tamaño de la base de datos esté disponible. Por ejemplo, si el almacén relacional utiliza actualmente 100 GB de almacenamiento, el PV asociado debe tener al menos 50 GB disponibles antes de la actualización, lo que hace que el tamaño total del volumen necesario sea de 150 GB o más. Consulte Administrar el almacenamiento necesario para obtener instrucciones sobre cómo aumentar el tamaño del volumen.
A fin de tener en cuenta los datos adicionales escritos durante la actualización, asegúrese de que el almacén de objetos disponga de al menos 20 GB de espacio disponible y el almacén espaciotemporal y de índices disponga de al menos un 20 % de espacio libre. Esto impide que los data stores pasen al modo de solo lectura durante la actualización.
Los miembros de su organización deben registrar todas las licencias de ArcGIS Pro sin conexión. Puede ver la actividad de las licencias para determinar qué miembros han realizado el check-out de su licencia de ArcGIS Pro para el uso sin conexión. Para obtener más información sobre cómo realizar el check-in de una licencia sin conexión, consulte Check-in de una licencia sin conexión.
Requisitos de actualización específicos del entorno
En función de la configuración de su entorno, es posible que deba cumplir requisitos adicionales antes de la actualización:
Si su entorno está en Red Hat OpenShift, debe cumplir las restricciones del contexto de seguridad actuales.
Si ha aprovisionado volúmenes persistentes estáticos (PV), debe aprovisionar almacenamiento adicional para adaptarse a los requisitos de actualización. Consulte Ajustar PV estáticos para las actualizaciones para obtener información.
Si su almacenamiento aprovisionado tiene PV dinámicos, debe haber suficiente almacenamiento disponible para el volumen de paquetes de elementos adicionales, el volumen de objetos y el volumen de cola.
Si configuró un Web Adaptor con su organización, revise los requisitos de instalación y actualización.
Si ha utilizado el registro de contenedores de su organización o si ha realizado la implementación en un entorno desconectado, deberá copiar las imágenes de contenedor necesarias del repositorio de Esri a su registro antes de ejecutar la actualización o mejora.
Si la implementación utiliza varias zonas de disponibilidad, debe haber una capacidad adecuada en cada zona de disponibilidad para permitir réplicas adicionales de las cargas de trabajo con estado. Esto puede requerir la escalabilidad horizontal provisional del grupo de nodos durante una o varias actualizaciones.
Si utiliza un almacén relacional en la nube, la versión de la base de datos debe ser compatible tanto con su versión actual de ArcGIS Enterprise on Kubernetes como con la versión a la que va a actualizar. Para ello, puede ser necesario actualizar la instancia de la base de datos relacional en la nube.
Se recomienda que verifique que las solicitudes y los límites para cada servicio son adecuados en función del uso de recursos y la capacidad de clústeres, si no lo ha hecho todavía. Escalar verticalmente los recursos para los servicios en caso necesario.
Nota:
La actualización no aplicará un perfil de rendimiento para ajustar las solicitudes y los límites de recursos.
Si previamente configuró la identidad basada en pods para la autenticación IAM en EKS, revise los requisitos de las cuentas de servicio actualizadas para el rol de IAM y asociaciones de identidad de pods.
Ajustar PV estáticos para las actualizaciones
Antes de la actualización, cada pod de rest-portal-api, in-memory-store y queue-store StatefulSets se debe configurar con un PV adicional. Cada PV se debe configurar con especificaciones equivalentes a aquellas especificadas durante la implementación. Consulte los requisitos de tamaño y etiqueta correspondientes.
Por ejemplo, si rest-portal-api está configurado con dos pods, debe aprovisionar dos volúmenes adicionales que cumplan con los requisitos de tamaño y etiqueta para item-packages-volume.
Una vez finalizada la actualización, rest-portal-api, in-memory-store y queue-store utilizarán los PV recién aprovisionados y una reclamación de volumen persistente (PVC). A continuación, se puede retirar el conjunto original de volúmenes. Se recomienda encarecidamente que elimine cualquier PV en estado liberado, ya que los PV liberados durante las actualizaciones o mejoras previas no se deben reutilizar nunca.