Changes between Version 3 and Version 4 of Build Configurations

Timestamp:

Sep 12, 2005, 3:27:10 PM (19 years ago)

Author:

cmlenz

Comment:

More details on setting up target platforms

Build Configurations

@@ -4 +4 @@
 
 A build configuration is composed of:
+ * a name used as identifier, a “pretty” name for display, as well as a description that may contain [wiki:WikiFormatting wiki formatting],
+ * a flag to temporarily or permanently deactivate builds of that tree,
  * a path (or branch name) that identifies the subset of the repository that should be built,
- * a flag to temporarily or permanently deactivate builds of that tree,
- * a “pretty” name for display, as well as a description that may contain [wiki:WikiFormatting wiki formatting], and
+ * a [wiki:BuildRecipes build recipe] for the configuration, and
  * a list of ''target platforms'' (see next section).
 
 == Target platforms ==
 
-A target platform is something like ''“NetBSD on x86”'' or ''“Win32 with Java 1.4”''. Technically, a target platform is a named set of rules against which the properties of build slaves are matched. Each rule is a regular expression matching a particular slave property, such as the operating system or the processor.
+A target platform is something like ''“NetBSD on x86”'' or ''“Win32 with Java 1.4”''.
+
+Technically, a target platform is a named set of rules against which the properties of build slaves are matched. Each rule is a regular expression matching a particular slave property, such as the operating system or the processor. When a slave connects to the build master, it sends a registration message that includes information about the slave.
+
+By default, the following properties are included:
+
+ `family`:: The basic type of operating system, typically “posix” for Unix-like systems and “nt” for Win32 systems.
+ `os`:: The name of the operating system (for example “Darwin”, “Linux” or “Windows”).
+ `version`:: The operating system version.
+ `machine`:: The hardware platform (for example “i686” or “Power Macintosh”).
+ `processor`:: The processor architecture (for example “athlon” or “powerpc”).
+
+Note that not all of these properties may be available for all platforms. For example, the `machine` and `processor` properties are currently empty for build slaves running on Windows. Additional properties can be set up on the slave side using a [wiki:SlaveConfiguration configuration file].
+
+So to set up a target platform, you create rules that are checked against the properties of the slave. For example, a target platform that matches slave running Linux on x86 would look like this:
+
+|| '''Property''' || '''Expression''' ||
+|| `os` || `^Linux` ||
+|| `processor` || `^[xi]\d86$` ||
+
+A target platform that matches any slaves running on Windows might look like this:
+
+|| '''Property''' || '''Expression''' ||
+|| `family` || `^nt$` ||
 
 The build master will request a build from at most one slave for every target platform. So, for example, if there are three slaves connected that are running NetBSD on x86, only one of them will perform the build of a specific revision. Slaves that match a particular target platform are treated as if they were completely interchangable.