Meego Wiki
Views

Build Infrastructure/Packagers Developers/WebUI part 2

From MeeGo wiki
< Build Infrastructure | Packagers Developers(Difference between revisions)
Jump to: navigation, search
m (Minor wording update to accommodate webui changes)
(Add repository / build target)
 
(14 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: ==
-
Enter your "Home Project" by clicking on the link at the bottom left. You'll see this page as setup in part 1:
+
Enter "My Projects" by clicking on the link at the bottom left. You'll see this page as setup in part 1:
[[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 40: Line 38:
Open that page and enter for  
Open that page and enter for  
  Name of original project:
  Name of original project:
-
  Meego:Trunk
+
  MeeGo:1.0:Core
and for
and for
  Name of package in original project:
  Name of package in original project:
  bash
  bash
-
- we'll leave "Name of linked package in target project" empty. This is shown on the next picture:
+
- we'll leave "Name of linked package in target project" empty.
 +
 
 +
This is shown on the next picture:
[[File:Build_meego_addlink1.png|center]]
[[File:Build_meego_addlink1.png|center]]
Line 55: 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]]
-
Now select "Meego:Trunk/standard" as target repository (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.
+
Now select "Meego:Trunk/standard" as target repository:
 +
 
 +
[[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.
[[File:Build_meego_trunk_added_arrows.png|center]]
[[File:Build_meego_trunk_added_arrows.png|center]]
-
Congratulations, the package automatically starts 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:
 +
 
 +
[[File:Build_meego_home_project_failed_build.png|center]]
 +
 
 +
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:
-
The package page:
 
[[File:Build_meego_package_overview.png|center]]
[[File:Build_meego_package_overview.png|center]]
-
The build log:
+
 
 +
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:
 +
 
[[File:Build_meego_building_log.png|center]]
[[File:Build_meego_building_log.png|center]]
 +
... and the bottom of the build log page:
[[File:Build_meego_building_log2.png|center]]
[[File:Build_meego_building_log2.png|center]]
-
Picture of the project monitor page:
+
 
 +
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:
 +
 
 +
[[File:Build_meego_building_log_err.png|center]]
 +
 
 +
Return using your browser back button to your home project Overview page. Click on the Monitor tab, and you'll see something like:
 +
 
[[File:Build_meego_building_monitor.png|center]]
[[File:Build_meego_building_monitor.png|center]]
 +
 +
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:
 +
 +
[[File:Build_meego_building_monitor_2.png|center]]
 +
 +
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'':
 +
 +
[[File:Build_meego_built_repos_arrow.png]]
 +
 +
And from there, click on ''Go to download repository''. You'll see something like this:
 +
 +
[[File: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 [[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