blob: 71aeda5a929ce55449d6a194064a969c3bf892e5 [file] [log] [blame]
<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>The
<a href="https://en.wikipedia.org/wiki/Continuous_integration" class="external">continuous
integration</a> dashboard (<a href="https://ci.android.com/" class="external">ci.android.com</a>)
provides visibility into the 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>