aboutsummaryrefslogtreecommitdiff
path: root/en/setup/build/dashboard.html
blob: 7dee5beeba877e3f0e2141402d2b2835adf49eee (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
<html devsite>
  <head>
    <title>Continuous Integration Dashboard</title>
    <meta name="project_path" value="/_project.yaml" />
    <meta name="book_path" value="/_book.yaml" />
  </head>
  <body>
  <!--
      Copyright 2018 The Android Open Source Project

      Licensed 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.
  -->

<p>This dashboard provides visibility into the
  <a href="https://en.wikipedia.org/wiki/Continuous_integration" class="external">continuous
    integration</a> system used by the Android Open Source Project (AOSP).</p>

<p>Contributors to AOSP can use this dashboard to monitor when their submissions are integrated
  into the tree. The status color shows whether the integrated change has built successfully
  across all of our build types. For convenience, the build artifacts
  from each build are available for download.</p>

<p>Each row represents a build that is completed on
  Android's automated builders. Each column represents a build target/buildtype combination.
  Within the grid, in-progress and completed builds are shown. In-progress builds are color-coded
  with a yellow background, failed builds with a red background, and successful builds with a green
  background. When a build is completed you can download the build artifacts by clicking the
  <span class="material-icons">get_app</span>(<strong>View artifacts</strong>) icon, which links to
  a page where the artifacts can be downloaded. Selecting a square opens a panel at the bottom of
  the screen with tabs for "Details" where the logs are kept, "Changes" which lists what changes
  went into a build, and another link to the build artifacts. The dashboard refreshes automatically
  as new builds are completed.</p>

<p>The dashboard can be found at <a href="https://ci.android.com"
                                    class="external">ci.android.com</a></p>

<figure><img src="../images/dashboard.png" alt="Image of dashboard"/><figcaption><b>Figure 1</b>:
  Continuous Integration Dashboard</figcaption></figure>

<p>The attributes of the dashboard include:<p>
<ul>
  <li><b>Branch name</b>: Name of the git branch where the builds happen</li>
  <li><b>Build artifacts</b>: Link to see and download artifacts from this build</li>
  <li><b>Build ID</b>: Unique ID for each build</li>
  <li><b>Build target</b>: Device configuration</li>
  <li><b>Buildtype</b>: Exact configuration of the target, which can be user, userdebug, or eng.
    For more details, see <a href="/setup/build/building#choose-a-target">Choose a
    Target</a></li>
  <li><b>Changes link</b>: Link to the changes included in this build</li>
  <li><b>Perm link</b>: Permanent link to this build’s page on
    <a href="https://ci.android.com" class="external">ci.android.com</a></li>

  </body>
</html>