diff --git a/docs/ansible-release-announcement/major-release/announcement-email.md b/docs/ansible-release-announcement/major-release/announcement-email.md new file mode 100644 index 0000000000..0891d456b9 --- /dev/null +++ b/docs/ansible-release-announcement/major-release/announcement-email.md @@ -0,0 +1,81 @@ +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` + +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 to further improve installation performance and reduce the size on disk. These files are still available in the source tarball if necessary. + +The changelog for ansible-core a.b installed by this release of Ansible X can be found here: + +Collections which have opted-in to being a part of the Ansible X 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://galaxy.ansible.com or the collection source repository. For example, the community.crypto collection is available at https://galaxy.ansible.com/community/crypto and you can find a link to the source repository under the "Repo" button at the top right. + +What's the schedule for new Ansible releases after X.0.0? +--------------------------------------------------------- + +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 + +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: + + + +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 \ No newline at end of file diff --git a/docs/ansible-release-announcement/major-release/announcement-matrix b/docs/ansible-release-announcement/major-release/announcement-matrix new file mode 100644 index 0000000000..ee58554f7d --- /dev/null +++ b/docs/ansible-release-announcement/major-release/announcement-matrix @@ -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]! ❤️ + +💽You can install it by running the following command or download the [release tarball] directly from [pypi]: + +``` +pip install ansible==X.0.0 --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! +``` diff --git a/docs/ansible-release-announcement/minor-release/announcement-matrix b/docs/ansible-release-announcement/minor-release/announcement-matrix index c3dd1efdb8..4b8326ed57 100644 --- a/docs/ansible-release-announcement/minor-release/announcement-matrix +++ b/docs/ansible-release-announcement/minor-release/announcement-matrix @@ -7,20 +7,20 @@ #ansible-social: (prepended with @newsbot) #ansible-packaging #ansible-devel -#ansible: update the topic or ask @sivel to update: /msg ChanServ TOPICSWAP #ansible 6.2.0:6.3.0 +#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 8.1.0 is out](https://groups.google.com/g/ansible-announce/c/iN-qliVQTbU)! ❤️ +[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 directly from [pypi](https://files.pythonhosted.org/packages/87/d7/322dd9d88261e56862ade2f9b9c125d0de648857e755d7177500272d2e05/ansible-8.1.0.tar.gz): +💽You can install it by running the following command or download the [release tarball](link relase tarball from PyPI ) directly from [pypi](https://pypi.org/project/ansible/): ``` -pip install ansible==8.1.0 --user +pip install ansible==x.y.z --user ``` -➡️ Check [Release Notes📦️🗒️](https://github.com/ansible-community/ansible-build-data/blob/main/8/CHANGELOG-v8.rst) and [Ansible 8 Porting Guide](https://docs.ansible.com/ansible/devel/porting_guides/porting_guide_8.html) for more details! +➡️ 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! ``` diff --git a/docs/ansible-release-announcement/pre-release/announcement-matrix b/docs/ansible-release-announcement/pre-release/announcement-matrix new file mode 100644 index 0000000000..d5b663cab8 --- /dev/null +++ b/docs/ansible-release-announcement/pre-release/announcement-matrix @@ -0,0 +1,14 @@ +## Matrix + +Communicate to the community msg at the Ansible Community Working Group matrix room. So the community is aware and can be ready that you might cry for help during that hour. + +## Pre release announcemnet : Message the following Matrix rooms after the release + + +#ansible-community +#ansible-packaging + + +``` +📯📯📯 I am working on the `Ansible X.O.O` Release with Ansible core a.b.0` now. I will keep the room updated about the progress.📦️ +```