Index: /devel/website/about.shtml =================================================================== --- /devel/website/about.shtml (revision 1025) +++ /devel/website/about.shtml (revision 1025) @@ -0,0 +1,109 @@ + + + + About Project-Builder.org + + + + + + +

About Project-Builder.org

What is Project-Builder.org ?

+Project-Builder.org aka pb helps building continuously multiple OS packages from sources. +

+With the increasing role of FLOSS in enterprise, some development techniques linked to it also know a momentum. Continuous integration (shared sources repository, automatic build, automatic test) is such an example. The new process called continuous packaging should still be promoted and developed as best practice for industry. +

+Project-Builder.org is a new GPL v2 tool designed to help projects developers producing easily packages for multiple OS and architectures, on a regular basis, from a single source repository. 90% of users and admins prefer to install packages rather than tar files or content from a [D]VCS. But packages don't necessarily follow the development stream of projects, to package alpha, beta. Giving the possibility for projects to distribute seamlessly packages for whatever step of their development is clearly a gain for the whole community. +

+The various aspects covered by the tool are: +

- only produce software packages (ease integration in deployment servers, provide inheritance mecanisms, and Virtual Machines (VM) or Environments (VE))
- ease the various steps of solution life cycle (controlled impact of installation/uninstallation, dependencies management, identical deliveries up to the customer, announce management, web site delivery, metadata management)
- help new projects in the provisioning of packages (templates and skeletons for the various supported OS, generated structure, help in VM/VE build)
- Avoid code or metadata duplication, as well as has no impact on the original project (macro system, separate repository)
- Neutral in term of Unix environment (repository, system, package type agnostic)

+These features help reducing the development cost by providing a process, method and tools to realize continuous packaging during the whole project life cycle. +Today the tool supports: +

- Muliple repository (none - aka tar balls, SVN, CVS, Git, Mercurial, SVK...)
- Multiple systems ((RPM Linux - Red Hat, SuSE, Mandriva, ..., deb Linux - Debian, Ubuntu, ..., ebuild -
Gentoo, pkg Solaris/OpenSolaris, ...)
- Multiple build environments (local, VM - QEMU, KVM, ..., VE - mock, rinse, pbuilder, ...)
- Multiple repository manager (yum, urpmi, apt, ...)

+and this at various phasis (development, test, integration, delivery) +

+It aims at becoming a tools for the vcs-pkg.org initiative. +It's today used for projects as diverse as FOSSology, MondoRescue, LinuxCOE, GOsaÂ², itself, ... + + +

Project-Builder.org References

+ TBD +

We also have freshmeat, entries.

+ +

Who is behind Project-Builder.org ?

Who is in the Project-Builder.org?

+ Bruno Cornec
+ lead development, maintenance, documentation, web site, rpm packaging, Mandriva packaging

+ Bryan Gartner
+ Ideas contributor, bug reporter

Who has been behind Project-Builder.org ?

Who has been in the Project-Builder.org?

Nobody ahas the project is too young for that ;-)

Artwork of this site

"I think I've already seen your look and feel somewhere" + +

Graphics made by Alexis Younes (Ayo73) and Amaury Amblard-Ladurantie

These 2 incredible guys have accepted to let us reuse the design they made for the not less incredible game Frozen Bubble. Many thanks guys ! Just hope Mondo Rescue will help you some days as much as I played to frozen bubble myself :-)

Don't miss Ayo's site at 73lab.com as it provides all his artworks, some of them reusable.

The Project-Builder.org Community

+ There are too few people involved at the moment. But that shouldn't refrain you from participating ! +

Contributors

These people helped technically the development of Project-Builder.org:

+ +

The Project-Builder.org Coopetitors

+ Project-Builder.org was first created because there was nothing like + it available at that time under a free license. Under the vcs-pkg.org initiative, you may find other projects whose goals are aligned with those of Project-Builder.org. + Especially you should look at the OpenSUSE Build Service. +

+ Comments? Suggestions? Click here + + + + Index: /devel/website/downloads.shtml =================================================================== --- /devel/website/downloads.shtml (revision 1025) +++ /devel/website/downloads.shtml (revision 1025) @@ -0,0 +1,104 @@ + + + + + + + + +

Download Project-Builder.org

This is Free Software

+This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 2, as published by the Free Software Foundation.
+This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

+ +

Mirrors

We are interested in up to date mirrors for both the Web and FTP sites. Please contact us on the mailing list. +

Europe: +
- France:
+

+ +

Dependencies

The solution has been written in perl and developed on a Mandriva Gnu/Linux distribution. For it to work, you will need some perl modules and tools:

perl-Mail-Sendmail
KVM/QEMU: the tool to create and use Virtual Machines
debootstrap: the tool to create and use Virtual Environment for deb based distros
rpmbootstrap: Tool to build Virtual Environments (chroot) for rpm based distros, part of the project
pb: the package build tool itself

