From e15efa7e08fdadfc613f5dd5353447b1e9de4a81 Mon Sep 17 00:00:00 2001 From: Valeriy Koval Date: Thu, 21 May 2015 16:43:09 +0300 Subject: [PATCH] Add CI services info and integration examples. --- .../droneci-platformio-integration-1.png | Bin 0 -> 22188 bytes .../droneci-platformio-integration-2.png | Bin 0 -> 41980 bytes docs/ci/appveyor.rst | 201 ++++++++++++++++++ docs/ci/circleci.rst | 73 +++++++ docs/ci/drone.rst | 70 ++++++ docs/ci/index.rst | 4 + docs/ci/shippable.rst | 76 +++++++ 7 files changed, 424 insertions(+) create mode 100644 docs/_static/droneci-platformio-integration-1.png create mode 100644 docs/_static/droneci-platformio-integration-2.png create mode 100644 docs/ci/appveyor.rst create mode 100644 docs/ci/circleci.rst create mode 100644 docs/ci/drone.rst create mode 100644 docs/ci/shippable.rst diff --git a/docs/_static/droneci-platformio-integration-1.png b/docs/_static/droneci-platformio-integration-1.png new file mode 100644 index 0000000000000000000000000000000000000000..303e30f66a2b367e9658c9cff85cfaec45c188b7 GIT binary patch literal 22188 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

