Update Static Content - Strapi v4

Update your statically generated site with github actions (more coming on the way).

Plugin Previews

Plugin Settings

Plugin Page

Features

• Workflow History
• Config Page
• Downloading Logs
• Roles to access the plugin
• Strapi Permissions in v1.0.7

Installation

  yarn add strapi-plugin-update-static-content
  OR
  npm i strapi-plugin-update-static-content

Plugin Configuration

1. Add plugin configs inside strapiProject/config/plugins.js

1
2
3
4
5
6
7
8
9
10
11
12
module.exports = ({ env }) => ({
  'update-static-content': {
    enabled: true,
    config: {
      githubToken: env('GITHUB_TOKEN'), // accessing personal github token from env file
      owner: 'everythinginjs', // owner of the repo
      repo: 'vahoora', // name of the repo
      workflowId: '40807041', // workflowId OR filename
      branch: 'main', // branch name
    },
  },
});

NOTE: add roles property (roles: 'strapi-super-admin', 'strapi-editor', 'strapi-author') if you are using the plugin lesser than v1.0.7 since above that version it is handled by Strapi Permissions.

2. Create a file in the root of your project .github/workflows/deploy.yml like below. In this example we are using fing cloud

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
name: Fing Deployment # a name for your workflow

on: # trigger on push event and main branch to the repo
  push:
    branches: [main]
  workflow_dispatch: # must be included in your .yml file for manually triggering event
defaults: # in case of monorepo project you can use `defauls` and choose the subfolder
  run:
    working-directory: ./gatsbyJS
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v2
      - name: install fing-cli and deploy
        env: # set the cloud provider token to the secrets on github and use it on run
          TOKEN: ${{ secrets.FING_TOKEN }}
        run: | # write your shell scripts for deploying or building based on your host provider
          npm install -g @fingcloud/cli
          fing --access-token "${TOKEN}" up --app vahoora-gatsby --dispatch

Roadmap

• Cancel workflow manually.
• Better documentation.

Special Thanks

Reza from Fing