added GitHub Actions to documentation
This commit is contained in:
1 parent
1e10783a28
commit
95a3f8e0b6
8 files changed
+114
-86
No files matched your search
@@ -31,6 +31,6 @@ If applicable, add screenshots to help explain your problem.
|
|||||||
Add any other context about the problem here.
|
Add any other context about the problem here.
|
||||||
|
|
||||||
* You should not have a compilation error if you use the versions of the libraries linked into the libraries folder, this badges show you the state of the compilation
|
* You should not have a compilation error if you use the versions of the libraries linked into the libraries folder, this badges show you the state of the compilation
|
||||||
[](https://travis-ci.com/1technophile/OpenMQTTGateway)
|
[](https://github.com/1technophile/OpenMQTTGateway/actions)
|
||||||
* If you are not sure this is a bug or an enhancement post your question to the forum below
|
* If you are not sure this is a bug or an enhancement post your question to the forum below
|
||||||
[](https://community.openmqttgateway.com)
|
[](https://community.openmqttgateway.com)
|
||||||
@@ -0,0 +1,34 @@
|
|||||||
|
name: Build
|
||||||
|
|
||||||
|
on: [push, pull_request]
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
build:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
name: Build with PlatformIO
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v2
|
||||||
|
- name: Set up Python
|
||||||
|
uses: actions/setup-python@v2
|
||||||
|
with:
|
||||||
|
python-version: "3.7"
|
||||||
|
- name: Install platformio
|
||||||
|
run: |
|
||||||
|
python -m pip install --upgrade pip
|
||||||
|
pip install platformio
|
||||||
|
- name: Run PlatformIO
|
||||||
|
run: platformio run
|
||||||
|
|
||||||
|
documentation:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
name: Create the documentation
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v2
|
||||||
|
- name: Set up Node.js
|
||||||
|
uses: actions/setup-node@v1
|
||||||
|
with:
|
||||||
|
node-version: "14.x"
|
||||||
|
- name: Install vuepress
|
||||||
|
run: npm install -g vuepress
|
||||||
|
- name: Build documentation
|
||||||
|
run: npm run docs:build
|
||||||
@@ -0,0 +1,62 @@
|
|||||||
|
name: Release
|
||||||
|
|
||||||
|
on:
|
||||||
|
release:
|
||||||
|
types: [published]
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
build-upload:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
name: Build and upload Assets to Release
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v2
|
||||||
|
- name: Set up Python
|
||||||
|
uses: actions/setup-python@v2
|
||||||
|
with:
|
||||||
|
python-version: "3.7"
|
||||||
|
- name: Install platformio
|
||||||
|
run: |
|
||||||
|
python -m pip install --upgrade pip
|
||||||
|
pip install platformio
|
||||||
|
- name: Set version tag from git
|
||||||
|
run: sed -i "s/version_tag/${GITHUB_REF#refs/tags/}/g" main/User_config.h
|
||||||
|
- name: Run PlatformIO
|
||||||
|
run: platformio run
|
||||||
|
- name: Prepare Release Assets
|
||||||
|
run: |
|
||||||
|
sudo apt install rename
|
||||||
|
./scripts/prepare_deploy.sh
|
||||||
|
- name: Get upload url
|
||||||
|
id: release-id
|
||||||
|
run: |
|
||||||
|
RELEASE_ID=$(jq --raw-output '.release.id' $GITHUB_EVENT_PATH)
|
||||||
|
echo "::set-output name=upload_url::https://uploads.github.com/repos/${GITHUB_REPOSITORY}/releases/${RELEASE_ID}/assets{?name,label}"
|
||||||
|
- name: Upload Release Assets
|
||||||
|
uses: bgpat/release-asset-action@03b0c30db1c4031ce3474740b0e4275cd7e126a3
|
||||||
|
with:
|
||||||
|
pattern: "toDeploy/*"
|
||||||
|
github-token: ${{ secrets.GITHUB_TOKEN }}
|
||||||
|
release-url: ${{ steps.release-id.outputs.upload_url }}
|
||||||
|
allow-overwrite: true
|
||||||
|
|
||||||
|
documentation:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
name: Create the documentation and deploy it to GitHub Pages
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v2
|
||||||
|
- name: Set up Node.js
|
||||||
|
uses: actions/setup-node@v1
|
||||||
|
with:
|
||||||
|
node-version: "14.x"
|
||||||
|
- name: Install vuepress
|
||||||
|
run: npm install -g vuepress
|
||||||
|
- name: Set version tag from git
|
||||||
|
run: sed -i "s/version_tag/${GITHUB_REF#refs/tags/}/g" docs/.vuepress/config.js
|
||||||
|
- name: Build documentation
|
||||||
|
run: npm run docs:build
|
||||||
|
- name: Deploy to GitHub Pages
|
||||||
|
uses: peaceiris/actions-gh-pages@v3
|
||||||
|
with:
|
||||||
|
github_token: ${{ secrets.GITHUB_TOKEN }}
|
||||||
|
publish_dir: ./docs/.vuepress/dist
|
||||||
|
cname: docs.openmqttgateway.com
|
||||||
-73
@@ -1,73 +0,0 @@
|
|||||||
# Continuous Integration (CI) is the practice, in software
|
|
||||||
# engineering, of merging all developer working copies with a shared mainline
|
|
||||||
# several times a day < https://docs.platformio.org/page/ci/index.html >
|
|
||||||
#
|
|
||||||
# Documentation:
|
|
||||||
#
|
|
||||||
# * Travis CI Embedded Builds with PlatformIO
|
|
||||||
# < https://docs.travis-ci.com/user/integration/platformio/ >
|
|
||||||
#
|
|
||||||
# * PlatformIO integration with Travis CI
|
|
||||||
# < https://docs.platformio.org/page/ci/travis.html >
|
|
||||||
#
|
|
||||||
# * User Guide for `platformio ci` command
|
|
||||||
# < https://docs.platformio.org/page/userguide/cmd_ci.html >
|
|
||||||
#
|
|
||||||
#
|
|
||||||
# Please choose one of the following templates (proposed below) and uncomment
|
|
||||||
# it (remove "# " before each line) or use own configuration according to the
|
|
||||||
# Travis CI documentation (see above).
|
|
||||||
#
|
|
||||||
|
|
||||||
#
|
|
||||||
# Template #1: General project. Test it using existing `platformio.ini`.
|
|
||||||
#
|
|
||||||
jobs:
|
|
||||||
include:
|
|
||||||
- name: "Build and deploy with PlatformIO"
|
|
||||||
language: python
|
|
||||||
python: 2.7
|
|
||||||
cache:
|
|
||||||
directories:
|
|
||||||
- "~/.platformio"
|
|
||||||
install:
|
|
||||||
- pip install -U platformio
|
|
||||||
- platformio update
|
|
||||||
script:
|
|
||||||
- sed -i 's/version_tag/'$TRAVIS_TAG'/g' main/User_config.h
|
|
||||||
- platformio run
|
|
||||||
- bash scripts/prepare_deploy.sh
|
|
||||||
before_deploy: ls -a
|
|
||||||
deploy:
|
|
||||||
on:
|
|
||||||
repo: 1technophile/OpenMQTTGateway
|
|
||||||
all_branches: true
|
|
||||||
tags: true
|
|
||||||
provider: releases
|
|
||||||
overwrite: true
|
|
||||||
api_key: $GITHUB_TOKEN
|
|
||||||
file_glob: true
|
|
||||||
file:
|
|
||||||
- toDeploy/*
|
|
||||||
skip_cleanup: true
|
|
||||||
|
|
||||||
- name: "Build and deploy docs"
|
|
||||||
language: node_js
|
|
||||||
node_js:
|
|
||||||
- lts/*
|
|
||||||
install:
|
|
||||||
- npm install -g vuepress
|
|
||||||
script:
|
|
||||||
- sed -i 's/version_tag/'$TRAVIS_TAG'/g' docs/.vuepress/config.js
|
|
||||||
- npm run docs:build
|
|
||||||
before_deploy: echo "docs.openmqttgateway.com" >> docs/.vuepress/dist/CNAME
|
|
||||||
deploy:
|
|
||||||
provider: pages
|
|
||||||
skip_cleanup: true
|
|
||||||
local_dir: docs/.vuepress/dist
|
|
||||||
github_token: $GITHUB_TOKEN # a token generated on github allowing travis to push code on you repository
|
|
||||||
keep_history: true
|
|
||||||
on:
|
|
||||||
repo: 1technophile/OpenMQTTGateway
|
|
||||||
all_branches: true
|
|
||||||
tags: true
|
|
||||||
@@ -1,5 +1,5 @@
|
|||||||
[](https://community.openmqttgateway.com)
|
[](https://community.openmqttgateway.com)
|
||||||
[](https://travis-ci.com/1technophile/OpenMQTTGateway)
|
[](https://github.com/1technophile/OpenMQTTGateway/actions)
|
||||||
[](https://www.codacy.com/app/1technophile/OpenMQTTGateway?utm_source=github.com&utm_medium=referral&utm_content=1technophile/OpenMQTTGateway&utm_campaign=badger)
|
[](https://www.codacy.com/app/1technophile/OpenMQTTGateway?utm_source=github.com&utm_medium=referral&utm_content=1technophile/OpenMQTTGateway&utm_campaign=badger)
|
||||||
[](http://isitmaintained.com/project/1technophile/openmqttgateway "Percentage of issues still open")
|
[](http://isitmaintained.com/project/1technophile/openmqttgateway "Percentage of issues still open")
|
||||||
[](https://gitlicense.com/license/1technophile/OpenMQTTGateway)
|
[](https://gitlicense.com/license/1technophile/OpenMQTTGateway)
|
||||||
|
|||||||
@@ -3,7 +3,7 @@
|
|||||||
I like pull requests from everyone. By participating in this project, you
|
I like pull requests from everyone. By participating in this project, you
|
||||||
agree to follow the code of conduct below
|
agree to follow the code of conduct below
|
||||||
|
|
||||||
[code of conduct]: https://github.com/1technophile/OpenMQTTGateway/blob/master/CODE_OF_CONDUCT.md
|
[code of conduct](https://github.com/1technophile/OpenMQTTGateway/blob/master/CODE_OF_CONDUCT.md)
|
||||||
|
|
||||||
[code style guide](https://google.github.io/styleguide/cppguide.html#Formatting)
|
[code style guide](https://google.github.io/styleguide/cppguide.html#Formatting)
|
||||||
|
|
||||||
@@ -16,7 +16,7 @@ Make your modification,
|
|||||||
|
|
||||||
Review your code, compile it for Arduino Uno and ESP8266
|
Review your code, compile it for Arduino Uno and ESP8266
|
||||||
|
|
||||||
Test it localy on your hardware config
|
Test it locally on your hardware config
|
||||||
|
|
||||||
If you modify `User_config.h` during your developments you need to report your modifications into Test_config.h
|
If you modify `User_config.h` during your developments you need to report your modifications into Test_config.h
|
||||||
https://github.com/1technophile/OpenMQTTGateway/blob/master/tests/Test_config.h
|
https://github.com/1technophile/OpenMQTTGateway/blob/master/tests/Test_config.h
|
||||||
@@ -25,7 +25,7 @@ Indeed during the continuous integration process `User_config.h` is replaced by
|
|||||||
|
|
||||||
Emit a pull request
|
Emit a pull request
|
||||||
|
|
||||||
Verify the travis CI compilation results
|
Verify the GitHub Actions CI compilation results
|
||||||
|
|
||||||
Request for review
|
Request for review
|
||||||
|
|
||||||
|
|||||||
@@ -1,8 +1,10 @@
|
|||||||
# Troubleshooting
|
# Troubleshooting
|
||||||
|
|
||||||
## Compilation/build error
|
## Compilation/build error
|
||||||
This badge [](https://travis-ci.com/1technophile/OpenMQTTGateway) show you the state of the compilation of the master and this one [](https://travis-ci.com/1technophile/OpenMQTTGateway) for the development branch. If you see a green badge this means that the code compilation is OK with the configuration given in the docs/platformio.ini. Check your IDE environment version, boards version, libraries version before submitting an issue or a question.
|
This badge [](https://github.com/1technophile/OpenMQTTGateway/actions?query=branch%3Amaster+workflow%3ABuild) show you the state of the compilation of the master and this one [](https://github.com/1technophile/OpenMQTTGateway/actions?query=branch%3Adevelopment+workflow%3ABuild) for the development branch.
|
||||||
Verify especially that the libraries provided into the [the release page](https://github.com/1technophile/OpenMQTTGateway/releases) are located into your "sketchbook folder"/libraries if your are using the Arduino IDE.
|
If you see a green badge this means that the code compilation is OK with the configuration given in the `docs/platformio.ini`.
|
||||||
|
Check your IDE environment version, boards version, libraries version before submitting an issue or a question.
|
||||||
|
Verify especially that the libraries provided into the [release page](https://github.com/1technophile/OpenMQTTGateway/releases) are located into your "sketchbook folder"/libraries if your are using the Arduino IDE.
|
||||||
|
|
||||||
## ESP32 compilation errors related to wifi
|
## ESP32 compilation errors related to wifi
|
||||||
If you get one or several of the following errors:
|
If you get one or several of the following errors:
|
||||||
@@ -29,10 +31,10 @@ Regarding the IR led emitter you can replace it with a normal led and see if it
|
|||||||
|
|
||||||
try with D2 instead of D3
|
try with D2 instead of D3
|
||||||
and put
|
and put
|
||||||
define RF_RECEIVER_PIN 4 // D2 on nodemcu
|
`#define RF_RECEIVER_PIN 4 // D2 on nodemcu`
|
||||||
in config_rf.h
|
in config_rf.h
|
||||||
instead of
|
instead of
|
||||||
define RF_RECEIVER_PIN 0 // D3 on nodemcu
|
`#define RF_RECEIVER_PIN 0 // D3 on nodemcu`
|
||||||
|
|
||||||
## Exception seen on serial monitor:
|
## Exception seen on serial monitor:
|
||||||
Hey I got a callback
|
Hey I got a callback
|
||||||
|
|||||||
Regular → Executable
+7
-4
@@ -1,7 +1,10 @@
|
|||||||
|
#!/bin/bash
|
||||||
|
set -e
|
||||||
echo "renaming bin files with the board name"
|
echo "renaming bin files with the board name"
|
||||||
rename -v 's:/:-:g' .pio/build/*/*.bin
|
rename -v 's:/:-:g' .pio/build/*/*.bin
|
||||||
mkdir toDeploy
|
mkdir toDeploy
|
||||||
rename 's/.pio-build-//' .*.bin
|
rename 's/.pio-build-//' .*.bin
|
||||||
|
(
|
||||||
cd .pio/libdeps
|
cd .pio/libdeps
|
||||||
echo "replace space by _ in folder names"
|
echo "replace space by _ in folder names"
|
||||||
find . -type d -name "* *" | while read FNAME; do mv "$FNAME" "${FNAME// /_}"; done
|
find . -type d -name "* *" | while read FNAME; do mv "$FNAME" "${FNAME// /_}"; done
|
||||||
@@ -9,11 +12,11 @@ echo "zipping libraries per board"
|
|||||||
for i in */; do zip -r "${i%/}-libraries.zip" "$i"; done
|
for i in */; do zip -r "${i%/}-libraries.zip" "$i"; done
|
||||||
ls -la
|
ls -la
|
||||||
mv *.zip ../../toDeploy
|
mv *.zip ../../toDeploy
|
||||||
cd ../..
|
)
|
||||||
|
|
||||||
echo "zipping code and licence"
|
echo "zipping code and licence"
|
||||||
zip -r OpenMQTTGateway_sources.zip main LICENSE.txt
|
zip -r OpenMQTTGateway_sources.zip main LICENSE.txt
|
||||||
mv *.zip toDeploy
|
mv *.zip toDeploy
|
||||||
mv *.bin toDeploy
|
mv *.bin toDeploy
|
||||||
cd toDeploy
|
|
||||||
ls -la
|
ls -lA toDeploy
|
||||||
cd ..
|
|
||||||
Reference in new issue
Block a user