You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
DevOps-Bash-tools/teamcity_vcs_roots_download.sh

65 lines
2.1 KiB
Bash

#!/usr/bin/env bash
# vim:ts=4:sts=4:sw=4:et
#
# Author: Hari Sekhon
# Date: 2020-11-30 19:06:40 +0000 (Mon, 30 Nov 2020)
#
# https://github.com/HariSekhon/bash-tools
#
# License: see accompanying Hari Sekhon LICENSE file
#
# If you're using my code you're welcome to connect with me on LinkedIn and optionally send me feedback to help steer this or other code I publish
#
# https://www.linkedin.com/in/HariSekhon
#
# https://www.jetbrains.com/help/teamcity/rest-api-reference.html#vcs_root+Configuration+And+Template+Settings
set -euo pipefail
[ -n "${DEBUG:-}" ] && set -x
srcdir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
# shellcheck disable=SC1090
. "$srcdir/lib/utils.sh"
# shellcheck disable=SC2034,SC2154
usage_description="
Exports all TeamCity VCS roots to local JSON configuration files for backup/restore / migration purposes, or even just to backport changes to Git for revision control tracking
If arguments are specified then only downloads those named VCS roots, otherwise finds and downloads all VCS roots
Uses the adjacent teamcity_api.sh and jq (installed by 'make')
See teamcity_api.sh for required connection settings and authentication
See teamcity_vcs_roots.sh for the list of vcs_roots and their IDs vs Names
"
# used by usage() in lib/utils.sh
# shellcheck disable=SC2034
usage_args="[<vcs_root_id1> <vcs_root_id2> ...]"
help_usage "$@"
#min_args 1 "$@"
if [ $# -gt 0 ]; then
for vcs_root_id in "$@"; do
echo "$vcs_root_id"
done
else
"$srcdir/teamcity_api.sh" /vcs-roots |
jq -r '.["vcs-root"][] | [.id, .name] | @tsv'
fi |
grep -v '^[[:space:]]*$' |
while read -r vcs_root_id vcs_root_name; do
# basing the filename off the ID instead of the Name is because it's more suitable for filenames
# instead of 'github.com/harisekhon/blah (1)', 'MyProject_GithubComHariSekhonBlah1 ' is safer and easier to use in daily practice
filename="$vcs_root_id.json"
vcs_root_name="${vcs_root_name:-$vcs_root_id}"
timestamp "downloading vcs_root '$vcs_root_name' to '$filename'"
"$srcdir/teamcity_api.sh" "/vcs-roots/$vcs_root_id" |
# using jq just for formatting
jq . > "$filename"
done