Important ⚠️ Gazebo and Ignition are going to GitHub!

General
1

Important :warning: Gazebo and Ignition are going to GitHub!

Hello community :fire:

BitBucket will be mercilessly eliminating all mercurial repositories on June 1st 2020.

Open Robotics’ simulation team has been using BitBucket to host our projects for many years. From Gazebo to Ignition, we have accumulated a couple hundred mercurial repositories over the years. And now that BitBucket is dropping mercurial support, you have been asking:

And the answer is yes. We’re going to GitHub.

:people_holding_hands: Who will be affected

You’ll be affected if you are:

  • A user who compiles / pulls any of our projects from source
  • A contributor to code, documentation, etc.

Within Open Robotics, our release, deployment and CI procedures will also be affected. This shouldn’t directly impact external users, but beware that there may be some downtime during migration, for example, on https://build.osrfoundation.org/.

It is worth noting that if you have down stream documentation or installation scripts you will be impacted and those materials may no longer function once BitBucket terminates mercurial support.

:snowflake: Freeze

As we migrate repositories, they will be frozen on BitBucket. So we ask users: please don’t create issues, pull requests or comments during those dates.

We’ll be closing all open pull requests on all repositories (merging or declining). If you’re working on a new pull request to one of our BitBucket repositories right now, we ask that you please wait until the repository is on GitHub to open new pull requests, so we can more quickly close the ones currently open.

At the end of each repository’s freeze, their issue trackers will be made private and users should refer to backup pages or GitHub instead.

Repository removals will happen in 2 phases, to ease transition:

  • On May 15th, all repositories will be transferred to the Bitbucket organization. They will still be using mercurial. New git repositories will be created on the original URLs with migration instructions. This will break any users cloning from the original URLs. Users may (mercurial) clone from osrf-migrated the next 15 days.
  • On June 1st, all mercurial repositories on osrf-migrated will be deleted by BitBucket. Downstream users will need to clone from GitHub.

See the schedule below for our repositories under active development:

Repository Freeze dates
Bitbucket 2020-04-09T07:00:00Z
Bitbucket
Bitbucket		 2020-04-10T07:00:00Z → 2020-04-13T07:00:00Z
Bitbucket
Bitbucket
Bitbucket
Bitbucket
Bitbucket
Bitbucket
Bitbucket
Bitbucket
Bitbucket
Bitbucket
Bitbucket
Bitbucket
Bitbucket
Bitbucket		 2020-04-14T07:00:00Z → 2020-04-17T07:00:00Z
Bitbucket 2020-04-17T07:00:00Z → 2020-04-21T07:00:00Z
Bitbucket
Bitbucket
Bitbucket		 2020-04-22T07:00:00Z → 2020-04-24T07:00:00Z

:world_map: What’s going where

We have 2 organizations on BitBucket:

  • Bitbucket
    • Hosts projects like Gazebo and SDFormat, as well as related projects like SubT, DRCSim, SRCSim, GzWeb, etc.
  • Bitbucket
    • Hosts the source code, release repositories, documentation, etc, all related to Ignition libraries.

As we move things to GitHub, we’ll distribute repositories across a few different organizations.

We will be using @scpeters’s fork of the bitbucket-hg-exporter tool to create a GitHub Pages backup of issues, pull requests and comments on public websites. All issues will also be imported to the new repositories, but BitBucket pull requests will only be archived on GitHub Pages.

As an example of this migration, osrf/sdformat has been migrated to scpeters-test/sdformat with issues imported to github and pull requests archived on GitHub pages.

See the table below as a quick reference of the archived and migrated repositories. We’ll be populating it as repositories are migrated.

