github.com/xushiwei/go@v0.0.0-20130601165731-2b9d83f45bc9/misc/dashboard/builder/doc.go (about)

     1  // Copyright 2010 The Go Authors. All rights reserved.
     2  // Use of this source code is governed by a BSD-style
     3  // license that can be found in the LICENSE file.
     4  
     5  /*
     6  
     7  Go Builder is a continuous build client for the Go project.
     8  It integrates with the Go Dashboard AppEngine application.
     9  
    10  Go Builder is intended to run continuously as a background process.
    11  
    12  It periodically pulls updates from the Go Mercurial repository.
    13  
    14  When a newer revision is found, Go Builder creates a clone of the repository,
    15  runs all.bash, and reports build success or failure to the Go Dashboard.
    16  
    17  For a release revision (a change description that matches "release.YYYY-MM-DD"),
    18  Go Builder will create a tar.gz archive of the GOROOT and deliver it to the
    19  Go Google Code project's downloads section.
    20  
    21  Usage:
    22  
    23    gobuilder goos-goarch...
    24  
    25    Several goos-goarch combinations can be provided, and the builder will
    26    build them in serial.
    27  
    28  Optional flags:
    29  
    30    -dashboard="godashboard.appspot.com": Go Dashboard Host
    31      The location of the Go Dashboard application to which Go Builder will
    32      report its results.
    33  
    34    -release: Build and deliver binary release archive
    35  
    36    -rev=N: Build revision N and exit
    37  
    38    -cmd="./all.bash": Build command (specify absolute or relative to go/src)
    39  
    40    -v: Verbose logging
    41  
    42    -external: External package builder mode (will not report Go build
    43       state to dashboard or issue releases)
    44  
    45  The key file should be located at $HOME/.gobuildkey or, for a builder-specific
    46  key, $HOME/.gobuildkey-$BUILDER (eg, $HOME/.gobuildkey-linux-amd64).
    47  
    48  The build key file is a text file of the format:
    49  
    50    godashboard-key
    51    googlecode-username
    52    googlecode-password
    53  
    54  If the Google Code credentials are not provided the archival step
    55  will be skipped.
    56  
    57  */
    58  package main