update static content
A plugin for manually triggering dispatch_event on github actions for rebuilding or deploying your SSG website with the ability to monitor the process and workflow history along with config page and role access.
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
- Trigger multiple workflows
- 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
Create a JWT BASE64 secret key
For example with :
openssl rand -base64 32
Add the key in the .env
Add plugin configs inside
strapiProject/config/plugins.js
1module.exports = ({ env }) => ({
2 'update-static-content': {
3 enabled: true,
4 config: {
5 JWT_SECRET: env('JWT_SECRET'),
6 },
7 },
8});
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.
- Create a file in the root of your project
.github/workflows/deploy.yml
like below. In this example we are using fing cloud
1name: Fing Deployment # a name for your workflow
2
3on: # trigger on push event and main branch to the repo
4 push:
5 branches: [main]
6 workflow_dispatch: # must be included in your .yml file for manually triggering event
7defaults: # in case of monorepo project you can use `defauls` and choose the subfolder
8 run:
9 working-directory: ./gatsbyJS
10jobs:
11 deploy:
12 runs-on: ubuntu-latest
13 steps:
14 - name: Checkout code
15 uses: actions/checkout@v2
16 - name: install fing-cli and deploy
17 env: # set the cloud provider token to the secrets on github and use it on run
18 TOKEN: ${{ secrets.FING_TOKEN }}
19 run: | # write your shell scripts for deploying or building based on your host provider
20 npm install -g @fingcloud/cli
21 fing --access-token "${TOKEN}" up --app vahoora-gatsby --dispatch
Create a GitHub Personal Access Token on Github : https://github.com/settings/tokens
See more on the Github Documentation
Then, you can add the workflow in the plugin settings from the admin panel, save and you'll be able to trigger your workflows from strapi.
Usage
- Add the workflow in the plugin's settings
admin/settings/update-static-content
- Trigger a build in the plugin page
Roadmap
- Cancel workflow manually.
- Better documentation.
Special Thanks
Install now
npm install strapi-plugin-update-static-content
Create your own plugin
Check out the available plugin resources that will help you to develop your plugin or provider and get it listed on the marketplace.