ejemplo de actualización del servicio docker

Descripción

Actualizar un servicio

API 1.24+ El cliente y la API del demonio deben ser al menos 1,24 para usar este comando. Utilizar el docker version comando en el cliente para verificar las versiones de la API del demonio y del cliente.

Enjambre Este comando funciona con el orquestador Swarm.

Uso

docker service update [OPTIONS] SERVICE

Opciones

Comando de padres

Comandos relacionados

Descripción ampliada

Actualiza un servicio como se describe en los parámetros especificados. Este comando debe ejecutarse apuntando a un nodo administrador. Los parámetros son los mismos que docker service create. Por favor, mire la descripción allí para obtener más información.

Normalmente, la actualización de un servicio solo hará que las tareas del servicio se reemplacen por otras nuevas si un cambio en el servicio requiere volver a crear las tareas para que surta efecto. Por ejemplo, solo cambiando el --update-parallelism La configuración no volverá a crear las tareas, porque las tareas individuales no se ven afectadas por esta configuración. sin embargo, el --force flag hará que las tareas se vuelvan a crear de todos modos. Esto se puede utilizar para realizar un reinicio continuo sin ningún cambio en los parámetros del servicio.

Ejemplos de

Actualizar un servicio

$ docker service update --limit-cpu 2 redis

Realice un reinicio continuo sin cambios de parámetros

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

En este ejemplo, el --force flag hace que las tareas del servicio se cierren y se reemplacen por otras nuevas, aunque ninguno de los otros parámetros normalmente haría que eso suceda. los --update-parallelism 1 La configuración garantiza que solo se reemplace una tarea a la vez (este es el comportamiento predeterminado). los --update-delay 30s La configuración introduce un retraso de 30 segundos entre tareas, de modo que el reinicio continuo se produce de forma gradual.

Agregar o quitar monturas

Utilizar el --mount-add o --mount-rm Las opciones agregan o eliminan los volúmenes o montajes de enlace de un servicio.

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

• los --mount-add bandera toma los mismos parámetros que el --mount bandera en service create. Consulte la sección de volúmenes y montajes de enlace en el service create referencia para más detalles.

• los --mount-rm bandera toma el target camino del monte.

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

myservice

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

myservice

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

myservice

Agregar o quitar puertos de servicio publicados

Utilizar el --publish-add o --publish-rm banderas para agregar o eliminar un puerto publicado para un servicio. Puede usar la sintaxis corta o larga que se describe en la referencia de creación del servicio docker.

El siguiente ejemplo agrega un puerto de servicio publicado a un servicio existente.

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

Agregar o quitar una red

Utilizar el --network-add o --network-rm banderas para agregar o eliminar una red para un servicio. Puede usar la sintaxis corta o larga que se describe en la referencia de creación del servicio docker.

El siguiente ejemplo agrega 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

Retroceder a la versión anterior de un servicio

Utilizar el --rollback opción para volver a la versión anterior del servicio.

Esto revertirá el servicio a la configuración que estaba en su lugar antes de la más reciente docker service update mando.

El siguiente ejemplo actualiza el número de réplicas del 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

Hacer retroceder el web Servicio…

$ docker service update --rollback web

web

$ docker service ls

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

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

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

web

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

La tasa, el paralelismo y otros parámetros de una operación de reversión están determinados por los valores pasados ​​con las siguientes banderas:

• --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, 3 tareas a la vez se revertirá. Estos parámetros de reversión se respetan tanto durante las reversiones automáticas como para las reversiones iniciadas manualmente mediante --rollback.

Agregar o quitar secretos

Utilizar el --secret-add o --secret-rm Las opciones agregan o eliminan los secretos de un servicio.

El siguiente ejemplo agrega un secreto llamado ssh-2 y quita ssh-1:

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

Actualizar servicios usando plantillas

Algunas banderas de service update Apoyar el uso de plantillas. Ver service create para la referencia.

Especificar el modo de aislamiento (Windows)

service update apoya lo mismo --isolation marcar como service create Ver service create para la referencia.