{"id":13702870,"url":"https://github.com/ros-industrial/industrial_ci","last_synced_at":"2025-05-15T04:07:41.779Z","repository":{"id":2391472,"uuid":"46426925","full_name":"ros-industrial/industrial_ci","owner":"ros-industrial","description":"Easy continuous integration repository for ROS repositories","archived":false,"fork":false,"pushed_at":"2025-04-26T18:21:24.000Z","size":1502,"stargazers_count":266,"open_issues_count":102,"forks_count":134,"subscribers_count":24,"default_branch":"master","last_synced_at":"2025-05-05T19:13:59.704Z","etag":null,"topics":["catkin","continuous-integration","gitlab","ros","travis"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ros-industrial.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2015-11-18T15:15:44.000Z","updated_at":"2025-05-01T15:22:34.000Z","dependencies_parsed_at":"2024-08-18T00:09:34.636Z","dependency_job_id":"bd6b76d3-fc42-40a6-accc-f82a37cf38e8","html_url":"https://github.com/ros-industrial/industrial_ci","commit_stats":{"total_commits":787,"total_committers":43,"mean_commits":"18.302325581395348","dds":"0.37102922490470136","last_synced_commit":"53cd3f10a847e3d374ce385f447587ebcb6791d7"},"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ros-industrial%2Findustrial_ci","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ros-industrial%2Findustrial_ci/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ros-industrial%2Findustrial_ci/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ros-industrial%2Findustrial_ci/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ros-industrial","download_url":"https://codeload.github.com/ros-industrial/industrial_ci/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254270646,"owners_count":22042859,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["catkin","continuous-integration","gitlab","ros","travis"],"created_at":"2024-08-02T21:00:44.830Z","updated_at":"2025-05-15T04:07:36.763Z","avatar_url":"https://github.com/ros-industrial.png","language":"Shell","funding_links":[],"categories":["Development Environment"],"sub_categories":["Build and Deploy"],"readme":"================\nIndustrial CI\n================\n.. image:: https://github.com/ros-industrial/industrial_ci/workflows/CI/badge.svg?branch=master\n    :target: https://github.com/ros-industrial/industrial_ci/actions\n    :alt: GitHub Actions status\n.. image:: https://gitlab.com/ipa-mdl/industrial_ci/badges/master/pipeline.svg\n    :target: https://gitlab.com/ipa-mdl/industrial_ci/commits/master\n    :alt: Gitlab CI status\n.. image:: https://img.shields.io/badge/License-Apache%202.0-blue.svg\n    :target: https://opensource.org/licenses/Apache-2.0\n    :alt: License\n\nCI (Continuous Integration) configuration for `ROS` (`Robot Operating System \u003chttp://ros.org\u003e`__).\nThis is the refactored version with ROS2 support, the old version can be found in the `legacy branch \u003chttps://github.com/ros-industrial/industrial_ci/tree/legacy\u003e`__.\nPlease check the `migration guide \u003cdoc/migration_guide.md\u003e`__ as well.\n\n.. contents:: Table of Contents\n   :depth: 2\n\nDetailed documentation\n========================\n\nOther than the brief introduction in this page, you can also check `the detailed doc here \u003c./doc/index.rst\u003e`__.\n\nIntroduction\n============\n\nThis package contains `CI (Continuous Integration) \u003chttps://en.wikipedia.org/wiki/Continuous_integration\u003e`__ scripts that any ROS-powered packages can commonly use.\nSome notable feature:\n\n* Checks if your package builds, installs without issues. If unit/system tests are defined run them. `ROS Prerelease Test \u003chttp://wiki.ros.org/bloom/Tutorials/PrereleaseTest\u003e`__ can optionally be run.\n* Proven to cover the general requirements of the ROS-based robotics repositories. Easily configurable.\n* Users can add custom pre/post processes.\n* Covers ROS1 Indigo, Jade, Kinetic, Lunar, Melodic, Noetic and ROS2 distributions.\n* This repo provides scripts for `Bitbucket CI`, `Gitlab CI`, `GitHub Actions` and `Travis CI` only, but it can be easily adapted for other CI services.\n\nFor a brief overall introduction, you could also check a presentation:\n\n* `ROS-Industrial community meeting \u003chttp://rosindustrial.org/news/2016/6/14/ros-i-community-web-meeting-june-2016\u003e`__\n\nQuick Start\n============\n\nWith a few steps, you can start in your client repository using CI confiurations stored in `industrial_ci`.\n\nFor Travis CI\n--------------\n\n1. Activate CI for your github repository on `Travis CI \u003chttps://travis-ci.com/\u003e`__).\n\n   a) You may do so either at https://travis-ci.com/github/YOUR_GITHUB_ORGANIZATION or at https://travis-ci.com/github/YOUR_GITHUB_USER (depending on where your repository sits).\n   b) Activate CI beta for your bitbucket repository is similar, but the target link that your status badge directs to needs to be modified from https://travis-ci.com/USERNAME/REPO_NAME to https://travis-ci.com/bitbucket/USERNAME/REPO_NAME. By default, the generated link directs to a github repository.\n\n2. Add `.travis.yml` file to your repository root (`complete template \u003chttps://github.com/ros-industrial/industrial_ci/blob/master/doc/.travis.yml\u003e`__):\n\n::\n\n  language: generic\n  services:\n    - docker\n\n  env:\n    matrix:\n      - ROS_DISTRO=\"indigo\"\n\n  install:\n    - git clone --quiet --depth 1 https://github.com/ros-industrial/industrial_ci.git .industrial_ci -b master\n  script:\n    - .industrial_ci/travis.sh\n\n* Note: The name `.industrial_ci` is NO longer REQUIRED for the cloned folder starting version 0.3.2; you can pick any name (recommended practice to keep the folder hidden (by prepending \".\").\n\nFor Gitlab CI\n-------------\n\n1. Enable CI for your repo. Please refer to `official doc \u003chttps://docs.gitlab.com/ee/ci/quick_start/\u003e`__ for the steps to do so. Note for Gitlab CI, necessary steps might be different between hosted version (i.e. the one on gitlab.com) v.s. the one on your own server, which Gitlab doesn't always clarify in its documentation.\n\n   1. For your server version, enable a runner for your Gitlab project which uses the Docker executor. See instructions on how to `install \u003chttps://docs.gitlab.com/runner/install/index.html\u003e`__ and `register \u003chttps://docs.gitlab.com/runner/register/index.html\u003e`__ such a runner with your Gitlab instance if you haven't done so yet.\n\n2. In `.gitlab-ci.yml` file in your client repo, add the following minimal configuration (this snippet can be the entire content of the file), replacing indigo for your chosen distro:\n\n::\n\n   image: docker:git\n   services:\n     - docker:dind\n   before_script:\n     - apk add --update bash coreutils tar\n     - git clone --quiet --depth 1 https://github.com/ros-industrial/industrial_ci .industrial_ci -b master\n   indigo:\n     script: .industrial_ci/gitlab.sh ROS_DISTRO=indigo\n\n\nFor Bitbucket Pipelines\n-----------------------\n\n1. Enable CI for your repo. Please refer to `official doc \u003chttps://confluence.atlassian.com/bitbucket/get-started-with-bitbucket-pipelines-792298921.html\u003e`__ for the steps to do so.\n2. In the `bitbucket-pipelines.yml` file in your client repo, add the following minimal configuration (this snippet can be the entire content of the file), replacing indigo for your chosen distro:\n\n::\n\n   image: docker:git\n\n   pipelines:\n     default:\n        - step:\n            services:\n              - docker\n            script:\n              - apk add --update bash coreutils tar\n              - git clone --quiet --depth 1 https://github.com/ros-industrial/industrial_ci .industrial_ci -b master\n              - .industrial_ci/bitbucket.sh ROS_DISTRO=indigo\n\n   definitions:\n     services:\n       docker:\n         memory: 2048\n\n\nFor GitHub Actions\n-----------------------\n\n1. Create `.github/workflows/industrial_ci_action.yml` (industrial_ci_action.yml is arbitrary, `complete template \u003cdoc/industrial_ci_action.yml\u003e`__)  with the following configuration, (this snippet can be the entire content of the file), replacing melodic for your chosen distro:\n\n::\n\n   name: CI\n\n   on: [push, pull_request]\n\n   jobs:\n     industrial_ci:\n       strategy:\n         matrix:\n           env:\n             - {ROS_DISTRO: melodic, ROS_REPO: testing}\n             - {ROS_DISTRO: melodic, ROS_REPO: main}\n       runs-on: ubuntu-latest\n       steps:\n         - uses: actions/checkout@v4\n         - uses: 'ros-industrial/industrial_ci@master'\n           env: ${{matrix.env}}\n\nFor Google Cloud Build\n----------------------\n1. Connect your source code repository to your Google Cloud Project. Please refer to the `official documentation \u003chttps://cloud.google.com/build/docs/automating-builds/create-manage-triggers#gcloud\u003e`__ for the steps to do so.\n2. In the `cloudbuild.yaml` file in your client repo, add the following minimal configuration\n\n::\n\n  steps:\n    - name: 'ros:melodic'\n      entrypoint: 'bash'\n      args:\n        - '-c'\n        - |-\n          git clone --depth 1 https://github.com/ros-industrial/industrial_ci .industrial_ci -b master\n          .industrial_ci/ci.sh\n      env:\n        - 'ISOLATION=shell'\n        - 'CI=true'\n\nConcrete examples of config files\n-------------------------------------\n\n- A `template for Travis CI \u003cdoc/.travis.yml\u003e`__.\n- For development branch intended for ROS Indigo: `ros_canopen \u003chttps://github.com/ros-industrial/ros_canopen/blob/0a42bf181804167834b8dc3b80bfca971f24546f/.travis.yml\u003e`__\n- For development branch intended for ROS Indigo onward:\n   - `example 1 \u003chttps://github.com/ros-industrial/industrial_core/blob/eeb6a470e05233d0efaaf8c32a9e4133cdcbb80b/.travis.yml\u003e`__ (Indigo and Jade compatible).\n   - `example 2 \u003chttps://github.com/ros-drivers/leap_motion/blob/954924befd2a6755f9d310f4a8b57aa526056a80/.travis.yml\u003e`__ (Indigo, Jade, Kinetic compatible. Also runs `ROS Prerelease Test \u003chttp://wiki.ros.org/bloom/Tutorials/PrereleaseTest\u003e`__).\n- For development branch intended for ROS Kinetic: `industrial_core \u003chttps://github.com/ros-industrial/industrial_core/blob/a07f9089b0f6c8a931bab80b7fca959dd6bba05b/.travis.yml\u003e`__\n- For more complexed example: `.travis.yml \u003chttps://github.com/ros-industrial/industrial_ci/blob/d09b8dd40d7f1fa1ad5b62323a1d6b2ca836e558/.travis.yml\u003e`__ from the same repo. You can see how options are used.\n- For Gitlab CI, a small `sample config \u003c./.gitlab-ci.yml\u003e`__.\n\nMetrics\n========\n\nThere might not an easy way to precisely count how many repositories out there are using `industrial_ci`. Counting that number isn't even our priority at all, but we're often simply curious. Here's some ways that give us some clues for the usage metrics:\n\n- `Searching Github repos that contain string industrial_ci \u003chttps://github.com/search?p=1\u0026q=industrial_ci+-repo%3Aros-industrial%2Findustrial_ci\u0026ref=searchresults\u0026type=Code\u0026utf8=%E2%9C%93\u003e`__) (with some duplicates. Excluding industrial_ci repo):\n\n  - 1,841 (Jan 2, 2019)\n  - 675 (May 15, 2018)\n  - 457 (Dec 12, 2017)\n  - 142 (Jan 20, 2017)\n\n- Github--\u003e `Graphs` --\u003e `Traffic` view (visible only to admins).\n\n  - Dec 30, 2018\n\n  .. figure:: http://ros-industrial.github.io/industrial_ci/images/industrial_ci_traffic_20181230.png\n\n  - May 15, 2018\n\n  .. figure:: http://ros-industrial.github.io/industrial_ci/images/industrial_ci_20180515_traffic.png\n\n  - Dec 12, 2017\n\n  .. figure:: http://ros-industrial.github.io/industrial_ci/images/industrial_ci_traffic_20171212.png\n\n  - Jan 20, 2017\n\n  .. figure:: http://ros-industrial.github.io/industrial_ci/images/industrial_ci_traffic_20170120.png\n\nEoF\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fros-industrial%2Findustrial_ci","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fros-industrial%2Findustrial_ci","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fros-industrial%2Findustrial_ci/lists"}