+ +

For Mandriva/Mandrake distributions, just use the magic:
+urpmi project-builder

+to use the native packages of your distribution, or download the repo file pb.addmedia script and launch it if you want to use upstream packages. +

For Fedora distributions, after downloading the repo file pb.repo and adding it to the /etc/yum.repos.d directory, just use the magic:
+yum install project-builder

+For Debian/Ubuntu, just use the magic:
+apt-get install project-builder

+to use the native packages of your distribution, or download the repo file pb.sources.list and add it to your /etc/apt/sources.list.d directory if you want to use upstream packages. +

+For the other RPM based distributions, you will have to issue a
+rpm -ivh *.rpm
+in the directory containing all the required packages, and solve dependancies manually. +

+ +

Downloads

Project-Builder.orgs FTP site is available at ftp://ftp.project-builder.org

+ +

Source code

tarballs are available under ftp://ftp.project-builder.org/src
Subversion browing available at http://trac.project-builder.org/browser/
Anonymous SVN Subversion check out of the project available with the following instruction set:
```
svn checkout svn://svn.project-builder.org/project-builder/devel
```

+ +

Packages

+ +

All the Project-Builder.org are built thanks to the Project-Builder.org tool. What else ;-)

Most of the time, you'll be able to download directly the packages suited for your distribution. Currently we provide packages for : +

RedHat 7.3, 9.
Fedora Core 4, Core 5, Core 6, 7, 8, 9, 10, 11, 12.
RedHat Enterprise Linux 2.1, 3, 4, 5.
Mandriva 10.1, 10.2, 2006.0, 2007.0, 2007.1., 2008.0, 2008.1, 2009.0, 2009.1, 2010.0
OpenSuSE 10.0, 10.1, 10.2, 10.3, 11.0, 11.1, 11.2. Look also at this web page for SuSE details. Packman may have some useful additional packages. +
SuSE Linux Enterprise Server 9, 10.
Asianux 2, 3.
Debian 3.1, 4.0, 5.0. Look also at this web page for Debian details.
Ubuntu 6.04, 7.04, 7.10, 8.04, 8.10, 9.04, 9.10.
Gentoo nover. +
Slackware 10.2, 11.0. +

+ +

Test packages are also on the ftp site for people wanting to test latest versions and report their success/failures.

+ + + + Index: /devel/website/support.shtml =================================================================== --- /devel/website/support.shtml (revision 1025) +++ /devel/website/support.shtml (revision 1025) @@ -0,0 +1,44 @@ + + + + + + + + +

Support around Project-Builder.org

+ +

Help yourself

First, when you have an issue, please try to read the log file/trace that Project-Builder.org produces. 99% of the time, the error is described in it in clear text. To make the error more clear, and debug easier, fill free to increase verbosity by adding at least 2 "-v" options. +

Second look at the Project-Builder.org documentation, as a lot of good tip and tricks are provided there as well as in the Wiki's FAQ and Documentation.

Third look at the Project-Builder.org wiki which may contain additional comments,and feel free to contribute by adding your remarks.

Fourth look at the Project-Builder.org Mailing List Archives (or this Gmane or Nabble mirror) as you're probably not the first with this problem. Or look at existing bug reports.

Fifth, if you're willing to help debugging the future Project-Builder.org versions, try the latest beta available under the test directory of our ftp server.

Finally post on the Project-Builder.org Mailing List if you did not find what you were looking for, as there are other users there who could help you, including dev team members.

If your think you found a bug in Project-Builder.org, please fill a bug report and also include the log files.

Likely, if you wish Project-Builder.org had your dreamed new shiny function, feel free to create a feature request.

Project-Builder.org Mailing Lists

There are 2 mailing lists for the Project-Builder.org Community:

The Project-Builder.org Announce Mailing List with low traffic dedicated to annoucements around Project-Builder.org.
The Project-Builder.org Mailing List with most of the traffic dedicated to discussions around Project-Builder.org.

+ + + + + Index: /devel/website/top.shtml =================================================================== --- /devel/website/top.shtml (revision 942) +++ /devel/website/top.shtml (revision 1025) @@ -24,11 +24,8 @@

id="current" > Home

- id="current" > About - -->

id="current" > News

- id="current" > Docs @@ -37,5 +34,4 @@

id="current" > Support

- -->

Wiki

Index: /devel/website/docs.shtml =================================================================== --- /devel/website/docs.shtml (revision 1025) +++ /devel/website/docs.shtml (revision 1025) @@ -0,0 +1,48 @@ + + + + + + + + + + +

Project-Builder.org Documentations

Project-Builder.org HOWTO

The Project-Builder.org HOWTO is to be created

+ +

Project-Builder.org man pages

The Project-Builder.org man pages are available under various formats:

A HTML
A PDF
A PostScript
A Text

rpmbootstrap

A HTML
A PDF
A PostScript
A Text

+ +