Creating and Managing Projects

{"header":{"message":"doc: Import the \"Creating Projects\" chapter by Visser & Dolstra.","description":null,"timestamp":"2011-03-16T22:50:09Z","authors":[{"email":"ludo@gnu.org","name":"Ludovic Courtès"}]},"hash":"PKE6I67S7TDGKEFCKIQZOZ5PSDZXCSPOQGSKDAE5NST3NOOLRUXAC","authors":[],"deps":{"hashes":[["PKE6I67S7TDGKEFCKIQZOZ5PSDZXCSPOQGSKDAE5NST3NOOLRUXAC","doc: Import the \"Creating Projects\" chapter by Visser & Dolstra."],["AA",null],["5AKAE3R6RZMDWN2UMNYCB73Z2FEE5WJUCEY4YAAOHGAKHVJQPO7QC","start of hydra manual"],["FV2M6MOTAP4BJMEKU5XUDVEACWEJGEIRCCE2MRY3F6SF2SFOE3MQC","hydra: use autoconf/-make"],["CPQQFQMZ3W7ISBF6L6WP2BWQYUZ6HQQI2VANQNRRBWT6JRIKR3KAC","doc: Reintegrate the intro by Visser & Dolstra from `manual.html'."],["6A6CZ7SC2VGEGRC5LSNTDDM3LFWVYO6Z6QNDF74SBJWO5P6T3ARQC","draft manual"]],"deps":["5AKAE3R6RZMDWN2UMNYCB73Z2FEE5WJUCEY4YAAOHGAKHVJQPO7QC","FV2M6MOTAP4BJMEKU5XUDVEACWEJGEIRCCE2MRY3F6SF2SFOE3MQC"],"known":["CPQQFQMZ3W7ISBF6L6WP2BWQYUZ6HQQI2VANQNRRBWT6JRIKR3KAC"]},"hunks":[{"Replacement":{"inode":{"change":3,"pos":16946},"path":"doc/manual/Makefile.am","line":1,"ins":{"up_context":[{"change":3,"pos":16946}],"down_context":[{"change":3,"pos":17008}],"flag":"BLOCK","start":0,"end":74,"inode":{"change":3,"pos":16946}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":3,"pos":16946},"to":{"change":3,"start":16947,"end":17008},"introduced_by":3}],"inode":{"change":3,"pos":16946}},"ins_contents":[{"Add":"DOCBOOK_FILES = installation.xml introduction.xml manual.xml projects.xml"}],"del_contents":[{"Del":"DOCBOOK_FILES = installation.xml introduction.xml manual.xml\n"}]}},{"Edit":{"inode":{"change":3,"pos":16946},"path":"doc/manual/Makefile.am","line":21,"atom":{"EdgeMap":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":3,"pos":17479},"to":{"change":3,"start":17479,"end":17482},"introduced_by":3}],"inode":{"change":3,"pos":16946}}},"contents":[{"Del":"\n\n\n"}]}},{"Replacement":{"inode":{"change":2,"pos":1},"path":"doc/manual/manual.xml","line":59,"ins":{"up_context":[{"change":2,"pos":1160}],"down_context":[{"change":2,"pos":1161}],"flag":"BLOCK","start":75,"end":112,"inode":{"change":2,"pos":1}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":2,"pos":1160},"to":{"change":2,"start":1160,"end":1161},"introduced_by":2}],"inode":{"change":2,"pos":1}},"ins_contents":[{"Add":" "}],"del_contents":[{"Del":"\n"}]}},{"FileAdd":{"meta":{"basename":"projects.xml","metadata":0},"context":[{"change":6,"pos":18}],"contents":[{"Add":""},{"Add":""},{"Add":" Creating and Managing Projects"},{"Add":""},{"Add":" "},{"Add":" Once Hydra is installed and running, the next step is to add"},{"Add":" projects to the build farm. We follow the example of the Patchelf"},{"Add":" project, a software tool written in C and using the GNU"},{"Add":" Build System (GNU Autoconf and GNU Automake)."},{"Add":" "},{"Add":""},{"Add":" "},{"Add":" Log in to the web interface of your Hydra installation using the"},{"Add":" user name and password you inserted in the database (by default,"},{"Add":" Hydra's web server listens on localhost:3000)."},{"Add":" Then follow the \"Create Project\" link to create a new project."},{"Add":" "},{"Add":""},{"Add":"

"},{"Add":" Project Information"},{"Add":""},{"Add":" "},{"Add":" A project definition consists of some general information and a"},{"Add":" set of job sets. The general information identifies a project,"},{"Add":" its owner, and current state of activity."},{"Add":""},{"Add":" Here's what we fill in for the patchelf project:"},{"Add":""},{"Add":" "},{"Add":" Identifier: patchelf"},{"Add":" "},{"Add":""},{"Add":" The identifier is the identity of the"},{"Add":" project. It is used in URLs and in the names of build results."},{"Add":" "},{"Add":""},{"Add":" "},{"Add":" The identifier should be a unique name (it is the primary"},{"Add":" database key for the project table in the database). If you try"},{"Add":" to create a project with an already existing identifier you'd"},{"Add":" get an error message such as:"},{"Add":""},{"Add":""},{"Add":"I'm very sorry, but an error occurred: "},{"Add":"DBIx::Class::ResultSet::create(): DBI Exception: DBD::SQLite::st execute failed: column name is not unique(19) at dbdimp.c line 402"},{"Add":""},{"Add":""},{"Add":" So try to create the project after entering just the general"},{"Add":" information to figure out if you have chosen a unique name."},{"Add":" Job sets can be added once the project has been created."},{"Add":""},{"Add":""},{"Add":" Display name: Patchelf"},{"Add":""},{"Add":""},{"Add":" The display name is used in menus."},{"Add":""},{"Add":""},{"Add":" Description: A tool for modifying ELF binaries"},{"Add":""},{"Add":""},{"Add":" The description is used as short"},{"Add":" documentation of the nature of the project."},{"Add":""},{"Add":""},{"Add":" Owner: eelco"},{"Add":""},{"Add":""},{"Add":" The owner of a project can create and edit"},{"Add":" job sets."},{"Add":""},{"Add":""},{"Add":" Enabled: Yes"},{"Add":""},{"Add":""},{"Add":" Only if the project is enabled are builds"},{"Add":" performed."},{"Add":" "},{"Add":""},{"Add":" "},{"Add":" Once created there should be an entry for the project in the"},{"Add":" sidebar. Go to the project page for the Patchelf"},{"Add":" project."},{"Add":" "},{"Add":"

"},{"Add":""},{"Add":"

"},{"Add":" Job Sets"},{"Add":""},{"Add":" "},{"Add":" A project can consist of multiple job sets"},{"Add":" (hereafter jobsets), separate tasks that"},{"Add":" can be built separately, but may depend on each other (without"},{"Add":" cyclic dependencies, of course). Go to the Edit"},{"Add":" page of the Patchelf project and \"Add a new jobset\" by providing"},{"Add":" the following \"Information\":"},{"Add":""},{"Add":""},{"Add":" Identifier: trunk"},{"Add":" Description: Trunk"},{"Add":" Nix expression: release.nix in input patchelfSrc"},{"Add":""},{"Add":""},{"Add":" This states that in order to build the trunk"},{"Add":" jobset, the Nix expression in the file"},{"Add":" release.nix, which can be obtained from"},{"Add":" input patchelfSrc, should be"},{"Add":" evaluated. (We'll have a look at"},{"Add":" release.nix later.)"},{"Add":""},{"Add":" "},{"Add":""},{"Add":" "},{"Add":" To realize a job we probably need a number of inputs, which can"},{"Add":" be declared in the table below. As many inputs as required can"},{"Add":" be added. For patchelf we declare the following inputs."},{"Add":""},{"Add":""},{"Add":" patchelfSrc "},{"Add":" 'Subversion checkout' https://svn.nixos.org/repos/nix/patchelf/trunk"},{"Add":""},{"Add":" nixpkgs 'Subversion checkout' https://svn.nixos.org/repos/nix/nixpkgs/trunk"},{"Add":""},{"Add":" officialRelease Boolean false"},{"Add":""},{"Add":" system String value \"i686-linux\" "},{"Add":""},{"Add":" "},{"Add":"

"},{"Add":""},{"Add":"

"},{"Add":" Release Set"},{"Add":""},{"Add":" "},{"Add":" there must be one primary job"},{"Add":""},{"Add":" check the radio button of exactly one job"},{"Add":""},{"Add":" https://svn.nixos.org/repos/nix/nixpkgs/trunk"},{"Add":"

"},{"Add":""},{"Add":"

"},{"Add":" Building Jobs"},{"Add":"

"},{"Add":""},{"Add":"

"},{"Add":" <filename>release.nix</filename>"},{"Add":""},{"Add":"- Voorbeelden van Nix expressies voor Hydra:"},{"Add":""},{"Add":""},{"Add":""},{"Add":"https://svn.nixos.org/repos/nix/patchelf/trunk/release.nix"},{"Add":"https://svn.nixos.org/repos/nix/nix/trunk/release.nix"},{"Add":"https://svn.nixos.org/repos/nix/hydra/trunk/release.nix"},{"Add":"

"},{"Add":""},{"Add":"

"},{"Add":" Building on the Command Line"},{"Add":""},{"Add":"Overigens zijn die helemaal niet Hydra-specifiek, je kunt ze gewoon vanaf de"},{"Add":"command line bouwen, bijv. als je een patchelf checkout hebt (met een nixpkgs"},{"Add":"checkout in ../nixpkgs):"},{"Add":""},{"Add":""},{"Add":"$ nix-build release.nix -A rpm_fedora10i386"},{"Add":""},{"Add":""},{"Add":"

"},{"Add":""}]}}],"owner":"grahamc","repo":"hydra2","token":"gioHNzObxObJagpx7+43cV11CyObANueTE9MM9Uo/AY=","login":null}

…

Dependencies

Change contents