External-Mirrors/awx
2
0
Fork 0
mirror of https://github.com/ansible/awx.git synced 2026-01-10 15:32:07 -03:30
Code Issues Packages Projects Releases Wiki Activity
awx/docs/release_process.md
Alex Corey ddbd143793 Adds more detail to the AWX release notes
2022-01-26 09:52:40 -05:00

3.4 KiB
Raw Blame History

Releasing AWX (and awx-operator)

The release process for AWX is completely automated as of version 19.5.0.

Get latest release version and list of new work

  1. Get latest version of AWX
  2. Get latest version of AWX Operator.
  3. Compare latest against devel

Comparing Branches

The page will automatically update with a list of PRs that are in AWX/devel but not in latest.

PR Compare List

Use this list of PRs to decide if this is a Y-stream (minor) release, or a Z-stream release (patch). Use semver to help determine what kind of release is needed. Indicators of a Z-stream release:

  • No significant new features have been merged into devel since the last release.

Staging the release

To stage the release, maintainers of this repository can run the Stage Release workflow. To start the workflow, follow this series of events:

  1. Click "Actions" in the top nav bar on the repository
  2. Click "Stage Release" in the left nav menu
  3. Click the "Run workflow" dropdown
  4. Populate the inputs.
  5. Click the "Run workflow" button

If the latest release of AWX is 19.5.0:

  • Y-stream release version will be 19.6.0.
  • Z-stream release version will be 19.5.1.

With very few exceptions the new AWX Operator release will always be a Y-stream release.

For AWX-Operator release version:

Staging AWX

This workflow will:

  • Build awx from devel
  • Build awx-operator from devel
  • Run smoke tests
  • Create a draft release for both ansible/awx and ansible/awx-operator

Once complete, navigate to the Releases page for AWX and verify things look ok. The changelog is automatically generated using the special comment in our Pull Request template. If things look ok, click the pencil icon on the draft:

Verify draft release

Next, click "Publish Release":

Publish release

This will not take long. Once this is complete go to AWX-Operator release page to verify and then publish the draft release following the same steps as above.

Once the release is published, another workflow called Promote Release will start running:

Promote release

Once it finished, verify that the new image is present on the Repository Tags on Quay:

Verify released AWX image

Once the AWX image is live, go to the Releases page for awx-operator and follow the same process to publish the release. Once published, the workflow Promote AWX Operator image will run.

Once complete, verify the image is on the awx-operator Quay repository:

Verify released awx-operator image