Upgrade script, additions to docs, other cleanup 🍬

[alismx]

Changes Proposed

• Minor updates to build script:

  • remove the utils directory, as it was overkill for the moment
  • name variables
  • fix reference to dibbs-query-connector

• dibbs-ecr-viewer-wizard script updates:

  • set vars for directories to be used throughout the script
  • use $HOME instead of ~/
  • rename a couple of functions to improve clarity
  • fix function calls in set_dot_vars to remove calls that set env vars don't want

• move dibbs-vm/docker/dibbs-ecr-viewer to dibbs-vm/dibbs-ecr-viewer

• update dibbs-ecr-viewer.env file to remove useless defaults

• remove deprecated docker-compose version reference from dibbs-ecr-viewer/docker-compose.yml file

• Docs improvements

  • Added some docs to the tops of the scripts in the repo
  • includes notes about using user data in AWS to set env var defaults
  • start on Azure docs

• Add hot-upgrade.sh.home script, everytime it's run:

  • This will update the DIBBS_SERVICE with the latest main branch dibbs-vm repo.
  • It'll create a backup of the previous running version
  • Copies all scripts with the .home suffix to the $HOME directory on the VM
  • Calls the latest wizard script for the service to assist in any new setup

• Update the provision script:

  • remove call to set vars, shouldn't be needed in this context, that's set by our packer vars
  • fix reference to dibbs-query-connector
  • set directory ownership of $HOME/dibbs-vm to ubuntu:ubuntu

• Packer build script:

  • fix some formatting
  • provision in the $HOME directory for ease of use

Additional Information

• 🤔
• Before merging, but after testing and review, I'll need to update the git clone references to use main instead of this branch
• I started a new pattern of adding .home to any script I want in the $HOME directory in the final build, along with a call in the hot-upgrade script that adds them and a step to provision them during the build.
  • If you want to do this differently, I'm open to chatting about it!
  • I like this approach because it means that we can add all scripts that have .home to the home directory without having to worry about knowing that those files exist, which is something that might happen if folks run the hot-upgrade script.
  • The call in the hot-upgrade script happens here: cat "$file" > "$HOME/$(basename "$file" .home)" this line removes .home from the script name.

Testing

Reviewers can verify these changes by:

• Run the following command in the root directory:
  • ./build.sh dibbs-ecr-viewer v2.0.0-beta
• Run the VM
• Check Docker containers are properly setup and after running each script
• run the ./dibbs-ecr-viewer-wizard.sh script (No sudo needed!)
• run the ./hot-upgrade.sh script (No sudo needed!)
• Run packer builds
• Poke it
• Prod it