summaryrefslogtreecommitdiff
path: root/chromium/fuchsia/cipd/README.md
blob: 63f1d3f020aed5133387743bf669dcbd1313bd0b (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
# CIPD recipes

The `//fuchsia/cipd` target generates a number of YAML files which are used to
produce archives that are uploaded to CIPD. The generated YAML files are stored
under the output directory, under the path `gen/fuchsia/cipd/`.

## Arguments

The YAML recipes require certain parameters to be passed in, using the CIPD
"pkg-var" system.

`targetarch` - The ID of the target architecture (amd64, arm64) must be passed
in as a pkg-var so that the packages can be archived at the appropriate location
in the CIPD package hierarchy.

`outdir` - The fully qualified path to the build output directory.

## Example usage

To create a CIPD package, run the following command from the build output
directory. In this example, "http.yaml" is being built for arm64:

```
$ cipd create --pkg-def gen/fuchsia/cipd/http/http.yaml
              -pkg-var targetarch:arm64
              -pkg-var outdir:`pwd`
              -ref latest
              -tag version:$(cat gen/fuchsia/cipd/build_id.txt)
```

The most recent package can be discovered by searching for the "latest" ref:

`$ cipd describe chromium/fuchsia/$PACKAGE_NAME-$TARGET_ARCH -version latest`