YLM2 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 literal 0 HcmV?d00001 diff --git a/docs/_static/droneci-platformio-integration-2.png b/docs/_static/droneci-platformio-integration-2.png new file mode 100644 index 0000000000000000000000000000000000000000..9b76e479b717666a7c94aac5933669b719b64d90 GIT binary patch literal 41980 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%0AO)^dAa!OO+2Qm!7+3Q)K}G95 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 literal 0 HcmV?d00001 diff --git a/docs/ci/appveyor.rst b/docs/ci/appveyor.rst new file mode 100644 index 00000000..ea603a46 --- /dev/null +++ b/docs/ci/appveyor.rst @@ -0,0 +1,201 @@ +.. _ci_appveyor: + +AppVeyor +======== + +`AppVeyor `_ is an open-source hosted, +distributed continuous integration service used to build and test projects hosted at `GitHub `_ on Windows family systems. + +AppVeyor is configured by adding a file named ``appveyor.yml``, which is a +`YAML `_ format text file, to the root +directory of the GitHub repository. + +AppVeyor automatically detects when a commit has been made and pushed to a +GitHub repository that is using AppVeyor, and each time this happens, it will +try to build the project using :ref:`cmd_ci` command. This includes commits to +all branches, not just to the master branch. AppVeyor will also build and run +pull requests. When that process has completed, it will notify a developer in +the way it has been configured to do so — for example, by sending an email +containing the build results (showing success or failure), or by posting a +message on an IRC channel. It can be configured to build project on a range of +different :ref:`platforms`. + +Integration +----------- + +Please put ``appveyor.yml`` to the root directory of the GitHub repository. + +.. code-block:: yaml + + build: off + environment: + matrix: + - PLATFORMIO_CI_SRC=pathto\\source\\file.c + - PLATFORMIO_CI_SRC=pathto\\source\\file.ino + - PLATFORMIO_CI_SRC=pathto\\source\\directory + + install: + cmd: python -c "$(curl -fsSL https://raw.githubusercontent.com/platformio/platformio/master/scripts/get-platformio.py)" + + script: + - platformio ci --lib="." --lib="c:\spi4teensy" --board=uno --board=teensy31 --board=due' + + +For more details as for PlatformIO build process please look into :ref:`cmd_ci` +command. + +Examples +-------- + +1. Integration for `USB_Host_Shield_2.0 `_ + project. The ``appveyor.yml`` configuration file: + +.. code-block:: yaml + + build: off + environment: + global: + WITH_COMPILER: "cmd /E:ON /V:ON /C .\\scripts\\appveyor\\run_with_compiler.cmd" + matrix: + - PLATFORMIO_CI_SRC: "examples\\Bluetooth\\PS3SPP\\PS3SPP.ino" + PLATFORMIO_CI_SRC: "examples\\pl2303\\pl2303_gps\\pl2303_gps.ino" + WINDOWS_SDK_VERSION: "v7.0" + PYTHON_HOME: "C:\\Python27-x64" + PYTHON_VERSION: "2.7" + PYTHON_ARCH: "64" + install: + - "git submodule update --init --recursive" + - "powershell scripts\\appveyor\\install.ps1" + before_test: + - cmd: SET PATH=%PATH%;%PYTHON_HOME%;%PYTHON_HOME%\Scripts + - cmd: git clone https://github.com/xxxajk/spi4teensy3.git c:\spi4teensy + test_script: + - "%PYTHON_HOME%\\Scripts\\pip --version" + - '%WITH_COMPILER% %PYTHON_HOME%\\Scripts\\platformio ci --lib="." --lib="c:\spi4teensy" --board=uno --board=teensy31 --board=due' + +The ``install.ps1`` script file: + +.. code-block:: none + + $BASE_URL = "https://www.python.org/ftp/python/" + $GET_PIP_URL = "https://bootstrap.pypa.io/get-pip.py" + $GET_PIP_PATH = "C:\get-pip.py" + + + function DownloadPython ($python_version, $platform_suffix) { + $webclient = New-Object System.Net.WebClient + $filename = "python-" + $python_version + $platform_suffix + ".msi" + $url = $BASE_URL + $python_version + "/" + $filename + + $basedir = $pwd.Path + "\" + $filepath = $basedir + $filename + if (Test-Path $filename) { + Write-Host "Reusing" $filepath + return $filepath + } + + # Download and retry up to 5 times in case of network transient errors. + Write-Host "Downloading" $filename "from" $url + $retry_attempts = 3 + for($i=0; $i -lt $retry_attempts; $i++){ + try { + $webclient.DownloadFile($url, $filepath) + break + } + Catch [Exception]{ + Start-Sleep 1 + } + } + Write-Host "File saved at" $filepath + return $filepath + } + + + function InstallPython ($python_version, $architecture, $python_home) { + Write-Host "Installing Python" $python_version "for" $architecture "bit architecture to" $python_home + if (Test-Path $python_home) { + Write-Host $python_home "already exists, skipping." + return $false + } + if ($architecture -eq "32") { + $platform_suffix = "" + } else { + $platform_suffix = ".amd64" + } + $filepath = DownloadPython $python_version $platform_suffix + Write-Host "Installing" $filepath "to" $python_home + $args = "/qn /i $filepath TARGETDIR=$python_home" + Write-Host "msiexec.exe" $args + Start-Process -FilePath "msiexec.exe" -ArgumentList $args -Wait -Passthru + Write-Host "Python $python_version ($architecture) installation complete" + return $true + } + + + function InstallPip ($python_home) { + $pip_path = $python_home + "/Scripts/pip.exe" + $python_path = $python_home + "/python.exe" + if (-not(Test-Path $pip_path)) { + Write-Host "Installing pip..." + $webclient = New-Object System.Net.WebClient + $webclient.DownloadFile($GET_PIP_URL, $GET_PIP_PATH) + Write-Host "Executing:" $python_path $GET_PIP_PATH + Start-Process -FilePath "$python_path" -ArgumentList "$GET_PIP_PATH" -Wait -Passthru + } else { + Write-Host "pip already installed." + } + } + + function InstallPackage ($python_home, $pkg) { + $pip_path = $python_home + "/Scripts/pip.exe" + & $pip_path install $pkg + } + + function InstallScons ($python_home) { + Write-Host "Start installing Scons" + $pip_path = $python_home + "/Scripts/pip.exe" + & $pip_path install --egg "http://sourceforge.net/projects/scons/files/latest/download" + Write-Host "Scons installed" + } + + function main () { + InstallPython $env:PYTHON_VERSION $env:PYTHON_ARCH $env:PYTHON_HOME + InstallPip $env:PYTHON_HOME + InstallPackage $env:PYTHON_HOME setuptools + InstallScons $env:PYTHON_HOME + } + + main + +The ``run_with_compiler.cmd`` script file: + +.. code-block:: none + + @ECHO OFF + + SET COMMAND_TO_RUN=%* + SET WIN_SDK_ROOT=C:\Program Files\Microsoft SDKs\Windows + + SET MAJOR_PYTHON_VERSION="%PYTHON_VERSION:~0,1%" + IF %MAJOR_PYTHON_VERSION% == "2" ( + SET WINDOWS_SDK_VERSION="v7.0" + ) ELSE IF %MAJOR_PYTHON_VERSION% == "3" ( + SET WINDOWS_SDK_VERSION="v7.1" + ) ELSE ( + ECHO Unsupported Python version: "%MAJOR_PYTHON_VERSION%" + EXIT 1 + ) + + IF "%PYTHON_ARCH%"=="64" ( + ECHO Configuring Windows SDK %WINDOWS_SDK_VERSION% for Python %MAJOR_PYTHON_VERSION% on a 64 bit architecture + SET DISTUTILS_USE_SDK=1 + SET MSSdk=1 + "%WIN_SDK_ROOT%\%WINDOWS_SDK_VERSION%\Setup\WindowsSdkVer.exe" -q -version:%WINDOWS_SDK_VERSION% + "%WIN_SDK_ROOT%\%WINDOWS_SDK_VERSION%\Bin\SetEnv.cmd" /x64 /release + ECHO Executing: %COMMAND_TO_RUN% + call %COMMAND_TO_RUN% || EXIT 1 + ) ELSE ( + ECHO Using default MSVC build environment for 32 bit architecture + ECHO Executing: %COMMAND_TO_RUN% + call %COMMAND_TO_RUN% || EXIT 1 + ) diff --git a/docs/ci/circleci.rst b/docs/ci/circleci.rst new file mode 100644 index 00000000..357ae00d --- /dev/null +++ b/docs/ci/circleci.rst @@ -0,0 +1,73 @@ +.. _ci_circleci: + +Circle CI +========= + +`Circle CI `_ is a hosted cloud +platform that provides hosted continuous integration, deployment, and testing +to `GitHub `_ repositories. + +Circle CI is configured by adding a file named ``circle.yml``, which is a +`YAML `_ format text file, to the root +directory of the GitHub repository. + +Circle CI automatically detects when a commit has been made and pushed to a +GitHub repository that is using Circle CI, and each time this happens, it will +try to build the project using :ref:`cmd_ci` command. This includes commits to +all branches, not just to the master branch. Circle CI will also build and run +pull requests. When that process has completed, it will notify a developer in +the way it has been configured to do so — for example, by sending an email +containing the build results (showing success or failure), or by posting a +message on an IRC channel. It can be configured to build project on a range of +different :ref:`platforms`. + +Integration +----------- + +Please put ``circle.yml`` to the root directory of the GitHub repository. + +.. code-block:: yaml + + machine: + + environment: + - PLATFORMIO_CI_SRC=path/to/source/file.c + - PLATFORMIO_CI_SRC=path/to/source/file.ino + - PLATFORMIO_CI_SRC=path/to/source/directory + + dependencies: + pre: + - python -c "$(curl -fsSL https://raw.githubusercontent.com/platformio/platformio/master/scripts/get-platformio.py)" + + test: + override: + - platformio ci --board=TYPE_1 --board=TYPE_2 --board=TYPE_N + + +For more details as for PlatformIO build process please look into :ref:`cmd_ci` +command. + +Examples +-------- + +1. Integration for `USB_Host_Shield_2.0 `_ + project. The ``circle.yml`` configuration file: + +.. code-block:: yaml + + machine: + environment: + PLATFORMIO_CI_SRC: examples/Bluetooth/PS3SPP/PS3SPP.ino + PLATFORMIO_CI_SRC: examples/pl2303/pl2303_gps/pl2303_gps.ino + + dependencies: + pre: + - sudo apt-get install python2.7-dev + - python -c "$(curl -fsSL https://raw.githubusercontent.com/platformio/platformio/master/scripts/get-platformio.py)" + - sudo pip install --egg http://sourceforge.net/projects/scons/files/latest/download + - wget https://github.com/xxxajk/spi4teensy3/archive/master.zip -O /tmp/spi4teensy3.zip + - unzip /tmp/spi4teensy3.zip -d /tmp + + test: + override: + - platformio ci --lib="." --lib="/tmp/spi4teensy3-master" --board=uno --board=teensy31 --board=due diff --git a/docs/ci/drone.rst b/docs/ci/drone.rst new file mode 100644 index 00000000..f4792ef6 --- /dev/null +++ b/docs/ci/drone.rst @@ -0,0 +1,70 @@ +.. _ci_drone: + +Drone +===== + +`Drone `_ is a hosted continuous integration service. +It enables you to conveniently set up projects to automatically build, test, +and deploy as you make changes to your code to +`GitHub `_ and +`BitBucket `_ repositories. + +Drone is configured by modifying settings in your project control panel. + +Drone automatically detects when a commit has been made and pushed to a +GitHub repository that is using Drone, and each time this happens, it will +try to build the project using :ref:`cmd_ci` command. This includes commits to +all branches, not just to the master branch. Drone will also build and run +pull requests. When that process has completed, it will notify a developer in +the way it has been configured to do so — for example, by sending an email +containing the build results (showing success or failure). It can be +configured to build project on a range of different :ref:`platforms`. + +Integration +----------- + +Please fill all fields for your project in the Drone control panel: + +`Environment Variables`: + +.. code-block:: bash + + PLATFORMIO_CI_SRC=path/to/source/file.c + PLATFORMIO_CI_SRC=path/to/source/file.ino + PLATFORMIO_CI_SRC=path/to/source/directory + +`Commands`: + +.. code-block:: bash + + python -c "$(curl -fsSL https://raw.githubusercontent.com/platformio/platformio/master/scripts/get-platformio.py)" + platformio ci --board=TYPE_1 --board=TYPE_2 --board=TYPE_N + +.. image:: ../_static/droneci-platformio-integration-1.png + +For more details as for PlatformIO build process please look into :ref:`cmd_ci` +command. + +Examples +-------- + +1. Integration for `USB_Host_Shield_2.0 `_ + project. The ``circle.yml`` configuration file: + +`Environment Variables`: + +.. code-block:: bash + + PLATFORMIO_CI_SRC=examples/Bluetooth/PS3SPP/PS3SPP.ino + PLATFORMIO_CI_SRC=examples/pl2303/pl2303_gps/pl2303_gps.ino + +`Commands`: + +.. code-block:: bash + + pip install --egg http://sourceforge.net/projects/scons/files/latest/download + wget https://github.com/xxxajk/spi4teensy3/archive/master.zip -O /tmp/spi4teensy3.zip + unzip /tmp/spi4teensy3.zip -d /tmp + platformio ci --lib="." --lib="/tmp/spi4teensy3-master" --board=uno --board=teensy31 --board=due + +.. image:: ../_static/droneci-platformio-integration-2.png diff --git a/docs/ci/index.rst b/docs/ci/index.rst index d619bc24..480974bf 100644 --- a/docs/ci/index.rst +++ b/docs/ci/index.rst @@ -17,4 +17,8 @@ easily. .. toctree:: :maxdepth: 2 + appveyor + circleci + drone + shippable travis diff --git a/docs/ci/shippable.rst b/docs/ci/shippable.rst new file mode 100644 index 00000000..9d27df52 --- /dev/null +++ b/docs/ci/shippable.rst @@ -0,0 +1,76 @@ +.. _ci_shippable: + +Shippable +========= + +`Shippable `_ is a hosted cloud +platform that provides hosted continuous integration, deployment, and testing +to `GitHub `_ and +`BitBucket `_ repositories. +Shippable's continuous integration service is built using Docker. + +Shippable is configured by adding a file named ``shippable.yml``, which is a +`YAML `_ format text file, to the root +directory of the GitHub repository or you can use your Travis CI configuration +file ``.travis.yml``. + +Shippable automatically detects when a commit has been made and pushed to a +GitHub repository that is using Shippable, and each time this happens, it will +try to build the project using :ref:`cmd_ci` command. This includes commits to +all branches, not just to the master branch. Shippable will also build and run +pull requests. When that process has completed, it will notify a developer in +the way it has been configured to do so — for example, by sending an email +containing the build results (showing success or failure), or by posting a +message on an IRC channel. It can be configured to build project on a range of +different :ref:`platforms`. + +Integration +----------- + +Please put ``shippable.yml`` or ``.travis.yml`` to the root directory of the +GitHub repository. + +.. code-block:: yaml + + language: python + python: + - "2.7" + + env: + - PLATFORMIO_CI_SRC=path/to/source/file.c + - PLATFORMIO_CI_SRC=path/to/source/file.ino + - PLATFORMIO_CI_SRC=path/to/source/directory + + install: + - python -c "$(curl -fsSL https://raw.githubusercontent.com/platformio/platformio/master/scripts/get-platformio.py)" + + script: + - platformio ci --board=TYPE_1 --board=TYPE_2 --board=TYPE_N + + +For more details as for PlatformIO build process please look into :ref:`cmd_ci` +command. + +Examples +-------- + +1. Integration for `USB_Host_Shield_2.0 `_ + project. The ``shippable.yml`` or ``.travis.yml`` configuration file: + +.. code-block:: yaml + + language: python + python: + - "2.7" + + env: + - PLATFORMIO_CI_SRC=examples/Bluetooth/PS3SPP/PS3SPP.ino + - PLATFORMIO_CI_SRC=examples/pl2303/pl2303_gps/pl2303_gps.ino + + install: + - python -c "$(curl -fsSL https://raw.githubusercontent.com/platformio/platformio/master/scripts/get-platformio.py)" + - wget https://github.com/xxxajk/spi4teensy3/archive/master.zip -O /tmp/spi4teensy3.zip + - unzip /tmp/spi4teensy3.zip -d /tmp + + script: + - platformio ci --lib="." --lib="/tmp/spi4teensy3-master" --board=uno --board=teensy31 --board=due