mindspore.mint.distributed.destroy_process_group

查看源文件
mindspore.mint.distributed.destroy_process_group(group=None)[源代码]

销毁指定通讯group。 如果指定的通讯group为None或“hccl_world_group”, 则销毁全局通讯域并释放分布式资源,例如 hccl 服务。

说明

  • 当前接口不支持GPU、CPU版本的MindSpore调用。

  • 此方法应该在 init_process_group 方法之后使用。

参数:
  • group (str,可选) - 通信组名称,通常由 mindspore.mint.distributed.new_group 方法创建,如果为 None , Ascend平台表示为 "hccl_world_group" 。 默认值: None

异常:
  • TypeError - 在参数 group 不是字符串时抛出。

  • RuntimeError - HCCL 服务不可用时,或者使用了MindSpore的GPU或CPU版本。

支持平台:

Ascend

样例:

说明

运行以下样例之前,需要配置好通信环境变量。

针对Ascend设备,推荐使用msrun启动方式,无第三方以及配置文件依赖。详见 msrun启动

>>> import mindspore as ms
>>> from mindspore import set_context
>>> from mindspore.mint.distributed import init_process_group, destroy_process_group
>>> set_context(device_target="Ascend")
>>> init_process_group()
>>> destroy_process_group()