BitBucket repository GitHub repository (may not exist yet) BitBucket backup
Active development / maintainance
Bitbucket GitHub - gazebosim/gazebo-classic: Gazebo classic. For the latest version, see https://github.com/gazebosim/gz-sim BitBucket backup of
Bitbucket GitHub - gazebosim/sdformat: Simulation Description Format (SDFormat) parser and description files. BitBucket backup of
Bitbucket GitHub - gazebosim/gz-cmake: A set of CMake modules that are used by the C++-based Gazebo projects. BitBucket backup of
Bitbucket GitHub - gazebosim/gz-common: An audio-visual library supports processing audio and video files, a graphics library can load a variety 3D mesh file formats into a generic in-memory representation, and the core library of Gazebo Common contains functionality that spans Base64 encoding/decoding to thread pools. BitBucket backup of
Bitbucket GitHub - gazebosim/gz-fuel-tools: A client library and command line tools for interacting with Gazebo Fuel servers. BitBucket backup of
Bitbucket GitHub - gazebosim/gz-sim: Open source robotics simulator. The latest version of Gazebo. BitBucket backup of
Bitbucket GitHub - gazebosim/gz-gui: Builds on top of Qt to provide widgets which are useful when developing robotics applications, such as a 3D view, plots, dashboard, etc, and can be used together in a convenient unified interface. BitBucket backup of
Bitbucket https://github.com/ignitionrobotics/ign-launch https://osrf-migration.github.io/ignition-gh-pages/#!/ignitionrobotics/ign-launch
Bitbucket https://github.com/ignitionrobotics/ign-math https://osrf-migration.github.io/ignition-gh-pages/#!/ignitionrobotics/ign-math
Bitbucket https://github.com/ignitionrobotics/ign-msgs https://osrf-migration.github.io/ignition-gh-pages/#!/ignitionrobotics/ign-msgs
Bitbucket https://github.com/ignitionrobotics/ign-physics https://osrf-migration.github.io/ignition-gh-pages/#!/ignitionrobotics/ign-physics
Bitbucket https://github.com/ignitionrobotics/ign-plugin https://osrf-migration.github.io/ignition-gh-pages/#!/ignitionrobotics/ign-plugin
Bitbucket https://github.com/ignitionrobotics/ign-rendering https://osrf-migration.github.io/ignition-gh-pages/#!/ignitionrobotics/ign-rendering
Bitbucket https://github.com/ignitionrobotics/ign-sensors https://osrf-migration.github.io/ignition-gh-pages/#!/ignitionrobotics/ign-sensors
Bitbucket https://github.com/ignitionrobotics/ign-tools https://osrf-migration.github.io/ignition-gh-pages/#!/ignitionrobotics/ign-tools
Bitbucket https://github.com/ignitionrobotics/ign-transport https://osrf-migration.github.io/ignition-gh-pages/#!/ignitionrobotics/ign-transport
Bitbucket https://github.com/osrf/subt https://osrf-migration.github.io/subt-gh-pages/#!/osrf/subt
https://bitbucket.org/osrf/subt_seed https://github.com/osrf/subt_seed https://osrf-migration.github.io/subt-gh-pages/#!/osrf/subt_seed
Bitbucket https://github.com/osrf/gazebo_models https://osrf-migration.github.io/gazebo_models-gh-pages/#!/osrf/gazebo_models
Bitbucket https://github.com/osrf/gazebo_tutorials https://osrf-migration.github.io/gazebo_tutorials-gh-pages/#!/osrf/gazebo_tutorials
Bitbucket https://github.com/osrf/sdf_tutorials https://osrf-migration.github.io/sdformat-gh-pages/#!/osrf/sdf_tutorials
Bitbucket https://github.com/ignitionrobotics/docs https://osrf-migration.github.io/ignition-gh-pages/#!/ignitionrobotics/docs
https://bitbucket.org/osrf/gzweb https://github.com/osrf/gzweb https://osrf-migration.github.io/gzweb-gh-pages/#!/osrf/gzweb
https://bitbucket.org/osrf/mesh_to_sdf https://github.com/osrf/mesh_to_sdf https://osrf-migration.github.io/osrf-others-gh-pages/#!/osrf/mesh_to_sdf
https://bitbucket.org/osrf/release-tools https://github.com/ignition-tooling/release-tools https://osrf-migration.github.io/ignition-tooling-gh-pages/#!/osrf/release-tools
https://bitbucket.org/osrf/gazebodistro https://github.com/ignition-tooling/gazebodistro https://osrf-migration.github.io/ignition-tooling-gh-pages/#!/osrf/gazebodistro
Past projects
https://bitbucket.org/osrf/drcsim https://github.com/osrf/drcsim https://osrf-migration.github.io/drcsim-gh-pages/#!/osrf/drcsim
https://bitbucket.org/osrf/handsim https://github.com/osrf/handsim https://osrf-migration.github.io/haptix-gh-pages/#!/osrf/handsim
https://bitbucket.org/osrf/srcsim https://github.com/osrf/srcsim https://osrf-migration.github.io/srcsim-gh-pages/#!/osrf/srcsim
https://bitbucket.org/osrf/servicesim https://github.com/osrf/servicesim https://osrf-migration.github.io/osrf-projects-gh-pages/#!/osrf/servicesim
https://bitbucket.org/osrf/citysim https://github.com/osrf/citysim https://osrf-migration.github.io/osrf-projects-gh-pages/#!/osrf/citysim
https://bitbucket.org/osrf/swarm https://github.com/osrf/swarm https://osrf-migration.github.io/osrf-projects-gh-pages/#!/osrf/swarm
https://bitbucket.org/osrf/mentor2 https://github.com/osrf/mentor2 https://osrf-migration.github.io/osrf-others-gh-pages/#!/osrf/mentor2
https://bitbucket.org/osrf/gazebojs https://github.com/osrf/gazebojs https://osrf-migration.github.io/gzweb-gh-pages/#!/osrf/gazebojs
https://bitbucket.org/osrf/robocup3ds https://github.com/osrf/robocup3ds https://osrf-migration.github.io/osrf-projects-gh-pages/#!/osrf/robocup3ds
https://bitbucket.org/ignitionrobotics/ign-rndf https://github.com/ignitionrobotics/ign-rndf https://osrf-migration.github.io/ignition-gh-pages/#!/ignitionrobotics/ign-rndf
8 Likes
3

Thanks for the clear planning @chapulina!

Just to clarify, the migrated bitbucket repositories will remain available in read only until BitBucket itself will eliminatead them in June 1st 2020, I got that correctly?

4

Thank you for the question. I updated the Freeze section above with the timeline for repository removal.