Skip to main content

Shell/Bash scripts

Semaphore can run shell scripts using /bin/bash. To do this, create a Bash Script task template.

Creating a Bash template​

  1. Go to Task Templates section and click the New Template button.
  2. Select Bash as the app type.
  3. Configure the template:
FieldDescription
NameA descriptive name for the template
RepositoryRepository containing your shell script
Playbook / ScriptRelative path to the script, e.g. scripts/deploy.sh
Variable GroupsVariable groups whose values are injected as environment variables
  1. Click Create.
  2. Click Run to execute the template.

Passing variables to scripts​

Variables from the selected Variable Groups are injected as environment variables. Access them in the script with $VARIABLE_NAME:

#!/bin/bash
echo "Deploying to $TARGET_HOST"

Notes​

  • Make your script executable (chmod +x) or ensure it starts with a valid shebang (#!/bin/bash).
  • Scripts run non-interactively. Avoid prompts that wait for user input.
  • Exit code 0 means success; any non-zero exit code marks the task as failed.
  • To run commands on remote hosts, use Ansible instead.