ghaction-github-pages

Go to file

CrazyMax 6fa8014eb2 Update CHANGELOG		2021-05-13 02:28:37 +02:00
.github	Update CHANGELOG	2021-05-13 02:28:37 +02:00
dist	Add dry-run input (#144 )	2021-05-13 02:23:35 +02:00
hack	Enhance workflow (#136 )	2021-03-29 23:41:46 +02:00
src	Add dry-run input (#144 )	2021-05-13 02:23:35 +02:00
.dockerignore	Enhance workflow (#136 )	2021-03-29 23:41:46 +02:00
.editorconfig	Update editorconfig	2020-04-09 03:37:51 +02:00
.gitattributes	Use ncc	2020-04-09 00:59:11 +02:00
.gitignore	Use ncc	2020-04-09 00:59:11 +02:00
.prettierrc.json	Match vars and inputs	2019-11-06 03:02:59 +01:00
action.yml	Add dry-run input (#144 )	2021-05-13 02:23:35 +02:00
CHANGELOG.md	Update CHANGELOG	2021-05-13 02:28:37 +02:00
docker-bake.hcl	Enhance workflow (#136 )	2021-03-29 23:41:46 +02:00
LICENSE	2021	2021-01-06 19:04:13 +01:00
package.json	Bump fs-extra from 9.1.0 to 10.0.0 (#139 )	2021-05-13 00:15:32 +02:00
README.md	Add dry-run input (#144 )	2021-05-13 02:23:35 +02:00
tsconfig.json	Use major version of actions	2020-11-08 02:55:49 +01:00
yarn.lock	Bump fs-extra from 9.1.0 to 10.0.0 (#139 )	2021-05-13 00:15:32 +02:00

README.md

About

A GitHub Action to deploy to GitHub Pages

If you are interested, check out my other :octocat: GitHub Actions!

Usage
Customizing
- inputs
- environment variables
Keep up-to-date with GitHub Dependabot
How can I help?
License

Usage

Workflow

Below is a simple snippet to deploy to GitHub Pages with a dummy HTML page.

A workflow is also available for this repository and deploys everyday to GitHub pages.

name: website

on: push

jobs:
  publish:
    runs-on: ubuntu-latest
    steps:
      -
        name: Checkout
        uses: actions/checkout@v2
      -
        name: Gen dummy page
        run: |
          mkdir public
          cat > public/index.html <<EOL
          <!doctype html>
          <html>
            <head>
              <title>GitHub Pages deployed!</title>
            </head>
            <body>
              <p>GitHub Pages with <strong>${{ github.sha }}</strong> commit ID has been deployed through <a href="https://github.com/marketplace/actions/github-pages">GitHub Pages action</a> successfully.</p>
            </body>
          </html>
          EOL          
      -
        name: Deploy to GitHub Pages
        if: success()
        uses: crazy-max/ghaction-github-pages@v2
        with:
          target_branch: gh-pages
          build_dir: public
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Sign commits

You can use the Import GPG GitHub Action along with this one to sign commits:

      -
        name: Import GPG key
        uses: crazy-max/ghaction-import-gpg@v3
        with:
          gpg-private-key: ${{ secrets.GPG_PRIVATE_KEY }}
          passphrase: ${{ secrets.PASSPHRASE }}
          git-user-signingkey: true
          git-commit-gpgsign: true
      -
        name: Deploy to GitHub Pages
        if: success()
        uses: crazy-max/ghaction-github-pages@v2
        with:
          target_branch: gh-pages
          build_dir: public
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Check availability of GitHub Pages

You can use the GitHub Status Action along with this one to check availability of GitHub Pages before deploying:

      -
        name: Check GitHub Pages status
        uses: crazy-max/ghaction-github-status@v2
        with:
          pages_threshold: major_outage
      -
        name: Deploy to GitHub Pages
        if: success()
        uses: crazy-max/ghaction-github-pages@v2
        with:
          target_branch: gh-pages
          build_dir: public
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Customizing

inputs

Following inputs can be used as step.with keys

Name	Type	Description
`domain`	String	Git domain (default `github.com`)
`repo`	String	GitHub repository where assets will be deployed (default `$GITHUB_REPOSITORY`)
`target_branch`	String	Git branch where assets will be deployed (default `gh-pages`)
`keep_history`	Bool	Create incremental commit instead of doing push force (default `false`)
`allow_empty_commit`	Bool	Allow an empty commit to be created (default `true`)
`build_dir`	String	Build directory to deploy (required)
`committer`	String	Committer name and email address as `Display Name <joe@foo.bar>` (defaults to the GitHub Actions bot user)
`author`	String	Author name and email address as `Display Name <joe@foo.bar>` (defaults to the GitHub Actions bot user)
`commit_message`	String	Commit message (default `Deploy to GitHub pages`)
`fqdn`	String	Write the given domain name to the CNAME file
`jekyll`	Bool	Allow Jekyll to build your site (default `true`)
`dry-run`	Bool	If enabled, nothing will be pushed (default `false`)

environment variables

Following environment variables can be used as step.env keys

Name	Description
`GITHUB_TOKEN`	GITHUB_TOKEN as provided by `secrets`
`GH_PAT`	Use a Personal Access Token if you want to deploy to another repo

Keep up-to-date with GitHub Dependabot

Since Dependabot has native GitHub Actions support, to enable it on your GitHub repo all you need to do is add the .github/dependabot.yml file:

version: 2
updates:
  # Maintain dependencies for GitHub Actions
  - package-ecosystem: "github-actions"
    directory: "/"
    schedule:
      interval: "daily"

How can I help?

All kinds of contributions are welcome 🙌! The most basic way to show your support is to star 🌟 the project, or to raise issues 💬 You can also support this project by becoming a sponsor on GitHub 👏 or by making a Paypal donation to ensure this journey continues indefinitely! 🚀

Thanks again for your support, it is much appreciated! 🙏

License

MIT. See LICENSE for more details.