Bad wording/missing information for live restore and swarm mode
Les mainteneurs répondent en général sous 1 jour
Personne n'a encore pris cette issue.
Évaluation
- Difficulté
- 1/5
- Temps estimé
- Moins d'une heure
- Accessibilité débutants
- 82/100
- Type d'issue
- Documentation
- Clarté
- Clairement spécifiée
- Activité
- Active
- Stack technique
- docker, markdown
- Domaine
- documentation
Piste de recherche
Commence par le paragraphe sur live restore et swarm sur la page liée dans l’issue. Vérifie que la formulation corresponde au comportement signalé du daemon : activer live restore sur un membre de swarm empêche le démarrage du daemon. Réécris le paragraphe pour indiquer clairement quelles configurations sont autorisées et ce qui se passe lorsque les deux options sont activées.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Description
Is this a docs issue?
- My issue is about the documentation content or website
Type of issue
Information is incorrect
Description
Hi there,
your original text for having live restore and swarm mode is incorrect or better said, inconsistent.
The way the paragraph is written suggests that in mixed-case scenario (which is perfectly legal), containers running as standalone will be managed with live restore, while containers running as services in swarm mode, would be managed by swarm.
Therefore, if one would enable live restore in daemon.js on a system that is both a swarm member and has standalone containers, one would expect both to work.
That is not true because docker implementation straight-up refuses to start the daemon if both live restore are enabled and node is part of a swarm:
Oct 23 12:28:39 msi dockerd[3191]: time="2026-10-23T12:28:39.195135279+02:00" level=info msg="Loading containers: done." Oct 23 12:28:39 msi dockerd[3191]: time="2026-10-23T12:28:39.218291222+02:00" level=info msg="Docker daemon" commit=0367cbe containerd-snapshotter=false storage-driver=overlay2 version=29.9.2 Oct 23 12:28:39 msi dockerd[3191]: time="2026-10-23T12:28:39.218905151+02:00" level=info msg="Daemon shutdown complete" error="failed to start cluster component: --live-restore daemon configuration is incompatible with swarm mode" Oct 23 12:28:39 msi dockerd[3191]: time="2026-10-23T12:28:39.218938380+02:00" level=info msg="stopping event stream following graceful shutdown" error="context canceled" module=libcontainerd namespace=moby Oct 23 12:28:39 msi dockerd[3191]: failed to start cluster component: --live-restore daemon configuration is incompatible with swarm mode Oct 23 12:28:39 msi dockerd[3191]: time="2026-10-23T12:28:39.218939560+02:00" level=info msg="stopping event stream following graceful shutdown" error="context canceled" module=libcontainerd namespace=plugins.moby Oct 23 12:28:39 msi systemd[1]: docker.service: Main process exited, code=exited, status=1/FAILURE
Location
https://docs.docker.com/engine/daemon/live-restore/
Suggestion
Please rewrite the live restore and swarm paragraph to explicitly say that trying to enable live restore on a node that is already a swarm member will break running docker daemon, and that it has to be only one of them: live restore is only for non-swarm node (no mixed mode possible) or if node is swarm member, live restore is not possible.
Or something similar but very precise what is allowed and what will break your system.
Of course, the best solution would be to have both options working for mixed mode cases, where docker would simply ignore swarm orchestrated containers on a swarm node and just manage standalone containers when live restore is enabled.
- Langage dominant
- Markdown
- Étoiles
- 4.7k
- Forks
- 8.5k
- Merge moyen
- 1 j 22 h
- PR mergées (30 j)
- 133
Préparer son environnement
- Fournit un Dockerfile ou un fichier Docker Compose
- Propose un modèle de pull request
- Lire le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Autres issues de docker/docs
-
status/triage
Difficulté 1/5 Moins d'une heure Accessibilité débutants 88/100
Les mainteneurs répondent en général sous 1 jour
-
Difficulté 1/5 Moins d'une heure Accessibilité débutants 88/100
Les mainteneurs répondent en général sous 1 jour
-
[docs-scanner] SSO multi-IdP configuration placed after enforcement sectionPeut-être pris @dave123981 l’a pris il y a 1 jour. Ouverte
Difficulté 1/5 Moins d'une heure Accessibilité débutants 85/100
Les mainteneurs répondent en général sous 1 jour
-
status/triage
Difficulté 1/5 Moins d'une heure Accessibilité débutants 82/100
Les mainteneurs répondent en général sous 1 jour
-
[docs-scanner] Example uses deprecated Flocker volume driverPeut-être pris @aevesdocker l’a pris il y a 7 jours. Ouverte
Difficulté 1/5 1-3 heures Accessibilité débutants 82/100
docker/docs#26376 · 1 personne assignée ·
Les mainteneurs répondent en général sous 1 jour
Toutes les issues de docker/docs
Issues similaires
-
Liens externes cassésOuverte
Difficulté 1/5 1-3 heures Accessibilité débutants 66/100
betagouv/conseillers-entreprises#4770 ·
Les mainteneurs répondent en général sous 1 jour
-
Difficulté 2/5 1-3 heures Accessibilité débutants 68/100
awsdocs/amazon-eks-user-guide#1257 ·
-
eks-recon: six more null-iteration crashes (networking env/args, observability ConfigMap data)Ouvertedeep-dive-feedback
Difficulté 2/5 1-3 heures Accessibilité débutants 78/100
aws-samples/sample-apex-skills#292 ·
Les mainteneurs répondent en général sous 1 jour
-
Difficulté 2/5 1-3 heures Accessibilité débutants 70/100
italia/eid-wallet-it-docs#1253 ·
Les mainteneurs répondent en général sous 13 jours
-
Difficulté 1/5 1-3 heures Accessibilité débutants 65/100
Les mainteneurs répondent en général sous 1 jour