[VOL-5319] voltctl release problems
jjb/github-release/voltha.yaml
------------------------------
o Update copyright notice, add SPDX tokens.
o Edits allow 'make lint-reuse' to run cleanly.
jjb/shell/github-release/help.sh
jjb/shell/github-release/parse-args.sh
--------------------------------------
o Cosmetic edits.
o Script is growing so bulk move some functions into named libraries.
jjb/shell/github-release.sh
---------------------------
o Script edits are mostly added to improve logging and debugging.
o Replace hardcoded /bbsim/ reference in log output with /{repo}/.
Can be confusing displaying 'bbism' when voltctl is being released.
o Added debug function bannerEL() to announce function ENTER/LEAVE.
o Display function name and line number when error() is called.
o Added arg --self-verify for debugging. Perform simple credential
validation using login() & logout() VS allowing script to run.
o Added an extra case in getGitVersion(). GERRIT_PROJECT= may not
be defined while debugging interactively. Report error and
suggest fixes.
Signed-off-by: Joey Armstrong <jarmstrong@linuxfoundation.org>
Change-Id: I481b3dfa1cc323d02babb0a5df86145f49ab176f
diff --git a/jjb/shell/github-release/help.sh b/jjb/shell/github-release/help.sh
new file mode 100755
index 0000000..7e409a5
--- /dev/null
+++ b/jjb/shell/github-release/help.sh
@@ -0,0 +1,66 @@
+#!/usr/bin/env bash
+# -----------------------------------------------------------------------
+# Copyright 2018-2024 Open Networking Foundation Contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# -----------------------------------------------------------------------
+# SPDX-FileCopyrightText: 2018-2024 Open Networking Foundation Contributors
+# SPDX-License-Identifier: Apache-2.0
+# -----------------------------------------------------------------------
+# Intent:
+# builds (with make) and uploads release artifacts (binaries, etc.) to github
+# given a tag also create checksums files and release notes from the commit
+# message
+# -----------------------------------------------------------------------
+
+## ---------------------------------------------------------------------------
+## Intent: Display program usage
+## ---------------------------------------------------------------------------
+function usage()
+{
+ cat <<EOH
+
+Usage: $0
+Usage: make [options] [target] ...
+ --help This mesage
+ --pac Personal Access Token (path to containing file or a string)
+ --repo-name ex: voltctl
+ --repo-org ex: opencord
+ --release-notes [f] Release notes are passed by file argument
+
+[DEBUG]
+ --gen-version Generate a random release version string.
+ --git-hostname Git server hostname (default=github.com)
+ --version-file [f] Read version string from local version file (vs env var)
+ Assume ./VERSION if [f] not passed
+[MODES]
+ --debug Enable script debug mode
+ --draft Create a draft release (vs published)
+ --dry-run Simulation mode
+ --todo Display future enhancement list
+
+All other arguments are pass-through to the gh command.
+
+Usage: $0 --draft --repo-org opencord --repo-name voltctl --git-hostname github.com --pac ~/access.pac
+
+# Troubleshoot credentials:
+Usage: $0 --pac ~/.access.pac --verify
+
+EOH
+
+ return
+}
+
+: # assign $?=0 for source $script
+
+# [EOF]