Website files will not deploy to gh-pages

[ma3b3]

Description

When someone commits to their project, the website and book project builds properly, but the output files are not deployed to the gh-pages branch, which is where they need to be served for public access.

Here is the error message we get from the Actions log:

example log file

Run peaceiris/actions-gh-pages@v3
[INFO] Usage https://github.com/peaceiris/actions-gh-pages#readme
Dump inputs
Setup auth token
Prepare publishing assets
Setup Git config
Create a commit
Push the commit or tag
  /usr/bin/git push origin gh-pages
  remote: Permission to ma3b3/lantern-test.git denied to github-actions[bot].
  fatal: unable to access 'https://github.com/ma3b3/lantern-test.git/': The requested URL returned error: 403
  Error: Action failed with "The process '/usr/bin/git' failed with exit code [12](https://github.com/ma3b3/lantern-test/runs/6236937432?check_suite_focus=true#step:6:12)8"

It appears that the workflow runner does not have permissions to commit back to the repository. I think the github_token that is generated at the actions/checkout step should be all we need to grant permissions to the workflow runner to commit to our repository, but I'm not sure why it no longer works.

Related

@jnorris37 found that this might be related to actions/checkout#417

I've tried using versions 1, 2, and 3 of the actions/checkout action, but I kept getting the error.