From f84681234f0101ffdd0d0c4d6ecb675f0d503ea5 Mon Sep 17 00:00:00 2001
From: Terry Brady <terrywbrady@gmail.com>
Date: Wed, 26 Jun 2024 12:14:29 -0700
Subject: [PATCH] Create tagging.md

---
 design/aws-build/tagging.md | 48 +++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 design/aws-build/tagging.md

diff --git a/design/aws-build/tagging.md b/design/aws-build/tagging.md
new file mode 100644
index 0000000..d849966
--- /dev/null
+++ b/design/aws-build/tagging.md
@@ -0,0 +1,48 @@
+# CodeArtifact Tagging for Merritt
+
+## Merritt JAR Versioning
+
+- Non-breaking changes SHOULD NOT update snapshot versions.
+- Breaking changes SHOULD update snapshot versions.
+  - This will necessitate update of SNAPSHOT references in our 5 java services.
+  - Consider registring Merritt JAR versions in the BOM files.
+ 
+## Update JAR Version
+
+```
+bash-4.2$ pwd
+/apps/dpr2/merritt-workspace/tbrady/merritt-docker/mrt-services/dep_zk/mrt-zk
+bash-4.2$ mvn release:update-versions
+[INFO] Scanning for projects...
+[INFO] 
+[INFO] ---------------------< org.cdlib.mrt.zk:MerrittZK >---------------------
+[INFO] Building Test 1.0
+[INFO] --------------------------------[ jar ]---------------------------------
+[INFO] 
+[INFO] --- maven-release-plugin:2.5.3:update-versions (default-cli) @ MerrittZK ---
+What is the new development version for "Test"? (org.cdlib.mrt.zk:MerrittZK) 1.1-SNAPSHOT: : 
+```
+
+Check in POM change to github.
+
+## Update WAR Version
+
+WAR file snapshot changes can be updated as listed above.
+
+## WAR File Tagged Release
+
+In `buildspec.yml`, change
+
+```
+      - mvn deploy:deploy-file -Durl=${CODEARTIFACT_URL} -DrepositoryId=cdlib-uc3-mrt-uc3-mrt-java -Dfile=audit-it/target/mrt-audit-it-1.0-SNAPSHOT.war
+      - mvn deploy:deploy-file -Durl=${CODEARTIFACT_URL} -DrepositoryId=cdlib-uc3-mrt-uc3-mrt-java -Dfile=audit-war/target/mrt-auditwarpub-1.0-SNAPSHOT.war
+```
+
+TO
+
+```
+      - mvn deploy:deploy-file -Durl=${CODEARTIFACT_URL} -DrepositoryId=cdlib-uc3-mrt-uc3-mrt-java -Dfile=audit-it/target/mrt-audit-it-1.0-SNAPSHOT.war -Dversion=2.0.0
+      - mvn deploy:deploy-file -Durl=${CODEARTIFACT_URL} -DrepositoryId=cdlib-uc3-mrt-uc3-mrt-java -Dfile=audit-war/target/mrt-auditwarpub-1.0-SNAPSHOT.war -Dversion=2.0.0
+```
+
+TODO: can we trigger the insertion of the version if a new tag is created?