Merge pull request #2871 from dkliban/thread-safe-progress

Adds docs about using ProgressBar with threads
pulp · Dec 5, 2016 · c724040 · c724040
2 parents 7595b3e + ee3ec28
commit c724040
Showing 1 changed file with 5 additions and 0 deletions.
diff --git a/app/pulp/app/models/progress.py b/app/pulp/app/models/progress.py
@@ -181,6 +181,11 @@ class ProgressBar(ProgressReport):
 
     ProgressBar objects are associated with a Task and auto-discover and populate the task id when
     saved.
+
+    When using threads to update a ProgressBar in parallel, it is recommended that all threads
+    share the same in-memory instance. Django does not synchronize in-memory model instances, so
+    multiple instances of a specific ProgressBar will diverge as they are written to from separate
+    threads.
     """
 
     class Meta: