GitLab Manage Stage, 3 Dec 2020

Previous Meeting Next Meeting

⏯

youtube image

►

From YouTube: Walkthrough: Import from GitHub into GitLab

Description

Haris Delalić from the Import Team walks through migration from GitHub into GitLab.

A

Hi everyone,, this is haris delalic and I'm the product manager.

A

For group import here at gitlab. today, I'm going to walk through migration from github.

A

Into gitlab to show the current user experience and note any opportunities for improvement.

A

I'll start by logging into my github account and review my data there before migration.

A

So,, this is my github account where I have created an organization in order to see.

A

How much of that, and in what way, can I migrate into gitlab.? My organization has two repositories:.

A

The website and the backend. the repositories have a couple of files in them. Each they're associated.

A

Different issues are associated with different projects, and the issues have elements such as.

A

Labels embedded images and comments with images on them. In addition to the.

A

Repositories, I have also created teams in order to see if and how that might get reflected in git lab.

A

In this case, I have four different teams, one of which is is a sub-team of a higher level team.

A

So with that in mind,, I'm going to switch over to gitlab.

A

In order to engage the migration and transfer my data from github.

A

Into gitlab, so first I'm going to have to find the import feature. It is actually.

A

Right behind the new project button on this view, so this view is the group that I've.

A

Created I'm going to use this group to migrate data into it and to move the data from github.

A

We really need to create a new project. That project will then get the data from github.

A

Populated into it, the project will belong to this group. I can create a new project, either directly.

A

From the group overview page or I can engage creation of a new project or a new subgroup.

A

From anywhere in the product, by using the plus add option in the top level now.

A

So the new project page gives me several options. One is to create a blank project, another one.

A

Is to create a project from a template, and I see that import project is one of the options.

A

To create a new project and from the description here I can tell that.

A

It does support at least the github and big bitbucket or another instance of gitlab among.

A

Other sources, so here I can see all the different choices where I can get. My data migrated from.

A

And in my case I'm going to select github, I have already provided gitlab with my github credentials.

A

Which then led me to this view here I can tell already that I have once.

A

Migrated a private project from github into gitlab, and that was completed and I have a link to go see.

A

The project here, if I had a lot of different projects, that I had visibility into in github,.

A

I could potentially use the filter here to find just the projects that match a search criteria.

A

I'm not sure exactly why this doesn't work, but it seems that.

A

If I try to filter the repositories by name.

A

I'm not able to see anything if I type in theme, for example, which is a which is contained.

A

In the projects that I have in github, maybe it's the actual project name, not the organization name.

A

Yeah, all right, so that's what it is. So the filter works in such a way that it looks.

A

Only for projects which in this case are private, public, backend and website.

A

And those are the ones that would show up in here. Okay, so I can decide where.

A

In git lab, I would like these projects to be migrated to so. In this particular case,.

A

I actually want to select that group that I was looking at earlier to.

A

Move the backend and the website projects into.

A

It seems that I can import all three repositories that are shown here, so the three that are.

A

Importable, I should be able to import them by clicking on the import three repositories button.

A

It'd be nice. If I can just select, you know several, but not all repositories, temperature. If I wanted.

A

To import, you know these two from the team get it done, and not necessarily this other public project.

A

I belong to. I wanted to exclude a project it'd be nice to do that, to be able to just checkbox.

A

These and then start import, but in this case I'm just going to kick off two separate imports.

A

So clicking on import and clicking on the other.

A

Import, what I see is that one of them is has gotten going and it's running.

A

I see that the button that says import multiple repositories is spinning as well, which I didn't.

A

Expect that to be engaging or that to be a spinner, I would expect it to be grayed out, because I'm.

A

Not importing multiple repositories at a time, but it's just odd that there's also a spinner there.

A

I wonder if I should just wait for the importers to complete here and whether I'll be able to.

A

Just see the site refreshed or do I need to hit refresh, so I don't think it'll hurt if I just.

A

Refresh this to see, if there's better data there- and there was so clearly, the page did.

A

Not refresh or did not refresh, you know quickly enough for me to be able to see.

A

