a modular framework for creating OpenWrt-based firmwares for wireless mesh nodes
Go to file
lemoer d4dee692c6
contrib: add push_pkg.sh to enhance package development workflow (v2) (#2023)
v2: In contrast to the last patches, this is now built on top of ssh
    only, without using e.g. 9pfs. Furthermore it works also with
    arbitary remote hosts on any target/architecture. Also the
    scripts were renamed and moved to /scripts.

The aim of this commit is to allow fast rebuild cycles during the
development of gluon packages.

Currently the following workflow can be used:

	# start a local qemu instance
	scripts/run_qemu.sh output/images/factory/[...].img

	# do your changes in the file you want to patch
	vi package/gluon-ebtables/files/etc/init.d/gluon-ebtables

	# rebuild and update the package
	scripts/push_pkg.sh package/gluon-ebtables/

	# test your changes
	...

	# do more changes
	...

	# rebuild and update the package
	scripts/push_pkg.sh package/gluon-ebtables/

	# test your changes
	...

	(and so on...)

Implementation details:
- Currently this is based on ssh/scp.
- Opkg is used to install/update the packages in the remote machine.

Benefits:
- This works with compiled and non-compiled packages.
- This works with native OpenWrt and Gluon packages.
- This even performs the check_site.lua checks as they are integrated
  as post_install scripts into the openwrt package.
- It works for all architectures/targets.
2021-07-23 19:50:15 +02:00
.github ramips-rt305x: drop target 2021-07-13 21:37:39 +02:00
contrib contrib: add push_pkg.sh to enhance package development workflow (v2) (#2023) 2021-07-23 19:50:15 +02:00
docs contrib: add push_pkg.sh to enhance package development workflow (v2) (#2023) 2021-07-23 19:50:15 +02:00
package treewide: correctly specify conffiles (#2276) 2021-07-23 19:48:58 +02:00
patches modules: switch to OpenWrt 21.02 2021-06-21 16:28:15 +02:00
scripts Merge pull request #2237 from freifunk-gluon/installed-check-site 2021-07-14 16:20:20 +02:00
targets ramips-mt76x8: add support for RAVPower RP-WD009 (#2265) 2021-07-18 16:41:27 +02:00
tests tests: respondd: update shebang to use the environments python3 version 2020-04-29 22:28:00 +02:00
.editorconfig .editorconfig: bunch of additions 2021-04-28 01:01:35 +02:00
.gitignore .gitignore: add files created when mounting repo in docker 2020-03-09 08:30:33 +01:00
.luacheckrc features: fix handling of logical expressions 2020-08-28 22:27:38 +02:00
.readthedocs.yml docs: add .readthedocs.yml to set Python version and requirements.txt 2021-06-26 20:39:22 +02:00
CONTRIBUTING.md CONTRIBUTING.md: fix link to list of rejected features (#1785) 2019-07-13 14:32:41 +02:00
LICENSE LICENSE: update for 2021 2021-01-02 19:10:18 +01:00
Makefile build: add refresh-patches step 2020-10-11 01:40:45 +02:00
modules modules: update OpenWrt 2021-07-18 16:43:50 +02:00
README.md README.md: add a teaster, update state of documentation 2021-06-11 00:32:39 +02:00

Build Gluon License GitHub release (latest SemVer)

Gluon

Gluon is a firmware framework to build preconfigured OpenWrt images for public mesh networks.

Getting started

We have a huge amount of documentation over at https://gluon.readthedocs.io/.

If you're new to Gluon and ready to get your feet wet, have a look at the Getting Started Guide.

Gluon's developers frequent an IRC chatroom at #gluon on hackint. There is also a webchat that allows for uncomplicated access from within your browser.

Issues & Feature requests

Before opening an issue, make sure to check whether any existing issues (open or closed) match. If you're suggesting a new feature, drop by on IRC or our mailinglist to discuss it first.

We maintain a Roadmap for the future development of Gluon.

Use a release!

Please refrain from using the master branch for anything else but development purposes! Use the most recent release instead. You can list all releases by running git tag and switch to one by running git checkout v2021.1 && make update.

If you're using the autoupdater, do not autoupdate nodes with anything but releases. If you upgrade using random master commits the nodes might break eventually.

Mailinglist

To subscribe to the list, send a message to:

gluon+subscribe@luebeck.freifunk.net

To remove your address from the list, just send a message to the address in the List-Unsubscribe header of any list message. If you haven't changed addresses since subscribing, you can also send a message to:

gluon+unsubscribe@luebeck.freifunk.net