docker service update

Swarm Este comando funciona con el orquestador de Swarm.

Descripción

Actualiza un servicio según lo descrito por los parámetros especificados. Los parámetros son los mismos que en docker service create. Consulta la descripción allí para obtener más información.

Normalmente, la actualización de un servicio solo hará que las tareas del servicio sean reemplazadas por otras nuevas si un cambio en el servicio requiere recrear las tareas para que tenga efecto. Por ejemplo, solo cambiar la configuración de --update-parallelism no recreará las tareas, porque las tareas individuales no se ven afectadas por esta configuración. Sin embargo, el flag --force hará que las tareas se recreen de todos modos. Esto se puede utilizar para realizar un reinicio continuo (rolling restart) sin realizar cambios en los parámetros del servicio.

Note

Este es un comando de gestión de clústeres y debe ejecutarse en un nodo administrador de Swarm (manager node). Para obtener más información sobre administradores y trabajadores, consulta la sección del modo Swarm en la documentación.

Opciones

Ejemplos

Actualizar un servicio

$ docker service update --limit-cpu 2 redis

Realizar un reinicio continuo (rolling restart) sin cambios en los parámetros

$ docker service update --force --update-parallelism 1 --update-delay 30s redis

En este ejemplo, el flag --force hace que las tareas del servicio se detengan y sean reemplazadas por otras nuevas, aunque normalmente ninguno de los otros parámetros provocaría que eso sucediera. La opción --update-parallelism 1 asegura que solo se reemplace una tarea a la vez (este es el comportamiento predeterminado). La opción --update-delay 30s introduce un retraso de 30 segundos entre tareas, de modo que el reinicio continuo se realice de manera gradual.

Añadir o eliminar montajes (--mount-add, --mount-rm)

Utiliza las opciones --mount-add o --mount-rm para añadir o eliminar montajes vinculados (bind mounts) o volúmenes de un servicio.

El siguiente ejemplo crea un servicio que monta el volumen test-data en /somewhere. El paso siguiente actualiza el servicio para montar también el volumen other-volume en /somewhere-else. El último paso desmonta el punto de montaje /somewhere, eliminando eficazmente el volumen test-data. Cada comando devuelve el nombre del servicio.

• El flag --mount-add toma los mismos parámetros que el flag --mount en service create. Consulta la sección de volúmenes y montajes vinculados en la referencia de service create para obtener más detalles.

• El flag --mount-rm toma la ruta de destino (target) del montaje.

$ docker service create \
    --name=myservice \
    --mount type=volume,source=test-data,target=/somewhere \
    nginx:alpine

myservice

$ docker service update \
    --mount-add type=volume,source=other-volume,target=/somewhere-else \
    myservice

myservice

$ docker service update --mount-rm /somewhere myservice

myservice

Añadir o eliminar puertos de servicio publicados (--publish-add, --publish-rm)

Utiliza los flags --publish-add o --publish-rm para añadir o eliminar un puerto publicado para un servicio. Puedes utilizar la sintaxis corta o larga descrita en la referencia de docker service create.

El siguiente ejemplo añade un puerto de servicio publicado a un servicio existente.

$ docker service update \
  --publish-add published=8080,target=80 \
  myservice

Añadir o eliminar red (--network-add, --network-rm)

Utiliza los flags --network-add o --network-rm para añadir o eliminar una red para un servicio. Puedes utilizar la sintaxis corta o larga descrita en la referencia de docker service create.

El siguiente ejemplo añade un nuevo nombre de alias a un servicio existente que ya está conectado a la red my-network:

$ docker service update \
  --network-rm my-network \
  --network-add name=my-network,alias=web1 \
  myservice

Revertir a la versión anterior de un servicio (--rollback)

Utiliza la opción --rollback para revertir a la versión anterior del servicio.

Esto restaurará el servicio a la configuración que tenía antes del comando docker service update más reciente.

El siguiente ejemplo actualiza el número de réplicas para el servicio de 4 a 5, y luego revierte a la configuración anterior.

$ docker service update --replicas=5 web

web

$ docker service ls

ID            NAME  MODE        REPLICAS  IMAGE
80bvrzp6vxf3  web   replicated  0/5       nginx:alpine

El siguiente ejemplo revierte el servicio web:

$ docker service update --rollback web

web

$ docker service ls

ID            NAME  MODE        REPLICAS  IMAGE
80bvrzp6vxf3  web   replicated  0/4       nginx:alpine

También se pueden combinar otras opciones con --rollback, por ejemplo, --update-delay 0s para ejecutar la reversión sin retraso entre tareas:

$ docker service update \
  --rollback \
  --update-delay 0s \
  web

web

Los servicios también se pueden configurar para revertirse a la versión anterior automáticamente cuando falla una actualización. Para configurar un servicio para la reversión automática, utiliza --update-failure-action=rollback. Se activará una reversión si la fracción de las tareas que no se actualizaron correctamente supera el valor proporcionado con --update-max-failure-ratio.

La velocidad, el paralelismo y otros parámetros de una operación de reversión se determinan por los valores pasados con los siguientes flags:

• --rollback-delay
• --rollback-failure-action
• --rollback-max-failure-ratio
• --rollback-monitor
• --rollback-parallelism

Por ejemplo, un servicio configurado con --update-parallelism 1 --rollback-parallelism 3 actualizará una tarea a la vez durante una actualización normal, pero durante una reversión, se revertirán 3 tareas a la vez. Estos parámetros de reversión se respetan tanto durante las reversiones automáticas como para las reversiones iniciadas manualmente utilizando --rollback.

Añadir o eliminar secretos (--secret-add, --secret-rm)

Utiliza las opciones --secret-add o --secret-rm para añadir o eliminar secretos de un servicio.

El siguiente ejemplo añade un secreto llamado ssh-2 y elimina ssh-1:

$ docker service update \
    --secret-add source=ssh-2,target=ssh-2 \
    --secret-rm ssh-1 \
    myservice

Actualizar servicios utilizando plantillas

Algunos flags de service update admiten el uso de plantillas. Consulta service create para obtener la referencia.

Especificar el modo de aislamiento en Windows (--isolation)

service update admite el mismo flag --isolation que service create. Consulta service create para obtener la referencia.

Actualizar trabajos (Jobs)

Cuando un servicio se crea como un trabajo, estableciendo su modo a replicated-job o a global-job al hacer service create, las opciones para actualizarlo están limitadas.

La actualización de un trabajo detiene inmediatamente cualquier tarea que esté en progreso. La operación crea un nuevo conjunto de tareas para el trabajo y restablece eficazmente su estado de finalización. Si había tareas ejecutándose antes de la actualización, estas se detienen y se crean nuevas tareas.

Los trabajos no se pueden implementar ni revertir progresivamente. Ninguno de los flags para configurar los ajustes de actualización o reversión es válido con los modos de trabajo.

Para ejecutar un trabajo de nuevo con los mismos parámetros que se ejecutó anteriormente, se puede forzar su actualización con el flag --force.