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

Adds directories & email announcement for minor release #258

Closed
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
22 commits
Select commit Hold shift + click to select a range
bdf4a78
Adds directories & email announcement for minor release
anweshadas Jun 28, 2023
51dac9d
Adds the annoucements for minor and major releases
anweshadas Jul 4, 2023
327d0b0
Adds email and Matrix annoucements
anweshadas Jul 13, 2023
18e54b3
Reverts back to the old draft
anweshadas Jul 13, 2023
cb11c6d
Edits the release announcement
anweshadas Jul 13, 2023
2ff10e0
Update docs/ansible-release-announcement/major-release/announcement-m…
anweshadas Jul 27, 2023
3a2549d
Update docs/ansible-release-announcement/major-release/announcement-m…
anweshadas Jul 27, 2023
2fbd4c1
Update docs/ansible-release-announcement/minor-release/announcement-m…
anweshadas Jul 27, 2023
11800e9
Update docs/ansible-release-announcement/major-release/announcement-e…
anweshadas Aug 15, 2023
62a7dc5
Update docs/ansible-release-announcement/major-release/announcement-e…
anweshadas Aug 15, 2023
f97c104
Update docs/ansible-release-announcement/major-release/announcement-e…
anweshadas Aug 15, 2023
c0f23f0
Update docs/ansible-release-announcement/minor-release/announcement-e…
anweshadas Aug 15, 2023
d3c6031
Update docs/ansible-release-announcement/minor-release/announcement-e…
anweshadas Aug 15, 2023
af1a9d8
Update docs/ansible-release-announcement/minor-release/announcement-e…
anweshadas Aug 15, 2023
527eb39
Update docs/ansible-release-announcement/major-release/announcement-e…
anweshadas Aug 15, 2023
13c7116
Update docs/ansible-release-announcement/major-release/announcement-e…
anweshadas Aug 15, 2023
5a1e213
Update docs/ansible-release-announcement/major-release/announcement-e…
anweshadas Aug 15, 2023
f681432
Update docs/ansible-release-announcement/minor-release/announcement-e…
anweshadas Aug 15, 2023
919869f
Updates based on feedback
anweshadas Aug 15, 2023
34c5513
Updates based on feedback
anweshadas Aug 15, 2023
f86f4a4
Adds Forum post & joinig info in the email
anweshadas Sep 14, 2023
9a95c27
Adds & edits the announcement-emails
anweshadas Sep 28, 2023
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
Original file line number Diff line number Diff line change
@@ -0,0 +1,88 @@
Release announcement : Ansible Community Package X.0.0

Hello everyone,

We're happy to announce the release of the Ansible X.0.0 package!

Ansible X.0.0 contains latest version of ansible-core a.b and includes a curated set of Ansible collections that provides a vast number of modules and plugins. This is a major release of Ansible.

ansible-core is a required dependency, not contained within the ansible packages.

The "ansible" distribution
--------------------------

This release is available on PyPI and can be installed with pip:

`$ python3 -m pip install ansible==X.0.0 --user`
Copy link
Member

Choose a reason for hiding this comment

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

Instead of inline, use a code block with proper lexer:

Suggested change
`$ python3 -m pip install ansible==X.0.0 --user`
```console
$ python3 -m pip install ansible==X.0.0
```

Also I wouldn't steer newbies towards --user. In general, offering a pipx command would be a better idea since it manages per-app venvs automatically.


The source and the wheel for this release can be found here:

Release tarball:


SHA256:


Wheel package:


SHA256:


Some important details
----------------------

Python wheels are available for both Ansible X and ansible-core a.b.

In addition, Ansible x no longer installs some unnecessary files from the included Ansible collections such as tests or hidden files and directories. This further improves installation performance and reduces the size on disk. These files are still available in the source tarball if needed.


Collections which have opted-in to being a part of the Ansible 8 unified changelog will have an entry on this page:

For collections which have not opted-in to the unified changelog, you may find more information on https://docs.ansible.com/ansible/latest/collections or the collection source repository. For example, the community.crypto collection is available at https://docs.ansible.com/ansible/latest/collections/community/crypto/index.html and you can find a link to the source repository under the "Repository(Sources)" button.

The changelog for ansible-core a.b installed by this release of Ansible X can be found here: <changelog of ansible-core>.

Copy link
Contributor

