feat: implement new gRPC transports

.ci/build_matrix.sh

@@ -7,6 +7,7 @@
 # List of versions
 versions=(
     # if added more "latest", change "$LATEST"
+    'v25.2-pre1-ubuntu-cicd'
     'v25.2-ubuntu-cicd'
     'latest-ubuntu-student'
     'v25.2.0'

.ci/start_mapdl.sh

@@ -94,11 +94,7 @@ CMD=$(cat <<-_EOT_
 run \
   --entrypoint /bin/bash \
   --name ${INSTANCE_NAME} \
-  --restart always \
-  --health-interval=0.5s \
-  --health-retries=4 \
-  --health-timeout=0.5s \
-  --health-start-period=10s \
+  --restart unless-stopped \
   -e ANSYSLMD_LICENSE_FILE=1055@${LICENSE_SERVER} \
   -e ANSYS_LOCK="OFF" \
   ${DPF_ON} \
@@ -110,6 +106,7 @@ run \
   -e EXEC_PATH=${EXEC_PATH} \
   -e DISTRIBUTED_MODE=${DISTRIBUTED_MODE} \
   -e MAPDL_IMAGE=${MAPDL_IMAGE} \
+  -e ANSYS_MAPDL_GRPC_TRANSPORT='insecure' \
   --shm-size=2gb \
   -e I_MPI_SHM_LMT=shm \
   -e P_SCHEMA=${P_SCHEMA} \

.github/workflows/ci.yml

@@ -242,7 +242,7 @@ jobs:
     with:
       mapdl-version: "${{ matrix.mapdl-version }}"
       file-name: "remote-${{ matrix.mapdl-version }}"
-      upload-logs: false
+      upload-logs: true
 
   build-test-local-matrix:
     name: "Build test matrix for minimal and local"

.github/workflows/test-local.yml

@@ -145,6 +145,8 @@ jobs:
       OMPI_ALLOW_RUN_AS_ROOT: 1
       OMPI_ALLOW_RUN_AS_ROOT_CONFIRM: 1
       DATAPROCESSING_DEBUG: /home/mapdl/dpf_logs
+      PYMAPDL_GRPC_TRANSPORT: 'insecure'
+      ANSYS_MAPDL_GRPC_TRANSPORT: 'insecure'
 
     container:
       image: "${{ inputs.package-registry }}:${{ inputs.mapdl-version }}" # zizmor: ignore[unpinned-images]
@@ -197,7 +199,6 @@ jobs:
         run: |
           apt-get update && apt-get -y install gcc mono-mcs g++
 
-
       - name: "Installing minimal OS packages"
         shell: bash
         if: inputs.testing-minimal == true
@@ -210,6 +211,20 @@ jobs:
         run: |
           apt-get update && apt install -y libgl1 libglx-mesa0 xvfb libgomp1 graphviz curl git && apt-get clean
 
+      # - name: "Test MAPDL"
+      #   shell: bash
+      #   env:
+      #     ANSYSLMD_LICENSE_FILE: "1055@${{ secrets.license-server }}"
+      #   run: |
+      #     echo "/prep7" > input.dat
+      #     /ansys_inc/v252/ansys/bin/ansys252 -grpc -mpi openmpi -np 2 -b -i input.dat -o output.out
+
+      # - name: "Show output file"
+      #   shell: bash
+      #   if: always()
+      #   run: |
+      #     cat output.out
+
       - name: "Setup Python"
         uses: actions/setup-python@83679a892e2d95755f2dac6acb0bfd1e9ac5d548 #v6.1.0
         with:
@@ -261,6 +276,7 @@ jobs:
           MAPDL_VERSION: ${{ inputs.mapdl-version }}
           PYTEST_INPUT_ARGUMENTS: "${{ inputs.pytest-arguments }}"
           LATEST_VERSION: "${{ inputs.latest-version }}"
+          PYMAPDL_NPROC: 2
         shell: bash
         run: |
           echo "ON_UBUNTU: $ON_UBUNTU"

.github/workflows/test-remote.yml

@@ -90,6 +90,7 @@ jobs:
       TEST_DPF_BACKEND: false
       PYTEST_ARGUMENTS: '--ignore_image_cache'
       MAPDL_PACKAGE: ghcr.io/ansys/mapdl
+      PYMAPDL_GRPC_TRANSPORT: 'insecure'
 
     steps:
       - name: "Freeing some space and show space consumption (pre-test)"

doc/changelog.d/4354.added.md

@@ -0,0 +1 @@
+Implement new gRPC transports

pyproject.toml

@@ -23,7 +23,7 @@ dependencies = [
   "ansys-mapdl-reader>=0.51.7",
   "ansys-math-core>=0.1.2",
   "ansys-platform-instancemanagement~=1.0",
-  "ansys-tools-common>=0.2.1",
+  "ansys-tools-common==0.3.0",
   "click>=8.1.3",                              # for CLI interface
   "grpcio>=1.30.0",                            # tested up to grpcio==1.35
   "numpy>=1.14.0,<3.0.0",
@@ -138,7 +138,7 @@ addopts = [
   "--durations=30",
   "--log-file-level=DEBUG",
   "--log-file=pytest.log",
-  "--maxfail=10",
+  "--maxfail=2",
   "--profile",
   "--profile-svg",
   "--random-order",

src/ansys/mapdl/core/launcher.py

@@ -152,6 +152,11 @@ def version_from_path(*args: Any, **kwargs: Any) -> int | None:
     "on_pool",
     "graphics_backend",
     "use_reader_backend",
+    # Transport-related args
+    "transport_mode",
+    "uds_dir",
+    "uds_id",
+    "certs_dir",
 ]
 
 ON_WSL = os.name == "posix" and (
@@ -1149,6 +1154,11 @@ def launch_mapdl(
     start_instance: Optional[bool] = None,
     start_timeout: Optional[int] = None,
     version: Optional[Union[int, str]] = None,
+    # Transport-related parameters
+    transport_mode: Optional[str] = None,
+    uds_dir: Optional[str] = None,
+    uds_id: Optional[str] = None,
+    certs_dir: Optional[str] = None,
     **kwargs: Dict[str, Any],
 ) -> "MapdlGrpc | MapdlConsole | list[Any]":
     """Start MAPDL locally.
@@ -1400,6 +1410,24 @@ def launch_mapdl(
         variable. If this environment variable is empty, it is as it is not set.
         Defaults to latest available version (:class:`None`).
 
+    transport_mode : str, optional
+        Transport mode for gRPC channel creation. Supported modes are:
+        ``'insecure'``, ``'uds'``, ``'wnua'``, ``'mtls'``.
+        Defaults to :class:`None`, which selects the appropriate mode based on
+        platform and environment variables.
+
+    uds_dir : str, optional
+        Directory for Unix Domain Socket (UDS) files when using ``'uds'`` transport.
+        Defaults to :class:`None`, which uses ``~/.conn``.
+
+    uds_id : str, optional
+        Identifier for UDS socket file when using ``'uds'`` transport.
+        Defaults to :class:`None`, which uses ``mapdl-{port}``.
+
+    certs_dir : str, optional
+        Directory containing certificates for ``'mtls'`` transport.
+        Defaults to :class:`None`.
+
     kwargs : dict, Optional
         These keyword arguments are interface-specific or for
         development purposes. For more information, see Notes.

src/ansys/mapdl/core/mapdl_core.py

@@ -244,6 +244,11 @@
     "start_timeout",
     "timeout",
     "use_reader_backend",
+    # Transport-related parameters
+    "transport_mode",
+    "uds_dir",
+    "uds_id",
+    "certs_dir",
 ]