Overview
In CircleCI, users may encounter situations where the "Rerun via SSH" option is not available for specific jobs. This article aims to explain common reasons why this option might be missing and provides troubleshooting steps to address any issues.
Reasons for Missing "Rerun via SSH" Option
Disabled SSH Functionality:
If the SSH feature is disabled in the CircleCI project settings, the "Rerun via SSH" option will not be available for any jobs, even if SSH keys are added to the user account. This is typically enabled and disabled via a call the the API. You can find more information on how to do this here.
Missing SSH Keys:
Without SSH keys added to the user account or project settings, the "Rerun via SSH" option will be inaccessible, as there is no authentication mechanism to establish an SSH connection.
Rerun Dropdown at Workflow Level:
The "Rerun via SSH" option is available at the job level and not at the workflow level in CircleCI. When looking at the rerun dropdown at the workflow level, this option will not be displayed.
Troubleshooting Steps
1. Enable SSH Feature:
Check project settings in CircleCI and ensure that the SSH feature is enabled. If disabled, toggle the settings to allow SSH access.
2. Add SSH Keys:
Add SSH keys to your CircleCI user account or project settings to enable secure SSH connections for debugging purposes.
3. Navigate to Job Level:
To access the "Rerun via SSH" option, navigate to the specific job where you need SSH access. The option is available at the job level under the individual job's settings.
4. Verify Permissions:
Ensure that you have the necessary permissions in the CircleCI project to utilize the "Rerun via SSH" option. Admin or owner access may be required for SSH functionality.
5. Refresh Browser Cache:
Sometimes, a browser cache issue may prevent certain options from displaying correctly. Try refreshing the page or accessing it from a different browser.
Comments
Article is closed for comments.