Skip to content

lucimobility/luci-ros2-sdk

Repository files navigation

LUCI Sandbox

This is the public repo for the LUCI ROS2 SDK.

All documentation for examples, packages, and use lives at https://lucimobility.github.io/luci-sdk-docs/

Docker Images

This repo supports multiple docker images in order to build and deploy them please see their respective folders README.md instructions.

Documents

Getting Started

ROS2 Install

Installing Protobuf

Installing GRPC

Installing SDK

Troubleshooting

Contributing

Releasing new version (FOR LUCI TEAM)

When an update has occurred to one of the SDK packages and a new version of the SDK is ready to be released there are a couple steps to follow. It is important to note that most of the process is automated for convenience and the process should be just a couple of button clicks.

Steps

  1. Update release version
    • This should be its own separate PR and should update the versions.json file and the release Dockerfile with the new package versions. Make sure that you have already officially released the SDK package with the version you are changing it to or this build will fail.
    • LUCI follows semver style versioning so MAJOR.MINOR.PATCH versions are expected.
    • It is okay to not put out versions until multiple changes have happened to the code.
  2. Once the version increment is merged you simply need to create an official release in github.
    • This should trigger an action to auto run called Create Release Documentation which you can monitor in the github actions panel. This should generate a new release tab on the documentation site.
  3. Then to release the dev and public docker images go to github actions panel and run the Create and Deploy Docker action making sure to select both images. This should grab the released code, build the docker images for public use and push them to jrog artifactory.

If everything went smoothly congratulations the new docker images with packages and docs will be released and publicly distributable.

NOTE: Once a PR is merged into the main branch the docs site in the next version will update with it that evening.