[TorchComms] integration CI tests (#1927)

Author: mori360

.github/workflows/integration_test_8gpu_torchcomms.yaml

@@ -0,0 +1,53 @@
+name: TorchComms 8 GPU Integration Tests
+
+on:
+  push:
+    branches: [ main ]
+    paths:
+      - 'torchtitan/experiments/torchcomms/**'
+      - '.github/workflows/integration_test_8gpu_torchcomms.yaml'
+  pull_request:
+    paths:
+      - 'torchtitan/experiments/torchcomms/**'
+      - '.github/workflows/integration_test_8gpu_torchcomms.yaml'
+  schedule:
+    # Runs every 12 hours
+    - cron: '0 */12 * * *'
+
+concurrency:
+  group: unit-test${{ github.workflow }}-${{ github.ref == 'refs/heads/main' && github.run_number || github.ref }}
+  cancel-in-progress: true
+
+defaults:
+  run:
+    shell: bash -l -eo pipefail {0}
+
+jobs:
+  build-test:
+    uses: pytorch/test-infra/.github/workflows/linux_job.yml@main
+    with:
+      runner: linux.g5.48xlarge.nvidia.gpu
+      gpu-arch-type: cuda
+      gpu-arch-version: "12.8"
+      # This image is faster to clone than the default, but it lacks CC needed by triton
+      # (1m25s vs 2m37s).
+      docker-image: torchtitan-ubuntu-20.04-clang12
+      repository: pytorch/torchtitan
+      upload-artifact: outputs
+      script: |
+        set -eux
+
+        # The generic Linux job chooses to use base env, not the one setup by the image
+        CONDA_ENV=$(conda env list --json | jq -r ".envs | .[-1]")
+        conda activate "${CONDA_ENV}"
+
+        # Log CUDA driver version for debugging.
+        DRIVER_VERSION=$(nvidia-smi --query-gpu=driver_version --format=csv,noheader | head -n 1 || true)
+        echo "CUDA driver version: ${DRIVER_VERSION}"
+
+        pip config --user set global.progress_bar off
+
+        python -m pip install --force-reinstall --pre torch torchcomms --index-url https://download.pytorch.org/whl/nightly/cu128
+
+        mkdir artifacts-to-be-uploaded
+        TEST_BACKEND=ncclx TRAIN_FILE=torchtitan.experiments.torchcomms.train python -m torchtitan.experiments.torchcomms.integration_tests artifacts-to-be-uploaded --ngpu 8

torchtitan/experiments/torchcomms/integration_tests.py

@@ -0,0 +1,100 @@
+# Copyright (c) Meta Platforms, Inc. and affiliates.
+# All rights reserved.
+#
+# This source code is licensed under the BSD-style license found in the
+# LICENSE file in the root directory of this source tree.
+
+import argparse
+import os
+
+from tests.integration_tests import OverrideDefinitions
+from tests.integration_tests.run_tests import run_tests
+
+
+def build_torchcomms_test_list() -> list[OverrideDefinitions]:
+    """
+    key is the config file name and value is a list of OverrideDefinitions
+    that is used to generate variations of integration tests based on the
+    same root config file.
+    """
+    integration_tests_flavors = [
+        OverrideDefinitions(
+            [
+                [],
+            ],
+            "1D FSDP",
+            "1d",
+        ),
+        OverrideDefinitions(
+            [
+                [
+                    "--parallelism.tensor_parallel_degree 2",
+                    "--parallelism.pipeline_parallel_degree 2",
+                ],
+            ],
+            "FSDP+TP+PP",
+            "3d_dp+tp+pp",
+            ngpu=8,
+        ),
+        # TODO: Enable CP and async TP tests once fixes are available in
+        # torchcomms nightly builds.
+        # OverrideDefinitions(
+        #    [
+        #        [
+        #            "--parallelism.context_parallel_degree 2",
+        #            "--parallelism.pipeline_parallel_degree 2",
+        #        ],
+        #    ],
+        #    "DP+CP+PP",
+        #    "3d_dp+cp+pp",
+        #    ngpu=8,
+        # ),
+        # OverrideDefinitions(
+        #    [
+        #        [
+        #            "--compile.enable",
+        #            "--parallelism.context_parallel_degree 2",
+        #            "--parallelism.tensor_parallel_degree 2",
+        #            "--parallelism.enable_async_tensor_parallel",
+        #        ],
+        #    ],
+        #    "3D CP+async TP compile",
+        #    "3d_cp+asynctp_compile",
+        #    ngpu=8,
+        # ),
+    ]
+    return integration_tests_flavors
+
+
+_TEST_SUITES_FUNCTION = {
+    "torchcomms": build_torchcomms_test_list,
+}
+
+
+def main():
+    parser = argparse.ArgumentParser()
+    parser.add_argument("output_dir")
+    parser.add_argument(
+        "--config_path",
+        default="./tests/integration_tests/base_config.toml",
+        help="Base config path for integration tests. This is the config that will be used as a base for all tests.",
+    )
+    parser.add_argument(
+        "--test_name",
+        default="all",
+        help="test to run, acceptable values: `test_name` in `build_test_list` (default: all)",
+    )
+    parser.add_argument("--ngpu", default=8, type=int)
+    args = parser.parse_args()
+
+    if not os.path.exists(args.output_dir):
+        os.makedirs(args.output_dir)
+    if os.listdir(args.output_dir):
+        raise RuntimeError("Please provide an empty output directory.")
+
+    test_list = _TEST_SUITES_FUNCTION["torchcomms"]()
+    run_tests(args, test_list)
+
+
+if __name__ == "__main__":
+    main()