summaryrefslogtreecommitdiff
path: root/README
blob: 713ef3377c99b9d0039a2ea9f4935bb8e9ced5c1 (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
Source code acquisition
=======================

This repository controls the source code acquisition service known as Lorry.

When it was created, there were two stanzas in the controller configuration
file.  One which retrieved open source Baserock into your Trove and one which
allows you to create individual Lorry configurations for other open source
code.

Please refer to the Trove Reference Manual chapters on the source code
acquisition service (Lorry) and the Developing With Baserock document's
scenarios regarding adding external software to your Trove before attempting to
add any additional configuration to this repository.

Remember, the Lorry tool is not permitted to manage repositories inside your
prefix which is baserock.

Validation
----------

Run `scripts/validate-lorries` to check the `.lorry` files.  This will
report:

* Invalid YAML/JSON syntax
* Wrong data types
* Duplicate repository names
* Missing required keys
* Unexpected keys
* Invalid values

The syntax and duplicate name checks are applied even to disabled
`.lorry` files, because reusing a repository name for a different
upstream type generally won't work.

Run `scripts/check-lorry-urls` to check that the upstream repositories
and files referred to by the active `.lorry` files exist.  This will
take several minutes.