Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

New Unstable "Test" Release

Prerequisites:

  • Pull request has been created containing the changes to be reviewed / tested
  • Ensure that associated JIRA ticket
  • Ensure documentation in Confluence is up-to-date
  • Checkout your feature branch
    • git checkout master
  • Sync with upstream
    • git pull upstream master
    • git push origin master
  • Update ALL documentation in GitHub

Process:

  • Create Pull Request on GitHub
  • Build new docker images from PR branch
    • API: docker build -t ndslabs/apiserver:NDS-123 . && docker push ndslabs/apiserver:NDS-123
    • GUI: ./build.sh -c && ./release.sh NDS-123 -t
  • Tag / push new image to DockerHub (issue tag: push, latest: don't push)Commit and push new build version / date(s) to upstream master on GitHub
  • Mark ticket as "In Review" and assign to tester

New Stable "Latest" Release

Prerequisites:

  • Any related PRs have been merged to master
  • Ensure that smoke test passes
  • Ensure documentation in Confluence is up-to-date
  • Checkout your master branch
    • git checkout master
  • Sync with upstream
    • git pull upstream master
    • git push origin master
  • Update ALL documentation in GitHub

...

  • Roll forward version numbers in source code and ensure that all values match:
    • Swagger API
      • apis/swagger-spec/ndslabs.yaml: NDS Labs swagger API spec version number
    • API Server:
      • apiserver/build.sh: NDS Labs API Server Docker image version tag
      • apiserver/version.go: NDS Labs API / Server version number
    • CLI Client:
      • apictl/build.sh: NDS Labs CLI version number
      • apictl/cmd/clientVersion.go: NDS Labs CLI / API version number
    • UI Client:
      • gui/Dockerfile.ndslabs-gui: NDS Labs UI / webserver Docker image version tag
      • gui/js/package.json: NDS Labs UI  / webserver NPM package version number
      • gui/js/bower.json: NDS Labs UI Angular app Bower package version number
      • gui/js/app/app.js: NDS Labs UI Angular app build version number
  • Regenerate Swagger API / Client from spec (if the spec has changed)
    • apiserver/???: generated Go swagger server
    • gui/js/app/shared/api.js: generated AngularJS swagger client 
  • Build new Docker images from master branch
    • API: ./build.sh build && ./build.sh release
    • GUI: ./build.sh -c && ./release.sh version-number
  • Tag / push new images to DockerHub (version tag: push, latest: push)
  • Commit and push new build version / date(s) to upstream master on GitHub
  • Create a new tag in GtiHub for the new version