As part of Unblock Phabricator and Jenkins Decommission initiative by Backend Infra, we will do the repository migration for tv-sql-product, backend-monorepo, and other central backend repositories (service-metadata, monitoring-tools, and tools) and Jenkins pipeline for code review used by backend-monorepo. We will also publish the migration guideline that can be followed by backend teams to migrate their own repository in Phabricator to Github or pipeline in Jenkins to CodeBuild. This guideline might be useful for other teams beside backend such as frontend, mobile, etc as well but we can’t guarantee that it’s suitable for all cases outside backend-related cases.

Migration Plan

tv-sql-product

We will migrate tv-sql-product repository on July 27th, 2020 at 09.00 UTC +7. The migration will be around 15 minutes with the schedule:

Announce the start of the migration – 08.55
Remove sync on Phabricator – 09.00
Grant backend team write access to tv-sql-product repository in Github – 09.05
Add branch protection to master branch – 09.05
Change tv-sql-product repository in Phabricator to read-only – 09.10
Announce the end of the migration – 09.10

During this migration period, avoid doing any action including arc diff and arc land to the repository.

backend-monorepo

We will remove backend-monorepo repository mirror to Phabricator on August 3rd, 2020 at 09.00 UTC +7. This process will take around 15 minutes with the schedule:

Announce the start of the migration – 08.55
Enable branch protection on develop branch – 09.00

We will also enforce option “Require status checks to pass before merging” which means your pull request to develop branch must be able to be built.

Turn off the mirror to Phabricator and make the repository to be read-only – 09.00
Announce the end of the migration – 09.10

During this migration period, avoid doing any action including arc diff and arc land to the repository.

Other central backend Repositories Migration Plan

Other than tv-sql-product and backend-monorepo, Backend Infra found that there are other central repositories that are owned by Backend Infra and we will migrate it to Github. These repositories are:

Although these repositories seem unused, we will migrate it to Github anyway just in case. This is the schedule for the migration:

Migrate other central backend repositories – by July 17th, 2020 :heavy_check_mark:
Archive these repositories in Phabricator – by July 20th, 2020 :heavy_check_mark:

What Do You Need to Do?

Add code owners configuration for your own code. This will trigger a request for review whenever someone raises a pull request that contains a change in your code.
Land all your diffs that are still in Phabricator. The deadline is the end of the day before the planned removal for the repo in Phabricator (end of July 26th for tv-sql-product, end of August 2nd for backend-monorepo). Leftover diffs won’t be able to be landed (for backend-monorepo) or synced to Github (for tv-sql-product).
Migrate all existing backend-monorepo pipelines in Jenkins to CodeBuild. We will announce the guidelines on July ~~20th~~ 21st, 2020.

Other Repositories in Phabricator and Pipelines in Jenkins

For other repositories and pipelines not owned by Backend Infra, you are responsible to migrate it by yourselves. Backend Infra will provide the guidelines for it that will be published on July ~~20th~~ 21st, 2020. This guideline mainly focuses on the repository and pipeline usage in backend team. Other teams such as frontend, mobile, etc can also read it as general guidance but it might not cover all usages that are uncommon. You can also consult to Backend Infra or Cloud Infra team in Slack channel #phabricator_jenkins_discussion.

tv-sql-product, backend-monorepo, and central backend Repositories Migration Plan

Overview