Difference between revisions of "FreeBSD/Setup/Area51"

< FreeBSD‎ | Setup
Jump to: navigation, search
m (Area 51)
(Packages and Build Status)
Line 26: Line 26:
 
  }
 
  }
 
It is strongly advised to disable the official FreeBSD package repository when installing from this unofficial repository, to avoid mixing packages from multiple sources. Set <code>enabled: false</code> in the repository configuration file for the official FreeBSD package repository while testing area51 packages.
 
It is strongly advised to disable the official FreeBSD package repository when installing from this unofficial repository, to avoid mixing packages from multiple sources. Set <code>enabled: false</code> in the repository configuration file for the official FreeBSD package repository while testing area51 packages.
 +
 +
== Poudriere ==
 +
 +
We strongly recommend using poudriere for building packages from the area51 repository. These packages can then easily be used with pkg(8). First things first, install poudriere:
 +
 +
    # pkg install poudriere
 +
 +
it is recommended to modify `/usr/local/etc/poudriere.conf` to use ZFS.
 +
 +
=== Setting up the Ports Tree ===
 +
 +
(''note that this can be done more easily with poudriere-devel'')
 +
 +
With poudriere installed, you must create one or more ports trees (to build from) and one or more jails (to build in). We'll start with the ports tree. Create a tree, but don't populate it; we'll call this ports tree ''freebsd-ports-kde''.
 +
 +
    # poudriere ports -c -F -m git -p freebsd-ports-kde
 +
 +
Next, clone the ports tree from Area51. This needs to go into the just-created directory for the ports tree, which could be anywhere on your system depending on how poudriere is configured. The default is under `/usr/local/poudriere/ports`. Depending on how you want to access the Github repository, you may need to use a different user or credentials -- this example just does an anonymous clone.
 +
 +
    # cd /usr/local/poudriere/ports
 +
    # git clone https://github.com/freebsd/freebsd-ports-kde
 +
 +
With this setup, you can `git pull` and otherwise update the git repository as you see fit: it is the working directory that will be used for the ports tree (so you can switch branches inside the clone, too).
 +
 +
=== Setting up the Build Jail ===
 +
 +
Create a jail to build in; this is essentially a whole new FreeBSD installation inside your existing one. It can also be an older FreeBSD version (newer than the host system is not recommended and may not work at all). This command creates a new 11.0 jail, calling it ''110amd64'':
 +
 +
    # poudriere jail -c -j 110amd64 -v 11.0-STABLE -m ftp
 +
 +
=== Running a Build ===
 +
 +
Poudriere can bulk-build ports, given a jail and a ports tree to work with. It will generally rebuild all that is needed; assuming you are most interested in all the latest KDE software, the metaport `x11/kde5` is the one to rebuild.
 +
 +
    # poudriere bulk -j 110amd64 -p freebsd-ports-kde x11/kde5

Revision as of 08:54, 1 June 2017

Area 51

In the KDE3 days, around FreeBSD 5, the repository where KDE ports were developed was called Area 51 -- the famous place where aliens land. We still refer to the ports-development repository as Area 51, even though it is no longer called that in hostname or repository name.


Development of the Qt and KDE ports maintained by the KDE on FreeBSD team happens in the area51 repository. New versions and changes the ports are always committed there first and only later hit the ports tree. Even though the ports in the area51 repository are not always in a stable state, users are encouraged to test them and report problems, especially during the call for tests periods.

The area51 repository is hosted on github. The history of commits is recorded in the KDE on FreeBSD mailing list. The workflow is roughly the same as the ports workflow, or the GNOME ports: a complete git clone of the ports tree is kept, branches work on specific updates, and that gets merged to ports master when things are ready.

HIC SUNT LEONES

Source Organization

See the XOrg ports pages.

Packages and Build Status

The current status of some of the branches of the area51 repository can be seen in the FreeBSD Continuous Integration (CI) system, which is a Jenkins instance kindly hosted by one of the team members. The build status can be found in Jenkins. These builds are done from the area51 ports repository, on both 11-STABLE and CURRENT.

Packages may be obtained from the unofficial package repository that is created by the Jenkins CI system. To use these packages, you may add a repository configuration file /usr/local/etc/pkg/repos/area51.conf as follows:

area51: {
  url: "http://meatwad.mouf.net/rubick/poudriere/packages/110-amd64-area51/"
  priority: 2
  enabled: true
}

It is strongly advised to disable the official FreeBSD package repository when installing from this unofficial repository, to avoid mixing packages from multiple sources. Set enabled: false in the repository configuration file for the official FreeBSD package repository while testing area51 packages.

Poudriere

We strongly recommend using poudriere for building packages from the area51 repository. These packages can then easily be used with pkg(8). First things first, install poudriere:

   # pkg install poudriere

it is recommended to modify `/usr/local/etc/poudriere.conf` to use ZFS.

Setting up the Ports Tree

(note that this can be done more easily with poudriere-devel)

With poudriere installed, you must create one or more ports trees (to build from) and one or more jails (to build in). We'll start with the ports tree. Create a tree, but don't populate it; we'll call this ports tree freebsd-ports-kde.

   # poudriere ports -c -F -m git -p freebsd-ports-kde

Next, clone the ports tree from Area51. This needs to go into the just-created directory for the ports tree, which could be anywhere on your system depending on how poudriere is configured. The default is under `/usr/local/poudriere/ports`. Depending on how you want to access the Github repository, you may need to use a different user or credentials -- this example just does an anonymous clone.

   # cd /usr/local/poudriere/ports
   # git clone https://github.com/freebsd/freebsd-ports-kde

With this setup, you can `git pull` and otherwise update the git repository as you see fit: it is the working directory that will be used for the ports tree (so you can switch branches inside the clone, too).

Setting up the Build Jail

Create a jail to build in; this is essentially a whole new FreeBSD installation inside your existing one. It can also be an older FreeBSD version (newer than the host system is not recommended and may not work at all). This command creates a new 11.0 jail, calling it 110amd64:

   # poudriere jail -c -j 110amd64 -v 11.0-STABLE -m ftp

Running a Build

Poudriere can bulk-build ports, given a jail and a ports tree to work with. It will generally rebuild all that is needed; assuming you are most interested in all the latest KDE software, the metaport `x11/kde5` is the one to rebuild.

   # poudriere bulk -j 110amd64 -p freebsd-ports-kde x11/kde5

Content is available under Creative Commons License SA 4.0 unless otherwise noted.