# docker node update

**Descripción:** Actualiza un nodo

**Uso:** `docker node update [OPTIONS] NODE`








**Orquestador:** Swarm

## Descripción

Actualiza los metadatos de un nodo, como su disponibilidad, etiquetas o roles.

> [!NOTE]
> Este es un comando de administración de clústeres y debe ejecutarse en un nodo
> administrador de swarm. Para obtener información sobre los administradores y los nodos de trabajo (workers), consulta la [sección del modo Swarm](/engine/swarm/) en la documentación.


## Opciones

| Opción                                                        | Predeterminado                                        | Descripción                                                                                                                                    |
| ------------------------------------------------------------- | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | `--availability` |  |  Disponibilidad del nodo (`active`, `pause`, `drain`) |

 | `--label-add` |  |  Añade o actualiza una etiqueta de nodo (`key=value`) |

 | `--label-rm` |  |  Elimina una etiqueta de nodo si existe |

 | `--role` |  |  Rol del nodo (`worker`, `manager`) |




## Ejemplos


### Añadir etiquetas de metadatos a un nodo (--label-add) {#label-add}

Añade metadatos a un nodo de swarm utilizando etiquetas de nodo. Puedes especificar una etiqueta de nodo como una clave con un valor vacío:

```bash
$ docker node update --label-add foo worker1
```

Para añadir múltiples etiquetas a un nodo, pasa la opción `--label-add` para cada etiqueta:

```console
$ docker node update --label-add foo --label-add bar worker1
```

Cuando [creas un servicio](/reference/cli/docker/service/create/), puedes utilizar las etiquetas de nodo como una restricción. Una restricción limita los nodos donde el planificador despliega las tareas de un servicio.

Por ejemplo, para añadir una etiqueta `type` para identificar los nodos donde el planificador debe desplegar las tareas del servicio de cola de mensajes:

```bash
$ docker node update --label-add type=queue worker1
```

Las etiquetas que estableces para los nodos mediante `docker node update` se aplican solo a la entidad del nodo dentro del swarm. No las confundas con las etiquetas del demonio docker para [dockerd](/reference/cli/dockerd/).

Para obtener más información sobre las etiquetas, consulta [aplicar metadatos personalizados](/engine/userguide/labels-custom-metadata/).