status-im
/
actions-gh-pages
mirror of https://github.com/status-im/actions-gh-pages.git
2
0
Fork 0
Code Issues Projects Releases Wiki Activity
GitHub Actions for GitHub Pages 🚀 Deploy static files and publish your site easily. Static-Site-Generators-friendly. https://github.com/marketplace/actions/github-pages-action
33 Commits 12 Branches 89 Tags 6.7 MiB
TypeScript 91.5%
Shell 3.3%
Dockerfile 3.2%
HTML 0.8%
JavaScript 0.6%
Other 0.5%
Go to file
peaceiris 61579670d5 enhance: readme 2019-09-06 00:50:59 +09:00
.github Release v2.0.0 (#10) 2019-09-05 23:07:49 +09:00
images remove: GitHub Actions v1 workflow overview images 2019-08-22 03:41:21 +09:00
.dockerignore update: .dockerignore 2019-09-05 23:38:50 +09:00
.hadolint.yaml Release v2.1.0 (#14) 2019-09-06 00:31:34 +09:00
Dockerfile Release v2.1.0 (#14) 2019-09-06 00:31:34 +09:00
LICENSE add: action 2019-05-22 06:53:54 +09:00
README.md enhance: readme 2019-09-06 00:50:59 +09:00
action.yml fix: action.yml name 2019-09-05 23:10:30 +09:00
entrypoint.sh Release v2.0.0 (#10) 2019-09-05 23:07:49 +09:00

README.md

license release GitHub release date GitHub Actions status Docker Hub Build Status

GitHub Actions for deploying to GitHub Pages with Static Site Generators

GitHub Actions for deploying to GitHub Pages

A GitHub Action to deploy your static site to GitHub Pages with Static Site Generators (Hugo, MkDocs, Gatsby, GitBook, etc.)

Getting started

(1) Add ssh deploy key

Generate your deploy key with the following command.

ssh-keygen -t rsa -b 4096 -C "$(git config user.email)" -f gh-pages -N ""
# You will get 2 files:
#   gh-pages.pub (public key)
#   gh-pages     (private key)

Next, Go to Repository Settings

  • Go to Deploy Keys and add your public key with the Allow write access
  • Go to Secrets and add your private key as ACTIONS_DEPLOY_KEY

(2) Create .github/workflows/gh-pages.yml

An example yaml file with Hugo action.

peaceiris/actions-hugo latest version peaceiris/actions-gh-pages latest version

name: github pages

on:
  push:
    branches:
    - master

jobs:
  build-deploy:
    runs-on: ubuntu-18.04
    steps:
    - uses: actions/checkout@master

    - name: build
      uses: peaceiris/actions-hugo@v0.58.0
      with:
        args: --gc --minify --cleanDestinationDir

    - name: deploy
      uses: peaceiris/actions-gh-pages@v2.1.0
      env:
        ACTIONS_DEPLOY_KEY: ${{ secrets.ACTIONS_DEPLOY_KEY }}
        PUBLISH_BRANCH: gh-pages
        PUBLISH_DIR: ./public

Options

Pull action image from Docker Hub

You can pull a public docker image from Docker Hub. By pulling docker images, you can reduce the overall execution time of your workflow. In addition, latest tag is provided.

- uses: peaceiris/actions-gh-pages@v2.1.0
+ uses: docker://peaceiris/gh-pages:v2.1.0

- uses: peaceiris/actions-hugo@v0.58.0
+ uses: docker://peaceiris/gha-hugo:v0.58.0

GITHUB_TOKEN

NOTES: This action supports GITHUB_TOKEN but it has some problems to deploy to GitHub Pages. See #9

- ACTIONS_DEPLOY_KEY: ${{ secrets.ACTIONS_DEPLOY_KEY }}
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Examples

MkDocs

peaceiris/actions-gh-pages latest version

name: github pages

on:
  push:
    branches:
    - master

jobs:
  build-deploy:
    runs-on: ubuntu-18.04
    steps:
    - uses: actions/checkout@v1

    - name: Set up Python
      uses: actions/setup-python@v1
      with:
        python-version: '3.6'
        architecture: 'x64'

    - name: Install dependencies
      run: |
        pip install --upgrade pip
        pip install -r ./requirements.txt        

    - name: Build with MkDocs
      run: mkdocs build

    - name: Deploy to GitHub Pages
      uses: peaceiris/actions-gh-pages@v2.1.0
      env:
        ACTIONS_DEPLOY_KEY: ${{ secrets.ACTIONS_DEPLOY_KEY }}
        PUBLISH_BRANCH: gh-pages
        PUBLISH_DIR: ./site

License

About the author