This repository stores GitHub Actions for R projects, which can be used to do a variety of CI tasks. It also has a number of example workflows which use these actions.
- r-lib/actions/setup-r - Sets up R
- r-lib/actions/setup-pandoc - Sets up pandoc
- r-lib/actions/setup-tinytex - Sets up LaTeX with tinytex
- r-lib/actions/pr-fetch - Fetches changes of a PR associated with an event
- r-lib/actions/pr-push - Pushes changes to a PR associated with an event
- r-lib/actions/run-rchk - Runs rchk tests to detect memory protection errors in C source code.
See the r-lib/actions/examples directory for a variety of example workflows using these actions.
If your build fails and you are unsure of why here are some useful strategies for getting help.
- Figure out what caused the error. Look for the first time the word 'error' appears in the build log. Quite often errors at the end of the log are caused by an earlier issue, so it is best to look for the root cause.
- Take advantage of GitHub's code search to find similar yaml files. Use 'path:.github/workflows' to restrict your search to GitHub Action workflow files and also include additional terms specific to your problem. e.g. If you need to figure out how to install geospatial libraries such as gdal use a search like 'gdal path:.github/workflows'. If you want to restrict results only to GitHub Actions workflows that use R you can add search for '"setup-r" path:.github/workflows
- Open an issue on
about your problem. Be sure to link to the workflow file you are using and a failing build to help others help you.
- If your issue seems related to GitHub Actions, but is not R specific open an issue at the GitHub Actions Community page.
- If you have done all of the above and are absolutely sure there is a bug in one of the R specifc actions listed above, open an issue here.
- GitHub Actions with R - a short online book about using GitHub Actions with R, produced as part of the rOpenSci OzUnconf.
- GitHub Actions advent calendar a series of blogposts by one of the GitHub Actions Product Managers highlighting features of GitHub Actions.
- Awesome Actions - a curated list of custom actions. Note many of these are from early in the GitHub Actions beta and may no longer work.
All examples in this repository are published with the CC0 license.