Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Documentation updates for Active/Standby #1994

Merged
merged 3 commits into from
Jul 9, 2020

Conversation

shreddedbacon
Copy link
Member

Checklist

  • Affected Issues have been mentioned in the Closing issues section
  • Documentation has been written/updated
  • PR title is ready for changelog and subsystem label(s) applied

Some updates for the active/standby documentation

Closing issues

Put closes #XXXX in your comment to auto-close the issue that your PR fixes (if such).

@shreddedbacon shreddedbacon marked this pull request as ready for review June 25, 2020 00:59
@shreddedbacon shreddedbacon added the 7-documentation-examples Documentation & Examples / DX subsystem label Jun 25, 2020

## Notes

When the active/standby trigger has been executed, the `productionEnvironment` and `standbyProductionEnvironments` will switch within the Lagoon API. Both environments are still classed as `production` environment types. We use the `productionEnvironment` to determine which one is labelled as `active`.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe we should link to the Environment Types page and say something like "for more information on the difference between production and development environments, read the documentation on environment types." I'm worried this could be confusing otherwise.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ahh good idea :D I will make some changes.

@@ -6,7 +6,7 @@ Lagoon supports Active/Standby (also known as blue/green) deployments.
To change an existing project to support active/standby you'll need to configure some project settings in the Lagoon API
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Need some periods after these first 3 sentences, a little hard to read.

@@ -52,10 +53,14 @@ production_routes:

> Note: Any routes that are under the section `environments.<branch>.routes` will not be moved as part of active/standby, these routes will always be attached to the environment as defined. Ensure that if you do need a specific route to be migrated during an active/standby switch, that you remove them from the `environments` section and place them under the `production_routes` section specific to if it should be an `active` or `standby` route.

## Triggering a switch event
## Triggering the active/standby switch
### via the UI
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Screenshot?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The current button is very much an interim feature while we wait to get some UX over it to determine the best way to implement the switch.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Got it.

@@ -52,10 +53,14 @@ production_routes:

> Note: Any routes that are under the section `environments.<branch>.routes` will not be moved as part of active/standby, these routes will always be attached to the environment as defined. Ensure that if you do need a specific route to be migrated during an active/standby switch, that you remove them from the `environments` section and place them under the `production_routes` section specific to if it should be an `active` or `standby` route.

## Triggering a switch event
## Triggering the active/standby switch
### via the UI
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Got it.

@Schnitzel Schnitzel added this to the v1.8.0 milestone Jul 9, 2020
@Schnitzel Schnitzel merged commit c9d7855 into uselagoon:master Jul 9, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
7-documentation-examples Documentation & Examples / DX subsystem
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants