GitLab Package Group, 12 Dec 2019

Previous Meeting Next Meeting

⏯

youtube image

►

From YouTube: GitLab Conan Repository: Speed Run

Description

In this video, I create a new project and go through the Conan MVC on the fly

A

Hello, I'm Tim I'm, the product manager at gate, lab for the packaged stage and I'm responsible for the packaged registry, as well as the container registry. Today, I wanted to do a quick demo of a new feature that just launched on get lab comm and will be available in the upcoming milestone 12.6, which is scheduled for release on December 22nd, so 11 days from now, okay I am going to share my screen and today, okay, so, like I mentioned we're gonna be talking about the conan repository this feature just launched.

A

If we look over the proposal, we could see that we wanted to provide documentation for configuring, the Konan client to add, get lab to the remote list.

A

Users needed the ability to authenticate using their personal access token the ability to create and upload packages to the gate lab remote, and we need to be able to view those packages on in the gate, lab application, so I'm going to try and do all those things today, following with the documentation, I have done this once before and I'll say: I have a couple of advantages: I'm, not starting totally from scratch. One I have Konan installed already.

A

If you don't have it installed, and you want to test out the feature you could, you could check out. Conan do the other thing I have installed is C make which is a compiler for C and C++.

A

You could use another compiler I'm using it, because it's the example that the Conan Doc's gave and speaking of which I'm actually using their sort of base HelloWorld application. As my C++ application, then I'm going to work with this demo and then finally, I already created a personal access token and signed it to the into the remote with it.

A

Just because I recorded this video once before and I was frustrated that I, let my personal access to it can be almost published to the world. So in this case, I already did it. If you want to, if you need to create the personal access token, you could find that under your profile and settings and then on settings, you just find this access tokens here. You can name it whatever you want, you can call it Conan.

A

You can set an expiration date, so if you want I could have done, is just set the expiration date for tomorrow and not worried about it and then, when it comes to scope, there's a few different options here, so you can select between read registry write repository what we're looking for in order to update the conan repository, you will need to set it to the scope to api.

A

You create your token and this screen will change yeah. I actually will not do this, but if you, if you create your personal token here, the screen will change you'll be able to copy it without a problem. Okay, that's enough disclaimers. I think so what do I have if I would go open up?

A

My code editor here, I have a simple hello world example and includes a readme that actually I've, just if it loads just copied the documentation for the Conan repository I also included a gettin ignore to ignore any files that are in these directories.

A

But what I want to do now is go to get leva. No I actually want to start a project on good lab, so I can't get myself out of the way there. We go so I'm going to click this new project button cool. This brings up a new screen. I'm gonna call this project Conan the example. I really wanted to call it Conan the librarian, but it just I thought it was too much so here, okay, I could add my project description.

A

I'll, just say this is the conan demo project and then I have to choose here. The visibility level so do I want this to be private or public. So for me, I want to share this with my teammates, also the other advantage of making it a public project is you could take advantage of all of get labs gold features, so you get included with it. The konan repository or the NPM registry, or the maven repository I, already have a readme so I'm going to skip that step. It's okay, I'm, going to create the project.

A

Okay project was successfully created and then get lab. Debt, thankfully gives me all these helpful command line instructions. So what I want to do is open up. My command line says CD into the existing folder, so I'm ready they're. Actually, just you could see it's the same files that I was referencing before, and so what I'm going to do is get an in.

A

It looks like it initialized the repository I'll copy, this next command, because I've making a lot of typos today.

A

So this is just gonna add the remote.

A

And then we'll I should have a bunch of files now the same ones that I've been showing you that exists there. They are have no commits. Yet they all need to be added, so I'm gonna, add them. Then I'm going to commit my initial commit eating the typos.

A

Okay and then I'm ready to push.

A

This is probably gonna prompt me firm.

A

A

Oops, that's right all these typos today, just this is why I'm very thankful, like it lab, has these simple commands that you can copy okay? So now it's asked me for my SSH key, so I need to open up my password.

A

Okay, it looks like it pushed. Let's see if I refresh this page, all right I could see all those same files and looks like it did bring in the readme with the conin repository documentation.

A

Okay, so the first step here it says enabling the Konan repository, let's see, navigate to your project settings general permissions. Well, actually, this is enabled by default. Unless your administrator has changed it, but forgi babcom, it's it is automatically enabled. But if you wanted to do it, you would go to settings general.

A

