refactor(colcon-build): nice-command to build-pre-command

colcon-build/README.md

@@ -39,9 +39,9 @@
 | token                        | false    | The token for build dependencies.                                                                                       |
 | include-eol-distros          | false    | If true, adds `--include-eol-distros` to `rosdep update`.                                                               |
 | cache-key-element            | false    | This value is added to the github actions cache key.                                                                    |
-| nice-command                 | false    | This command is prepended to the `colcon build` to avoid draining resources.                                            |
+| build-pre-command            | false    | This command is prepended to the `colcon build` to avoid draining resources.                                            |
 | colcon-parallel-workers-flag | false    | Will be appended to the colcon build command to limit number of packages built in parallel. e.g. "--parallel-workers 3" |
 | makeflags                    | false    | Will be exported as MAKEFLAGS environment variable for colcon build step. e.g. "-j 4"                                   |
 
 ## Outputs
 

colcon-build/action.yaml

@@ -26,16 +26,16 @@
     description: Will be part of the cache key
     default: default
     required: false
-  nice-command:
-    description: See `man nice` for details
+  build-pre-command:
+    description: Will be prepended to the colcon build command. e.g. "nice -n 19" or "taskset --cpu-list 0-2"
     required: false
     default: nice -n 19
   colcon-parallel-workers-flag:
     description: Will be appended to the colcon build command to limit number of packages built in parallel. e.g. "--parallel-workers 3"
     default: ""
     required: false
   makeflags:
     description: Will be exported as MAKEFLAGS environment variable. e.g. "-j 4"
     default: ""
     required: false
 
@@ -92,9 +92,9 @@
         cat /etc/nsswitch.conf
         sed -e 's#hosts:\(.*\)dns\(.*\)#hosts:\1\2#g' -i.bak /etc/nsswitch.conf
         cat /etc/nsswitch.conf
         MAKEFLAGS="${{ inputs.makeflags }}"
         echo "MAKEFLAGS=$MAKEFLAGS"  # for debugging
-        ${{ inputs.nice-command }} colcon build ${{ inputs.colcon-parallel-workers-flag }} \
+        ${{ inputs.build-pre-command }} colcon build ${{ inputs.colcon-parallel-workers-flag }} \
           --event-handlers console_cohesion+ \
           --packages-above-and-dependencies ${{ inputs.target-packages }} \
           --cmake-args -DCMAKE_BUILD_TYPE=${{ inputs.cmake-build-type }} \