Meego Wiki
Views

Build Infrastructure/Packagers Developers/WebUI part 2

From MeeGo wiki
< Build Infrastructure | Packagers Developers(Difference between revisions)
Jump to: navigation, search
(Create a link to a package in your home:)
(Add repository / build target)
 
(3 intermediate revisions not shown)
Line 1: Line 1:
= Creating a link and adding a repository =
= Creating a link and adding a repository =
-
Welcome to the MeeGo OBS webinterface guide - part 2. We'll show you how you can login and use the webinterface being hosted at build.meego.com . This includes login, adding a link to a package in your personal workspace (home:) and how to build that package by adding a repository.
+
Welcome to the MeeGo OBS webinterface guide - part 2. We'll show you how you can log in and use the web interface hosted at build.meego.com. This includes login, adding a link to a package in your personal workspace (home:) and how to build that package by adding a repository.
-
Please note: you'll need an account to access the build service server.
+
-
See [[Build_Infrastructure/Community_Builder|this page]] on the progress of the [[Build_Infrastructure/Community_Builder|Community Builder]].
+
-
== Startpage and Login ==
+
== Start page and Login ==
-
Open your favourite browser and navigate to https://build.meego.com. You'll be directed to the startpage.
+
Open your favorite browser and navigate to https://build.meego.com. You'll be directed to the start page.
-
[[File:Build_meego_startpage.png|center|alt=build.meego.com|build.meego.com startpage.]]
+
[[File:Build_meego_startpage.png|center|alt=build.meego.com|build.meego.com start page.]]
-
To proceed, you'll need to login and authenticate with your username and your password.
+
To proceed, you'll need to log in and authenticate with your username and your password.
Enter the data in the upper right corner.
Enter the data in the upper right corner.
-
[[File:Build_meego_startpage_arrow.png|center|alt=build.meego.com|build.meego.com login.]]
+
[[File:Build_meego_startpage_arrow.png|center|alt=build.meego.com|build.meego.com log in.]]
-
After successful authentication, you'll end up on the startpage again - with new options visible.
+
After successful authentication, you'll end up on the start page again - with new options visible.
-
[[File:Build_meego_startpage_loggedin.png|center|alt=build.meego.com|build.meego.com login.]]
+
[[File:Build_meego_startpage_loggedin.png|center|alt=build.meego.com|build.meego.com log in.]]
== Create a link to a package in your home: ==
== Create a link to a package in your home: ==
Line 26: Line 24:
[[File:Build_meego_my_projects.png|center]]
[[File:Build_meego_my_projects.png|center]]
-
Now lets create a link to a package and add a repository to build against. A link is basically a pointer to sources of an already existing package in another project. By *repository*, we mean a build target - e.g. like Trunk/Fedora_12/openSUSE_11.2. Lets follow these steps:
+
Now let's create a link to a package and add a repository to build against. A link is basically a pointer to sources of an already existing package in another project. By *repository*, we mean a build target - like Trunk/Fedora_12/openSUSE_11.2. Let's follow these steps:
# Add link to the existing package.
# Add link to the existing package.
# Add repository / build target.
# Add repository / build target.
Line 57: Line 55:
=== Add repository / build target ===
=== Add repository / build target ===
 +
To do this, click on "Add Repository". This will look like:
To do this, click on "Add Repository". This will look like:
 +
 +
https://build.pub.meego.com/project/add_repository_from_default_list?project=home%3A${USER}
[[File:Build_meego_add_repo.png|center]]
[[File:Build_meego_add_repo.png|center]]
Line 65: Line 66:
[[File:Build_meego_add_repo_2.png|center]]
[[File:Build_meego_add_repo_2.png|center]]
-
(if it is not in the initial list, see if there an an Advanced link to a more comprehensive list). This will take you back to your home: project. The build repository might be disabled: if so, klick on the cogwheel to enable it.
+
(If it is not in the initial list, see if there an an Advanced link to a more comprehensive list). This will take you back to your home: project. The build repository might be disabled: if so, klick on the cogwheel to enable it.
[[File:Build_meego_trunk_added_arrows.png|center]]
[[File:Build_meego_trunk_added_arrows.png|center]]
-
Congratulations, it is configured. On a heavily loaded server it can sometimes take a few minutes for your changes to become effective, but your linked package will automatically begin building.
+
Congratulations, it is configured. On a heavily loaded server, it can sometimes take a few minutes for your changes to become effective, but your linked package will automatically begin building.
=== Package page, build log and project monitor page ===
=== Package page, build log and project monitor page ===
-
Next it is time to explore the Monitor page, the package detail page and the build log. Just Click on the links and explore the webinterface.
+
Next, it is time to explore the Monitor page, the package detail page and the build log. Just click on the links and explore the web interface.
I recommend starting with your home project's top level 'overview' page - click on the Overview tab and you may see something like this:
I recommend starting with your home project's top level 'overview' page - click on the Overview tab and you may see something like this:
Line 100: Line 101:
[[File:Build_meego_building_monitor_2.png|center]]
[[File:Build_meego_building_monitor_2.png|center]]
-
Feel free to inspect the logs as it each version of the package is building.
+
Feel free to inspect the logs as each version of the package is building.
== Repository Output: Built Packages ==
== Repository Output: Built Packages ==
Line 117: Line 118:
We've had a look at adding a linked package. We watched it build automatically, pulling in prerequisite source packages, and inspected the logs. We also located the final output: built package files: source and binary rpm files. In our next step, we'll show how you can set up your own first package using the web interface -- continue at [[Build_Infrastructure/Packagers_Developers/WebUI_part_3|Part 3]].
We've had a look at adding a linked package. We watched it build automatically, pulling in prerequisite source packages, and inspected the logs. We also located the final output: built package files: source and binary rpm files. In our next step, we'll show how you can set up your own first package using the web interface -- continue at [[Build_Infrastructure/Packagers_Developers/WebUI_part_3|Part 3]].
 +
 +