The progress but both of those imports were done and I'm now provided with a link to go to the.

A

Project in gitlab, at the same time, there's also a link here, so I can go back to the project in.

A

Github and compare the two, which is something that I will want to do so I'll open up the.

A

Backend project in github and at the same time I'm going to open up the same project in git, lab and.

A

Kind of compare the two and see what what what got migrated and how it will work. How it'll work out.

A

So looking at github, the name of the project was backhand and then there was a description.

A

That says the server portion of the product, and it seems that both the name and the description have.

A

Been moved across, I see that my commits have been migrated across as well as well as the two files.

A

That I had in the in the repo, so three commits two files. I'll take a look at the commits to just.

A

See what that looks like so yeah these were the comments that I've made when I, when I.

A

Made those commits so I created the sql. I did some initial commit, create a sql data file and.

A

Then made another change to restore the tables, so it does seem that the commits are all there.

A

So now next thing I would like to take a look at. It are the issues it does say three here, so that.

A

Gives me confidence that my three issues were moved across the three issues I had.

A

There was out of those three issues. One was.

A

I thought that one of them was closed, but apparently,.

A

It was not closed, so that's something we'll have to try next time is to make sure that.

A

If an issue is closed, that it comes across as closed.

A

So three open issues.

A

And the labels seem to have come across, interestingly enough, which is kind of cool.

A

The label colors have made it across as well, and the milestones that these.

A

Issues were associated with, which were which, in this case was the r2 for the issue number one.

A

Also seem to have made it across into milestones, so there's a milestone.

A

That's defined as r2, and this issue is now associated with the milestone.

A

So this happens every now and then really not sure what to do other than refresh to make that go away.

A

So the issue seems to have come across pretty well, including the embedded image.

A

That I had in the issue, and additionally I have also. I also see the comment that I that I've made.

A

That comment was created by a user by a github user that does not have an account.

A

In gitlab, so I see this note here that says that it was created by this user.

A

And the actual comment- and the issue are all associated with my gitlab user, which is the.

A

One that performed the import, so that's that's. As expected, I'm curious if the issue that had.

A

The image in the comments, if those images have come across as well.

A

So, let's take a look at the issue number.

A

Two and yeah it seems that the image from the comment has made it across as well.

A

So far, all everything that I expected to be there has made it across.

A

As I suspected the you know, the users, if they're not in gitlab they're, not going to get mapped.

A

And they're, you know: they're not gonna get moved from github into git lab either in any kind of.

A

Automated way, the teams that concept, just it doesn't seem like it, mapped to anything or it.

A

Got moved in any particular way, but that's also sort of to be expected because the import that.

A

I've done was at the level of the project, each project being one of these repositories, so I.

A

Moved this repository and that repository out of github, I did not move packages or people or teams.

A

Or projects, so those are, those are entities that do not get mapped or moved in any way.

A

Really, what gets, mapped and moved across is sort of everything that belongs with.

A

With the repositories- and in that case, what I end up with is projects in the group that I've.

A

Selected, so if I go take a look at the group, I do see the two projects that I've migrated: over.

A

So I guess there are some steps that I would need to do manually in order to.

A

Really mirror the entire organization from github into gitlab, namely the users and the teams.

A

Would need to be mapped manually at this point and I wonder if there's anything else, that's missing.

A

Okay, so if I go back to import, I also am curious whether I can tell that the imports that those.

A

Groups that those projects were actually imported and whether it would let me to import again.

A

So yeah it clearly recognizes the fact that these two projects were imported and there isn't a way.

A

For me to re-import, on top of that, I would imagine I would need to delete the project in.

A

Gitlab, in order to be able to import it again.

A

Okay, so I think that that gives me an idea of what the user experience.

A

Looks like and also definitely prompted me to look look into a few things and.

A

Note some of the improvements that we can make in the user experience.

A

As well as in the depth of the integration, adapt of the migration so be able to migrate.

A

More things in an automated way, as opposed to having to manually, do some of that.

A

This concludes my walkthrough and the video.

A

Thank you very much for watching, and I hope it was as useful to you as it was for me.. Take care.