Purpose

This issue tracks the arcade-services repository rollout. On top of the Rollout instructions described on the wiki, it provides the person responsible for the rollout checklist of the steps that need to be performed to rollout services in this repository. All relevant information, including the rollout PR, issues encountered during the rollout and steps taken to resolve them should be linked or added to this issue to keep full audit trail of changes rolled out to production.

Process

Build status check

• Check the status of the dotnet-arcade-services-weekly pipeline
• Rotate any secrets that need manual rotation
• Check the status of the arcade-services-internal-ci pipeline. Try to fix issues, if any, so that we have a green build before the rollout day.
• Check the Rollout column in the Product Construction board - move any issues rolled-out last week into Done

Rollout preparation

• Create the rollout PR:
  • Find a commit on main that you want to rollout
  • Create a branch named rollout/YYYY-MM-DD from that commit
  • Create a PR on GitHub from the rollout/YYYY-MM-DD branch to production
  • Name the PR [Rollout] Production rollout YYYY-MM-DD
  • Link this issue in the PR description
• Link the rollout PR to the Rollout PRs section of this issue
• Merge the prepared rollout PR (⚠️ DO NOT SQUASH)
• Link the rollout build to the Rollout build section of this issue
• Verify that Maestro opened a production => main PR in arcade-services with the rollout merge commit (example). There should be no changes in the PR to any files. Do not merge the PR yet.
• Ensure the build is green and stops at the Approval phase

Rollout

• Approve the Approval stage of the rollout build.
• Monitor the rollout build for failures.
  • Note: this Maestro exceptions query might help in diagnosing issues.
• Keep track of any issues encountered during the rollout either directly in this issue, or in a dedicated issue linked to this issue
• When finished, update the rollout stats in the Stats section below. The statistics will be available in Kusto a few minutes after the build was finished
• Merge the production => main PR in arcade-services (⚠️ DO NOT SQUASH)
• Move rolled-out issues/PRs in the Rollout column of the Product Construction board into Done. Verify that PRs have a reference to the release at the bottom (example). If needed, manually add a comment with the reference (example)
• Close this issue with closing comment describing a high-level summary of issues encountered during the rollout
• In case of rollback, uncomment the Rollback section below and follow the steps there

Rollout data

Rollout PRs

• The main PR: [Rollout] Production rollout 2024-12-16 #4247

Rollout build

• Rollout AzDO build: https://dev.azure.com/dnceng/internal/_build/results?buildId=2601087

Rollout times

Use the following Kusto query to gather data about rollout times:

• Pre-Approval run time: 01:11
• Post-Approval run time: 00:47

Useful links

• AzDO pipelines
  • arcade-services-internal-ci
  • dotnet-arcade-services-weekly
• Rollout channel
• Maestro exceptions
• Deployment Policy