navy-clock-prepare

Navy Order to prepare a Clock project for deployment

Usage no npm install needed!

<script type="module">
  import navyClockPrepare from 'https://cdn.skypack.dev/navy-clock-prepare';
</script>

README

Clock Prepare Order

This is an Order which is used by Captains as part of the Navy deployment suite.

It does the following actions (note, these steps will only be run on the 'master' Captain):

  • Clone a specified GIT repository to a specified prepare location OR execute a fetch on the existing GIT repository
  • Compare currently checked out branch or tag to the one we are trying to checkout. If the commit hash is the same, skip remaining steps
  • Checkout the specified GIT branch or tag
  • Initialise or update all submodule references
  • Run npm run-script setup
  • Copy prepare directory to application specfic subdirectory of the build directory
  • Run npm run-script build inside the application subdirectory
  • Clean up the application subdirectory of any non application files
  • Tar up the application subdirectory, encrypt it with a random passphrase and place in /tmp
  • Start up a HTTP server on a the port specified in the captain config and issue the ''requestBuild'' order to other Captains
  • Remove the tar file in /tmp

This order assumes that the following configuration keys have been added to the Admiral for the application you are trying to prepare:

  • repository: The URL to the GIT repository where your application is stored
  • prepareDir: Where the GIT repository should be cloned to
  • buildDir: Directory into which the prepareDir should be copied. The directory specific to your application will be a subdirectory of this directory
  • env (optional): Any custom environment variables that need to be set on build

An example Admiral application configuration might look like:

{ "name": "My Application"
, "appId": "myApp"
, "repository": "git@github.com:clocklimited/navy-clock-prepare.git"
, "prepareDir": "/tmp/my-application-prepare-dir"
, "buildDir": "/var/application"
, "env":
  { "EXAMPLE_VAR": "example env var"
  }
}

This order assumes that the following config options have been set on your Captains that will run this order

  • externalHost: host of the Captain running this order. This should be able to be used to access the Captain running this order, from other Captains

An example Captain config file might look like:

module.exports = function () {

  var config =
  { name: 'captain-one'
  , applications: { exampleAppId: [ 'staging', 'production' ] }
  , admiral: { host: '127.0.0.1', port: 8006 }
  , orderDir: __dirname + '/orders'
  , orders:
    { 'navy-clock-prepare': { command: 'prepare', config: { externalHost: '10.0.0.1', tarServerPort: 2020 } }
    }
  }

  return config
}