GitHub Actions and Secrets

GitHub Actions** help you automate your software development workflows in the same place you store code and collaborate on pull requests and issues. You can write individual tasks, called actions, and combine them to create a custom workflow. Workflows are custom automated processes that you can set up in your repository to build, test, package, release, or deploy any code project on GitHub.

A note on testing: Some projects would like to use GitHub Actions for complex processes, such as automating their tests of software builds.

The time runners are in use (measured in minutes) is unlimited for public repositories, so how long a test takes isn't the issue. The issue is tying up limited runners (nodes) while those minutes are running. The ASF has a limited number of runners for over 1200 repositories, so the concern would be how many runners the test requires, as they would be unavailable to other projects for the duration of the test.

The ASF maxes out its runner allocation quite often, so a project needs to plan carefully to make best use of them for everyone's sake. For example, it would be important not to trigger a full release test with a pull request that is correcting a typo on one page in one module.

Evolving knowledge

  • If you are considering using GitHub Actions with buildsy, please subscribe to the builds@ a.o mailing list, where there is a continuing discussion on this topic and others related to continuous integration development.

  • The community is curating a Wiki page about the current state of using GitHub Actions for ASF projects.

  • See Apache Airflow's experience with Actions.

GitHub Secrets are encrypted environment variables that you create in a repository or organization. The secrets you create are available for use in GitHub Actions workflows.

A GitHub Personal Access Token (PAT) is a string of characters that functions similarly to an OAuth token in that you can specify its permissions via scopes. A PAT can also function as a password; you can have many of them and you can revoke access to any one of them at any time. As an example, you can enable a PAT to write to your repositories. If then you run a cURL command or write a script that creates an issue in your repository, you would pass the PAT to authenticate it. You can store the PAT as an environment variable to avoid having to enter it every time you use it.

See GitHub secrets and tokens.

Examples

GitHub Secrets

Apache Arrow has GitHub Secrets added to their Arrow GitHub repos with the name 'DOCKERHUB_USER' and token 'DOCKERHUB_TOKEN' created as the user account on DockerHub (those account details are in LP). Additionally, in DockerHub, an 'arrow-dev' repository was created and the DockerHub 'jenkins' team (containing the DockerHub 'DOCKERHUB_USER' user) was given admin access.

GitHub Actions

Using Apache Arrow again as an example, the tokens above can be called using this code:

run: |
docker login -u ${{ secrets.DOCKERHUB_USER }} \
-p ${{ secrets.DOCKERHUB_TOKEN }}
docker-compose push ...

Using an argument to extend the validity of a token for Develocity

If you use the setup-gradle Action, it creates a short-lived Develocity token, which expires by default after two hours. If your build takes longer than two hours to run, the token becomes invalid and the build fails.

To extend the validity of the token, adjust the develocity-token-expiry action parameter:

 develocity-token-expiry:
    description: The Develocity short-lived access tokens expiry in hours. Default is 2 hours.
    required: false

Further information is at these pages:

Links

Copyright 2026, The Apache Software Foundation, Licensed under the Apache License, Version 2.0.
Apache® and the Apache logo are trademarks of The Apache Software Foundation.