PkgForge::App::Platform - Package Forge Registry App for managing platforms
This documentation refers to PkgForge::App::Platform version 1.3.0
pkgforge platform list pkgforge platform add --name f13 --arch i386 pkgforge platform activate --name f13 --arch i386 pkgforge platform setauto --name f13 --arch i386
This is a Package Forge application for managing the registered build platforms. It makes it easy to list, add and manage platforms.
It is not expected that this class will be used directly, it is designed to provide a command for the pkgforge(1) command-line tool.
This class has the following attributes which are mapped into command-line options when used via the pkgforge application.
pkgforge
This is the name of the platform. For example, sl5 or f13.
sl5
f13
This is the name of the architecture for the platform. For example, i386 or x86_64.
i386
x86_64
The class has the following methods which are mapped into sub-commands without the leading action_ for the pkgforge application.
action_
Ths action lists all the registered build platforms. It does not use any of the attributes (or command-line options).
This action adds a new platform. You must specify the values for the name and the architecture attributes. Note that a platform is NOT activated automatically, you must do that in a separate step.
This action activates a platform. You must specify the values for the name and the architecture attributes. Once a platform is activated new tasks will be registered for it whenever a new job is submitted.
This action deactivates a platform. You must specify the values for the name and the architecture attributes. A platform which is not active will not get any new tasks registered. This is particularly useful when a platform is no longer supported but you cannot remove it from the registry as there is lots of associated history from old completed jobs.
This action sets the auto flag on a platform. When this flag is true pkgforge tasks will be automatically registered for a platform whenever the user requests the auto set of platforms. If the auto flag is false then it is still possible to register tasks for a platform, as long as it is marked as active. The user must request the all set or explicitly list the platform when it is not marked as auto.
auto
active
all
The Package Forge Registry configuration file can be specified via the configfile attribute (or command-line option). If not specified then the default, /etc/pkgforge/registry.yml will be used.
configfile
/etc/pkgforge/registry.yml
This module is powered by Moose and uses MooseX::App::Cmd and MooseX::Types.
PkgForge, PkgForge::Registry, pkgforge(1)
This is the list of platforms on which we have tested this software. We expect this software to work on any Unix-like platform which is supported by Perl.
ScientificLinux5, Fedora13
Please report any bugs or problems (or praise!) to bugs@lcfg.org, feedback and patches are also always very welcome.
Stephen Quinney <squinney@inf.ed.ac.uk>
Copyright (C) 2010-2011 University of Edinburgh. All rights reserved.
This library is free software; you can redistribute it and/or modify it under the terms of the GPL, version 2 or later.
To install PkgForge::Registry, copy and paste the appropriate command in to your terminal.
cpanm
cpanm PkgForge::Registry
CPAN shell
perl -MCPAN -e shell install PkgForge::Registry
For more information on module installation, please visit the detailed CPAN module installation guide.