[[Category:Build Infrastructure]]

Latest revision as of 01:47, 8 July 2011

Contents

Creating a link and adding a repository

Welcome to the MeeGo OBS webinterface guide - part 2. We'll show you how you can log in and use the web interface hosted at build.meego.com. This includes login, adding a link to a package in your personal workspace (home:) and how to build that package by adding a repository.

Start page and Login

Open your favorite browser and navigate to https://build.meego.com. You'll be directed to the start page.

build.meego.com

To proceed, you'll need to log in and authenticate with your username and your password. Enter the data in the upper right corner.

build.meego.com

After successful authentication, you'll end up on the start page again - with new options visible.

build.meego.com

Create a link to a package in your home:

Enter "My Projects" by clicking on the link at the bottom left. You'll see this page as setup in part 1:

Build meego my projects.png

Now let's create a link to a package and add a repository to build against. A link is basically a pointer to sources of an already existing package in another project. By *repository*, we mean a build target - like Trunk/Fedora_12/openSUSE_11.2. Let's follow these steps:

  1. Add link to the existing package.
  2. Add repository / build target.
  3. Enable the build (optional, if not already enabled).
  4. Observe the build on the monitor page
  5. Look at package's page

Add link to existing package

Right below packages, there's "Link Package from other Project" .

Build meego empty home arrow.png

Open that page and enter for

Name of original project:
MeeGo:1.0:Core

and for

Name of package in original project:
bash

- we'll leave "Name of linked package in target project" empty.

This is shown on the next picture:

Build meego addlink1.png

Proceed with "Create Link" and you'll be redirected to your home again. You'll see a new package "bash" and a notice about the link being added.

Build meego link added arrows.png

Wonderful, we've added a pointer to the sources - now we need a build repository added, so the builder knows the target-distribution.

Add repository / build target

To do this, click on "Add Repository". This will look like:

https://build.pub.meego.com/project/add_repository_from_default_list?project=home%3A${USER}

Build meego add repo.png

Now select "Meego:Trunk/standard" as target repository:

Build meego add repo 2.png

(If it is not in the initial list, see if there an an Advanced link to a more comprehensive list). This will take you back to your home: project. The build repository might be disabled: if so, klick on the cogwheel to enable it.

Build meego trunk added arrows.png

Congratulations, it is configured. On a heavily loaded server, it can sometimes take a few minutes for your changes to become effective, but your linked package will automatically begin building.

Package page, build log and project monitor page

Next, it is time to explore the Monitor page, the package detail page and the build log. Just click on the links and explore the web interface.

I recommend starting with your home project's top level 'overview' page - click on the Overview tab and you may see something like this:

Build meego home project failed build.png

This page has shown that some builds for some packages failed to complete successfully. Let's go look at the package itself. Click on the 'Packages' tab and then on 'bash'. You'll see the package detail page:

Build meego package overview.png

What failed? You can click on failed for either of the packages builds to inspect the build log. Below are the top of that page:

Build meego building log.png

... and the bottom of the build log page:

Build meego building log2.png

The comment at the end hints that the package probably built OK and rpms were produced, but that there were style violations in the packaging tests mandated by the MeeGo project. In fact, all that is confirmed some lines above when the rpmlint test is started:

Build meego building log err.png

Return using your browser back button to your home project Overview page. Click on the Monitor tab, and you'll see something like:

Build meego building monitor.png

So you can monitor something as it is building, let's add the acl package too. Click on the Packages tab. Then, click Link package from another project. Enter MeeGo:1.0:Core as the original project and acl as the name of package, and click Create Link. Return to your home project. Click on the Monitor tab and it will look like:

Build meego building monitor 2.png

Feel free to inspect the logs as each version of the package is building.

Repository Output: Built Packages

To find the RPMs you built, go to your home project page and click Repositories. From there click on the repository name. For example, Trunk:

Build meego built repos arrow.png

And from there, click on Go to download repository. You'll see something like this:

Build meego built repos download.png

Your rpms can be found in the subdirectories, and the .repo file is suitable for use with zypper, yum or other repository-friendly package management tools.

Summary

We've had a look at adding a linked package. We watched it build automatically, pulling in prerequisite source packages, and inspected the logs. We also located the final output: built package files: source and binary rpm files. In our next step, we'll show how you can set up your own first package using the web interface -- continue at Part 3.

Personal tools