https://github.com/shvchk/padavan-builder-workflow
Automatic Padavan firmware builds using GitHub servers
https://github.com/shvchk/padavan-builder-workflow
automation firmware padavan router workflow
Last synced: 4 months ago
JSON representation
Automatic Padavan firmware builds using GitHub servers
- Host: GitHub
- URL: https://github.com/shvchk/padavan-builder-workflow
- Owner: shvchk
- Created: 2023-10-09T18:02:50.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-03-25T09:20:46.000Z (over 1 year ago)
- Last Synced: 2025-03-25T09:43:53.137Z (over 1 year ago)
- Topics: automation, firmware, padavan, router, workflow
- Homepage: https://github.com/shvchk/padavan-builder-workflow/discussions
- Size: 213 KB
- Stars: 52
- Watchers: 6
- Forks: 847
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
English | Русский
## Automatic Padavan firmware builds using GitHub servers
### Usage
- [Fork this repository](https://github.com/shvchk/padavan-builder-workflow/fork), further steps should be performed in your fork
- Copy your build config to [`build.config`](build.config)
Build config template can be found in the [firmware repository](https://gitlab.com/hadzhioglu/padavan-ng/-/tree/master/trunk/configs/templates)
- Run the build process: [Actions](../../actions) → [Build firmware](../../actions/workflows/build.yml) → Run workflow
The build process will appear on the same page (if it doesn't appear, just refresh the page). You can get process details by clicking on it.
Depending on the build config, build process usually takes from 10 to 60 minutes.
- While the process is in progress, its status indicator would be gold-ish circle
- If the process finishes successfully, its status indicator would turn green with a check mark
Click on the finished process. Archive with the firmware would be stored as its artifact:
Firmware license does not permit binaries distribution, so artifacts are stored for 7 days for personal use.
- If the process finishes with an error, its status indicator would turn red with a cross
Click on the finished process. To get details about the error, click on the failed `build` job at the left:
Job report will be opened:
Here it's immediately obvious that it was *Check firmware size* step that failed — it is marked with a red circle with a cross. Specific reason is shown below: *Firmware size (18,492,849 bytes) exceeds max size (16,187,392 bytes) for your target device* — i.e. built firmware size is too big for the target device.
In case of any error its reason is usually shown at the end of the log, as in the example above. To view full log click on the cog ⚙️ icon in the top right corner → View raw logs. You can also download compressed log archive in the same menu → Download log archive.
If you can't figure out the problem on your own, you can ask community or firmware developer for help. In this case don't forget to attach the log archive.
### Updating your fork
To sync your fork with its origin repository, just click *Sync fork* → *Update branch* at the top of the main page of your fork:
### Advanced usage
You can set the firmware repository, branch, specific tag or commit in the [`variables`](variables) file.
In the [`variables`](variables) file you can also specify which themes you want to install by uncommenting theme names in the `PADAVAN_THEMES` variable. Themes repository can be set with the `PADAVAN_THEMES_REPO` variable.
You can create a `pre-build.sh` script with any custom commands, which will be executed just before build process. By that time firmware source code is already downloaded, so you can add or change anything in it.
You can create a `post-build.sh` script, which will be executed right after build process.
---
Discussion: https://github.com/shvchk/padavan-builder-workflow/discussions/categories/general