Merge branch 'ggillies/add-deploy-environment-docs' into 'master'

Add initial draft of runbook to deploy to a specific environment

See merge request !438

README.md

@@ -92,6 +92,7 @@ general process overview and specific documentation for different stakeholders.
 - [How to deploy risky MRs in isolation](general/deploy/deploying-risky-mrs-in-isolation.md)
 - [How to speed the auto-deploy process for urgent merge requests?](runbooks/how_to_speed_auto_deploy_process_for_urgent_merge_requests.md)
 - [Evaluate Deployment health](runbooks/evaluate-deployment-health-metrics.md)
+- [How to deploy to a single environment](runbooks/how_to_deploy_to_a_single_environment?)
 
 ## Glossary
 - [Deployment related terminology](general/deploy/glossary.md)

runbooks/deploy-to-a-single-environment.md

+# How to deploy to a single environment?
+
+This runbook aims to cover the use cases where our coordinated pipelines
+are not functioning correctly but an urgent deployment needs to bypass the
+failure. In this case, you would manually deploy a specific package to an environment.
+
+## Pre-deploy considerations
+
+* Packages on `gstg` and `gprd` should be kept in sync, if you need to manually deploy 
+to one of these environments, it'd be required to also deploy to other one as well.
+* When deploying to a canary environment, make sure [canary is undrained] so
+that QA tests are accurately using the canary stage.
+
+## Deploying to a single environment
+
+1. Identify the auto-deploy package version you wish to deploy. You can grab the package
+  from the `#announcements` channel.
+2. Use chatops to deploy to a single environment:
+
+| Environment | ChatOps command |
+| --- | --- |
+| staging           | `/chatops run deploy 14.9.202203101220-571badda7c4.4e8301d17e3` |
+| staging-canary    | `/chatops run deploy --canary 14.9.202203101220-571badda7c4.4e8301d17e3` |
+| production        | `/chatops run deploy --production 14.9.202203101220-571badda7c4.4e8301d17e3` | 
+| canary-production | `/chatops run deploy --production --canary 14.9.202203101220-571badda7c4.4e8301d17e3` |
+| pre               | `/chatops run deploy 14.9.202203101220-571badda7c4.4e8301d17e3 --pre`|
+| release           | `/chatops run deploy 14.8.3-ee.0 --release` 
+
+[canary is undrained]: https://about.gitlab.com/handbook/engineering/infrastructure/environments/canary-stage/#re-enabling-canary-stage-in-an-environment