real_accelerator.py 6.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164
  1. # Copyright (c) Microsoft Corporation.
  2. # SPDX-License-Identifier: Apache-2.0
  3. # DeepSpeed Team
  4. import os
  5. try:
  6. # Importing logger currently requires that torch is installed, hence the try...except
  7. # TODO: Remove logger dependency on torch.
  8. from deepspeed.utils import logger as accel_logger
  9. except ImportError as e:
  10. accel_logger = None
  11. try:
  12. from accelerator.abstract_accelerator import DeepSpeedAccelerator as dsa1
  13. except ImportError as e:
  14. dsa1 = None
  15. try:
  16. from deepspeed.accelerator.abstract_accelerator import DeepSpeedAccelerator as dsa2
  17. except ImportError as e:
  18. dsa2 = None
  19. ds_accelerator = None
  20. def _validate_accelerator(accel_obj):
  21. # because abstract_accelerator has different path during
  22. # build time (accelerator.abstract_accelerator)
  23. # and run time (deepspeed.accelerator.abstract_accelerator)
  24. # and extension would import the
  25. # run time abstract_accelerator/DeepSpeedAccelerator as its base
  26. # class, so we need to compare accel_obj with both base class.
  27. # if accel_obj is instance of DeepSpeedAccelerator in one of
  28. # accelerator.abstractor_accelerator
  29. # or deepspeed.accelerator.abstract_accelerator, consider accel_obj
  30. # is a conforming object
  31. if not ((dsa1 != None and isinstance(accel_obj, dsa1)) or (dsa2 != None and isinstance(accel_obj, dsa2))):
  32. raise AssertionError(f'{accel_obj.__class__.__name__} accelerator is not subclass of DeepSpeedAccelerator')
  33. # TODO: turn off is_available test since this breaks tests
  34. #assert accel_obj.is_available(), \
  35. # f'{accel_obj.__class__.__name__} accelerator fails is_available() test'
  36. def get_accelerator():
  37. global ds_accelerator
  38. if ds_accelerator is not None:
  39. return ds_accelerator
  40. accelerator_name = None
  41. ds_set_method = None
  42. # 1. Detect whether there is override of DeepSpeed accelerators from environment variable.
  43. # DS_ACCELERATOR = 'cuda'|'xpu'|'cpu'
  44. if 'DS_ACCELERATOR' in os.environ.keys():
  45. accelerator_name = os.environ['DS_ACCELERATOR']
  46. if accelerator_name == 'xpu':
  47. try:
  48. from intel_extension_for_deepspeed import XPU_Accelerator # noqa: F401
  49. except ImportError as e:
  50. raise ValueError(
  51. f'XPU_Accelerator requires intel_extension_for_deepspeed, which is not installed on this system.')
  52. elif accelerator_name == 'cpu':
  53. try:
  54. import intel_extension_for_pytorch # noqa: F401
  55. except ImportError as e:
  56. raise ValueError(
  57. f'CPU_Accelerator requires intel_extension_for_pytorch, which is not installed on this system.')
  58. elif accelerator_name == 'cuda':
  59. pass
  60. else:
  61. raise ValueError(
  62. f'DS_ACCELERATOR must be one of "cuda", "cpu", or "xpu". Value "{accelerator_name}" is not supported')
  63. ds_set_method = 'override'
  64. # 2. If no override, detect which accelerator to use automatically
  65. if accelerator_name == None:
  66. try:
  67. from intel_extension_for_deepspeed import XPU_Accelerator # noqa: F401,F811
  68. accelerator_name = 'xpu'
  69. except ImportError as e:
  70. # We need a way to choose between CUDA_Accelerator and CPU_Accelerator
  71. # Currently we detect whether intel_extension_for_pytorch is installed
  72. # in the environment and use CPU_Accelerator if the answer is True.
  73. # An alternative might be detect whether CUDA device is installed on
  74. # the system but this comes with two pitfalls:
  75. # 1. the system may not have torch pre-installed, so
  76. # get_accelerator().is_available() may not work.
  77. # 2. Some scenario like install on login node (without CUDA device)
  78. # and run on compute node (with CUDA device) may cause mismatch
  79. # between installation time and runtime.
  80. try:
  81. import intel_extension_for_pytorch # noqa: F401,F811
  82. accelerator_name = 'cpu'
  83. except ImportError as e:
  84. accelerator_name = 'cuda'
  85. ds_set_method = 'auto detect'
  86. # 3. Set ds_accelerator accordingly
  87. if accelerator_name == 'cuda':
  88. from .cuda_accelerator import CUDA_Accelerator
  89. ds_accelerator = CUDA_Accelerator()
  90. elif accelerator_name == 'cpu':
  91. from .cpu_accelerator import CPU_Accelerator
  92. ds_accelerator = CPU_Accelerator()
  93. elif accelerator_name == 'xpu':
  94. # XPU_Accelerator is already imported in detection stage
  95. ds_accelerator = XPU_Accelerator()
  96. _validate_accelerator(ds_accelerator)
  97. if accel_logger is not None:
  98. accel_logger.info(f"Setting ds_accelerator to {ds_accelerator._name} ({ds_set_method})")
  99. return ds_accelerator
  100. def set_accelerator(accel_obj):
  101. global ds_accelerator
  102. _validate_accelerator(accel_obj)
  103. if accel_logger is not None:
  104. accel_logger.info(f"Setting ds_accelerator to {accel_obj._name} (model specified)")
  105. ds_accelerator = accel_obj
  106. '''
  107. -----------[code] test_get.py -----------
  108. from deepspeed.accelerator import get_accelerator
  109. my_accelerator = get_accelerator()
  110. logger.info(f'{my_accelerator._name=}')
  111. logger.info(f'{my_accelerator._communication_backend=}')
  112. logger.info(f'{my_accelerator.HalfTensor().device=}')
  113. logger.info(f'{my_accelerator.total_memory()=}')
  114. -----------[code] test_get.py -----------
  115. ---[output] python test_get.py---------
  116. my_accelerator.name()='cuda'
  117. my_accelerator.communication_backend='nccl'
  118. my_accelerator.HalfTensor().device=device(type='cuda', index=0)
  119. my_accelerator.total_memory()=34089730048
  120. ---[output] python test_get.py---------
  121. **************************************************************************
  122. -----------[code] test_set.py -----------
  123. from deepspeed.accelerator.cuda_accelerator import CUDA_Accelerator
  124. cu_accel = CUDA_Accelerator()
  125. logger.info(f'{id(cu_accel)=}')
  126. from deepspeed.accelerator import set_accelerator, get_accelerator
  127. set_accelerator(cu_accel)
  128. my_accelerator = get_accelerator()
  129. logger.info(f'{id(my_accelerator)=}')
  130. logger.info(f'{my_accelerator._name=}')
  131. logger.info(f'{my_accelerator._communication_backend=}')
  132. logger.info(f'{my_accelerator.HalfTensor().device=}')
  133. logger.info(f'{my_accelerator.total_memory()=}')
  134. -----------[code] test_set.py -----------
  135. ---[output] python test_set.py---------
  136. id(cu_accel)=139648165478304
  137. my_accelerator=<deepspeed.accelerator.cuda_accelerator.CUDA_Accelerator object at 0x7f025f4bffa0>
  138. my_accelerator.name='cuda'
  139. my_accelerator.communication_backend='nccl'
  140. my_accelerator.HalfTensor().device=device(type='cuda', index=0)
  141. my_accelerator.total_memory()=34089730048
  142. ---[output] python test_set.py---------
  143. '''