Project

General

Profile

Installer development process » History » Version 5

Peter Amstutz, 05/28/2021 01:52 PM

1 1 Peter Amstutz
h1. Installer development process
2
3
The Arvados SaltStack based installer has two pieces:
4
5 3 Peter Amstutz
# The provision script in https://git.arvados.org/arvados.git/tree/HEAD:/tools/salt-install
6
# The SaltStack formula at https://git.arvados.org/arvados-formula.git
7 4 Peter Amstutz
8
Additionally, the documentation in https://git.arvados.org/arvados.git/tree/HEAD:/doc/install needs to be kept up to date.
9
10
h2. Branches
11
12
# @master@ - installer for current development packages.
13
# @X.Y-dev@ - installer for X.Y release series (match the arvados branch name for that release series)
14
15
h2. Process
16
17
Issues are created for installer bugs and features.  Development takes place on feature branches in the formula and/or arvados repository, which are reviewed and merged into master and/or relevant X.Y-dev.
18
19 5 Peter Amstutz
h2. Releases
20
21
_In the release branch_, update these three variables in @tools/tools/salt-install/provision.sh@:
22
23
<pre>
24
# For a stable release, change RELEASE "production" and VERSION to the
25
# package version of the release.
26
RELEASE="development"
27
VERSION="latest"
28
29
# The arvados-formula version.  For a stable release, change the tag
30
# or X.Y-dev branch of the release.
31
ARVADOS_TAG="master"
32
33
</pre>
34
35
36 4 Peter Amstutz
h2. Testing
37
38
Merge to arvados-formula master should trigger a jenkins jobs which
39
40
* run formula linting / other checks
41
* kicks off the single node installer with the new formula and current arvados master
42
* runs tests to confirm a good install
43
44
Merge to arvados master should trigger a jenkins jobs which
45
46
* after building packages, kicks off the single node installer with the current formula and new arvados master
47
* runs tests to confirm a good install
48
49
It should also be possible to trigger the formula test directly with a explicitly specified commit hashes for both arvados and the formula.