feat: support recording deployments

[bethesque]

• Support querying can-i-deploy with an environment name
  • The Pact CLI now supports (not yet released) pact-broker can-i-deploy --pacticipant Foo --version 1 --to-environment test
• Support recording deployments
  • to be called via Pact CLI as pact-broker record-deployment --pacticipant Foo --version 1 --environment test (not yet written).
  • The endpoint to call to record the deployment is available in the pacticipant version relations (the pb:record-deployment relation with the matching environment name).
  • By default, the CLI will assume that the current deployment replaces the previous, and send { replacedPreviousDeployedVersion: true } with the "record deployment" post request, and the previous deployed version will be marked as undeployed in the broker.
  • When --no-replace-previous-deployed-version is specified in the CLI, the call to record the deployment will specify { replacedPreviousDeployedVersion: false } and the previous deployed version will not be marked as undeployed.
  • This will allow us to
    • know exactly which versions of an app are in an environment (unlike tags, where we don't know if "all prod" or "latest prod" are currently deployed).
    • measure the time between deployments to provide better metrics
• Update the matrix UI to show the environment field
• Seed the broker on start up with "test" and "production" environments
• Update the seeded data to have deployments as well as tags (todo: remove the tags once the UI is done)

Next

• show the environments in the index/matrix pages
• provide a migration path from tags to deployed versions (mostly so we can get retrospective data in PF).

[uglyog]

Not using the pacticipant?

[bethesque]

Well spotted - that's a dummy method for Pactflow to override by supplying a different service. In the OSS version, any pacticipant can deploy to any environment (mostly because I don't want to have to develop a configuration page 😆 ), but in Pactflow, I envisage us supporting assigning particular environments to pacticipants.

[mefellows]

I didn't look at the code Beth, but I can agree that this is awesomeness.

[bethesque]

It's ok, Ron's got the 🦅 eyes. Just wanted to get you across the upcoming features.