The Perl Advent Calendar needs more articles for 2022. Submit your idea today!

NAME

PkgForge::App::Platform - Package Forge Registry App for managing platforms

VERSION

This documentation refers to PkgForge::App::Platform version 1.3.0

SYNOPSIS

    pkgforge platform list

    pkgforge platform add --name f13 --arch i386

    pkgforge platform activate --name f13 --arch i386

    pkgforge platform setauto --name f13 --arch i386

DESCRIPTION

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.

ATTRIBUTES

This class has the following attributes which are mapped into command-line options when used via the pkgforge application.

name

This is the name of the platform. For example, sl5 or f13.

architecture

This is the name of the architecture for the platform. For example, i386 or x86_64.

SUBROUTINES/METHODS

The class has the following methods which are mapped into sub-commands without the leading action_ for the pkgforge application.

action_list

Ths action lists all the registered build platforms. It does not use any of the attributes (or command-line options).

action_add

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.

action_activate

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.

action_deactivate

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.

setauto

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.

CONFIGURATION AND ENVIRONMENT

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.

DEPENDENCIES

This module is powered by Moose and uses MooseX::App::Cmd and MooseX::Types.

SEE ALSO

PkgForge, PkgForge::Registry, pkgforge(1)

PLATFORMS

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

BUGS AND LIMITATIONS

Please report any bugs or problems (or praise!) to bugs@lcfg.org, feedback and patches are also always very welcome.

AUTHOR

    Stephen Quinney <squinney@inf.ed.ac.uk>

LICENSE AND COPYRIGHT

    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.