 ------
 Force Project Build
 ------
 ------
 2010-02-18
 ------

~~ Licensed to the Apache Software Foundation (ASF) under one
~~ or more contributor license agreements.  See the NOTICE file
~~ distributed with this work for additional information
~~ regarding copyright ownership.  The ASF licenses this file
~~ to you under the Apache License, Version 2.0 (the
~~ "License"); you may not use this file except in compliance
~~ with the License.  You may obtain a copy of the License at
~~
~~   http://www.apache.org/licenses/LICENSE-2.0
~~
~~ Unless required by applicable law or agreed to in writing,
~~ software distributed under the License is distributed on an
~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
~~ KIND, either express or implied.  See the License for the
~~ specific language governing permissions and limitations
~~ under the License.

Force Project Build

    Occasionally you may want to force a build outside of the regular schedule.
    When builds are triggered manually, the following happens:

    * Projects are updated from the SCM.
      These are queued under the <<Prepare Build Queues>> section in <<Queues>> page.

    * Builds of the projects are executed.
      These are queued under the <<Build Queues>> in <<Queues>> page.

    []

    To manually build a project perform the following steps:

    [[1]] Click <<Show Project Groups>>.

    [[2]] Click the project group link of the project you want to build.
    This will put you on the <<Summary>> page of the project group.

    [[3]] You can click <<Build all projects>> button under <<Group Actions>> to build all
    the projects in the project group.

[../../images/force_build.png] Project Group Actions

    [[4]] To build an individual project, you can click on the build icon that is found
    along the row of the project you want to build. It is the first icon on the right of
    the project name. This will execute the default build goal you have defined for that project.

    To build selected projects, check the box beside the name of the project,
    then click the <<Build Project(s)>> button.

    If you want to build the project according to a specific build goal other than the
    default build goal, click on the project name to go to the <<Project's Information>> page.
    All build goal definitions for the project are listed under the <<Build Definitions>> section.
    Click on the build icon to the right of the specific build goal you want to execute.

    []
    
    *Note* In a distributed build setup, the project builds are not executed if no build agent is
    configured or if a build agent group with no build agent, is configured in the build environment 
    that is attached to the project's build definition.

    To view the results of the build, refer to {{{./build_results.html}Build Results Management}}.