> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/knowledge-base/es/system-administration/updating-vergeos-system.md).

# Actualización del sistema VergeOS

## Resumen

{% hint style="info" %}
**Puntos clave**

* Las actualizaciones del sistema deben realizarse durante una ventana de mantenimiento
* Las actualizaciones pueden realizarse sin tiempo de inactividad cuando hay recursos adecuados disponibles
* Las actualizaciones del sistema solo se ejecutan desde el sistema anfitrión (padre de nivel superior)
* Los sistemas inquilinos se actualizan automáticamente desde su sistema anfitrión
* Las actualizaciones pueden programarse o realizarse a demanda
* El sistema gestiona automáticamente la migración de cargas de trabajo durante las actualizaciones
  {% endhint %}

Esta guía proporciona instrucciones detalladas para realizar actualizaciones del sistema en VergeOS, ya sea a demanda o programadas.

## Requisitos previos

* Acceso administrativo al Panel de control en la nube de VergeOS
* Recursos del sistema adecuados para permitir la migración de cargas de trabajo durante las actualizaciones
* Una ventana de mantenimiento (recomendada, aunque no requerida debido a la capacidad de cero tiempo de inactividad)

## Realización de actualizaciones a demanda

### 1. Buscar actualizaciones

1. Vaya a **Sistema** > **Actualizaciones** en el Panel de control en la nube
2. Haga clic en **Buscar actualizaciones** en el menú de la izquierda
3. Haga clic en **Sí** para confirmar
   * La sección Paquetes mostrará las actualizaciones disponibles
   * Un icono de nube indica paquetes descargables
   * La información de la versión muestra las versiones actual y disponible

### 2. Descargar actualizaciones

1. Haga clic en **Descargar** en el menú de la izquierda
2. Haga clic en **Sí** para confirmar
3. Espere a que finalice la descarga

### 3. Instalar actualizaciones

1. Haga clic en **Instalar** en el menú de la izquierda
2. Haga clic en **Sí** para confirmar
3. Espere a que finalice la instalación
   * El estado mostrará "Inactivo - se requiere reinicio" cuando esté listo
   * La opción Reiniciar se habilitará

{% hint style="info" %}
Las actualizaciones que no incluyen cambios del paquete VergeOS no requerirán reinicios completos de los nodos, pero aun así necesitarán la opción Reiniciar para aplicar los cambios.
{% endhint %}

### 4. Aplicar actualizaciones

1. Haga clic en **Reinicie** en el menú de la izquierda
2. Haga clic en **Sí** para confirmar
   * El sistema procesará un nodo a la vez:
     * El nodo entra en modo de mantenimiento
     * Las cargas de trabajo se migran a otros nodos
     * Reinicio de la aplicación / reinicio del nodo
     * El nodo sale del modo de mantenimiento
   * El progreso se muestra en el campo Estado
   * El estado Nodos actualizados realiza un seguimiento de la finalización

{% hint style="success" %}
Usar **Cancelar reinicio** para detener los reinicios automáticos si es necesario (por ejemplo, para el reequilibrio de cargas de trabajo)
{% endhint %}

## Programación de actualizaciones

### 1. Crear tarea de actualización

1. Vaya a **Sistema** > **Actualizaciones** > **Tareas**
2. Haga clic en **Nuevo** en el menú de la izquierda

### 2. Configurar programación

1. Elija una opción de programación:
   * **Una sola vez**: Mantener el valor predeterminado "No se repite"
   * **Recurrente**: Seleccione la frecuencia (semanal, quincenal, mensual)
2. Establezca **Fecha de inicio** y hora
3. Para tareas recurrentes, opcionalmente establezca una fecha de finalización

### 3. Configurar detalles de la tarea

1. Introduzca los **Nombre**
2. Añada los opcionales **Descripción**
3. Seleccione **Tipo de tarea**:
   * Elija "Descargar, instalar y reiniciar" para una actualización completa
4. Opcional: habilitar **Eliminar después de ejecutar**
5. Haga clic en **Enviar** para guardar

## Mejores prácticas

* Programe las actualizaciones durante períodos de poco uso y durante ventanas de mantenimiento
* Asegure recursos del sistema adecuados para la migración de cargas de trabajo
* Supervise el sistema durante el proceso de actualización
* Mantenga copias de seguridad periódicas antes de actualizaciones importantes
* Revise las actualizaciones disponibles antes de aplicarlas

## Resolución de problemas

{% hint style="warning" %}
**Problemas comunes**

* **Problema:** Las cargas de trabajo no se pueden migrar
  * **Solución:** Verifique que haya recursos adecuados en los nodos de destino
* **Problema:** El proceso de actualización se bloquea
  * **Solución:** Revise los registros del sistema y contacte con soporte si es necesario
* **Problema:** El nodo no logra reincorporarse después del reinicio
  * **Solución:** Revise los registros y la conectividad de red
    {% endhint %}

## Comentarios

{% hint style="info" %}
**¿Necesitas ayuda?**

Si encuentra algún problema durante el proceso de actualización o tiene preguntas, póngase en contacto con nuestro equipo de soporte.
{% endhint %}

***

{% hint style="info" %}
**Información del documento**

* Última actualización: 2024-12-19
* Versión de VergeOS: Todas
  {% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.io/knowledge-base/es/system-administration/updating-vergeos-system.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
