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.

Sign up for GitHub

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

Jump to bottom

Initial instructions for release #56

Merged
merged 8 commits into from
Aug 29, 2022
Merged

Initial instructions for release #56

Changes from 2 commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
17b999d
Initial instructions for release
andresrc Jun 9, 2022
2b21ec7
Simplify usage
andresrc Jul 14, 2022
c2b8a42
Add render command and misc fixes
andresrc Jul 18, 2022
375618b
Merge branch 'main' into doc-release
andresrc Aug 17, 2022
351c16a
Address review comments and TODO
andresrc Aug 17, 2022
01c311c
Update docs/usage.md
andresrc Aug 29, 2022
29b0f4e
Update docs/usage.md
andresrc Aug 29, 2022
ea960c9
Merge branch 'main' into doc-release
andresrc Aug 29, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 27 additions & 1 deletion docs/usage.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -49,4 +49,30 @@ To be done.

## I'm the release manager

To be done.
> NOTE: This instructions are for the 0.2.0 milestone (when ready). As more features and automation is added the process will become simpler.

### Preparing the changelog

* Wait for the last BC of the release. If another BC is generated after that or a patch version for a previous minor is released, you might need to restart the process.
* Create a branch from the commit of the BC.
* From the root folder of the repository run:

```
$ elastic-agent-changelog-tool build --version x.y.z
Copy link
Collaborator Author

Choose a reason for hiding this comment

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

This command will need some additional option to specific the repository.

Copy link
Member

Choose a reason for hiding this comment

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

This is being done in #57: a --owner and --repo flags are added to this command for this purpose

Copy link
Member

Choose a reason for hiding this comment

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

This is now available

```
* This will create `./changelog.yaml`. Store it in the repository as `changelog/x.y.x.yaml`.
andresrc marked this conversation as resolved.
Show resolved Hide resolved
* From the root of the repository run:
```
$ elastic-agent-changelog-tool cleanup
```
* Commit the previous changes (consolidated changelod and removed files)
* **TODO: ** Add `render` command when available.
* Integrate the generated asciidoc fragment into your changelog. If the changelog is stored in the same repository, commit the changes in this same branch.
* Create a PR with the changes above the `x.y` branch.


### On Release Day

Once the release is given the final go on release day:
* Merge the PR created in the previous section.
* Forward-port it to the other active branches, up to `main`.