Let's see permissions would come up here, sorry I'm, a little slower and then here see packages, so this will actually enable and disable the Conan repository or the other package manager formats that we support.

A

Okay, let's go back to so it's enabled we talked about installing Conan so but the first thing we're gonna want to do actually now is build a package. So here that means I'm going to have to interact with the Conan client, and the first step of this is to create a new recipe which will take the command Conan knew and with the package name and version, and it looks like we have an example here, so this command will create a new package named hello with the version 0.1.

A

Great and so what that did, is it saved a new file? The the Conan file see make lists as well as a few items and in the test package folder. So, let's see if those got added here great, so here's the Conan file- and you can see here the name and the version that was what we included in the Conan- knew command. It also has support for additional metadata like license or author or other information.

A

The nice thing is the package registry user interface should bring all this information and present it in the user in the user interface, okay. But let's go back to our documentation.

A

Okay, so we did Conan knew so next up, Conan create username channel. Ok, this is confusing because Conan has the concept of username, but this is not your github username. What this actually is is the, where you would put in your project path.

A

And then the channel would be, it could be beta, it could be release or master whatever, whatever you would like to call it, but the tricky part here is that you have to put in the project path and it looks like we separate the path using a plus instead of the slash. The reason this is that we did. This is because Konan requires that there's only one slash and it be between the user name and channel. So that means that we have to translate the project path into into pluses for instead of slashes, okay.

A

So let's do. Let's copy this example command here, I'm gonna do Conan, create I.

A

Think we I'm okay, calling it putting it in the beta channel, but instead of mine, my group, we could take T rizzi as the path and then, instead of slash, we'll do plus and then Conan the example. Okay, that looks pretty good.

A

Looks like it's working. It worked great okay, so next we are going to add the gate lab package registry as a conan, remote, okay, I'll warn you I have already done this, but it doesn't hurt for me to run it. I'll just just create an error. So so for this you do Conan remote, add and you change it to whatever. Whatever your instance is, if you're on gate lab comm, it would just it would be exactly this. If you were get lab at dot acne, you would do it that way.

A

Okay, so this should feel cool and I could have always done pulled up. My list of remotes here using the remote list and I could see here that kid lab is listed. Ok,.

A

Next up we're going to authenticate so like I mentioned earlier, I had already created the personal access token, with the scope set to API. So next up, we want to add a conan user to the get lab remote, and this is the piece again that I've already done. So what you could do here is put in copy this command and just substitute your get lab username and your personal access token.

A

Okay, I want to get to building or uploading a package. Let's get to the fun part.

A

Okay, so first upload a package: it's telling me how to create the package locally, follow specific naming convention. I think I did all those things it tells me: I need a personal access. Token I've already done that. Okay I can upload a package. So what I'm going to do is Conan upload.

A

But I have to correct this pad, so what I really want is.

A

Tear is e / gun in the example / beta Oh.

A

Oops oh I, put in slashes instead of the plus, so this should be. Tear is e + Conan the example / beta, which is the channel and I, should have just copied and pasted that from here. Okay, let's try that again.

A

A

Okay, so that actually is asking me to put in my personal access token hide this there we go. It's uploading.

A

Looks like it's working looks like it worked. Let's see if I go to my project, go to packages list.

A

Look at that there. It is hello just created just now now that I'm here, if I had multiple packages, I could sort by create a date name or version. I could see some metadata here and, if I click into it, I could see a bit more, so I could see the name and the version when it was created. This all looks about right and then I could download the associated files. So if I wanted to download, for example, the manifest that's no problem, I can just open that great okay.

A

One thing looks off about this user interface. It's not quite done so I'll. We have another feature, that's in progress right now see, and this will actually just expand the metadata that we support. So when we looked in that Conan file, we saw the compiler information, for example, that'll, be here, we'll also have this settings, which will let's see here it can see if it expanded. This will actually capture any of the key value pairs that you're putting into that settings in the Conan file.

A

So that'll be the change to the UI and we expect that to launch in the coming weeks.

A

Okay, well coming back to our proposal for the MVC, we follow documentation for configuring, the Conan client we added get little lab as a remote repository. We authenticated using to get that personal access, token created and uploaded a package to the gate lab remote and we viewed the package and downloaded the associated files from the user interface. That was great I hope you can check out this feature and if you have any feature requests, start a community contribution or open an issue and start the conversation thanks and look forward to getting your thoughts on this.