Create Releases

Create a new release

1. Complete all merges.
2. Review/Update folders.
   • builds - Newly successful log files for all deployments.
   • docs - Complete review.
3. Create Release Notes (ex. diff/V1.0/Release_Notes.txt).
   • Release Notes Format:

     # V1.0 Release Notes
     
     ## Overview:
     
     ## Upgrade Procedure
     
     ## Downgrade Procedure
     

   • Generate Overview

     git fetch --all
     git log V0.0..main --pretty=format:"%s" | sort -u
     

   • Add Procedures
4. Create "diff" Scripts
   • Create Sub-Folders
     • Upgrade from (ex. diff/V1.0/Upgrade_from_V0.0)
     • Downgrade to (ex. diff/V1.0/Downgrade_to_V0.0)
   • diff script details

     git diff --name-only V0.0..main | grep -Ev '^builds/.*/.*(log|xml)$'
     git diff -w V0.0..main <file-name>
     

   • Test diff scripts
5. Update Version in Source Code
   • "odbcapture_version" PL/SQL function.

     sed -i "1,\$s/^   return ['].*['][;]\$/   return 'V1.0';/1" "grbsrc/ODBCAPTURE/ODBCAPTURE_VERSION.func"
     

   • "odbcapture_installation_logs.ctl" files in each of the Build Type Folders.

     sed -i '1,$s/ CONSTANT ".*"/ CONSTANT "V1.0"/1' grb*/odbcapture_installation_logs.ctl
     

6. Zip the following files/folders from "main" branch (ex. "ODBCapture_V1.0.zip").
   • diffs/
   • grb_linked_install_scripts/
   • grbjava/
   • grbras/
   • grbsdo/
   • grbsrc/
   • grbxrep/
   • LICENSE
   • README.md
7. Go to https://github.com/DDieterich/ODBCapture.
   1. Under Releases on the right, click "Create a new release".
   2. Create a New Tag (ex. "V1.0").
   3. Confirm Target is "Main".
   4. Set the Title "Initial Release V1.0".
   5. Add Description "Initial release V1.0 of Oracle DB Capture".
   6. Upload "ODBCapture_v1.0.zip".
   7. Check "Create a discussion for this release.
   8. Set discussion category to "Announcements".
   9. Click "Publish Release".