{"id":349,"date":"2022-03-10T14:42:00","date_gmt":"2022-03-10T14:42:00","guid":{"rendered":"https:\/\/www.simplybusiness.co.uk\/creating-github-action-in-ruby\/"},"modified":"2024-05-30T09:38:04","modified_gmt":"2024-05-30T09:38:04","slug":"creating-github-action-in-ruby","status":"publish","type":"post","link":"https:\/\/www.simplybusiness.co.uk\/about-us\/tech\/2022\/03\/creating-github-action-in-ruby","title":{"rendered":"How to create GitHub actions in Ruby"},"content":{"rendered":"\n

GitHub Actions enables you to create custom workflows for your software development life cycle and automate them within your GitHub repository. In this article, we’ll walk through how to create a GitHub action in Ruby to automate your continuous integration pipeline.<\/p>\n\n\n\n

Note:<\/strong> Before you start, you’ll need a basic understanding of GitHub Actions. If you’re not familiar with GitHub Actions, first read the GitHub guide to understanding GitHub Actions<\/a>, which explains essential concepts and terminology.<\/p>\n\n\n\n

Why GitHub Actions?<\/h2>\n\n\n\n

GitHub Actions is becoming increasingly popular with organisations who are looking to automate the workflows in their CI\/CD pipeline. GitHub Actions is free to use in public and private repositories, with limited free minutes and storage per month<\/a>. It’s also very easy to configure GitHub Actions, as the workflow is available in the repository, with no need for any additional configuration. There is a substantial library<\/a> of built-in actions available for free, which makes it easy to get started. You can also compose your workflow by using multiple actions.<\/p>\n\n\n\n

Creating a GitHub action in Ruby<\/h2>\n\n\n\n

Much has been documented about how to create a GitHub action in JavaScript. The GitHub guide to creating a JavaScript action<\/a> walks through the steps. However, in Ruby, it’s not as straightforward.<\/p>\n\n\n\n

You have two options:<\/p>\n\n\n\n

    \n
  1. Using a Dockerfile.<\/li>\n\n\n\n
  2. Using the setup-ruby<\/a> GitHub action. (Recommended).<\/li>\n<\/ol>\n\n\n\n

    Using a Dockerfile<\/h3>\n\n\n\n

    To create a GitHub action in Ruby using a Dockerfile, you’ll need to:<\/p>\n\n\n\n

      \n
    1. Create a minimal Ruby project that contains a Ruby file, for example run.rb<\/code>, in the root directory and a Gemfile to manage dependencies in your project.<\/li>\n\n\n\n
    2. Create a Dockerfile in the root of your project. Add run.rb<\/code> as the entry point.<\/li>\n<\/ol>\n\n\n\n
      FROM ruby:2.7.0\n\nRUN gem install bundler\n\nRUN mkdir -p \/runner\/action\n\nWORKDIR \/runner\/action\n\nCOPY Gemfile* .\/\n\nCOPY run.rb .\/\n\nRUN bundle install --retry 3\n\nENV BUNDLE_GEMFILE \/runner\/action\/Gemfile\n\nRUN chmod +x \/runner\/action\/run.rb\n\nENTRYPOINT [\"ruby\", \"\/runner\/action\/run.rb\"]<\/code><\/pre>\n\n\n\n
        \n
      1. Create an action.yml<\/code> metadata file that defines the input\/output and the information required to publish your action. You can customise your action by using the metadata syntax for GitHub Actions<\/a>, including customising how your action will look. Here is an example:<\/li>\n<\/ol>\n\n\n\n
        name: 'Unique name of your action'\nauthor: 'opensourcetech@simplybusiness.co.uk'\ndescription: 'description of what action does'\nbranding:\n  icon: code\n  color: red\nruns:\n  using: 'docker'\n  image: 'Dockerfile'<\/code><\/pre>\n\n\n\n
          \n
        1. Push your changes to your default branch (master\/main).<\/li>\n\n\n\n
        2. Publish the GitHub action<\/a>.<\/li>\n<\/ol>\n\n\n\n
          Here is an example of a Simply Business public GitHub action – the deploy status action<\/a>. The deploy status action<\/strong> uses the Octokit<\/a> library to call the GitHub API and create statuses that can be used to block and unblock deploys in the pipeline.<\/p>\n\n\n\n
          Using the action in your project<\/h4>\n\n\n\n
          To use the action you created in your project:<\/p>\n\n\n\n
            \n
          1. Create a workflow file .github\/workflows\/my-workflow.yml<\/code> in your repository, which will be triggered by an event such as when a pull request is opened or changes are pushed to the repository.<\/li>\n<\/ol>\n\n\n\n
            name: 'my workflow'\non:\n  pull_request:\n    types: [opened, synchronize]\npermissions:\n  contents: read\n  statuses: write # change according to the permissions your workflow needs. For more info, visit: https:\/\/docs.github.com\/en\/actions\/learn-github-actions\/workflow-syntax-for-github-actions#permissions\njobs:\n  build:\n    runs-on: ubuntu-20.04\n    steps:\n      - uses: org-name\/worklfow-name@v1.0.0\n        env:\n          ACCESS_TOKEN: ${{ secrets.GITHUB_TOKEN }} # provided by GitHub. You can use this to access the GitHub API.<\/code><\/pre>\n\n\n\n
              \n
            1. Open a PR and check that it runs your Ruby action in the actions<\/code> tab of your repository. If not, check the workflow to ensure there are no typos or syntax errors.<\/li>\n<\/ol>\n\n\n\n
              \"sb-tech-site-banner\"<\/a><\/figure>\n\n\n\n
              Using the setup-ruby action (Recommended)<\/h3>\n\n\n\n
              Docker container actions are great, but they don’t take advantage of the caching action<\/a> that GitHub provides. Therefore, each run can take a long time. We can save a lot of time (over half) by caching bundler dependencies after the first run. It not only saves time but reduces the number of minutes taken to run the action, thereby saving money if you’re using a private repository.<\/p>\n\n\n\n
              Here are the steps for creating an action using the setup-ruby<\/a> action:<\/p>\n\n\n\n
                \n
              1. Create a minimal Ruby project with a simple run.rb<\/code> file, .ruby-version<\/code> to specify ruby at the root directory and a Gemfile to manage dependencies in your project.<\/li>\n\n\n\n
              2. Create an action.yml<\/code> metadata file. Note here we are not using a Dockerfile in the run section, instead using a composite action to run the Ruby code. You can customise your action by using the metadata syntax for GitHub Actions<\/a>, including customising how your action will look.<\/li>\n<\/ol>\n\n\n\n
                Here is an example:<\/p>\n\n\n\n
                name: 'Unique name of your action'\ndescription: 'Description of what your action does'\nauthor: 'opensourcetech@simplybusiness.co.uk'\nbranding:\n  icon: filter\n  color: red\nruns:\n  using: 'composite'\n  steps:\n    - run: |\n        bundle exec ruby run.rb\n      shell: bash<\/code><\/pre>\n\n\n\n
                  \n
                1. Push the changes to your default branch (master\/main).<\/li>\n\n\n\n
                2. Publish the GitHub action<\/a>.<\/li>\n<\/ol>\n\n\n\n
                  Here is an example of a Simply Business public GitHub action – dobby<\/a>. Dobby uses the Octokit<\/a> library to call the GitHub API to update the gem version based on a comment added to a pull request.<\/p>\n\n\n\n
                  Using the action in your workflow<\/h4>\n\n\n\n
                  To use the action in your project, you’ll need to add some additional steps in your workflow:<\/p>\n\n\n\n
                    \n
                  1. Check out the repository that will use the action, and then use the setup-ruby action<\/a>. Create a workflow file .github\/workflows\/my-workflow.yml<\/code>, for example:<\/li>\n<\/ol>\n\n\n\n
                    name: 'my workflow'\non:\n  pull_request:\n    types: [opened, synchronize]\npermissions:\n  contents: read\n  statuses: write # change according to the permissions your workflow needs. For more info, visit: https:\/\/docs.github.com\/en\/actions\/learn-github-actions\/workflow-syntax-for-github-actions#permissions\njobs:\n  build:\n    runs-on: ubuntu-20.04\n    steps:\n     - uses: actions\/checkout@v2.4.0\n       with:\n         repository: 'org-name\/worklfow-name@v1.0.0'\n         ref: 'v1.0.0'\n     - uses: ruby\/setup-ruby@v1\n       with:\n         bundler-cache: true # runs 'bundle install' and caches installed gems automatically\n      - uses: org-name\/worklfow-name@v1.0.0\n        env:\n          ACCESS_TOKEN: ${{ secrets.GITHUB_TOKEN }} # provided by GitHub. You can use this to access the GitHub API.<\/code><\/pre>\n\n\n\n
                      \n
                    1. Open a PR and ensure that it runs in the actions<\/code> tab of your repository. If not, check the workflow to ensure there are no typos or syntax errors.<\/li>\n<\/ol>\n\n\n\n
                      Running and debugging GitHub Actions<\/h2>\n\n\n\n
                      It’s not easy to debug a GitHub action locally, primarily because an action provides a lot of tools and environments (ENV) that are not available locally. That said, there are several things that you can try:<\/p>\n\n\n\n
                        \n
                      1. act<\/a> – you can pass an event payload to test locally.<\/li>\n\n\n\n
                      2. action-tmate<\/a> – debug via ssh shell.<\/li>\n\n\n\n
                      3. Create a test repository and play around by directly changing the workflow in the default branch. I like this option best because you can use the UI editor in GitHub. It also highlights any issue, and you can quickly run the workflow in the same environment with all the environment variables and secrets available.<\/li>\n<\/ol>\n\n\n\n
                        I hope this article helps you to get started with GitHub actions in Ruby. Enjoy!<\/p>\n\n\n\n
                        \n
                        Ready to start your career at Simply Business?<\/h3>\n\n\n\n
                        Want to know more about what it’s like to work in tech at Simply Business? Read about our approach to tech, then check out our current vacancies.<\/p>\n\n\n\n
                        \n
                        Find out more<\/a><\/div>\n<\/div>\n<\/div>\n\n\n\n
                        \n
                        We create this content for general information purposes and it should not be taken as advice. Always take professional advice. Read our full disclaimer<\/a><\/p>\n<\/div>\n\n\n\n
                        \n
                        A free monthly newsletter with the latest news and tools for small businesses and landlords.<\/p>\n\n\n\n
                        \n
                        Subscribe to our newsletter<\/a><\/div>\n<\/div>\n\n\n\n