Skip to content

Default non-Windows bash is not invoked as documented #353

Closed

Description

@johnstevenson

Describe the bug
The documentation at https://help.github.com/en/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun implies that when a shell is not specified on a non-Windows platform, bash (if found) will be invoked as bash --noprofile --norc -eo pipefail {0}.

Fail-fast behavior using set -e o pipefail: Default for bash and built-in shell. It is also the default when you don't provide an option on non-Windows platforms.

However, this is not exactly the case.

To Reproduce
Steps to reproduce the behavior:

  1. Create an action without specifying a shell value:
    - name: No shell specified (default bash)
      run: echo Hello, world!
  1. Observe that it is executed as shell: /bin/bash -e {0} as per this example at https://github.com/johnstevenson/runner-actions-test/actions/runs/48283923 which also shows the documented behaviour when the shell is specified.

action-error-bash

Expected behavior
For the command to be executed as shell: /bin/bash --noprofile --norc -e -o pipefail {0}

Runner Version and Platform

Current runner version: 2.165.2
Tested on ubuntu-latest and macos-latest

What's not working?

Regardless of whether this is a documentation problem (or my incorrect interpretation), there is no consistency when invoking bash with and without a shell value.

The ScriptHandler:RunAsync code (also duplicated in ScriptHandler:PrintActionDetails) sets shellCommand as sh even if bash is found, resulting in the wrong format string being used:

if (string.IsNullOrEmpty(shell))
{
#if OS_WINDOWS
shellCommand = "pwsh";
commandPath = WhichUtil.Which(shellCommand, require: false, Trace, prependPath);
if (string.IsNullOrEmpty(commandPath))
{
shellCommand = "powershell";
Trace.Info($"Defaulting to {shellCommand}");
commandPath = WhichUtil.Which(shellCommand, require: true, Trace, prependPath);
}
ArgUtil.NotNullOrEmpty(commandPath, "Default Shell");
#else
shellCommand = "sh";
commandPath = WhichUtil.Which("bash", false, Trace, prependPath) ?? WhichUtil.Which("sh", true, Trace, prependPath);
#endif
argFormat = ScriptHandlerHelpers.GetScriptArgumentsFormat(shellCommand);

So any fix would be:

#if OS_WINDOWS
                shellCommand = "pwsh";
                commandPath = WhichUtil.Which(shellCommand, require: false, Trace, prependPath);
                if (string.IsNullOrEmpty(commandPath))
                {
                    shellCommand = "powershell";
                    Trace.Info($"Defaulting to {shellCommand}");
                    commandPath = WhichUtil.Which(shellCommand, require: true, Trace, prependPath);
                }
                ArgUtil.NotNullOrEmpty(commandPath, "Default Shell");
#else
                shellCommand = "bash";
                commandPath = WhichUtil.Which(shellCommand, require: false, Trace, prependPath)
                if (string.IsNullOrEmpty(commandPath))
                {
                    shellCommand = "sh";
                    Trace.Info($"Defaulting to {shellCommand}");
                    commandPath = WhichUtil.Which(shellCommand, require: true, Trace, prependPath);
                }
                ArgUtil.NotNullOrEmpty(commandPath, "Default Shell");
#endif
                argFormat = ScriptHandlerHelpers.GetScriptArgumentsFormat(shellCommand);

I'd happily PR this if needed and if I could find out how you debug an action in Visual Studio (are there any docs about this?)

Activity

  1. added
    Runner BugBug fix scope to the runner
    and removed
    bugSomething isn't working
    on Jun 6, 2020
  2. bendavies commented on Oct 27, 2020

    @bendavies

    Just came across this - this is still an issue.

  3. johnstevenson commented on Oct 27, 2020

    @johnstevenson
    Author

    The behaviour is still the same: https://github.com/johnstevenson/runner-actions-test/runs/1317090059
    and the documentation hasn't changed, so yes.

  4. amacneil commented on Aug 24, 2021

    @amacneil

    Still appears to be a problem

  5. self-assigned this
    on Feb 25, 2022
  6. self-assigned this
    on Mar 14, 2022
  7. thboop commented on Mar 14, 2022

    @thboop
    Collaborator

    This is working as intended, thought I definitely understand with the docs in their current state this is very confusing.

    For hosted runners, we know bash is installed, so users can expect their steps to run on it. For self hosted runners, we don't have the same luxury.
    -eo pipefail would cause scripts executing on bash to fail where there would have passed on a sh instance, which could be confusing and tricky to debug for workflow authors who don't have great visibility into what software is installed on the runner they landed on (or what happened to be in the PATH at the time of the run).

    That being said, we should update the docs to clarify this behavior. I've filed an issue to update the documentation so we can improve this experience.

    Thank you for the report! I'm going to close out this issue for now. If you need this behavior, you can use the job defaults shell and specify it as bash to invoke all steps with bash --noprofile --norc -eo pipefail {0}

  8. Makeshift commented on Sep 12, 2022

    @Makeshift

    For self hosted runners, we don't have the same luxury.

    I'm aware this issue has been closed for a long time, and this does make sense for self-hosted runners and code running in the self-hosted environment.

    However, for containers, wouldn't it be preferable to query the default shell before starting the container and set the job defaults appropriately as part of container start?

    eg.

    $ docker inspect catthehacker/ubuntu:act-latest | jq -c '.[0].Config.Shell'
    ["/bin/bash","--login","-e","-o","pipefail","-c"]
    

    Let me know if this should be a new issue/suggestion.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions