TFS to GCcode (or GitHub)
Similar Guides:
Steps
- (Optional) Decouple projects and services
- Scan & Remove secrets (encrypt where necessary)
- Migrate TFS Tasks to Issues (manual, overtime, after a release)
- Migrate the Code
- Build your pipeline
Setting up a GCcode repository for your team
- Create a personal account in GCcode
- Create an issue in the ESDC Welcome project and fill out the
New Team Group Request
template- Wait for access to your new group
- Create a
New project
- Clone and copy the files from the template-gabarit project
- Use the label-generator to add default starter labels to your project
Note: You may need to configure your repository to bypass the network proxy to be able to clone from GitHub.
Setting up a GitHub repository for your team
- Create a personal account in GitHub
- Create a new Organization for your team
- Create an issue in the ESDC Welcome project and fill out the
List Team Group
template- Fork the template-gabarit project into your new ogranization.
- Change the Settings of that forked project to be a Template repository (under Repository name)
- Create a new repository using the forked template project as the template
- Use the label-generator to add default starter labels to your project
Note: You may need to configure your repository to bypass the network proxy to be able to clone from GitHub.
FAQ
How do you manage TFS related items like UserStory, WorkItem, Bugs, etc, in GitLab?
It looks very similar in GitLab.
Labels & Issue Templates!!!
Labels are critical to organizing Issues (or WorkItems). Bugs are given a bug
label. Things like UserStory are given an enhancement
or feature request
label.
Issue Templates help users creating new Issues to fill out all of the necessary details for a standard Issue.
You can copy bug
and feature
Issue templates from the ESDC Template project.
We recommend that you start with the key labels from ESDC Label Generator project to add default labels to your project or group and add more as it helps you organize your project. You should have labels that identify key parts of your application. You should also add labels to help with the flow of your team’s processes.
Is it possible to migrate all the Work Items (User Story, Bug, tasks, etc) to GitLab?
Even if it’s look very different.
It might be technically possible by custom writing a script using TFS and GitLab APIs; but I wouldn’t recommend it. The platforms are different enough that it could take more time to write the script than doing it manually. The other benefit of doing it manually is forcing your team to remove redundant and outdated information. (Don’t move closed items.)
What is the recommended approach for managing secrets in code?
When migrating to an open source platform (like GitHub or GCcode) we can’t keep hardcoding secrets, and they need to be removed. How should a new developer get the necessary information to input into the web.config? (i.e. : inserting secrets, server name, username, etc)
Whatever tool is used to building your solution for deployment is also responsible for injecting the secrets into the config. Depending on the language and framework you are developing with, they may have different methods to managing the injection of those secrets. You may need to custom write a build script to search and replace secrets from your build’s secret environment variables. GitLab, Jenkins, Azure DevOps & TFS 2015 all have ways of managing secret environment variables for your scripted build.
A new developer should likely be creating their own development secrets. As for non-user specific secrets, it likely will depend on the secret itself as to how the developer will obtain that information.
What is the recommended approach for working with an external testing team service?
When migrating on GCcode, all the functionality around the work items changes. In GcCode, everything is related around
issues
combined with differentlabels
. With TFS, we have some strict workflow where work items have strict state flow. Testing team are working with tools like ‘Microsoft Test Manager’ which is tightly coupled with TFS.
Get them to work with you. Create workflows that work with your development cycle; there is nothing stopping a team from having strict workflows and following them in GCcode.
As far as the tool usage goes, developers and testers need to pick the tools that are best for the project. GCcode does function differently than TFS, however GCcode is more mature and flexible as a platform for development. If GCcode is the development platform (which it has been recommended to be) the testing platform (or tools) need to work with it, not the other way around.