https://github.com/theaccordance/balena-push
Continuously deploy your application to BalenaCloud
https://github.com/theaccordance/balena-push
actions balenacloud continuous-delivery github-actions hacktoberfest open-source
Last synced: 5 months ago
JSON representation
Continuously deploy your application to BalenaCloud
- Host: GitHub
- URL: https://github.com/theaccordance/balena-push
- Owner: theaccordance
- License: mit
- Created: 2019-11-10T18:51:11.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2022-08-30T21:18:42.000Z (almost 4 years ago)
- Last Synced: 2025-09-14T06:27:55.703Z (9 months ago)
- Topics: actions, balenacloud, continuous-delivery, github-actions, hacktoberfest, open-source
- Language: Dockerfile
- Homepage: https://docs.mainwaring.dev/open-source-projects/balena-push
- Size: 20.5 KB
- Stars: 20
- Watchers: 2
- Forks: 21
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# Balena Push


[](https://www.codefactor.io/repository/github/theaccordance/balena-push)






Continuously deliver your applications to [BalenaCloud](https://www.balena.io/).
## Table of Contents
* [Inputs](#inputs)
* [Examples](#examples)
* [Pushing the project root](#pushing-the-project-root)
* [Pushing a project subdirectory](#pushing-a-project-sub-directory)
## Inputs
| Attribute | Required? | Purpose |
|--------------------|------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `api-token` | **Yes*** | A BalenaCloud API Token, used to authenticate with BalenaCloud. API keys can be created in the [user settings for BalenaCloud](https://dashboard.balena-cloud.com/preferences/access-tokens). |
| `application-name` | **Yes*** | The target application on BalenaCloud |
| `application-path` | _Optional_ | Provide a sub-path to the location for application being deployed to BalenaCloud. Defaults to the workspace root. |
## Examples
### Pushing the project root
```yaml
name: Balena Push
on:
push:
# Only run workflow for pushes to specific branches
branches:
- master
jobs:
balena-push:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v1
- uses: theaccordance/balena-push@v1.1.0
with:
api-token: ${{secrets.BALENA_API_TOKEN}}
application-name: ${{secrets.BALENA_APPLICATION_NAME}}
```
### Pushing a project sub-directory
```yaml
name: Balena Push
on:
push:
# Only run workflow for pushes to specific branches
branches:
- master
jobs:
balena-push:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v1
- uses: theaccordance/balena-push@v1.1.0
with:
api-token: ${{secrets.BALENA_API_TOKEN}}
application-name: ${{secrets.BALENA_APPLICATION_NAME}}
application-path: "./balena-wpe"
```