Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/balena-os/balenafin-raspbian
Raspbian support for balenaFin
https://github.com/balena-os/balenafin-raspbian
Last synced: about 1 month ago
JSON representation
Raspbian support for balenaFin
- Host: GitHub
- URL: https://github.com/balena-os/balenafin-raspbian
- Owner: balena-os
- License: apache-2.0
- Created: 2019-02-27T15:12:27.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2024-04-29T17:23:26.000Z (8 months ago)
- Last Synced: 2024-04-29T18:39:45.905Z (8 months ago)
- Language: Shell
- Size: 89.8 KB
- Stars: 2
- Watchers: 2
- Forks: 2
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# balenaFin Raspbian support packages and tools
* [  ](https://bintray.com/balenaos/raspbian/sd8887-mrvl/_latestVersion) sd8887-mrvl
* [  ](https://bintray.com/balenaos/raspbian/balenafin-firmware/_latestVersion) balenafin-firmware
This repository includes metadata and tools for generating and maintaining [balenaFin](https://balenafin.io) specific Debian packages.
The Debian repository is available on [bintray](https://bintray.com) at [balenaos/raspbian](https://bintray.com/balenaos/raspbian).
## Debian packages generation
The packages supported are structured as subdirectories in `debs`. In order to generate Debian artefacts for one of these packages run `gen-deb-container.sh` with appropriate arguments (see tool's help for more info). This will generate the artefacts in the respective package's directory.
For example, running `./gen-deb-container.sh --package FOO`, will generate the deb package (and additional artefacts) in `debs/FOO/`.
## Upload to bintray
In order to upload a deb file to `bintray` use `upload-to-bintray.sh`. This requires an API key passed to the tool.
## Upgrading a package
Each package, structured as a subdirectory in `debs`, has the following content:
```
.
├── deb-root # This is the workspace of the debian package generator.
│ └── debian # Debian package metadata. See [debian manual](https://www.debian.org/doc/manuals/maint-guide/dreq.en.html) for more info.
└── src # Package's source directory - usually a git submodule.
```
In order to upgrade a package
* Update the `src` git submodule to the new version (if required).
* Add changelog entry for the new version (if `src` was updated, specify the new package version and reset the revision to 1 or increment the revision if only files in `debian` directory were modified).
* For example: Current version is 1.0.0-3 and updated `src` from 1.0.0 to 2.0.0 -> Add changelog entry for 2.0.0-1.
* For example: Current version is 2.0.0-2 and changed the `rules` files in `debian` directory -> Add a changelog entry for 2.0.0-3
* The changelog is parsed for the package's version so be careful when adding changelog entries. See [debian manual:changelog](https://www.debian.org/doc/manuals/maint-guide/dreq.en.html#changelog) for more info.
* Regenerate the deb as per above instructions.
* Upload the new deb as per above instructions.
## Run Raspbian image with balenaFin support
If you are running a pristine Raspbian image, you can install and configure it to support balenaFin by taking advantage of the `balenafin-ify.sh` tool. This script is meant to run on target (on a balenaFin board). It will configure the OS and download all the needed packages. Check the tool's help message for more info.
bash <(curl -L https://raw.githubusercontent.com/balena-os/balenafin-raspbian/master/balenafin-ify.sh)
## License
Copyright 2019 Rulemotion Ltd.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
[http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0)
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.