Resolving CircleCI Runner Error: Missing --kube.task-pod-config Flag

Overview

Users upgrading to CircleCI Runner V3 may encounter an error related to a missing --kube.task-pod-config flag. This article provides a solution to this issue, ensuring a smooth transition to the latest version.

Prerequisites

• Ensure you have administrative access to your self-hosted runner machines.
• Verify that you are following the correct installation guide for CircleCI Runner V3 on Windows.

Instructions

To address the error message encountered during the upgrade to V3, follow these steps:

1. Open your command prompt or terminal on the Windows machine where you're setting up the CircleCI Runner.
2. Navigate to the directory containing your circleci-runner.exe file.

3. Run the following command to start your runner: 

   ./circleci-runner.exe machine --config machine-runner-config.yaml. 

   Replace machine-runner-config.yaml with the path to your actual configuration file if it's located elsewhere or named differently.

Solution

The correct command to start the CircleCI Runner on Windows should not include the --kube.task-pod-config flag, as it is not required for the machine runner. Using the command provided above should start the runner without the error.

Additional Resources

• Installing CircleCI Runner on Windows
• Manual Installation of CircleCI Runner on Windows
• CircleCI Runner documentation.