Choose a reason for hiding this comment

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

Seems to me the changelogs for Ansible X include the core changelogs. So perhaps these two sentences should be switched to say the collection that opted in blablabla changelog is at .
And then the second sentence states this changelog also includes the core changelogs?


Copy link
Contributor

Choose a reason for hiding this comment

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

This is a nit/discussion point - I think all collections in the package have a link to the repository on the docsite now. Do we want to switch the wording to point to that instead of galaxy?

image

What's the schedule for new Ansible releases after X.0.0?
---------------------------------------------------------

The next release roadmap can be found at https://docs.ansible.com/ansible/devel/roadmap/ansible_roadmap_index.html

Subscribe to the Bullhorn for all future release dates, announcements, and Ansible contributor community news.

anweshadas marked this conversation as resolved.
Show resolved Hide resolved
Visit this link to subscribe: https://bit.ly/subscribe-bullhorn

You can find all past Bullhorn issues on the official wiki page:
https://github.com/ansible/community/wiki/News#the-bullhorn


Join our new Ansible Community Forum to follow along and participate in all the discssions release related discussions and announcements. Feel free to share your thoughts, ideas and concerns in there.

Register here to join the Ansible Forum:

https://forum.ansible.com

Porting Help
------------

A unified porting guide for collections that have opted-in is available here:
https://docs.ansible.com/ansible/devel/porting_guides/porting_guide_X.html

Getting collection updates from Ansible X with older releases of ansible-core
-----------------------------------------------------------------------------

Ansible X includes ansible-core a.b. Based on your requirements, you can get collection updates as they ship in the Ansible "batteries included" package while continuing to use older versions of ansible-core.

An ansible-galaxy requirements file based on the collections from Ansible X has been made available for this use case:
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
An ansible-galaxy requirements file based on the collections from Ansible X has been made available for this use case:
See the ansible-galaxy requirements file based on the collections from Ansible X for this use case:


<https://github.com/ansible-community/ansible-build-data/blob/main/X/galaxy-requirements.yaml>

After you download the requirements file, the collections can be installed by running this command:
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
After you download the requirements file, the collections can be installed by running this command:
After you download the requirements file, you can install the collections by running the following command:


"ansible-galaxy collection install -r galaxy-requirements.yaml"

On behalf of the Ansible community, thank you and happy automating!

Cheers
Ansible Community Team
Copy link
Contributor

Choose a reason for hiding this comment

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

Possibly too soon to make a change, but given we're opening the release up, maybe this should be either Ansible Release Managers or just Ansible community?

Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
## Matrix

## Post release announcemnet : Message the following Matrix room after the release


#ansible-community
#ansible-social: (prepended with @newsbot)
#ansible-packaging
#ansible-devel
#ansible: update the topic or ask @sivel to update: /msg ChanServ TOPICSWAP #ansible x.y.z:X.0.0
#ansible: same message, but only required for major versions of ansible community


## Red Hat Ansible Slack #general

```
[Ansible X.0.0 is out](insert link from the google group ansible-announce : https://groups.google.com/g/ansible-announce)! ❤️

💽 You can install it by running the following command or download the [release tarball](link to release tarball from PyPI) directly from [pypi](https://pypi.org/project/ansible/):

```
pip install ansible==X.0.0 --user
Copy link
Member

Choose a reason for hiding this comment

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

Same sentiment regarding the block highlighting, --user and pipx.

```

➡️ Check [Release Notes📦️🗒️](https://github.com/ansible-community/ansible-build-data/blob/main/X/CHANGELOG-vx.rst) and [Ansible X Porting Guide](https://docs.ansible.com/ansible/devel/porting_guides/porting_guide_X.html) for more details!
```
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
Release announcement : Ansible Community Package X.0.0



We're happy to announce the release of the Ansible X.0.0 package!

Ansible X.0.0 requires latest version of ansible-core a.b and includes a curated set of Ansible collections that provides a vast number of modules and plugins. This is a major release of Ansible.

ansible-core is a required dependency, not contained within the ansible packages. Pip install builds the
dependency, but it can be built and installed quite independently of the "ansible" distribution.

The "ansible" distribution
--------------------------

This release is available on PyPI and can be installed with pip:

`$ python3 -m pip install ansible==X.0.0 --user`

The sources for this release can be found here:

Release tarball:


SHA256:


Wheel package:


SHA256:


On behalf of the Ansible community, thank you and happy automating!
Original file line number Diff line number Diff line change
@@ -0,0 +1,90 @@
Release announcement : Ansible Community Package X.0.0

Hello everyone,

We're happy to announce the release of the Ansible X.0.0 package!

Ansible X.0.0 requires latest version of ansible-core a.b and includes a curated set of Ansible collections that provides a vast number of modules and plugins. This is a major release of Ansible.

ansible-core is a required dependency, not contained within the ansible packages. Pip install builds the
dependency, but it can be built and installed quite independently of the "ansible" distribution.

How to get it
-------------

This release is available on PyPI and can be installed with pip:

`$ python3 -m pip install ansible==X.0.0 --user`
Copy link
Member

Choose a reason for hiding this comment

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

Same as above.


The sources for this release can be found here:

Release tarball:


SHA256:



Wheel package:



SHA256:



Some important details
----------------------

Python wheels are now available for both Ansible X and ansible-core a.b resulting in significantly improved installation performance.

In addition, Ansible x no longer installs some unnecessary files from the included Ansible collections such as tests or hidden files and directories. This further improves installation performance and reduces the size on disk. These files are still available in the source tarball if needed.

Collections which have opted-in to being a part of the Ansible 8 unified changelog will have an entry on this page:

For collections which have not opted-in to the unified changelog, you may find more information on https://docs.ansible.com/ansible/latest/collections or the collection source repository. For example, the community.crypto collection is available at https://docs.ansible.com/ansible/latest/collections/community/crypto/index.html and you can find a link to the source repository under the "Repository(Sources)" button.

The changelog for ansible-core a.b installed by this release of Ansible X can be found here: <changelog of ansible-core>.


anweshadas marked this conversation as resolved.
Show resolved Hide resolved
What's the schedule for new Ansible releases after X.0.0?
---------------------------------------------------------
Copy link
Member

Choose a reason for hiding this comment

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

RST syntax in Markdown?

Copy link
Contributor

Choose a reason for hiding this comment

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

This is actually MarkDown (CommonMark): https://spec.commonmark.org/0.31.2/#setext-headings


anweshadas marked this conversation as resolved.
Show resolved Hide resolved
The next release roadmap can be found at https://docs.ansible.com/ansible/devel/roadmap/ansible_roadmap_index.html

Subscribe to the Bullhorn for all future release dates, announcements, and Ansible contributor community news.

Visit this link to subscribe: https://bit.ly/subscribe-bullhorn

You can find all past Bullhorn issues on the official wiki page:
https://github.com/ansible/community/wiki/News#the-bullhorn

Join our new Ansible Community Forum to follow along and participate in all the discssions release related discussions and announcements. Feel free to share your thoughts, ideas and concerns in there.

Register here to join the Ansible Forum:

https://forum.ansible.com

Porting Help
------------

A unified porting guide for collections that have opted-in is available here:
https://docs.ansible.com/ansible/devel/porting_guides/porting_guide_8.html

Getting collection updates from Ansible X with older releases of ansible-core
-----------------------------------------------------------------------------

Ansible X includes ansible-core a.b. Based on your requirements, you can get collection updates as they ship in the Ansible "batteries included" package while continuing to use older versions of ansible-core.
Copy link
Contributor

Choose a reason for hiding this comment

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

When the time comes and the group decides on a better way to phrase the ansible-core dependency, this is another place to update it.


An ansible-galaxy requirements file based on the collections from Ansible X has been made available for this use case:

<https://github.com/ansible-community/ansible-build-data/blob/main/8/galaxy-requirements.yaml>

After you download the requirements file, the collections can be installed by running this command:

"ansible-galaxy collection install -r galaxy-requirements.yaml"

On behalf of the Ansible community, thank you and happy automating!

Cheers
Ansible Community Team
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
## Matrix

## Post release announcemnet : Message the following Matrix room after the release


#ansible-community
#ansible-social: (prepended with @newsbot)
#ansible-packaging
#ansible-devel
#ansible: update the topic or ask @sivel to update: /msg ChanServ TOPICSWAP #ansible x.y.0:x.y.z
#ansible: same message, but only required for major versions of ansible community


## Red Hat Ansible Slack #general

