go.fuchsia.dev/infra@v0.0.0-20240507153436-9b593402251b/artifacts/doc.go (about)

     1  // Copyright 2019 The Fuchsia Authors. All rights reserved.
     2  // Use of this source code is governed by a BSD-style license that can be
     3  // found in the LICENSE file.
     4  
     5  // Package artifacts controls how files generated by Fuchsia's CI tasks are written to and
     6  // read from Cloud Storage.  The directory layout is defined below:
     7  //
     8  // gs://BUCKET/
     9  //
    10  //	builds/
    11  //	    BUILD/
    12  //	        tests/
    13  //	            TEST/
    14  //	                ENVIRONMENT/
    15  //
    16  // BUCKET
    17  //
    18  //	The Cloud Storage bucket used to store CI artifacts. Multiple buckets can exist
    19  //	exist using this scheme.
    20  //
    21  // BUILD
    22  //
    23  //	Contains all artifacts for a build. The directory's name is the unique BuildBucket
    24  //	build ID.
    25  //
    26  // TEST
    27  //
    28  //	Contains all artifacts relevant to a particular test.  The directory's name is the
    29  //	canonical name of the test - which is usually a test "suite".
    30  //
    31  // ENVIRONMENT
    32  //
    33  //	Contains all test artifacts relevant to a particular test environment. The
    34  //	directory's name is the canonical name of the test environment. Tests will often
    35  //	have multiple environment directories, because they often run in multiple
    36  //	environments per build.
    37  package artifacts