starlingx/tools

History

Scott Little 6f3d1e5dd2 cengn reference removal - centos mirror.starlingx.cengn.ca no longer exists. CENGN is kindly forwarding requests to the new location mirror.starlingx.windriver.com for now, but that will only last a few months. We need to replace all the references with the new URL. I will also remove as many 'cengn' references as possible, replacing them with 'stx_mirror' Partial-Bug: 2033555 Signed-off-by: Scott Little <scott.little@windriver.com> Change-Id: I09e3f564edef2049786c965a86dbcaacac359801		2023-11-07 11:23:12 -05:00
..
branch-repo.sh	branch-repo: Give tag a better description	2020-08-05 07:52:36 -07:00
branch-stx.sh	Detect opendev.org repos and skip staging repos	2019-08-02 11:31:29 -05:00
build-context.py	cengn reference removal - centos	2023-11-07 11:23:12 -05:00
getrepo.sh	Add release tools	2018-07-19 17:51:24 -05:00
README.rst	cengn reference removal - debian	2023-11-06 19:51:14 +00:00

README.rst

Release Tools

A set of tools used in the StarlingX release process past, current and future...

branch-repo.sh - Derived from the older branch-stx.sh to support reading a list of repos, paths and SHAs from stdin, usually the output of build-context.py. This simplifies the creation of branching based on a specific build using the CONTEXT.sh file generated by the build system.

build-context.py - Takes a manifest file and an optional CONTEXT.sh file to produce a list of repositories and their paths and SHAs that represent a specific build. This can be fed directly into branch-repo.sh to create branches corresponding to that specific build. (This is in Python completely due to combining XML and the joys of dict-like manipulation in shell.)

Examples

Here is an example of creating a new branch named 'r/stx.2.0' and tag 'v2.0.0.rc0' from the lastest green build context at the time:

release/build-context.py \
    --remote starlingx \
    --context https://mirror.starlingx.windriver.com/mirror/starlingx/master/centos/latest_green_build/outputs/CONTEXT.sh \
    https://opendev.org/starlingx/manifest/raw/branch/master/default.xml | \
release/branch-repo.sh -b r/stx.2.0 -t v2.0.0.rc0

Older Scripts

branch-stx.sh - Shell script previously used to create release and milestone branches. This has a number of assumptions baked in regarding branch and tag names.

get-repo.sh - Called from branch-stx.sh to read the XML manifest and extract repo names from specific remotes. This has totally been absorbed into build-context.py.