blob: 5de6d030808f0466d203a390e58d910d0d0fd764 [file] [log] [blame]
Zack Williams27cd3e52018-09-18 16:44:50 -07001#!/usr/bin/env bash
Joey Armstrong28eddda2023-01-10 03:09:34 -05002# -----------------------------------------------------------------------
3# Copyright 2018-2023 Open Networking Foundation (ONF) and the ONF Contributors
Zack Williams27cd3e52018-09-18 16:44:50 -07004#
5# Licensed under the Apache License, Version 2.0 (the "License");
6# you may not use this file except in compliance with the License.
7# You may obtain a copy of the License at
8#
9# http://www.apache.org/licenses/LICENSE-2.0
10#
11# Unless required by applicable law or agreed to in writing, software
12# distributed under the License is distributed on an "AS IS" BASIS,
13# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14# See the License for the specific language governing permissions and
15# limitations under the License.
Joey Armstrong28eddda2023-01-10 03:09:34 -050016#
Zack Williams27cd3e52018-09-18 16:44:50 -070017# github-release.sh
18# builds (with make) and uploads release artifacts (binaries, etc.) to github
19# given a tag also create checksums files and release notes from the commit
20# message
Joey Armstrong28eddda2023-01-10 03:09:34 -050021# -----------------------------------------------------------------------
Zack Williams27cd3e52018-09-18 16:44:50 -070022
Joey Armstrong2097d3e2023-03-26 10:32:03 -040023set -euo pipefail
24
25##-------------------##
26##---] GLOBALS [---##
27##-------------------##
28declare -g WORKSPACE
29declare -g GERRIT_PROJECT
Joey Armstrong78cecc52023-04-03 11:39:11 -040030declare -g __githost=github.com
Joey Armstrong43c48422023-04-03 10:17:32 -040031# export DEBUG=1
Joey Armstrong2097d3e2023-03-26 10:32:03 -040032
33## -----------------------------------------------------------------------
34## Uncomment to activate
35## -----------------------------------------------------------------------
Joey Armstrong43c48422023-04-03 10:17:32 -040036# declare -i -g gen_version=1
Joey Armstrong78cecc52023-04-03 11:39:11 -040037# declare -i -g draft_release=1
Joey Armstrong43c48422023-04-03 10:17:32 -040038
Joey Armstrong41923cc2023-01-30 14:38:16 -050039# declare -g TRACE=0 # uncomment to set -x
40
41# shellcheck disable=SC2015
42[[ -v TRACE ]] && { set -x; } || { set +x; } # SC2015 (shellcheck -x)
43
Joey Armstrong2097d3e2023-03-26 10:32:03 -040044declare -a -g ARGV=() # Capture args to minimize globals and arg passing
45[[ $# -gt 0 ]] && ARGV=("$@")
Joey Armstrongd99e3d22023-01-29 12:35:43 -050046
47declare -g scratch # temp workspace for downloads
Joey Armstrongd99e3d22023-01-29 12:35:43 -050048
Joey Armstrong78cecc52023-04-03 11:39:11 -040049declare -g SCRIPT_VERSION='1.3' # git changeset needed
Joey Armstrong26707f02023-01-26 12:41:12 -050050
Joey Armstrong7f382ef2023-01-25 12:00:08 -050051##--------------------##
52##---] INCLUDES [---##
Joey Armstrong1962bcf2023-01-27 13:53:18 -050053##--------------------#
Joey Armstrong2097d3e2023-03-26 10:32:03 -040054
55## -----------------------------------------------------------------------
56## Intent: Register an interrupt handler to display a stack trace on error
57## -----------------------------------------------------------------------
58function errexit()
59{
60 local err=$?
61 set +o xtrace
62 local code="${1:-1}"
63
64 local prefix="${BASH_SOURCE[1]}:${BASH_LINENO[0]}"
65 echo -e "\nOFFENDER: ${prefix}"
66 if [ $# -gt 0 ] && [ "$1" == '--stacktrace-quiet' ]; then
67 code=1
68 else
69 echo "ERROR: '${BASH_COMMAND}' exited with status $err"
70 fi
71
72 # Print out the stack trace described by $function_stack
73 if [ ${#FUNCNAME[@]} -gt 2 ]
74 then
Joey Armstrong43c48422023-04-03 10:17:32 -040075 echo "Call tree:"
76 for ((i=1;i<${#FUNCNAME[@]}-1;i++))
77 do
78 echo " $i: ${BASH_SOURCE[$i+1]}:${BASH_LINENO[$i]} ${FUNCNAME[$i]}(...)"
79 done
Joey Armstrong2097d3e2023-03-26 10:32:03 -040080 fi
81
82 echo "Exiting with status ${code}"
83 echo
84 exit "${code}"
85 # return
86}
87
88# trap ERR to provide an error handler whenever a command exits nonzero
89# this is a more verbose version of set -o errexit
90trap errexit ERR
91
92# setting errtrace allows our ERR trap handler to be propagated to functions,
93# expansions and subshells
94set -o errtrace
Joey Armstrong7f382ef2023-01-25 12:00:08 -050095
96## -----------------------------------------------------------------------
Joey Armstrongd99e3d22023-01-29 12:35:43 -050097## Intent: Cleanup scratch area on exit
98## -----------------------------------------------------------------------
99function sigtrap()
100{
101 ## Prevent mishaps
102 local is_read_only
103 is_read_only="$(declare -p scratch)"
104 if [[ $is_read_only != *"declare -r scratch="* ]]; then
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400105 echo "ERROR: variable scratch is not read-only, cleanup skipped"
106 exit 1
Joey Armstrongd99e3d22023-01-29 12:35:43 -0500107 fi
108
109 if [ -d "$scratch" ]; then
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400110 /bin/rm -fr "$scratch"
Joey Armstrongd99e3d22023-01-29 12:35:43 -0500111 fi
112
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400113 do_logout
Joey Armstrongd99e3d22023-01-29 12:35:43 -0500114 return
115}
116trap sigtrap EXIT
117
118## -----------------------------------------------------------------------
Joey Armstrongad7b1e02023-03-27 11:55:48 -0400119## Intent: Return a release version for queries
120## Note: Do not use in production, function is intended for interactive use
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400121## -----------------------------------------------------------------------
122function get_version()
123{
124 declare -n ref="$1"
125
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400126 declare -a rev=()
127 rev+=("$(( RANDOM % 10 + 1 ))")
128 rev+=("$(( RANDOM % 256 + 1 ))")
Joey Armstrongeef8c2c2023-03-27 17:27:43 -0400129 rev+=("$(( RANDOM % 10000 + 1 ))")
Joey Armstrongfc20ed52023-04-03 19:37:58 -0400130 local ver="v${rev[0]}.${rev[1]}.${rev[2]}"
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400131
Joey Armstrong43c48422023-04-03 10:17:32 -0400132 func_echo "VERSION: $ver"
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400133 ref="$ver"
134 return
135}
136
137## -----------------------------------------------------------------------
138## Intent: Provide defaults for environment variables
139## -----------------------------------------------------------------------
140function initEnvVars()
141{
142 # when not running under Jenkins, use current dir as workspace and a blank
143 # project name
144 declare -g WORKSPACE=${WORKSPACE:-.}
145 declare -g GERRIT_PROJECT=${GERRIT_PROJECT:-}
Joey Armstrong76026b72023-03-29 12:19:17 -0400146
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400147 # Github organization (or user) this project is published on. Project name should
148 # be the same on both Gerrit and GitHub
Joey Armstrong76026b72023-03-29 12:19:17 -0400149 declare -g GITHUB_ORGANIZATION=${GITHUB_ORGANIZATION:-}
150
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400151 # glob pattern relative to project dir matching release artifacts
152 # ARTIFACT_GLOB=${ARTIFACT_GLOB:-"release/*"} # stat -- release/* not found, literal string (?)
153 declare -g ARTIFACT_GLOB=${ARTIFACT_GLOB:-"release/."}
Joey Armstrong76026b72023-03-29 12:19:17 -0400154
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400155 # Use "release" as the default makefile target, can be a space separated list
156 declare -g RELEASE_TARGETS=${RELEASE_TARGETS:-release}
Joey Armstrong76026b72023-03-29 12:19:17 -0400157
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400158 # Set and handle GOPATH and PATH
159 export GOPATH=${GOPATH:-$WORKSPACE/go}
160 export PATH=$PATH:/usr/lib/go-1.12/bin:/usr/local/go/bin:$GOPATH/bin
161 return
162}
163
164## -----------------------------------------------------------------------
Joey Armstrongd99e3d22023-01-29 12:35:43 -0500165## Intent: Create a scratch area for downloads and transient tools
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400166## temp directory will be automatically removed upon exit.
Joey Armstrongd99e3d22023-01-29 12:35:43 -0500167## -----------------------------------------------------------------------
168function init()
169{
Joey Armstrongd99e3d22023-01-29 12:35:43 -0500170 local pkgbase="${0##*/}" # basename
171 local pkgname="${pkgbase%.*}"
172
Joey Armstrongad7b1e02023-03-27 11:55:48 -0400173 # initEnvVars # moved to full_banner()
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400174
175 ## Create a temp directory for auto-cleanup
176 declare -g scratch
Joey Armstrongd99e3d22023-01-29 12:35:43 -0500177 scratch="$(mktemp -d -t "${pkgname}.XXXXXXXXXX")"
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400178 readonly scratch
179 declare -p scratch
180
Joey Armstrong43c48422023-04-03 10:17:32 -0400181 ## prime the stream: cache answers
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400182 local work
183 get_release_dir work
184 declare -p work
Joey Armstrong43c48422023-04-03 10:17:32 -0400185
186 local filler
187 getGitVersion filler
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400188 return
189}
190
191## -----------------------------------------------------------------------
192## Intent: Verbose output for logging
193## -----------------------------------------------------------------------
194function banner()
195{
196 local iam="${0##*/}"
197 cat <<EOB
198
199** -----------------------------------------------------------------------
200** ${iam}::${FUNCNAME[1]}: $*
201** -----------------------------------------------------------------------
202EOB
Joey Armstrongd99e3d22023-01-29 12:35:43 -0500203}
204
205## -----------------------------------------------------------------------
Joey Armstrong7f382ef2023-01-25 12:00:08 -0500206## Intent: Output a log banner to identify the running script/version.
207## -----------------------------------------------------------------------
208## TODO:
209## o SCRIPT_VERSION => git changeset for repo:ci-managment
210## o echo "library version: ${env."library.libName.version"}"
211# -----------------------------------------------------------------------
212# 14:18:38 > git fetch --no-tags --progress -- https://gerrit.opencord.org/ci-management.git +refs/heads/*:refs/remotes/origin/* # timeout=10
213# 14:18:39 Checking out Revision 50f6e0b97f449b32d32ec0e02d59642000351847 (master)
214# -----------------------------------------------------------------------
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400215function full_banner()
Joey Armstrong7f382ef2023-01-25 12:00:08 -0500216{
Joey Armstrongad7b1e02023-03-27 11:55:48 -0400217 local iam="${0##*/}"
218
219 initEnvVars # set defaults
Joey Armstrong7f382ef2023-01-25 12:00:08 -0500220
221cat <<EOH
222
223** -----------------------------------------------------------------------
224** IAM: ${iam} :: ${FUNCNAME[0]}
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400225** ARGV: ${ARGV[@]}
Joey Armstrong7f382ef2023-01-25 12:00:08 -0500226** PWD: $(/bin/pwd)
227** NOW: $(date '+%Y/%m/%d %H:%M:%S')
228** VER: ${SCRIPT_VERSION:-'unknown'}
229** -----------------------------------------------------------------------
Joey Armstrongad7b1e02023-03-27 11:55:48 -0400230** GERRIT_PROJECT: $(declare -p GERRIT_PROJECT)
231** GITHUB_ORGANIZATION: $(declare -p GITHUB_ORGANIZATION)
232** RELEASE_TARGETS: $(declare -p RELEASE_TARGETS)
233** GOPATH: $(declare -p GOPATH)
234** -----------------------------------------------------------------------
235** PATH += /usr/lib/go-1.12/bin:/usr/local/go/bin:GOPATH/bin
236** -----------------------------------------------------------------------
Joey Armstrong7f382ef2023-01-25 12:00:08 -0500237EOH
238
239 return
240}
241
Joey Armstrongaf577ab2022-12-15 14:43:33 -0500242## -----------------------------------------------------------------------
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400243## Intent: Display a message with 'iam' identifier for logging
Joey Armstrong50f6e0b2023-01-24 14:14:08 -0500244## -----------------------------------------------------------------------
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400245function func_echo()
Joey Armstrong1962bcf2023-01-27 13:53:18 -0500246{
247 local iam="${0##*/}"
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400248 echo "** ${iam} :: ${FUNCNAME[1]}: $*"
Joey Armstrong1962bcf2023-01-27 13:53:18 -0500249 return
250}
251
252## -----------------------------------------------------------------------
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400253## Intent: Display an error message then exit with status.
254## -----------------------------------------------------------------------
255function error()
256{
257 local iam="${0##*/}"
258 echo "ERROR ${iam} :: ${FUNCNAME[1]}: $*"
259 exit 1
260}
261
262## -----------------------------------------------------------------------
263## Intent: Verify sandbox/build is versioned for release.
264## -----------------------------------------------------------------------
265function getGitVersion()
266{
267 declare -n varname="$1"; shift
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400268
Joey Armstrong43c48422023-04-03 10:17:32 -0400269 local __ver # use prefix('__') to protect callers variable name
270 if [[ -v cached_getGitVersion ]]; then
271 __ver="$cached_getGitVersion"
272 varname="$__ver"
273 return
Joey Armstrong39fac652023-03-27 18:50:43 -0400274
Joey Armstrong43c48422023-04-03 10:17:32 -0400275 elif [[ -v argv_gen_version ]]; then
276 get_version __ver
277
278 elif [[ -v WORKSPACE ]] && [[ -v GITHUB_TOKEN ]]; then # i_am_jenkins
Joey Armstrongca557dc2023-04-03 17:12:32 -0400279 local path="$GERRIT_PROJECT"
280 pushd "$path" || error "pushd GERRIT_PROJECT= failed $(declare -p path)"
Joey Armstrong43c48422023-04-03 10:17:32 -0400281 __ver="$(git tag -l --points-at HEAD)"
Joey Armstrongca557dc2023-04-03 17:12:32 -0400282 popd || error "popd GERRIT_PROJECT= failed"
Joey Armstrong43c48422023-04-03 10:17:32 -0400283
284 elif [[ -v argv_version_file ]]; then # local debug
285 [[ ! -f VERSION ]] && error "./VERSION file not found"
286 readarray -t tmp < <(sed -e 's/[[:blank:]]//g' 'VERSION')
287 __ver="v${tmp[0]}"
288
289 else
Joey Armstrongca557dc2023-04-03 17:12:32 -0400290 local path="$GERRIT_PROJECT"
291 pushd "$path" || error "pushd GERRIT_PROJECT= failed $(declare -p path)"
Joey Armstrong43c48422023-04-03 10:17:32 -0400292 __ver="$(git tag -l --points-at HEAD)"
Joey Armstrongca557dc2023-04-03 17:12:32 -0400293 popd || error "popd GERRIT_PROJECT= failed"
Joey Armstrong43c48422023-04-03 10:17:32 -0400294 fi
Joey Armstrong76026b72023-03-29 12:19:17 -0400295
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400296 # ------------------------------------------------------
297 # match bare versions or v-prefixed golang style version
298 # Critical failure for new/yet-to-be-released repo ?
299 # ------------------------------------------------------
Joey Armstrong43c48422023-04-03 10:17:32 -0400300 if [[ "$__ver" =~ ^v?([0-9]+)\.([0-9]+)\.([0-9]+)$ ]]; then
Joey Armstrongfc20ed52023-04-03 19:37:58 -0400301 echo "git has a SemVer released version tag: '$__ver'"
Joey Armstrong43c48422023-04-03 10:17:32 -0400302 echo "Building artifacts for GitHub release."
303
304 elif [[ "$__ver" =~ ^v?([0-9]+)\.([0-9]+)\.([0-9]+)-dev([0-9]+)$ ]]; then
305 declare -i -g draft_release=1
306 echo "Detected --draft SemVer release version tag [$__ver]"
307 echo "Building artifacts for GitHub release."
308
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400309 else
Joey Armstrong43c48422023-04-03 10:17:32 -0400310 error "No SemVer released version tag found, exiting..."
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400311 fi
312
Joey Armstrong43c48422023-04-03 10:17:32 -0400313 ## Cache value for subsequent calls.
314 ## readonly is a guarantee assignment happens once.
315 declare -g cached_getGitVersion="$__ver"
316 readonly cached_getGitVersion;
317
318 varname="$__ver"
319 func_echo "Version is [$__ver] from $(/bin/pwd)"
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400320 return
321}
322
323## -----------------------------------------------------------------------
324## Intent:
325## Note: Release description is sanitized version of the log message
326## -----------------------------------------------------------------------
327function getReleaseDescription()
328{
329 declare -n varname="$1"; shift
330
331 local msg
332 msg="$(git log -1 --pretty=%B)"
333
334 local val
335 val="$(tr -dc "[:alnum:]\n\r\.\[\]\:\-\\\/\`\' " <<< "$msg")"
336
337 [[ ${#val} -eq 0 ]] && error "Release Description is empty ($msg)"
338 varname="$val"
339 return
340}
341
342## -----------------------------------------------------------------------
343## Intent: Retrieve value of the release temp directory.
344## -----------------------------------------------------------------------
345## Note: Limit use of globals so logic can be isolated in function calls.
346## -----------------------------------------------------------------------
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400347function get_release_dir()
348{
349 declare -n varname=$1; shift
350
351 # Temporary staging directory to copy artifacts to
352 varname="$scratch/release"
353 mkdir -p "$varname"
354 return
355}
356
357## -----------------------------------------------------------------------
358## Intent: Retrieve github server hostname
359## -----------------------------------------------------------------------
360function get_gh_hostname()
361{
362 declare -n varname=$1; shift
363 varname+=('--hostname' "${__githost}")
364 return
365}
366
367## -----------------------------------------------------------------------
368## Intent: Retrieve repository organizaiton name
369## -----------------------------------------------------------------------
370function get_gh_repo_org()
371{
372 declare -n varname=$1; shift
373 declare -g __repo_org
Joey Armstrong76026b72023-03-29 12:19:17 -0400374
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400375 local org
376 if [[ -v __repo_org ]]; then
Joey Armstrong43c48422023-04-03 10:17:32 -0400377 org="$__repo_org"
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400378 elif [[ ! -v GITHUB_ORGANIZATION ]]; then
Joey Armstrong43c48422023-04-03 10:17:32 -0400379 error "--repo-org or GITHUB_ORGANIZATION= are required"
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400380 else
Joey Armstrong43c48422023-04-03 10:17:32 -0400381 org="${GITHUB_ORGANIZATION}"
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400382 fi
383
384 # shellcheck disable=SC2178
385 varname="$org"
386 return
387}
388
389## -----------------------------------------------------------------------
390## Intent: Retrieve repository organizaiton name
391## -----------------------------------------------------------------------
392function get_gh_repo_name()
393{
394 declare -n varname=$1; shift
395 declare -g __repo_name
Joey Armstrong76026b72023-03-29 12:19:17 -0400396
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400397 local name
398 if [[ -v __repo_name ]]; then
Joey Armstrong43c48422023-04-03 10:17:32 -0400399 name="$__repo_name"
Joey Armstrong39fac652023-03-27 18:50:43 -0400400 elif [[ ! -v GERRIT_PROJECT ]]; then
Joey Armstrong43c48422023-04-03 10:17:32 -0400401 error "--repo-name or GERRIT_PROJECT= are required"
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400402 else
Joey Armstrong43c48422023-04-03 10:17:32 -0400403 name="${GERRIT_PROJECT}"
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400404 fi
405
406 varname="$name"
407 return
408}
409
410## -----------------------------------------------------------------------
411## Intent: Return path for the gh release query
412## -----------------------------------------------------------------------
413function get_gh_releases()
414{
415 declare -n ref="$1"
416
417 local repo_org
418 get_gh_repo_org repo_org
419
420 local repo_name
421 get_gh_repo_name repo_name
422
423 ref="repos/${repo_org}/${repo_name}/releases"
424 func_echo "ref=$ref"
425 return
426}
427
428## -----------------------------------------------------------------------
429## Intent: Retrieve repository path argument
430## -----------------------------------------------------------------------
431function get_argv_repo()
432{
433 declare -n varname=$1; shift
434
435 local repo_org
436 get_gh_repo_org repo_org
Joey Armstrong76026b72023-03-29 12:19:17 -0400437
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400438 local repo_name
Joey Armstrong76026b72023-03-29 12:19:17 -0400439 get_gh_repo_name repo_name
440
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400441 varname="${repo_org}/${repo_name}"
Joey Armstrong43c48422023-04-03 10:17:32 -0400442 # func_echo "VARNAME=$varname"
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400443 return
444}
445
446## -----------------------------------------------------------------------
447## Intent: Retrieve release name string "project - version"
448## -----------------------------------------------------------------------
449function get_argv_name()
450{
451 declare -n varname=$1; shift
452
453 local repo_name
454 get_gh_repo_name repo_name
Joey Armstrong43c48422023-04-03 10:17:32 -0400455
456 local repo_ver
457 getGitVersion repo_ver
458
459 # varname="${repo_name} - $GIT_VERSION"
460 varname="${repo_name} - ${repo_ver}"
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400461 func_echo "varname=$varname"
462 return
463}
464
465## -----------------------------------------------------------------------
466## Intent: Retrieve tag version
467## -----------------------------------------------------------------------
468function get_argv_tag()
469{
470 declare -n varname=$1; shift
471
472 # cached_argv_tag='v3.41.3204'
473 if [[ ! -v cached_argv_tag ]]; then
Joey Armstrong43c48422023-04-03 10:17:32 -0400474 declare -g cached_argv_tag
475 if [[ -v GIT_VERSION ]]; then # hello jenkins
476 cached_argv_tag="$GIT_VERSION"
477 fi
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400478 fi
479
480 [[ ${#cached_argv_tag} -eq 0 ]] && error "Unable to determine GIT_VERSION="
481 varname="$cached_argv_tag"
482 func_echo "varname=$varname"
483 return
484}
485
486## -----------------------------------------------------------------------
487## Intent:
488## -----------------------------------------------------------------------
489# To support golang projects that require GOPATH to be set and code checked out there
490# If $DEST_GOPATH is not an empty string:
491# - create GOPATH within WORKSPACE, and destination directory within
492# - set PATH to include $GOPATH/bin and the system go binaries
493# - move project from $WORKSPACE/$GERRIT_PROJECT to new location in $GOPATH
494# - start release process within that directory
495## -----------------------------------------------------------------------
496function get_release_path()
497{
498 declare -n varname=$1; shift
499
500 DEST_GOPATH=${DEST_GOPATH:-}
501 if [ -n "$DEST_GOPATH" ]; then
Joey Armstrong43c48422023-04-03 10:17:32 -0400502 mkdir -p "$GOPATH/src/$DEST_GOPATH"
503 varname="$GOPATH/src/$DEST_GOPATH/$GERRIT_PROJECT"
504 mv "$WORKSPACE/$GERRIT_PROJECT" "$varname"
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400505 else
Joey Armstrong43c48422023-04-03 10:17:32 -0400506 varname="$WORKSPACE/$GERRIT_PROJECT"
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400507 fi
508
Joey Armstrong43c48422023-04-03 10:17:32 -0400509 ## Verify pwd is OK
510 for path in \
511 "$varname/Makefile"\
512 "$varname/makefile"\
513 "__ERROR__"\
514 ; do
515 case "$path" in
516 __ERROR__) error "Makefile not found at $varname!" ;;
517 *) [[ -f "$path" ]] && break ;;
518 esac
519 done
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400520
521 return
522}
523
524## -----------------------------------------------------------------------
525## Intent: Display future enhancements
526## -----------------------------------------------------------------------
527function todo()
528{
529 local iam="${0##*/}"
530
531cat <<EOT
532
533** -----------------------------------------------------------------------
534** IAM: ${iam} :: ${FUNCNAME[0]}
535** -----------------------------------------------------------------------
536 o get_release_path()
537 - refactor redundant paths into local vars.
538 - see comments, do we have a one-off failure condition ?
Joey Armstrongad7b1e02023-03-27 11:55:48 -0400539 o PATH += golang appended 3 times, release needs a single, reliable answer.
540 o do_login, do_logout and api calls do not use the my_gh wrapper:
541 - Add a lookup function to cache and retrieve path to downloaded gh command.
Joey Armstrong76026b72023-03-29 12:19:17 -0400542
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400543EOT
544
545 return
546}
547
548## -----------------------------------------------------------------------
Joey Armstrong76026b72023-03-29 12:19:17 -0400549## Intent: Verify a directory contains content for release.
550## -----------------------------------------------------------------------
551## Given:
552## scalar Path to release/ directory
553## ref Results returned through this indirect var.
554## -----------------------------------------------------------------------
555## Usage:
556## declare -a artifacts=()
557## get_artifacts '/foo/bar/tans' artifacts
558## declare -p artifacts
559## -----------------------------------------------------------------------
560function get_artifacts()
561{
562 local dir="$1" ; shift
563 declare -n ref=$1 ; shift
564
565 # Glob available files
566 readarray -t __artifacts < <(find "$dir" -mindepth 1 ! -type d)
567 func_echo "$(declare -p __artifacts)"
568
569 # -----------------------------------------------------------------------
570 # Verify count>0 to inhibit source-only release
571 # Problem children:
572 # o build or make release failures.
573 # o docker container filesystem mount problem (~volume)
574 # -----------------------------------------------------------------------
575 [[ ${#__artifacts[@]} -eq 0 ]] \
Joey Armstrong43c48422023-04-03 10:17:32 -0400576 && error "Artifact dir is empty: $(declare -p dir)"
Joey Armstrong76026b72023-03-29 12:19:17 -0400577
578 ref=("${__artifacts[@]}")
579 return
580}
581
582## -----------------------------------------------------------------------
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400583## Intent: Copy files from the build directory into the release staging
584## directory for publishing to github releases/ endpoint.
Joey Armstrong26707f02023-01-26 12:41:12 -0500585## -----------------------------------------------------------------------
586function copyToRelease()
587{
Joey Armstrong76026b72023-03-29 12:19:17 -0400588 banner ''
Joey Armstrong26707f02023-01-26 12:41:12 -0500589
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400590 local artifact_glob="${ARTIFACT_GLOB%/*}"
591 func_echo "$(declare -p artifact_glob)"
592
593 local work
594 get_release_dir work
Joey Armstrong76026b72023-03-29 12:19:17 -0400595 func_echo "Artifact dir: $(declare -p work)"
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400596
Joey Armstrong76026b72023-03-29 12:19:17 -0400597 ## Verify release content is available
598 declare -a artifacts=()
Joey Armstrong43c48422023-04-03 10:17:32 -0400599 # get_artifacts "$work" artifacts
600 get_artifacts "$artifact_glob" artifacts
601 func_echo "Artifacts in copy_from: $(declare -p artifacts)"
Joey Armstrong472bfba2023-03-27 18:12:28 -0400602
Joey Armstrong26707f02023-01-26 12:41:12 -0500603 # Copy artifacts into the release temp dir
604 # shellcheck disable=SC2086
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400605 echo "rsync -rv --checksum \"$artifact_glob/.\" \"$work/.\""
606 rsync -rv --checksum "$artifact_glob/." "$work/."
Joey Armstrong1962bcf2023-01-27 13:53:18 -0500607
Joey Armstrong43c48422023-04-03 10:17:32 -0400608 get_artifacts "$work" artifacts
609 func_echo "Artifacts in copy_to: $(declare -p artifacts)"
610
Joey Armstrong26707f02023-01-26 12:41:12 -0500611 return
612}
613
614## -----------------------------------------------------------------------
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400615## https://docs.github.com/en/rest/releases?apiVersion=2022-11-28
616 # https://cli.github.com/manual/gh_release_create
617 # --target <branch> or commit SHA
618 # --title
619 # --generate-notes
620 # --release-notes (notes file)
621 # --release
622 # release create dist/*.tgz
623 # --discussion-category "General"
Joey Armstrongf085d872023-01-28 17:52:29 -0500624## -----------------------------------------------------------------------
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400625# https://cli.github.com/manual/gh_release_create
626## -----------------------------------------------------------------------
627function gh_release_create()
Joey Armstrong38bfeea2023-02-06 18:01:29 -0500628{
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400629 banner ''
Joey Armstrong38bfeea2023-02-06 18:01:29 -0500630
Joey Armstrong43c48422023-04-03 10:17:32 -0400631 local version
632 getGitVersion version
Joey Armstrong38bfeea2023-02-06 18:01:29 -0500633
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400634 local work
635 get_release_dir work
636
Joey Armstrong43c48422023-04-03 10:17:32 -0400637 declare -a args=()
638 args+=('--host-repo')
639 args+=('--title')
640 if [[ -v draft_release ]]; then
641 args+=('--draft')
642 else
643 args+=('--discussion-category' 'Announcements')
644 fi
645
646 # args+=('--notes' "'Testing release create -- ignore'")
647
Joey Armstrong78cecc52023-04-03 11:39:11 -0400648 pushd "$work/.." >/dev/null
649 func_echo "WORK=$work"
650 # readarray -t payload < <(find '.' -maxdepth 4 ! -type d -print)
651 readarray -t payload < <(find 'release' -maxdepth 4 ! -type d -print)
Joey Armstrong76026b72023-03-29 12:19:17 -0400652
Joey Armstrongad7b1e02023-03-27 11:55:48 -0400653 func_echo "$gh_cmd release create ${version} ${args[@]}" "${payload[@]}"
Joey Armstrong43c48422023-04-03 10:17:32 -0400654
655 if [[ -v dry_run ]]; then
656 echo "[SKIP] dry run"
657 else
Joey Armstrong78cecc52023-04-03 11:39:11 -0400658 func_echo "my_gh release create '$version' ${args[@]} ${payload[@]}"
Joey Armstrong43c48422023-04-03 10:17:32 -0400659 my_gh 'release' 'create' "'$version'" "${args[@]}" "${payload[@]}"
660 set +x
661 fi
Joey Armstrong76026b72023-03-29 12:19:17 -0400662 popd >/dev/null
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400663
Joey Armstrong38bfeea2023-02-06 18:01:29 -0500664 return
665}
666
667## -----------------------------------------------------------------------
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400668## Intent: Authenticate credentials for a github gh session
Joey Armstrong38bfeea2023-02-06 18:01:29 -0500669## -----------------------------------------------------------------------
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400670## NOTE: my_gh currently unused due to --with-token < "$pac"
671## -----------------------------------------------------------------------
672function do_login()
Joey Armstrongf085d872023-01-28 17:52:29 -0500673{
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400674 declare -g pac
Joey Armstrong485081f2023-03-27 13:34:08 -0400675 declare -a login_args=()
676 [[ $# -gt 0 ]] && login_args+=("$@")
Joey Armstrongf085d872023-01-28 17:52:29 -0500677
Joey Armstrong485081f2023-03-27 13:34:08 -0400678 # https://github.com/cli/cli/issues/2922#issuecomment-775027762
Joey Armstrong75a0d932023-03-28 08:59:54 -0400679 # (sigh) why not quietly return VS forcing a special logic path
Joey Armstronge6e18eb2023-03-27 14:19:21 -0400680 # [[ -v WORKSPACE ]] && [[ -v GITHUB_TOKEN ]] && return
681
682# 12:58:36 ** -----------------------------------------------------------------------
683# 12:58:36 ** jenkins582353203049151829.sh::do_login: --hostname github.com
684# 12:58:36 ** --------------------------------------------------------------------# ---
685# 12:58:36 ** jenkins582353203049151829.sh :: do_login: Detected ENV{GITHUB_TOKEN}=
686# 12:58:36 The value of the GITHUB_TOKEN environment variable is being used for authentication.
687# 12:58:36 To have GitHub CLI store credentials instead, first clear the value from the environment.
Joey Armstrong43c48422023-04-03 10:17:32 -0400688# -----------------------------------------------------------------------
Joey Armstrong76026b72023-03-29 12:19:17 -0400689
Joey Armstrong485081f2023-03-27 13:34:08 -0400690 get_gh_hostname login_args
Joey Armstrongf085d872023-01-28 17:52:29 -0500691
Joey Armstrong485081f2023-03-27 13:34:08 -0400692 banner "${login_args[@]}"
Joey Armstrong78cecc52023-04-03 11:39:11 -0400693 func_echo "$(declare -p WORKSPACE)"
Joey Armstrongf085d872023-01-28 17:52:29 -0500694
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400695 ## Read from disk is safer than export GITHUB_TOKEN=
696 if [[ -v pac ]] && [[ ${#pac} -gt 0 ]]; then # interactive/debugging
Joey Armstrong43c48422023-04-03 10:17:32 -0400697 [ ! -f "$pac" ] && error "PAC token file $pac does not exist"
Joey Armstrong78cecc52023-04-03 11:39:11 -0400698 func_echo "$gh_cmd auth login ${login_args[@]} --with-token < $pac"
Joey Armstrong485081f2023-03-27 13:34:08 -0400699 "$gh_cmd" auth login "${login_args[@]}" --with-token < "$pac"
Joey Armstrongf085d872023-01-28 17:52:29 -0500700
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400701 elif [[ ! -v GITHUB_TOKEN ]]; then
702 error "--token [t] or GITHUB_TOKEN= are required"
Joey Armstrong41923cc2023-01-30 14:38:16 -0500703
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400704 else # jenkins
Joey Armstrong78cecc52023-04-03 11:39:11 -0400705 func_echo "$gh_cmd auth login ${login_args[@]} (ie: jenkins)"
Joey Armstrong43c48422023-04-03 10:17:32 -0400706 "$gh_cmd" auth login "${login_args[@]}"
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400707 fi
Joey Armstrongf085d872023-01-28 17:52:29 -0500708
Joey Armstrong43c48422023-04-03 10:17:32 -0400709 declare -i -g active_login=1 # signal logout needed
Joey Armstrongf085d872023-01-28 17:52:29 -0500710
Joey Armstrongf085d872023-01-28 17:52:29 -0500711 return
712}
713
714## -----------------------------------------------------------------------
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400715## Intent: Destroy credentials/gh session authenticated by do_login
716## -----------------------------------------------------------------------
717## NOTE: my_gh currently unused due to "<<< 'y'"
718## -----------------------------------------------------------------------
719function do_logout()
720{
721 declare -i -g active_login
722 [[ ! -v active_login ]] && return
723
Joey Armstrong78cecc52023-04-03 11:39:11 -0400724 declare -a logout_args=()
725 [[ $# -gt 0 ]] && logout_args+=("$@")
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400726
Joey Armstrong78cecc52023-04-03 11:39:11 -0400727 get_gh_hostname logout_args
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400728
Joey Armstrong78cecc52023-04-03 11:39:11 -0400729 banner "${logout_args[@]}"
730 func_echo "$gh_cmd auth logout ${logout_args[@]} <<< 'Y'"
731 "$gh_cmd" auth logout "${logout_args[@]}" <<< 'Y'
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400732
733 unset active_login
734 return
735}
736
737## -----------------------------------------------------------------------
738## Intent: Query for repository version strings
739## -----------------------------------------------------------------------
740function get_releases()
741{
742 declare -n ref="$1"; shift
743 local func="${FUNCNAME[0]}"
744
745 banner ""
746 pushd "$scratch" >/dev/null
Joey Armstrong76026b72023-03-29 12:19:17 -0400747
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400748 # gh api repos/{owner}/{repo}/releases
749 local releases_uri
750 get_gh_releases releases_uri
751 declare -p releases_uri
Joey Armstrong76026b72023-03-29 12:19:17 -0400752
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400753 ref=()
Joey Armstrongad7b1e02023-03-27 11:55:48 -0400754 "$gh_cmd" api "$releases_uri" "${common[@]}" | jq . > 'release.raw'
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400755 readarray -t __tmp < <(jq '.[] | "\(.tag_name)"' 'release.raw')
756
757 local release
758 for release in "${__tmp[@]}";
759 do
Joey Armstrong43c48422023-04-03 10:17:32 -0400760 release="${release//\"/}"
761 ref+=("$release")
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400762 done
763
764 popd >/dev/null
765 return
766}
767
768## -----------------------------------------------------------------------
769## Intent: Display repository query strings.
770## Indirect: verify authentication and API
771## -----------------------------------------------------------------------
772function showReleases()
773{
Joey Armstrong43c48422023-04-03 10:17:32 -0400774 declare -a raw=()
775 get_releases raw
776
777 ## Sort for display, we may need to prune volume later on
778 IFS=$'\n' releases=($(sort -nr <<<"${raw[*]}"))
779 unset IFS
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400780
781 local release
782 for release in "${releases[@]}";
783 do
Joey Armstrong43c48422023-04-03 10:17:32 -0400784 func_echo "$release"
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400785 done
786 return
787}
788
789## -----------------------------------------------------------------------
790## Intent: Install the gh command line tool locally
Joey Armstrong26707f02023-01-26 12:41:12 -0500791## -----------------------------------------------------------------------
Joey Armstrongd99e3d22023-01-29 12:35:43 -0500792function install_gh_binary()
Joey Armstrong26707f02023-01-26 12:41:12 -0500793{
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400794 banner
Joey Armstrong26707f02023-01-26 12:41:12 -0500795
Joey Armstrongd99e3d22023-01-29 12:35:43 -0500796 pushd "$scratch"
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400797 func_echo "Retrieve latest gh download URLs"
Joey Armstrongf085d872023-01-28 17:52:29 -0500798
Joey Armstrongd99e3d22023-01-29 12:35:43 -0500799 local latest="https://github.com/cli/cli/releases/latest"
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400800 local tarball="gh.tar.tgz"
801
Joey Armstrong76026b72023-03-29 12:19:17 -0400802 readarray -t latest < <(\
803 curl --silent -qI "$latest" \
Joey Armstrong43c48422023-04-03 10:17:32 -0400804 | awk -F '/' '/^location/ {print substr($NF, 1, length($NF)-1)}')
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400805 declare -p latest
806 if [ ${#latest[@]} -ne 1 ]; then
Joey Armstrong43c48422023-04-03 10:17:32 -0400807 error "Unable to determine latest gh package version"
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400808 fi
Joey Armstrong76026b72023-03-29 12:19:17 -0400809
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400810 local VER="${latest[0]}"
811
812 func_echo "Download latest gh binary"
Joey Armstrongd99e3d22023-01-29 12:35:43 -0500813 local url="https://github.com/cli/cli/releases/download/${VER}/gh_${VER#v}_linux_amd64.tar.gz"
Joey Armstrong43c48422023-04-03 10:17:32 -0400814 func_echo "wget --quiet --output-document='$tarball' '$url'"
Joey Armstrongd99e3d22023-01-29 12:35:43 -0500815 wget --quiet --output-document="$tarball" "$url"
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400816
817 func_echo "Unpack tarball"
Joey Armstrongd99e3d22023-01-29 12:35:43 -0500818 tar zxf "$tarball"
819
Joey Armstrong78cecc52023-04-03 11:39:11 -0400820 declare -g gh_cmd
821 gh_cmd="$(find "${scratch}" -name 'gh' -print)"
822 #declare -g gh_cmd='/usr/bin/gh'
Joey Armstrongd99e3d22023-01-29 12:35:43 -0500823 readonly gh_cmd
824
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400825 func_echo "Command: ${gh_cmd}"
826 func_echo "Version: $("$gh_cmd" --version)"
Joey Armstrongd99e3d22023-01-29 12:35:43 -0500827 popd
828
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400829 return
830}
831
832## -----------------------------------------------------------------------
833## Intent: Danger Will Robinson
834## -----------------------------------------------------------------------
835function releaseDelete()
836{
837 local version="$1"; shift
Joey Armstrong76026b72023-03-29 12:19:17 -0400838
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400839 banner "${in_args[@]}"
840 declare -a args=()
841 args+=('--host-repo')
842 args+=('--yes')
843 # args+=('--cleanup-tag')
844
845# ** github-release.sh :: get_argv_repo: VARNAME=opencord/voltctl
846#* Running: /tmp/github-release.R7geZo7Ywo/gh_2.25.1_linux_amd64/bin/gh release delete v4.175.710 --repo 'github.com/opencord/voltctl' --yes --cleanup-tag
847#rror connecting to 'github.com
848#heck your internet connection or https://githubstatus.com
849
850 echo
851 echo "==========================================================================="
852 my_gh 'release' 'delete' "$version" "${args[@]}"
853 echo "==========================================================================="
854 echo
855
856 showReleases
857 return
858}
859
860## -----------------------------------------------------------------------
861## Intent: Copy binaries into temp/release, checksum then publish
862## -----------------------------------------------------------------------
863function release_staging()
864{
865 local release_temp
866 get_release_dir release_temp
867
868 banner ''
869 func_echo "Packaging release files"
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400870
Joey Armstrong76026b72023-03-29 12:19:17 -0400871 pushd "$release_temp" >/dev/null \
Joey Armstrong43c48422023-04-03 10:17:32 -0400872 || error "pushd failed: dir is [$release_temp]"
Joey Armstrong76026b72023-03-29 12:19:17 -0400873
874 declare -a to_release=()
875 get_artifacts '.' to_release
876
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400877 func_echo "Files to release: $(declare -p to_release)"
878
879 # Generate and check checksums
880 sha256sum -- * > checksum.SHA256
881 sha256sum -c < checksum.SHA256
882
883 echo
884 func_echo "Checksums(checksum.SHA256):"
885 cat checksum.SHA256
886
Joey Armstrong43c48422023-04-03 10:17:32 -0400887 if false; then
Joey Armstrong78cecc52023-04-03 11:39:11 -0400888 # Careful with credentials display
Joey Armstrong43c48422023-04-03 10:17:32 -0400889 get_gh_hostname login_args
890 banner "gh auth status ${login_args[@]}"
891 gh auth status "${login_args[@]}"
892 fi
893
Joey Armstrong76026b72023-03-29 12:19:17 -0400894 gh_release_create # publish
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400895
896 popd >/dev/null || error "pushd failed: dir is [$release_temp]"
897
898 return
899}
900
901## -----------------------------------------------------------------------
902## Intent: Display program usage
903## -----------------------------------------------------------------------
904function usage()
905{
906 [[ $# -gt 0 ]] && func_echo "$*"
907
908 cat <<EOH
909Usage: github-release.sh [options] [target] ...
910
911[Github CLI (gh) arguments]
912 --login Perform authentication using a PAC
913 --logout
914 --host [h] Specify github server for connection.
915
916[Options]
917 --token Login debugging, alternative to env var use.
918
919[Modes]
920 --debug Enable script debug mode
921 --verbose Enable script verbose mode
922
923All remaining arguments are passthrough to the gh command.
924EOH
925
926 exit 0
927}
928
929## -----------------------------------------------------------------------
Joey Armstrong43c48422023-04-03 10:17:32 -0400930## Intent: Normalize common arguments and access to the gh command.
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400931## o Cache path to the gh command
932## o Construct a gh command line from given args
933## o Command wrapper can provide defaults (--hostname github.com)
934## -----------------------------------------------------------------------
935## Given:
936## scalar Array variable name (declare -n is a reference)
937## Return:
938## ref gh command line passed back to caller
939## Switches:
940## --host Pass default github hostname
941## --verbose Enable verbose mode#
942## --version Display command version
943## @array Remaining arguments passed as command switches.
944## -----------------------------------------------------------------------
945## See Also:
946## o https://cli.github.com/manual
947## -----------------------------------------------------------------------
948function my_gh()
949{
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400950 declare -a cmd=()
951 cmd+=("$gh_cmd")
952
953 ## ----------------------
954 ## Construct command line
955 ## ----------------------
956 # shellcheck disable=SC2034
957 declare -A action=() # pending operations
958 declare -a args=() # common gh command line args
959
960 while [ $# -gt 0 ]; do
961 local arg="$1"; shift
962 case "$arg" in
963
Joey Armstrong43c48422023-04-03 10:17:32 -0400964 # Modes
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400965 -*debug) declare -i -g debug=1 ;;
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400966 -*verbose) args+=('--verbose') ;;
967
Joey Armstrong43c48422023-04-03 10:17:32 -0400968 -*hostname)
969 get_gh_hostname in_args
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400970 ;;
971
Joey Armstrong43c48422023-04-03 10:17:32 -0400972 --host-repo)
973 local val
974 get_argv_repo val
Joey Armstrong76026b72023-03-29 12:19:17 -0400975
Joey Armstrong43c48422023-04-03 10:17:32 -0400976 # --repo <[HOST/]OWNER/REPO>
Joey Armstrong78cecc52023-04-03 11:39:11 -0400977 args+=('--repo' "${__githost}/${val}")
Joey Armstrong43c48422023-04-03 10:17:32 -0400978 ;;
Joey Armstrong76026b72023-03-29 12:19:17 -0400979
Joey Armstrong43c48422023-04-03 10:17:32 -0400980 --repo)
981 local val
982 get_argv_repo val
983 args+=('--repo' "$val")
984 ;;
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400985
Joey Armstrong43c48422023-04-03 10:17:32 -0400986 --tag)
987 local val
988 get_argv_tag val
989 args+=("'$val'") # No switch, pass inline
990 ;;
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400991
Joey Armstrong43c48422023-04-03 10:17:32 -0400992 --title)
993 local val
994 get_argv_name val
995 args+=('--title' "'$val'")
996 ;;
Joey Armstrong76026b72023-03-29 12:19:17 -0400997
Joey Armstrong2097d3e2023-03-26 10:32:03 -0400998 *) args+=("$arg") ;;
999 esac
1000 done
Joey Armstrong76026b72023-03-29 12:19:17 -04001001
Joey Armstrong2097d3e2023-03-26 10:32:03 -04001002 cmd+=("${args[@]}")
1003 echo "** Running: ${cmd[*]}"
1004 "${cmd[@]}"
1005 local status=$?
1006
1007 [[ $status -eq 0 ]] && { true; } || { false; }
1008 return
1009}
1010
1011## ---------------------------------------------------------------------------
1012## Intent:
1013## ---------------------------------------------------------------------------
1014function usage()
1015{
1016 cat <<EOH
Joey Armstrong76026b72023-03-29 12:19:17 -04001017
Joey Armstrong2097d3e2023-03-26 10:32:03 -04001018Usage: $0
1019Usage: make [options] [target] ...
1020 --help This mesage
1021 --pac Personal Access Token (file)
1022
1023[DEBUG]
1024 --gen-version Generate a random release version string.
1025 --git-hostname Git server hostname (default=github.com)
Joey Armstrong43c48422023-04-03 10:17:32 -04001026 --version-file Read version string from local version file
1027
1028 --dry-run Simulation mode
Joey Armstrong2097d3e2023-03-26 10:32:03 -04001029
1030EOH
1031 return
1032}
1033
1034## ---------------------------------------------------------------------------
1035## Intent: Parse script command line arguments
1036## ---------------------------------------------------------------------------
1037function parse_args()
1038{
Joey Armstrong2097d3e2023-03-26 10:32:03 -04001039 [[ -v DEBUG ]] && func_echo "ENTER"
1040
Joey Armstrong2097d3e2023-03-26 10:32:03 -04001041 while [ $# -gt 0 ]; do
Joey Armstrong43c48422023-04-03 10:17:32 -04001042 local arg="$1"; shift
1043 func_echo "ARGV: $arg"
1044 case "$arg" in
Joey Armstrong2097d3e2023-03-26 10:32:03 -04001045
Joey Armstrong43c48422023-04-03 10:17:32 -04001046 -*debug) declare -i -g debug=1 ;;
1047 --draft) declare -i -g draft_release=1 ;;
1048 --dry-run) declare -i -g dry_run=1 ;;
Joey Armstrong2097d3e2023-03-26 10:32:03 -04001049
Joey Armstrong43c48422023-04-03 10:17:32 -04001050 --version-file)
1051 declare -i -g argv_version_file=1
1052 ;;
Joey Armstrong2097d3e2023-03-26 10:32:03 -04001053
Joey Armstrong43c48422023-04-03 10:17:32 -04001054 -*gen-version)
1055 declare -g -i argv_gen_version=1
1056 ;;
Joey Armstrong2097d3e2023-03-26 10:32:03 -04001057
Joey Armstrong43c48422023-04-03 10:17:32 -04001058 -*git-hostname)
1059 __githost="$1"; shift
1060 ;;
Joey Armstrong2097d3e2023-03-26 10:32:03 -04001061
Joey Armstrong43c48422023-04-03 10:17:32 -04001062 -*repo-name)
1063 __repo_name="$1"; shift
1064 ;;
1065
1066 -*repo-org)
1067 __repo_org="$1"; shift
1068 ;;
1069
1070 -*pac)
1071 declare -g pac="$1"; shift
1072 readonly pac
1073 [[ ! -f "$pac" ]] && error "--token= does not exist ($pac)"
1074 : # nop/true
1075 ;;
1076
1077 -*todo) todo ;;
1078
1079 -*help)
1080 usage
1081 exit 0
1082 ;;
1083
1084 *) error "Detected unknown argument $arg" ;;
1085 esac
Joey Armstrong2097d3e2023-03-26 10:32:03 -04001086 done
1087
Joey Armstrong26707f02023-01-26 12:41:12 -05001088 return
1089}
1090
Joey Armstrongaf577ab2022-12-15 14:43:33 -05001091##----------------##
1092##---] MAIN [---##
1093##----------------##
Joey Armstrong1962bcf2023-01-27 13:53:18 -05001094iam="${0##*/}"
1095
Joey Armstrong2097d3e2023-03-26 10:32:03 -04001096full_banner
1097parse_args $@
Joey Armstrongd99e3d22023-01-29 12:35:43 -05001098init
1099install_gh_binary
Joey Armstrong7f382ef2023-01-25 12:00:08 -05001100
Joey Armstrong2097d3e2023-03-26 10:32:03 -04001101do_login
Zack Williams27cd3e52018-09-18 16:44:50 -07001102
Joey Armstrong2097d3e2023-03-26 10:32:03 -04001103release_path='/dev/null'
1104get_release_path release_path
1105declare -p release_path
Zack Williams27cd3e52018-09-18 16:44:50 -07001106
Joey Armstrong2097d3e2023-03-26 10:32:03 -04001107pushd "$release_path" || error "pushd failed: dir is [$release_path]"
Zack Williams27cd3e52018-09-18 16:44:50 -07001108
Joey Armstrong2097d3e2023-03-26 10:32:03 -04001109 # legacy: getGitVersion "$GERRIT_PROJECT" GIT_VERSION
1110 getGitVersion GIT_VERSION
1111 getReleaseDescription RELEASE_DESCRIPTION
Zack Williams27cd3e52018-09-18 16:44:50 -07001112
Joey Armstrongeef8c2c2023-03-27 17:27:43 -04001113 cat <<EOM
1114
1115** -----------------------------------------------------------------------
1116** GIT VERSION: $(declare -p GIT_VERSION)
1117** RELEASE_DESCRIPTION: $(declare -p RELEASE_DESCRIPTION)
1118** RELEASE_TARGETS: $(declare -p RELEASE_TARGETS)
Joey Armstrong43c48422023-04-03 10:17:32 -04001119** -----------------------------------------------------------------------
1120** Running: make ${RELEASE_TARGETS}
Joey Armstrongeef8c2c2023-03-27 17:27:43 -04001121** -----------------------------------------------------------------------
1122EOM
Joey Armstrong2097d3e2023-03-26 10:32:03 -04001123 # build the release, can be multiple space separated targets
1124 # -----------------------------------------------------------------------
1125 # % go build command-line-arguments:
1126 # copying /tmp/go-build4212845548/b001/exe/a.out:
1127 # open release/voltctl-1.8.25-linux-amd64: permission denied
1128 # missing: docker run mkdir
1129 # -----------------------------------------------------------------------
1130 # shellcheck disable=SC2086
Joey Armstrongeef8c2c2023-03-27 17:27:43 -04001131 make "$RELEASE_TARGETS"
Joey Armstrong2097d3e2023-03-26 10:32:03 -04001132 copyToRelease
Joey Armstrong50f6e0b2023-01-24 14:14:08 -05001133
Joey Armstrong26707f02023-01-26 12:41:12 -05001134 cat <<EOM
Joey Armstrong1962bcf2023-01-27 13:53:18 -05001135
1136** -----------------------------------------------------------------------
1137** Create the release:
1138** 1) Create initial github release with download area.
1139** 2) Generate checksum.SHA256 for all released files.
1140** 3) Upload files to complete the release.
Joey Armstrong75a0d932023-03-28 08:59:54 -04001141** 4) Display released info from github
Joey Armstrong1962bcf2023-01-27 13:53:18 -05001142** -----------------------------------------------------------------------
Joey Armstrong26707f02023-01-26 12:41:12 -05001143EOM
1144
Joey Armstrong2097d3e2023-03-26 10:32:03 -04001145 showReleases
Joey Armstrong2097d3e2023-03-26 10:32:03 -04001146 release_staging
1147 popd || error "pushd failed: dir is [$release_path]"
Joey Armstrong43c48422023-04-03 10:17:32 -04001148# fi
Joey Armstrong28eddda2023-01-10 03:09:34 -05001149
Joey Armstrong2097d3e2023-03-26 10:32:03 -04001150do_logout
1151
Joey Armstrong28eddda2023-01-10 03:09:34 -05001152# [SEE ALSO]
1153# -----------------------------------------------------------------------
1154# https://www.shellcheck.net/wiki/SC2236
Joey Armstrong26707f02023-01-26 12:41:12 -05001155# https://docs.github.com/en/rest/releases/releases?apiVersion=2022-11-28#create-a-release
Joey Armstrong28eddda2023-01-10 03:09:34 -05001156# -----------------------------------------------------------------------
Joey Armstrongf085d872023-01-28 17:52:29 -05001157# https://cli.github.com/manual/gh_help_reference
1158# https://cli.github.com/manual/gh_release
1159# -----------------------------------------------------------------------
Joey Armstrong28eddda2023-01-10 03:09:34 -05001160
1161# [EOF]