Files
paddlepaddle--paddle/python/paddle/distributed/auto_parallel/static/process_group.py
T
2026-07-13 12:40:42 +08:00

276 lines
9.7 KiB
Python

# Copyright (c) 2021 PaddlePaddle Authors. All Rights Reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License
import hashlib
from collections import OrderedDict
import paddle
from paddle.framework import core
from ...collective import _get_global_env, _new_ring_id
from ...utils.log_utils import get_logger
from .utils import dygraph_guard
logger = get_logger("INFO", __name__)
def get_all_process_groups():
global _g_process_group_map
return _g_process_group_map.values()
def get_process_group(group_id, g_process_group_map=None):
global _g_process_group_map
return (
_g_process_group_map.get(group_id, None)
if g_process_group_map is None
else g_process_group_map.get(group_id, None)
)
def get_world_process_group():
global _g_process_group_map
return _g_process_group_map[0]
def clear_all_process_groups():
global _g_process_group_map
_g_process_group_map = {}
_g_process_group_map[0] = ProcessGroup(0, [])
def remove_process_group(ring_id):
global _g_process_group_map
if ring_id in _g_process_group_map:
_g_process_group_map.pop(ring_id)
def new_process_group(
ranks, group_id=None, force_new_group=False, group_type=None
):
global _g_process_group_map
if not force_new_group:
# A key constructed from ranks is used for avoiding duplication
new_key = '_'.join(map(str, ranks))
for pg_id, pg in _g_process_group_map.items():
cur_key = '_'.join(map(str, pg.ranks))
if pg_id != 0 and new_key == cur_key:
return pg
# If not matching the existing one, construct a new process group
num_groups = len(_g_process_group_map)
# Note: our process group may interfere with the original implementation
# so the created group id should start from the original _new_ring_id()
if group_id is None:
group_id = _new_ring_id() + num_groups + 1
new_pg = ProcessGroup(group_id, ranks, group_type)
_g_process_group_map[group_id] = new_pg
return new_pg
# This implementation refers to lots of Paddle/python/paddle/distributed/collective.py,
# Fleet also has a collective helper which uses ops to initialize communication in
# Paddle/python/paddle/distributed/fleet/meta_optimizers/common.py. We use the first one
# because it seems simple. This should be enhanced to manage the process membership and
# the instantiation process in a more general way. In the future, the process group may
# handle the communication implementation choice.
class ProcessGroup:
def __init__(self, group_id, ranks, group_type=None):
if group_id == 0 and get_process_group(0) is not None:
assert group_id != 0, (
"Process group id 0 is reserved for all ranks."
)
self._group_id = group_id
self._ranks = ranks
# Add the current ranks into group 0
if group_id != 0:
global _g_process_group_map
_g_process_group_map[0].add_ranks(ranks)
self._is_instantiate = False
self._group_type = group_type
@property
def id(self):
return self._group_id
@property
def ranks(self):
return self._ranks
@property
def nranks(self):
return len(self._ranks)
@property
def group_type(self):
return self._group_type
def add_ranks(self, new_ranks):
if set(new_ranks) <= set(self.ranks):
return
else:
assert not self.is_instantiate(), (
"Cannot add new ranks after instantiating the process group"
)
self._ranks.extend(new_ranks)
self._ranks = list(set(self.ranks))
def local_rank(self, global_rank):
if global_rank in self.ranks:
return self.ranks.index(global_rank)
else:
raise AssertionError(
f"Rank {global_rank} doesn't belong to this group"
)
def is_instantiate(self):
return self._is_instantiate
@dygraph_guard
def instantiate(self):
if self._is_instantiate:
return
ring_id = self.id
genv = _get_global_env()
global_rank = genv.rank
if self.nranks >= 2 and global_rank in self.ranks:
logger.info(
f"group_id: {self.id}, ranks: {self.ranks}, nranks: {self.nranks}, trainer_endpoints: {genv.current_endpoint}"
)
strategy = core.ParallelStrategy()
strategy.nranks = self.nranks
strategy.local_rank = self.local_rank(global_rank)
strategy.trainer_endpoints = [
genv.trainer_endpoints[i] for i in self.ranks
]
strategy.current_endpoint = genv.current_endpoint
strategy.nrings = 1
if core.is_compiled_with_cuda():
place = core.CUDAPlace(genv.device_id)
store = core.create_or_get_global_tcp_store()
endpoints_str = ""
for endpoint in strategy.trainer_endpoints:
endpoints_str += endpoint
endpoints_str += f"ring_id:{ring_id}"
endpoints_str_hash = hashlib.md5(
endpoints_str.encode(encoding='UTF-8')
).hexdigest()
core.CommContextManager.set_device_id(genv.device_id)
core.CommContextManager.create_nccl_comm_context(
store,
str(ring_id),
strategy.local_rank,
strategy.nranks,
endpoints_str_hash,
)
elif core.is_compiled_with_xpu():
place = core.XPUPlace(genv.device_id)
store = core.create_or_get_global_tcp_store()
endpoints_str = ""
for endpoint in strategy.trainer_endpoints:
endpoints_str += endpoint
endpoints_str += f"ring_id:{ring_id}"
endpoints_str_hash = hashlib.md5(
endpoints_str.encode(encoding='UTF-8')
).hexdigest()
core.CommContextManager.set_device_id(genv.device_id)
core.CommContextManager.create_bkcl_comm_context(
store,
str(ring_id),
strategy.local_rank,
strategy.nranks,
endpoints_str_hash,
)
elif genv.device_type in core.get_all_custom_device_type():
place = core.CustomPlace(genv.device_type, genv.device_id)
core.XCCLParallelContext(strategy, place).init_with_ring_id(
ring_id
)
else:
raise AssertionError('No CUDA device found')
if core.is_compiled_with_cuda():
paddle.set_device(
f'gpu:{paddle.distributed.ParallelEnv().dev_id}'
)
elif core.is_compiled_with_xpu():
paddle.set_device(
f'xpu:{paddle.distributed.ParallelEnv().dev_id}'
)
elif genv.device_type in core.get_all_custom_device_type():
paddle.set_device(
f'{paddle.distributed.ParallelEnv().device_type!s}:{paddle.distributed.ParallelEnv().dev_id}'
)
# TODO(shenliang03): This is a temporary solution to solve the problem of
# hang caused by cross-creation of new_group
barrier_tensor = paddle.full([1], 1, dtype="int32")
# barrier is not available in xpu for now
if not paddle.framework.core.is_compiled_with_xpu():
paddle._legacy_C_ops.barrier(
barrier_tensor, barrier_tensor, 'ring_id', ring_id
)
# NOTE(zhiqiu): to avoid send/recv hang in lazy init
if self._group_type == 'p2p':
alltoall_tmp = paddle.empty(
shape=[self.nranks, self.nranks], dtype="int32"
)
paddle._legacy_C_ops.all_to_all(
alltoall_tmp, 'use_calc_stream', True, 'ring_id', ring_id
)
paddle.device.cuda.synchronize()
if self.nranks > 1:
barrier_tensor = paddle.full([1], 1, dtype="int32")
# barrier is not available in xpu for now
if not paddle.framework.core.is_compiled_with_xpu():
paddle._legacy_C_ops.barrier(
barrier_tensor, barrier_tensor, 'ring_id', 0
)
self._is_instantiate = True
def is_member(self):
return True
def __eq__(self, other):
if not isinstance(other, ProcessGroup):
return False
if self.id != other.id:
return False
return True
def __ne__(self, other):
return not self.__eq__(other)
def __str__(self):
string = "id: {}, nranks: {}, ranks: {}.".format(
self.id, self.nranks, ", ".join(map(str, self.ranks))
)
return string
def __hash__(self):
return hash(self.__str__())
# Note that Process group 0 is reserved for representing all ranks.
# At the beginning, group 0 is empty and new ranks will be added automatically.
_g_process_group_map = OrderedDict()
_g_process_group_map[0] = ProcessGroup(0, [])