```
[Ansible x.y.z is out](insert link from the google group ansible-announce : https://groups.google.com/g/ansible-announce)! ❤️

💽 You can install it by running the following command or download the [release tarball](link to release tarball from PyPI) directly from [pypi](https://pypi.org/project/ansible/):

```
pip install ansible==x.y.z --user
```

➡️ Check [Release Notes📦️🗒️](https://github.com/ansible-community/ansible-build-data/blob/main/x/CHANGELOG-vx.rst) and [Ansible x Porting Guide](https://docs.ansible.com/ansible/devel/porting_guides/porting_guide_x.html) for more details!
```
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
Release announcement : Ansible Community Package X.c.0



We're happy to announce the release of the Ansible X.c.0 package!

Ansible X.c.0 requires latest version of ansible-core a.b and includes a curated set of Ansible collections that provides a vast number of modules and plugins.

ansible-core is a required dependency, not contained within the ansible packages. Pip install builds the
dependency, but it can be built and installed quite independently of the "ansible" distribution.

The "ansible" distribution
--------------------------

This release is available on PyPI and can be installed with pip:

`$ python3 -m pip install ansible==X.c.0 --user`

The sources for this release can be found here:

Release tarball:


SHA256:


Wheel package:


SHA256:


On behalf of the Ansible community, thank you and happy automating!
Original file line number Diff line number Diff line change
@@ -0,0 +1,88 @@
Release announcement : Ansible Community Package X.0.0a1 (Pre Release)

Hello everyone,

We're happy to announce the release of the Alpha release of Ansible X.0.0a1!

This pre-release version contains the latest version of ansible-core a.b and includes a curated set of Ansible collections that provides a vast number of modules and plugins.

ansible-core is a required dependency, not contained within the ansible packages.

How to get it?
--------------

This release is available on PyPI and can be installed with pip:

`$ python3 -m pip install ansible==X.0.0a1 --user`

The source and the wheel for this release can be found here:

Release tarball:


SHA256:


Wheel package:


SHA256:


Some important details
----------------------

Python wheels are available for both Ansible X and ansible-core a.b.

In addition, Ansible x no longer installs some unnecessary files from the included Ansible collections such as tests or hidden files and directories. This further improves installation performance and reduces the size on disk. These files are still available in the source tarball if needed.


Collections which have opted-in to being a part of the Ansible 8 unified changelog will have an entry on this page:

For collections which have not opted-in to the unified changelog, you may find more information on https://docs.ansible.com/ansible/latest/collections or the collection source repository. For example, the community.crypto collection is available at https://docs.ansible.com/ansible/latest/collections/community/crypto/index.html and you can find a link to the source repository under the "Repository(Sources)" button.

The changelog for ansible-core a.b installed by this release of Ansible X can be found here: <changelog of ansible-core>.


What's the schedule for new Ansible releases after X.0.0a1?
---------------------------------------------------------

The next release roadmap can be found at https://docs.ansible.com/ansible/devel/roadmap/ansible_roadmap_index.html

Subscribe to the Bullhorn for all future release dates, announcements, and Ansible contributor community news.

Visit this link to subscribe: https://bit.ly/subscribe-bullhorn

You can find all past Bullhorn issues on the official wiki page:
https://github.com/ansible/community/wiki/News#the-bullhorn


Join the new Ansible Community Forum to follow along and participate in all the discssions release related discussions and announcements. Feel free to share your thoughts, ideas and concerns in there.

Register here to join the Ansible Forum:

https://forum.ansible.com

Porting Help
------------

A unified porting guide for collections that have opted-in is available here:
https://docs.ansible.com/ansible/devel/porting_guides/porting_guide_X.html

Getting collection updates from Ansible X with older releases of ansible-core
-----------------------------------------------------------------------------

Ansible X includes ansible-core a.b. Based on your requirements, you can get collection updates as they ship in the Ansible "batteries included" package while continuing to use older versions of ansible-core.

An ansible-galaxy requirements file based on the collections from Ansible X has been made available for this use case:

<https://github.com/ansible-community/ansible-build-data/blob/main/X/galaxy-requirements.yaml>

After you download the requirements file, the collections can be installed by running this command:

"ansible-galaxy collection install -r galaxy-requirements.yaml"

On behalf of the Ansible community, thank you and happy automating!

Cheers
Ansible Community Team
Loading