Adds docs about using ProgressBar with threads

closes #2318 https://pulp.plan.io/issues/2318
pulp · Dec 5, 2016 · eb2cd45 · eb2cd45
1 parent 7595b3e
commit eb2cd45
Showing 1 changed file with 4 additions and 0 deletions.
diff --git a/app/pulp/app/models/progress.py b/app/pulp/app/models/progress.py
@@ -181,6 +181,10 @@ 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 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 in separate threads.
     """
 
     class Meta: