Development of an internal social media platform with personalised dashboards for students
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

prefork.py 5.6KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178
  1. # -*- coding: utf-8 -*-
  2. """
  3. celery.concurrency.prefork
  4. ~~~~~~~~~~~~~~~~~~~~~~~~~~
  5. Pool implementation using :mod:`multiprocessing`.
  6. """
  7. from __future__ import absolute_import
  8. import os
  9. from billiard import forking_enable
  10. from billiard.pool import RUN, CLOSE, Pool as BlockingPool
  11. from celery import platforms
  12. from celery import signals
  13. from celery._state import set_default_app, _set_task_join_will_block
  14. from celery.app import trace
  15. from celery.concurrency.base import BasePool
  16. from celery.five import items
  17. from celery.utils.functional import noop
  18. from celery.utils.log import get_logger
  19. from .asynpool import AsynPool
  20. __all__ = ['TaskPool', 'process_initializer', 'process_destructor']
  21. #: List of signals to reset when a child process starts.
  22. WORKER_SIGRESET = frozenset(['SIGTERM',
  23. 'SIGHUP',
  24. 'SIGTTIN',
  25. 'SIGTTOU',
  26. 'SIGUSR1'])
  27. #: List of signals to ignore when a child process starts.
  28. WORKER_SIGIGNORE = frozenset(['SIGINT'])
  29. logger = get_logger(__name__)
  30. warning, debug = logger.warning, logger.debug
  31. def process_initializer(app, hostname):
  32. """Pool child process initializer.
  33. This will initialize a child pool process to ensure the correct
  34. app instance is used and things like
  35. logging works.
  36. """
  37. _set_task_join_will_block(True)
  38. platforms.signals.reset(*WORKER_SIGRESET)
  39. platforms.signals.ignore(*WORKER_SIGIGNORE)
  40. platforms.set_mp_process_title('celeryd', hostname=hostname)
  41. # This is for Windows and other platforms not supporting
  42. # fork(). Note that init_worker makes sure it's only
  43. # run once per process.
  44. app.loader.init_worker()
  45. app.loader.init_worker_process()
  46. logfile = os.environ.get('CELERY_LOG_FILE') or None
  47. if logfile and '%i' in logfile.lower():
  48. # logfile path will differ so need to set up logging again.
  49. app.log.already_setup = False
  50. app.log.setup(int(os.environ.get('CELERY_LOG_LEVEL', 0) or 0),
  51. logfile,
  52. bool(os.environ.get('CELERY_LOG_REDIRECT', False)),
  53. str(os.environ.get('CELERY_LOG_REDIRECT_LEVEL')),
  54. hostname=hostname)
  55. if os.environ.get('FORKED_BY_MULTIPROCESSING'):
  56. # pool did execv after fork
  57. trace.setup_worker_optimizations(app)
  58. else:
  59. app.set_current()
  60. set_default_app(app)
  61. app.finalize()
  62. trace._tasks = app._tasks # enables fast_trace_task optimization.
  63. # rebuild execution handler for all tasks.
  64. from celery.app.trace import build_tracer
  65. for name, task in items(app.tasks):
  66. task.__trace__ = build_tracer(name, task, app.loader, hostname,
  67. app=app)
  68. from celery.worker import state as worker_state
  69. worker_state.reset_state()
  70. signals.worker_process_init.send(sender=None)
  71. def process_destructor(pid, exitcode):
  72. """Pool child process destructor
  73. Dispatch the :signal:`worker_process_shutdown` signal.
  74. """
  75. signals.worker_process_shutdown.send(
  76. sender=None, pid=pid, exitcode=exitcode,
  77. )
  78. class TaskPool(BasePool):
  79. """Multiprocessing Pool implementation."""
  80. Pool = AsynPool
  81. BlockingPool = BlockingPool
  82. uses_semaphore = True
  83. write_stats = None
  84. def on_start(self):
  85. """Run the task pool.
  86. Will pre-fork all workers so they're ready to accept tasks.
  87. """
  88. forking_enable(self.forking_enable)
  89. Pool = (self.BlockingPool if self.options.get('threads', True)
  90. else self.Pool)
  91. P = self._pool = Pool(processes=self.limit,
  92. initializer=process_initializer,
  93. on_process_exit=process_destructor,
  94. synack=False,
  95. **self.options)
  96. # Create proxy methods
  97. self.on_apply = P.apply_async
  98. self.maintain_pool = P.maintain_pool
  99. self.terminate_job = P.terminate_job
  100. self.grow = P.grow
  101. self.shrink = P.shrink
  102. self.flush = getattr(P, 'flush', None) # FIXME add to billiard
  103. def restart(self):
  104. self._pool.restart()
  105. self._pool.apply_async(noop)
  106. def did_start_ok(self):
  107. return self._pool.did_start_ok()
  108. def register_with_event_loop(self, loop):
  109. try:
  110. reg = self._pool.register_with_event_loop
  111. except AttributeError:
  112. return
  113. return reg(loop)
  114. def on_stop(self):
  115. """Gracefully stop the pool."""
  116. if self._pool is not None and self._pool._state in (RUN, CLOSE):
  117. self._pool.close()
  118. self._pool.join()
  119. self._pool = None
  120. def on_terminate(self):
  121. """Force terminate the pool."""
  122. if self._pool is not None:
  123. self._pool.terminate()
  124. self._pool = None
  125. def on_close(self):
  126. if self._pool is not None and self._pool._state == RUN:
  127. self._pool.close()
  128. def _get_info(self):
  129. try:
  130. write_stats = self._pool.human_write_stats
  131. except AttributeError:
  132. def write_stats():
  133. return 'N/A' # only supported by asynpool
  134. return {
  135. 'max-concurrency': self.limit,
  136. 'processes': [p.pid for p in self._pool._pool],
  137. 'max-tasks-per-child': self._pool._maxtasksperchild or 'N/A',
  138. 'put-guarded-by-semaphore': self.putlocks,
  139. 'timeouts': (self._pool.soft_timeout or 0,
  140. self._pool.timeout or 0),
  141. 'writes': write_stats()
  142. }
  143. @property
  144. def num_processes(self):
  145. return self._pool._processes