From 966df5e1888ccade1182959bb0cda789eb01ebd2 Mon Sep 17 00:00:00 2001 From: Anwesha Das Date: Wed, 13 Dec 2023 13:49:56 +0100 Subject: [PATCH 01/15] Adds basic release_process for community ee Adds docs directory. Adds basic release-process for community-ee-base image. --- docs/release_process.md | 237 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 237 insertions(+) create mode 100644 docs/release_process.md diff --git a/docs/release_process.md b/docs/release_process.md new file mode 100644 index 0000000..5fcc9af --- /dev/null +++ b/docs/release_process.md @@ -0,0 +1,237 @@ +## Release Cadence + +Community EE is to be built and published on the next day and/or the day after ansible-core is released. + +## EE tag versioning + +Versioning would be the core tag + a patch number, e.g + + - EE with core `2.15.2` comes out -> `community-ee:2.15.2-1` + - EE with core `2.15.3` comes out -> `community-ee:2.15.3-1` + + +## Dependencies + +- Podman/Docker + +## Credentials + +- Access to https://github.com/ansible/ansible repo +- Access to ghcr.io + + +## Build steps for Community-ee-base + +1. Go to the working directory + +`cd images/execution-environments/community-ee-base` + +2. List images in local storage + +`podman images` + +3. Delete the existing community-ee base and fedora images + +``` +podman rmi +podman rmi +``` +4. Create a virtual environment + +``` +python3 -m venv .venv +source .venv/bin/activate +``` +5. Install `ansible-builder` and `setuptools` + +``` +python3 -m pip install ansible-builder +python3 -m pip install setuptools +``` + +6. Pull the latest feodra image + +`podman pull fedora:latest` + +7. Build the ansible community-ee-base podman image with ansible-builder. (versioning : 2.16.1-1) + +`ansible-builder build --tag ghcr.io/ansible-community/community-ee-base:` + +8. Check if the image has been created or not and get the < image ID> of `community-ee-base` + +`podman images` + +9. Build latest tag for the community-ee-base image + +`podman tag ghcr.io/ansible-community/community-ee-base:latest` + +10. Create the Github token + +Go to Github UI and create Personal Token (classic). + +Select `write:packages` scope while creating the token. +Copy the token from Github UI and then pass the token on the following command. + + +11. Login to Github Registry + +`echo TOKEN | podman login ghcr.io -u USERNAME --password-stdin` + +12. Push both the images (general versioning and the latest) to Github Registry + +``` +podman push ghcr.io/ansible-community/community-ee-base: +podman push ghcr.io/ansible-community/community-ee-base:latest +``` +13. Check the community-ee-base images [here](https://github.com/orgs/ansible-community/packages/container/package/community-ee-base) and get the sha256 sum. + + + +## Community-ee-minimal + +``` + +cd /home/adas/code/redhat/images/execution-environments/community-ee-minimal +``` + + +``` +ansible-builder build --tag ghcr.io/ansible-community/community-ee-minimal:2.16.0-1 +``` + +``` +podman images +``` + +``` +podman tag ghcr.io/ansible-community/community-ee-minimal:latest +``` + + +### Test + +podman run --rm -it ghcr.io/ansible-community/community-ee-minimal:2.15.7-1 /bin/bash +cat /etc/os-release +ansible --version +ansible-galaxy collection list + + + +``` +podman push ghcr.io/ansible-community/community-ee-minimal:2.15.5-1 + +``` + +``` +podman push ghcr.io/ansible-community/community-ee-minimal:latest +``` + + + + +Release Announcement + +``` +Hello everyone, + +We’re happy to announce the release of the + +Base Ansible Community Excution Environment 2.16.1-1 +Base Ansible Community Excution Environment 2.16.1-1 +Minimal Ansible Community Excution Environment 2.16.0-1 +Minimal Ansible Community Excution Environment 2.16.0-1 + + + +## Whats inside community-ee-minimal ? + +Ansible community-ee-minimal is a container image. includes : + +- `base_image`: fedora-minimal + +- `ansible-core`: ansible-core 2.16.0 (latest version of ansible-core) + +- `collections`: The following set of collections + + - ansible.posix + - ansible.utils + - ansible.windows + +## sha256 sum value of the container image : + +7849a7f261d1080c47d38718169bae13b1a05cd65b34c7ffba4a2a9604db730d + +## How to get community-ee-minimal? + +### Install from command line via @sha256_sum_value of the image + +`podman pull http://ghcr.io/ansible-community/community-ee-minimal@sha256:7849a7f261d1080c47d38718169bae13b1a05cd65b34c7ffba4a2a9604db730d` + +### Install from command line via image tag + +`podman pull ghcr.io/ansible-community/community-ee-minimal:latest` +`podman pull ghcr.io/ansible-community/community-ee-minimal:2.16.0-1` + + + +## Whats inside community-ee-base? + +- `base_image`: fedora-minimal + +- `ansible-core`: ansible-core 2.16.0 (latest version of ansible-core) + +## sha256 sum value of the container image : + +24863f44ca9cce42f4d3015dce728bab4de3ad16cd2c7d4737196ccde6f8cef8 + +## How to get community-ee-base? + +### Install from command line via @sha256_sum_value of the image + +`podman pull http://ghcr.io/ansible-community/community-ee-base@sha256:24863f44ca9cce42f4d3015dce728bab4de3ad16cd2c7d4737196ccde6f8cef8` + +### Install from command line via image tag + +`podman pull ghcr.io/ansible-community/community-ee-base:latest` +`podman pull ghcr.io/ansible-community/community-ee-base:2.16.0-1` + + +## To know about the future releases + +Join the new Ansible Community Forum to follow along and participate +in all the discussions and release related discussions and +announcements. Feel free to share your thoughts, ideas and concerns +there. + +Register here to join the Ansible Forum: + +https://forum.ansible.com + +Subscribe to the Bullhorn for all future release dates, announcements, +and Ansible community contributor news at: + +[https://bit.ly/subscribe-bullhorn](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](https://github.com/ansible/community/wiki/News#the-bullhorn) + +On behalf of the Ansible community, thank you and happy automating! + +Cheers, +Ansible Community Team + +``` + + +After uploading an image to ghcr.io the sha256 sum is not matching the with local digest value. I am finding the local value in the build machine via `podman inspect ghcr.io/repo/image-name:tag-name |grep Digest`. Any tips what I am doing wrong + +1a224490e5025eb6a96e0831a3f6d5f5f1d236f65a56e33d88f406869ba3d41a + + + + +# Forum post + +Release announcement to be done in the [Ecosystem Releases category](https://forum.ansible.com/c/news/releases) under the News and Announcement section. + +`ghcr.io/ansible-community/community-ee-base:latest` \ No newline at end of file From 172a8063ff455695df8883a519c454711097f01c Mon Sep 17 00:00:00 2001 From: Anwesha Das Date: Thu, 14 Dec 2023 12:12:36 +0100 Subject: [PATCH 02/15] Adds release process for community-ee-minimal --- docs/release_process.md | 152 +++++----------------------------------- 1 file changed, 19 insertions(+), 133 deletions(-) diff --git a/docs/release_process.md b/docs/release_process.md index 5fcc9af..2f3657a 100644 --- a/docs/release_process.md +++ b/docs/release_process.md @@ -6,8 +6,8 @@ Community EE is to be built and published on the next day and/or the day after a Versioning would be the core tag + a patch number, e.g - - EE with core `2.15.2` comes out -> `community-ee:2.15.2-1` - - EE with core `2.15.3` comes out -> `community-ee:2.15.3-1` + - EE with core `2.16.2` comes out -> `community-ee:2.16.2-1` + - EE with core `2.16.3` comes out -> `community-ee:2.16.3-1` ## Dependencies @@ -16,7 +16,7 @@ Versioning would be the core tag + a patch number, e.g ## Credentials -- Access to https://github.com/ansible/ansible repo +- Access to https://github.com/ansible-community/images repo - Access to ghcr.io @@ -87,151 +87,37 @@ podman push ghcr.io/ansible-community/community-ee-base:latest -## Community-ee-minimal +## Build steps for Community-ee-minimal -``` +1. Go to the working directory -cd /home/adas/code/redhat/images/execution-environments/community-ee-minimal -``` +`cd images/execution-environments/community-ee-minimal` +2. List images in local storage -``` -ansible-builder build --tag ghcr.io/ansible-community/community-ee-minimal:2.16.0-1 -``` +`podman images` -``` -podman images -``` +3. Delete the existing community-ee-minimal image -``` -podman tag ghcr.io/ansible-community/community-ee-minimal:latest -``` +`podman rmi ` +4. Build the ansible community-ee-minimal podman image with ansible-builder. (versioning : 2.16.1-1) -### Test +`ansible-builder build --tag ghcr.io/ansible-community/community-ee-minimal:` -podman run --rm -it ghcr.io/ansible-community/community-ee-minimal:2.15.7-1 /bin/bash -cat /etc/os-release -ansible --version -ansible-galaxy collection list +5. Check if the image has been created or not and get the < image ID> of `community-ee-minimal` +`podman images` +6. Build `latest` tag for the community-ee-minimal image -``` -podman push ghcr.io/ansible-community/community-ee-minimal:2.15.5-1 +`podman tag ghcr.io/ansible-community/community-ee-minimal:latest` -``` +7. Push both the images (general versioning and the latest) to Github Registry by using the Github Token created before ``` +podman push ghcr.io/ansible-community/community-ee-minimal: podman push ghcr.io/ansible-community/community-ee-minimal:latest ``` +10. Check the community-ee-minimal images [here](https://github.com/orgs/ansible-community/packages/container/package/community-ee-minimal) and get the sha256 sum. - - - -Release Announcement - -``` -Hello everyone, - -We’re happy to announce the release of the - -Base Ansible Community Excution Environment 2.16.1-1 -Base Ansible Community Excution Environment 2.16.1-1 -Minimal Ansible Community Excution Environment 2.16.0-1 -Minimal Ansible Community Excution Environment 2.16.0-1 - - - -## Whats inside community-ee-minimal ? - -Ansible community-ee-minimal is a container image. includes : - -- `base_image`: fedora-minimal - -- `ansible-core`: ansible-core 2.16.0 (latest version of ansible-core) - -- `collections`: The following set of collections - - - ansible.posix - - ansible.utils - - ansible.windows - -## sha256 sum value of the container image : - -7849a7f261d1080c47d38718169bae13b1a05cd65b34c7ffba4a2a9604db730d - -## How to get community-ee-minimal? - -### Install from command line via @sha256_sum_value of the image - -`podman pull http://ghcr.io/ansible-community/community-ee-minimal@sha256:7849a7f261d1080c47d38718169bae13b1a05cd65b34c7ffba4a2a9604db730d` - -### Install from command line via image tag - -`podman pull ghcr.io/ansible-community/community-ee-minimal:latest` -`podman pull ghcr.io/ansible-community/community-ee-minimal:2.16.0-1` - - - -## Whats inside community-ee-base? - -- `base_image`: fedora-minimal - -- `ansible-core`: ansible-core 2.16.0 (latest version of ansible-core) - -## sha256 sum value of the container image : - -24863f44ca9cce42f4d3015dce728bab4de3ad16cd2c7d4737196ccde6f8cef8 - -## How to get community-ee-base? - -### Install from command line via @sha256_sum_value of the image - -`podman pull http://ghcr.io/ansible-community/community-ee-base@sha256:24863f44ca9cce42f4d3015dce728bab4de3ad16cd2c7d4737196ccde6f8cef8` - -### Install from command line via image tag - -`podman pull ghcr.io/ansible-community/community-ee-base:latest` -`podman pull ghcr.io/ansible-community/community-ee-base:2.16.0-1` - - -## To know about the future releases - -Join the new Ansible Community Forum to follow along and participate -in all the discussions and release related discussions and -announcements. Feel free to share your thoughts, ideas and concerns -there. - -Register here to join the Ansible Forum: - -https://forum.ansible.com - -Subscribe to the Bullhorn for all future release dates, announcements, -and Ansible community contributor news at: - -[https://bit.ly/subscribe-bullhorn](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](https://github.com/ansible/community/wiki/News#the-bullhorn) - -On behalf of the Ansible community, thank you and happy automating! - -Cheers, -Ansible Community Team - -``` - - -After uploading an image to ghcr.io the sha256 sum is not matching the with local digest value. I am finding the local value in the build machine via `podman inspect ghcr.io/repo/image-name:tag-name |grep Digest`. Any tips what I am doing wrong - -1a224490e5025eb6a96e0831a3f6d5f5f1d236f65a56e33d88f406869ba3d41a - - - - -# Forum post - -Release announcement to be done in the [Ecosystem Releases category](https://forum.ansible.com/c/news/releases) under the News and Announcement section. - -`ghcr.io/ansible-community/community-ee-base:latest` \ No newline at end of file From abb460bdb00a06919d86f074289c7a61e9577305 Mon Sep 17 00:00:00 2001 From: Anwesha Das Date: Thu, 14 Dec 2023 14:39:52 +0100 Subject: [PATCH 03/15] Adds announcement draft --- docs/announcement.md | 120 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 120 insertions(+) create mode 100644 docs/announcement.md diff --git a/docs/announcement.md b/docs/announcement.md new file mode 100644 index 0000000..2e8db5a --- /dev/null +++ b/docs/announcement.md @@ -0,0 +1,120 @@ +We annouce both community-ee-base and community-ee-minimal together + +# Forum Announcement + +Release announcement to be done in the [Ecosystem Releases category](https://forum.ansible.com/c/news/releases) under the News and Announcement section. + +# E-Mail Announcement + +`ansible-annouce` Google Groups + +# community-ee-base announcement + +``` +Hello everyone, + +We’re happy to announce the release of the + +Ansible Community Execution Environment Minimal and Ansible Community Execution Environment Base !!! + + +## Whats inside community-ee-minimal ? + +Ansible community-ee-minimal is a container image. It includes : + +- `base_image`: fedora-minimal + +- `ansible-core`: + +- `collections`: The following set of collections + + - ansible.posix + - ansible.utils + - ansible.windows + +## sha256 sum value of the container image : + + + +## How to get community-ee-minimal? + +### Install from command line via @sha256_sum_value of the image + +`podman pull http://ghcr.io/ansible-community/community-ee-minimal@sha256:sha_value` + +### Install from command line via image tag + +`podman pull ghcr.io/ansible-community/community-ee-minimal:latest` +`podman pull ghcr.io/ansible-community/community-ee-minimal:` + + + +## Whats inside community-ee-base? + +- `base_image`: fedora-minimal + +- `ansible-core`: ansible-core 2.16.0 (latest version of ansible-core) + +## sha256 sum value of the container image : + + + +## How to get community-ee-base? + +### Install from command line via @sha256_sum_value of the image + +`podman pull http://ghcr.io/ansible-community/community-ee-base@sha256:24863f44ca9cce42f4d3015dce728bab4de3ad16cd2c7d4737196ccde6f8cef8` + +### Install from command line via image tag + +`podman pull ghcr.io/ansible-community/community-ee-base:latest` +`podman pull ghcr.io/ansible-community/community-ee-base:2.16.0-1` + + +## To know about the future releases + +Join the new Ansible Community Forum to follow along and participate +in all the discussions and release related discussions and +announcements. Feel free to share your thoughts, ideas and concerns +there. + +Register here to join the Ansible Forum: + +https://forum.ansible.com + +Subscribe to the Bullhorn for all future release dates, announcements, +and Ansible community contributor news at: + +[https://bit.ly/subscribe-bullhorn](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](https://github.com/ansible/community/wiki/News#the-bullhorn) + +On behalf of the Ansible community, thank you and happy automating! + +Cheers, +Ansible Community Team + +``` + +# Matrix Announcement + +Inform the Ansible users - Matrix: #users:ansible.com + +Inform Discussions on community and collections related topics - Matrix: #community:ansible.com + +Inform the Release Managers Working Group: /#release-management:ansible.com + +Inform Community social room - Matrix: #social:ansible.com +Posting news for the Bullhorn newsletter @newbot + + +``` +We’re happy to announce the release of the + +Ansible Community Execution Environment Minimal and Ansible Community Execution Environment Base !!! + +Get the details of both the images [here](). + +On behalf of the Ansible community, thank you and happy automating! +``` From f66367369ccb58e9d2bff555287d26914d765681 Mon Sep 17 00:00:00 2001 From: Anwesha Das Date: Thu, 14 Dec 2023 15:56:09 +0100 Subject: [PATCH 04/15] Adds the process for creating Pull Request --- docs/release_process.md | 115 +++++++++++++++++++++++++++++++++------- 1 file changed, 95 insertions(+), 20 deletions(-) diff --git a/docs/release_process.md b/docs/release_process.md index 2f3657a..c6c3dbc 100644 --- a/docs/release_process.md +++ b/docs/release_process.md @@ -22,50 +22,82 @@ Versioning would be the core tag + a patch number, e.g ## Build steps for Community-ee-base -1. Go to the working directory +1. Go to the working directory. `cd images/execution-environments/community-ee-base` -2. List images in local storage +2. Create a new release branch + +`git checkout -b base-` + +3. Edit the `execution-environment.yml` file to the right `collection version` and `ansible-core version`. Get the correct `[ansible-core](https://pypi.org/project/ansible-core/)` version and `[ansible-.deps](https://github.com/ansible-community/ansible-build-data/blob/main/9/ansible-9.0.1.deps)` and edit accordinly. + +`vim execution-environments/community-ee-base/execution-environment.yml` + +``` +version: +images: + base_image: + name: quay.io/fedora/fedora:latest +dependencies: + ansible_core: + package_pip: ansible-core== + ansible_runner: + package_pip: ansible-runner + system: + - openssh-clients + - sshpass + galaxy: + collections: + - name: ansible.posix + version: + - name: ansible.utils + version: + - name: ansible.windows + version: + +``` + +4. List images in local storage `podman images` -3. Delete the existing community-ee base and fedora images +5. Delete the existing community-ee base and fedora images ``` podman rmi podman rmi ``` -4. Create a virtual environment +6. Create a virtual environment ``` python3 -m venv .venv source .venv/bin/activate ``` -5. Install `ansible-builder` and `setuptools` +7. Install `ansible-builder` and `setuptools` ``` python3 -m pip install ansible-builder python3 -m pip install setuptools ``` -6. Pull the latest feodra image +8. Pull the latest fedora image `podman pull fedora:latest` -7. Build the ansible community-ee-base podman image with ansible-builder. (versioning : 2.16.1-1) +9. Build the ansible community-ee-base podman image with ansible-builder. (versioning : 2.16.1-1) `ansible-builder build --tag ghcr.io/ansible-community/community-ee-base:` -8. Check if the image has been created or not and get the < image ID> of `community-ee-base` +10. Check if the image has been created or not and get the < image ID> of `community-ee-base` `podman images` -9. Build latest tag for the community-ee-base image +11. Build latest tag for the community-ee-base image `podman tag ghcr.io/ansible-community/community-ee-base:latest` -10. Create the Github token +12. Create the Github token Go to Github UI and create Personal Token (classic). @@ -73,17 +105,27 @@ Select `write:packages` scope while creating the token. Copy the token from Github UI and then pass the token on the following command. -11. Login to Github Registry +13. Login to Github Registry `echo TOKEN | podman login ghcr.io -u USERNAME --password-stdin` -12. Push both the images (general versioning and the latest) to Github Registry +14. Push both the images (general versioning and the latest) to Github Registry ``` podman push ghcr.io/ansible-community/community-ee-base: podman push ghcr.io/ansible-community/community-ee-base:latest ``` -13. Check the community-ee-base images [here](https://github.com/orgs/ansible-community/packages/container/package/community-ee-base) and get the sha256 sum. + +15. Commit and push the changes made in the `execution-environments/community-ee-base/execution-environment.yml` to the `https://github.com/ansible-community/images` repo. + +``` +git add execution-environments/community-ee-base/execution-environment.yml +git commit +git push origin +``` +Compare and create the pull request. + +16. Check the community-ee-base images [here](https://github.com/orgs/ansible-community/packages/container/package/community-ee-base) and get the sha256 sum. @@ -93,31 +135,64 @@ podman push ghcr.io/ansible-community/community-ee-base:latest `cd images/execution-environments/community-ee-minimal` -2. List images in local storage +2. Create a new release branch + +`git checkout -b base-` + +3. Edit the `execution-environment.yml` file to the right `collection version` and `ansible-core version`. Get the correct `[ansible-core](https://pypi.org/project/ansible-core/)` version and edit accordinly. + +`vim execution-environments/community-ee-minimal/execution-environment.yml` + +``` +version: +images: + base_image: + name: quay.io/fedora/fedora:latest +dependencies: + ansible_core: + package_pip: ansible-core== + ansible_runner: + package_pip: ansible-runner + system: + - openssh-clients + - sshpass + +``` + +4. List images in local storage `podman images` -3. Delete the existing community-ee-minimal image +5. Delete the existing community-ee-minimal image `podman rmi ` -4. Build the ansible community-ee-minimal podman image with ansible-builder. (versioning : 2.16.1-1) +6. Build the ansible community-ee-minimal podman image with ansible-builder. (versioning : 2.16.1-1) `ansible-builder build --tag ghcr.io/ansible-community/community-ee-minimal:` -5. Check if the image has been created or not and get the < image ID> of `community-ee-minimal` +7. Check if the image has been created or not and get the < image ID> of `community-ee-minimal` `podman images` -6. Build `latest` tag for the community-ee-minimal image +8. Build `latest` tag for the community-ee-minimal image `podman tag ghcr.io/ansible-community/community-ee-minimal:latest` -7. Push both the images (general versioning and the latest) to Github Registry by using the Github Token created before +9. Push both the images (general versioning and the latest) to Github Registry by using the Github Token created before ``` podman push ghcr.io/ansible-community/community-ee-minimal: podman push ghcr.io/ansible-community/community-ee-minimal:latest ``` -10. Check the community-ee-minimal images [here](https://github.com/orgs/ansible-community/packages/container/package/community-ee-minimal) and get the sha256 sum. +10. Commit and push the changes made in the `execution-environments/community-ee-minimal/execution-environment.yml` to the `https://github.com/ansible-community/images` repo. + +``` +git add execution-environments/community-ee-minimal/execution-environment.yml +git commit +git push origin +``` +Compare and create the pull request. + +11. Check the community-ee-minimal images [here](https://github.com/orgs/ansible-community/packages/container/package/community-ee-minimal) and get the sha256 sum. From b02510d92f5aac93c6b1c998d546c74ffb2534d5 Mon Sep 17 00:00:00 2001 From: Anwesha Das Date: Mon, 18 Dec 2023 10:26:14 +0100 Subject: [PATCH 05/15] Edits based on feedback --- docs/announcement.md | 12 ++++++------ docs/release_process.md | 6 +++--- 2 files changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/announcement.md b/docs/announcement.md index 2e8db5a..eb05f67 100644 --- a/docs/announcement.md +++ b/docs/announcement.md @@ -8,19 +8,19 @@ Release announcement to be done in the [Ecosystem Releases category](https://f `ansible-annouce` Google Groups -# community-ee-base announcement +# Community-ee (both Base and Minimal) announcement ``` Hello everyone, We’re happy to announce the release of the -Ansible Community Execution Environment Minimal and Ansible Community Execution Environment Base !!! +Ansible Community Execution Environment Minimal and Ansible Community Execution Environment Base ! ## Whats inside community-ee-minimal ? -Ansible community-ee-minimal is a container image. It includes : +Ansible community-ee-minimal is a container image. It includes: - `base_image`: fedora-minimal @@ -32,7 +32,7 @@ Ansible community-ee-minimal is a container image. It includes : - ansible.utils - ansible.windows -## sha256 sum value of the container image : +## sha256 sum value of the container image: @@ -55,7 +55,7 @@ Ansible community-ee-minimal is a container image. It includes : - `ansible-core`: ansible-core 2.16.0 (latest version of ansible-core) -## sha256 sum value of the container image : +## sha256 sum value of the container image: @@ -112,7 +112,7 @@ Posting news for the Bullhorn newsletter @newbot ``` We’re happy to announce the release of the -Ansible Community Execution Environment Minimal and Ansible Community Execution Environment Base !!! +Ansible Community Execution Environment Minimal and Ansible Community Execution Environment Base ! Get the details of both the images [here](). diff --git a/docs/release_process.md b/docs/release_process.md index c6c3dbc..750bf84 100644 --- a/docs/release_process.md +++ b/docs/release_process.md @@ -30,7 +30,7 @@ Versioning would be the core tag + a patch number, e.g `git checkout -b base-` -3. Edit the `execution-environment.yml` file to the right `collection version` and `ansible-core version`. Get the correct `[ansible-core](https://pypi.org/project/ansible-core/)` version and `[ansible-.deps](https://github.com/ansible-community/ansible-build-data/blob/main/9/ansible-9.0.1.deps)` and edit accordinly. +3. Edit the `execution-environment.yml` file to the right `collection version` and `ansible-core version`. Get the correct [ansible-core](https://pypi.org/project/ansible-core/) version and [ansible-.deps](https://github.com/ansible-community/ansible-build-data/blob/main/9/ansible-9.0.1.deps) and edit accordinly. `vim execution-environments/community-ee-base/execution-environment.yml` @@ -89,7 +89,7 @@ python3 -m pip install setuptools `ansible-builder build --tag ghcr.io/ansible-community/community-ee-base:` -10. Check if the image has been created or not and get the < image ID> of `community-ee-base` +10. Check if the image has been created or not and get the of `community-ee-base` `podman images` @@ -139,7 +139,7 @@ Compare and create the pull request. `git checkout -b base-` -3. Edit the `execution-environment.yml` file to the right `collection version` and `ansible-core version`. Get the correct `[ansible-core](https://pypi.org/project/ansible-core/)` version and edit accordinly. +3. Edit the `execution-environment.yml` file to the right `collection version` and `ansible-core version`. Get the correct [ansible-core](https://pypi.org/project/ansible-core/) version and edit accordinly. `vim execution-environments/community-ee-minimal/execution-environment.yml` From b302bfe3840167be8c17737c8c0dac01fa37ed37 Mon Sep 17 00:00:00 2001 From: Anwesha Das Date: Thu, 21 Dec 2023 19:50:31 +0100 Subject: [PATCH 06/15] Edits based on the feeback --- docs/announcement.md | 32 ++++++++++++++------------------ 1 file changed, 14 insertions(+), 18 deletions(-) diff --git a/docs/announcement.md b/docs/announcement.md index eb05f67..b11bdfc 100644 --- a/docs/announcement.md +++ b/docs/announcement.md @@ -1,12 +1,12 @@ -We annouce both community-ee-base and community-ee-minimal together +We announce both community-ee-base and community-ee-minimal together # Forum Announcement -Release announcement to be done in the [Ecosystem Releases category](https://forum.ansible.com/c/news/releases) under the News and Announcement section. +Release announcement to be done in the Ecosystem Release sub-category under the News & Announcements category. # E-Mail Announcement -`ansible-annouce` Google Groups +`ansible-announce` Google Groups # Community-ee (both Base and Minimal) announcement @@ -18,7 +18,7 @@ We’re happy to announce the release of the Ansible Community Execution Environment Minimal and Ansible Community Execution Environment Base ! -## Whats inside community-ee-minimal ? +## What's inside community-ee-minimal ? Ansible community-ee-minimal is a container image. It includes: @@ -40,7 +40,7 @@ Ansible community-ee-minimal is a container image. It includes: ### Install from command line via @sha256_sum_value of the image -`podman pull http://ghcr.io/ansible-community/community-ee-minimal@sha256:sha_value` +`podman pull http://ghcr.io/ansible-community/community-ee-minimal@sha256:` ### Install from command line via image tag @@ -49,11 +49,11 @@ Ansible community-ee-minimal is a container image. It includes: -## Whats inside community-ee-base? +## What's inside community-ee-base? - `base_image`: fedora-minimal -- `ansible-core`: ansible-core 2.16.0 (latest version of ansible-core) +- `ansible-core`: ansible-core ## sha256 sum value of the container image: @@ -63,32 +63,28 @@ Ansible community-ee-minimal is a container image. It includes: ### Install from command line via @sha256_sum_value of the image -`podman pull http://ghcr.io/ansible-community/community-ee-base@sha256:24863f44ca9cce42f4d3015dce728bab4de3ad16cd2c7d4737196ccde6f8cef8` +`podman pull http://ghcr.io/ansible-community/community-ee-base@sha256:` ### Install from command line via image tag `podman pull ghcr.io/ansible-community/community-ee-base:latest` -`podman pull ghcr.io/ansible-community/community-ee-base:2.16.0-1` +`podman pull ghcr.io/ansible-community/community-ee-base:` -## To know about the future releases +## To know about future releases -Join the new Ansible Community Forum to follow along and participate +Join the [Ansible Community Forum](https://forum.ansible.com) to follow along and participate in all the discussions and release related discussions and announcements. Feel free to share your thoughts, ideas and concerns there. -Register here to join the Ansible Forum: - -https://forum.ansible.com - Subscribe to the Bullhorn for all future release dates, announcements, and Ansible community contributor news at: [https://bit.ly/subscribe-bullhorn](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](https://github.com/ansible/community/wiki/News#the-bullhorn) +You can find all Bullhorn issues on the Community forum: +https://forum.ansible.com/c/news/bullhorn/17 On behalf of the Ansible community, thank you and happy automating! @@ -103,7 +99,7 @@ Inform the Ansible users - Matrix: #users:ansible.com Inform Discussions on community and collections related topics - Matrix: #community:ansible.com -Inform the Release Managers Working Group: /#release-management:ansible.com +Inform the Release Managers Working Group: Matrix: #release-management:ansible.com Inform Community social room - Matrix: #social:ansible.com Posting news for the Bullhorn newsletter @newbot From 2cd0aa74d8c99121e3097e6798838c2b796797b8 Mon Sep 17 00:00:00 2001 From: Anwesha Das Date: Fri, 22 Dec 2023 14:39:07 +0100 Subject: [PATCH 07/15] Edits based on the feedback on PR Fixes formating, typo. Edits the directory structure. --- .../community-ee-announcement.md} | 12 +++++++----- .../community-ee-release-process.md} | 6 ++++-- 2 files changed, 11 insertions(+), 7 deletions(-) rename docs/{announcement.md => community-ee/community-ee-announcement.md} (93%) rename docs/{release_process.md => community-ee/community-ee-release-process.md} (96%) diff --git a/docs/announcement.md b/docs/community-ee/community-ee-announcement.md similarity index 93% rename from docs/announcement.md rename to docs/community-ee/community-ee-announcement.md index b11bdfc..3e03a97 100644 --- a/docs/announcement.md +++ b/docs/community-ee/community-ee-announcement.md @@ -1,14 +1,16 @@ +# Announcing the community-ee-* execution environments + We announce both community-ee-base and community-ee-minimal together -# Forum Announcement +## Forum Announcement Release announcement to be done in the Ecosystem Release sub-category under the News & Announcements category. -# E-Mail Announcement +## E-Mail Announcement `ansible-announce` Google Groups -# Community-ee (both Base and Minimal) announcement +## Community-ee (both Base and Minimal) announcement ``` Hello everyone, @@ -93,7 +95,7 @@ Ansible Community Team ``` -# Matrix Announcement +## Matrix Announcement Inform the Ansible users - Matrix: #users:ansible.com @@ -102,7 +104,7 @@ Inform Discussions on community and collections related topics - Matrix: #commun Inform the Release Managers Working Group: Matrix: #release-management:ansible.com Inform Community social room - Matrix: #social:ansible.com -Posting news for the Bullhorn newsletter @newbot +Posting news for the Bullhorn newsletter @newsbot ``` diff --git a/docs/release_process.md b/docs/community-ee/community-ee-release-process.md similarity index 96% rename from docs/release_process.md rename to docs/community-ee/community-ee-release-process.md index 750bf84..d3a1f5e 100644 --- a/docs/release_process.md +++ b/docs/community-ee/community-ee-release-process.md @@ -1,6 +1,8 @@ +# Releasing the community-ee-* execution environments + ## Release Cadence -Community EE is to be built and published on the next day and/or the day after ansible-core is released. +The community EEs are to be built and published on the next day and/or the day after ansible-core is released. ## EE tag versioning @@ -85,7 +87,7 @@ python3 -m pip install setuptools `podman pull fedora:latest` -9. Build the ansible community-ee-base podman image with ansible-builder. (versioning : 2.16.1-1) +9. Build the ansible community-ee-base podman image with ansible-builder. (versioning: 2.16.1-1) `ansible-builder build --tag ghcr.io/ansible-community/community-ee-base:` From dd105bdb3ce4389e407c02e5f01420136a35d99d Mon Sep 17 00:00:00 2001 From: Anwesha Das Date: Fri, 3 May 2024 09:55:27 +0200 Subject: [PATCH 08/15] Update docs/community-ee/community-ee-release-process.md Co-authored-by: Felix Fontein --- docs/community-ee/community-ee-release-process.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/community-ee/community-ee-release-process.md b/docs/community-ee/community-ee-release-process.md index d3a1f5e..25980d1 100644 --- a/docs/community-ee/community-ee-release-process.md +++ b/docs/community-ee/community-ee-release-process.md @@ -173,7 +173,7 @@ dependencies: `ansible-builder build --tag ghcr.io/ansible-community/community-ee-minimal:` -7. Check if the image has been created or not and get the < image ID> of `community-ee-minimal` +7. Check if the image has been created or not and get the of `community-ee-minimal` `podman images` From 92ee8e8ca7c354fef7c6d53d4e7336235909c2a9 Mon Sep 17 00:00:00 2001 From: Anwesha Das Date: Fri, 3 May 2024 09:55:37 +0200 Subject: [PATCH 09/15] Update docs/community-ee/community-ee-release-process.md Co-authored-by: Felix Fontein --- docs/community-ee/community-ee-release-process.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/community-ee/community-ee-release-process.md b/docs/community-ee/community-ee-release-process.md index 25980d1..de4143d 100644 --- a/docs/community-ee/community-ee-release-process.md +++ b/docs/community-ee/community-ee-release-process.md @@ -169,7 +169,7 @@ dependencies: `podman rmi ` -6. Build the ansible community-ee-minimal podman image with ansible-builder. (versioning : 2.16.1-1) +6. Build the ansible community-ee-minimal podman image with ansible-builder. (versioning: 2.16.1-1) `ansible-builder build --tag ghcr.io/ansible-community/community-ee-minimal:` From e01859322a4de69d7ea4583a04e88b7cfaca9650 Mon Sep 17 00:00:00 2001 From: Anwesha Das Date: Fri, 3 May 2024 09:55:46 +0200 Subject: [PATCH 10/15] Update docs/community-ee/community-ee-release-process.md Co-authored-by: Felix Fontein --- docs/community-ee/community-ee-release-process.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/community-ee/community-ee-release-process.md b/docs/community-ee/community-ee-release-process.md index de4143d..ad1747b 100644 --- a/docs/community-ee/community-ee-release-process.md +++ b/docs/community-ee/community-ee-release-process.md @@ -14,7 +14,7 @@ Versioning would be the core tag + a patch number, e.g ## Dependencies -- Podman/Docker +- Podman/Docker ## Credentials From 741ef0a42d07d88289846ee57a0685ffe4855ea7 Mon Sep 17 00:00:00 2001 From: Anwesha Das Date: Fri, 3 May 2024 10:13:30 +0200 Subject: [PATCH 11/15] Update docs/community-ee/community-ee-announcement.md Co-authored-by: Felix Fontein --- docs/community-ee/community-ee-announcement.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/community-ee/community-ee-announcement.md b/docs/community-ee/community-ee-announcement.md index 3e03a97..4c4b7da 100644 --- a/docs/community-ee/community-ee-announcement.md +++ b/docs/community-ee/community-ee-announcement.md @@ -1,6 +1,6 @@ # Announcing the community-ee-* execution environments -We announce both community-ee-base and community-ee-minimal together +We announce both community-ee-base and community-ee-minimal together. ## Forum Announcement From 22bc865b0860ba46b1333ae4e551bb82b26adbc4 Mon Sep 17 00:00:00 2001 From: Anwesha Das Date: Fri, 3 May 2024 10:13:40 +0200 Subject: [PATCH 12/15] Update docs/community-ee/community-ee-release-process.md Co-authored-by: Felix Fontein --- docs/community-ee/community-ee-release-process.md | 15 --------------- 1 file changed, 15 deletions(-) diff --git a/docs/community-ee/community-ee-release-process.md b/docs/community-ee/community-ee-release-process.md index ad1747b..8e6c6ee 100644 --- a/docs/community-ee/community-ee-release-process.md +++ b/docs/community-ee/community-ee-release-process.md @@ -145,21 +145,6 @@ Compare and create the pull request. `vim execution-environments/community-ee-minimal/execution-environment.yml` -``` -version: -images: - base_image: - name: quay.io/fedora/fedora:latest -dependencies: - ansible_core: - package_pip: ansible-core== - ansible_runner: - package_pip: ansible-runner - system: - - openssh-clients - - sshpass - -``` 4. List images in local storage From 64a98b1c9b673985e273a35af36582d42f4f1d0b Mon Sep 17 00:00:00 2001 From: Anwesha Das Date: Fri, 3 May 2024 10:13:52 +0200 Subject: [PATCH 13/15] Update docs/community-ee/community-ee-release-process.md Co-authored-by: Felix Fontein --- .../community-ee-release-process.md | 23 ------------------- 1 file changed, 23 deletions(-) diff --git a/docs/community-ee/community-ee-release-process.md b/docs/community-ee/community-ee-release-process.md index 8e6c6ee..3963463 100644 --- a/docs/community-ee/community-ee-release-process.md +++ b/docs/community-ee/community-ee-release-process.md @@ -36,29 +36,6 @@ Versioning would be the core tag + a patch number, e.g `vim execution-environments/community-ee-base/execution-environment.yml` -``` -version: -images: - base_image: - name: quay.io/fedora/fedora:latest -dependencies: - ansible_core: - package_pip: ansible-core== - ansible_runner: - package_pip: ansible-runner - system: - - openssh-clients - - sshpass - galaxy: - collections: - - name: ansible.posix - version: - - name: ansible.utils - version: - - name: ansible.windows - version: - -``` 4. List images in local storage From e28c4611b44fa3333bafef23cb292eea12549cf6 Mon Sep 17 00:00:00 2001 From: Anwesha Das Date: Fri, 3 May 2024 10:14:01 +0200 Subject: [PATCH 14/15] Update docs/community-ee/community-ee-release-process.md Co-authored-by: Felix Fontein --- docs/community-ee/community-ee-release-process.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/community-ee/community-ee-release-process.md b/docs/community-ee/community-ee-release-process.md index 3963463..ff1a365 100644 --- a/docs/community-ee/community-ee-release-process.md +++ b/docs/community-ee/community-ee-release-process.md @@ -118,7 +118,7 @@ Compare and create the pull request. `git checkout -b base-` -3. Edit the `execution-environment.yml` file to the right `collection version` and `ansible-core version`. Get the correct [ansible-core](https://pypi.org/project/ansible-core/) version and edit accordinly. +3. Edit the `execution-environment.yml` file to the right `collection version` and `ansible-core version`. Get the correct [ansible-core](https://pypi.org/project/ansible-core/) version and edit accordingly. `vim execution-environments/community-ee-minimal/execution-environment.yml` From 3100e1cd268373c1da8d067580314d2cf648b3f8 Mon Sep 17 00:00:00 2001 From: Anwesha Das Date: Fri, 3 May 2024 10:14:10 +0200 Subject: [PATCH 15/15] Update docs/community-ee/community-ee-release-process.md Co-authored-by: Felix Fontein --- docs/community-ee/community-ee-release-process.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/community-ee/community-ee-release-process.md b/docs/community-ee/community-ee-release-process.md index ff1a365..f7f8c11 100644 --- a/docs/community-ee/community-ee-release-process.md +++ b/docs/community-ee/community-ee-release-process.md @@ -32,7 +32,7 @@ Versioning would be the core tag + a patch number, e.g `git checkout -b base-` -3. Edit the `execution-environment.yml` file to the right `collection version` and `ansible-core version`. Get the correct [ansible-core](https://pypi.org/project/ansible-core/) version and [ansible-.deps](https://github.com/ansible-community/ansible-build-data/blob/main/9/ansible-9.0.1.deps) and edit accordinly. +3. Edit the `execution-environment.yml` file to the right `collection version` and `ansible-core version`. Get the correct [ansible-core](https://pypi.org/project/ansible-core/) version and [ansible-.deps](https://github.com/ansible-community/ansible-build-data/blob/main/9/ansible-9.0.1.deps) and edit accordingly. `vim execution-environments/community-ee-base/execution-environment.yml`