From 34ab5985e26fa59538043a0adf720e8b3b5339b1 Mon Sep 17 00:00:00 2001
From: Sofia Boldyreva <87830789+sboldyreva@users.noreply.github.com>
Date: Fri, 5 Jul 2024 13:50:34 +0200
Subject: [PATCH] Adding cloud images changelog and a vagrant boxes page (#443)
* Adding cloud images changelog and a vagrant boxes page
* Updates based on review
* Updates based on review
* Updates based on review
* Updates based on review
---
docs/.vuepress/config.js | 2 ++
docs/cloud/README.md | 22 ++++++++++++--
docs/cloud/cloud-changelog.md | 49 ++++++++++++++++++++++++++++++
docs/installation/vagrant-boxes.md | 22 ++++++++++++++
4 files changed, 93 insertions(+), 2 deletions(-)
create mode 100644 docs/cloud/cloud-changelog.md
create mode 100644 docs/installation/vagrant-boxes.md
diff --git a/docs/.vuepress/config.js b/docs/.vuepress/config.js
index 51cdaecdc..0a04c30ec 100644
--- a/docs/.vuepress/config.js
+++ b/docs/.vuepress/config.js
@@ -202,10 +202,12 @@ module.exports = {
path: '/LiveMedia',
},
'/documentation/raspberry-pi',
+ '/installation/vagrant-boxes',
{
title: 'Cloud Images',
path : '/cloud',
children: [
+ '/cloud/cloud-changelog',
{
title: 'Generic Cloud (Cloud-init)',
path: '/cloud',
diff --git a/docs/cloud/README.md b/docs/cloud/README.md
index 54b9dce9d..85dcb7924 100644
--- a/docs/cloud/README.md
+++ b/docs/cloud/README.md
@@ -1,5 +1,23 @@
# Cloud Images
-At AlmaLinux, cloud integration is among our top priorities, ensuring that users get the most streamlined and efficient experience when deploying our OS in the cloud. Our dedication to this initiative is evident through the exceptional work of our Cloud Special Interest Group (Cloud SIG). They relentlessly work on perfecting and tailoring AlmaLinux for cloud environments, making our cloud images stand out for their performance, stability, and adaptability.
+At AlmaLinux, cloud integration is among our top priorities, ensuring that users get the most streamlined and efficient experience when deploying our OS in the cloud. Our dedication to this initiative is evident through the exceptional work of our [Cloud Special Interest Group (Cloud SIG)](/sigs/Cloud). They relentlessly work on perfecting and tailoring AlmaLinux for cloud environments, making our cloud images stand out for their performance, stability, and adaptability.
-Presently, we are proud to offer robust support for a wide range of platforms including AWS, Azure, Google Cloud, Oracle Cloud Infrastructure, OpenNebula, and Generic Cloud. Additionally, for those wishing to simulate cloud environments or test locally, we also provide options to run the Cloud image on your local machine. Dive in and experience the pinnacle of cloud-based Linux distributions with AlmaLinux.
+Presently, we are proud to offer robust support for a wide range of platforms including:
+| Cloud | AlmaLinux OS 8 | AlmaLinux OS 9 |
+| --- | --- | --- |
+| [AWS](AWS) | [Intel/AMD (x86_64)](https://aws.amazon.com/marketplace/pp/prodview-mku4y3g4sjrye)
[ARM64 (AArch64)](https://aws.amazon.com/marketplace/pp/prodview-zgsymdwitnxmm) | [Intel/AMD (x86_64)](https://aws.amazon.com/marketplace/pp/prodview-ykmb6re2rcouy)
[ARM64 (AArch64)](https://aws.amazon.com/marketplace/pp/prodview-pvttztrj2uzjk) |
+| [Azure](Azure) | [Intel/AMD (x86_64)](https://azuremarketplace.microsoft.com/en-us/marketplace/apps/almalinux.almalinux-x86_64)
[ARM64 (AArch64)](https://azuremarketplace.microsoft.com/en-us/marketplace/apps/almalinux.almalinux-arm)
[HPC Intel/AMD (x86_64)](https://azuremarketplace.microsoft.com/en-us/marketplace/apps/almalinux.almalinux-hpc) | [Intel/AMD (x86_64)](https://azuremarketplace.microsoft.com/en-us/marketplace/apps/almalinux.almalinux-x86_64)
[ARM64 (AArch64)](https://azuremarketplace.microsoft.com/en-us/marketplace/apps/almalinux.almalinux-arm) |
+| [Generic Cloud (Cloud-init)](Generic-cloud)| [Intel/AMD (x86_64)](https://repo.almalinux.org/almalinux/8/cloud/x86_64/images/)
[ARM64 (AArch64)](https://repo.almalinux.org/almalinux/8/cloud/aarch64/images)
[IBM Z (s390x)](https://repo.almalinux.org/almalinux/8/cloud/s390x/images/)
[Power LE (ppc64le)](http://repo.almalinux.org/almalinux/8/cloud/ppc64le/images/) | [Intel/AMD (x86_64)](https://repo.almalinux.org/almalinux/9/cloud/x86_64/images/)
[ARM64 (AArch64)](https://repo.almalinux.org/almalinux/9/cloud/aarch64/images/)
[IBM Z (s390x)](https://repo.almalinux.org/almalinux/9/cloud/s390x/images/)
[Power LE (ppc64le)](https://repo.almalinux.org/almalinux/9/cloud/ppc64le/images/) |
+| [Google Cloud](Google) | [Intel/AMD (x86_64)](https://console.cloud.google.com/marketplace/product/almalinux-cloud/almalinux-8)| [Intel/AMD (x86_64)](https://console.cloud.google.com/marketplace/product/almalinux-cloud/almalinux-9) |
+| [OpenNebula](OpenNebula) | [Intel/AMD (x86_64)](https://repo.almalinux.org/almalinux/8/cloud/x86_64/images/)
[ARM64 (AArch64)](https://repo.almalinux.org/almalinux/8/cloud/aarch64/images) |[Intel/AMD (x86_64)](https://repo.almalinux.org/almalinux/9/cloud/x86_64/images/)
[ARM64 (AArch64)](https://repo.almalinux.org/almalinux/9/cloud/aarch64/images/)|
+| [Oracle Cloud Infrastructure](OCI) | [Intel/AMD (x86_64)](https://cloudmarketplace.oracle.com/marketplace/en_US/listing/125544666)
[ARM64 (AArch64)](https://cloudmarketplace.oracle.com/marketplace/en_US/listing/125567282) |[Intel/AMD (x86_64)](https://cloudmarketplace.oracle.com/marketplace/en_US/listing/127985411)
[ARM64 (AArch64)](https://cloudmarketplace.oracle.com/marketplace/en_US/listing/127985893) |
+
+Additionally, for those wishing to simulate cloud environments or test locally, we also provide options to run the [Cloud image on your local machine](Generic-cloud-on-local). Dive in and experience the pinnacle of cloud-based Linux distributions with AlmaLinux.
+
+## Changelog
+
+You can find all the changes for every AlmaLinux Cloud Image starting versions 8.9 and 9.3 on the [changelog](cloud-changelog) page.
+
+## Contribute and Get Help
+
+If you are interested in contributing or need any assistance, check the [SIG/Cloud](/sigs/Cloud) wiki page and join the *~SIG/Cloud* chat channel in [Mattermost](https://chat.almalinux.org/almalinux/channels/sigcloud) chat channel on [chat.almalinux.org](https://chat.almalinux.org).
diff --git a/docs/cloud/cloud-changelog.md b/docs/cloud/cloud-changelog.md
new file mode 100644
index 000000000..2cc212b4e
--- /dev/null
+++ b/docs/cloud/cloud-changelog.md
@@ -0,0 +1,49 @@
+---
+title: 'Changelog'
+---
+
+###### last updated: 2024-07-04
+
+## Amazon Web Services AMIs
+
+### AlmaLinux OS versions 9.3.20240303 and 8.9.20240303:
+
+* AlmaLinux Amazon Images were switched from Instance Metadata Service Version 1 (IMDSv1) to Instance Metadata Service Version 2 (IMDSv2).
+ The IMDSv2 is beneficial in multiple use cases such as:
+ - Misconfigured Open Web Application Firewalls (WAF).
+ - Misconfigured Open Reverse Proxies (Apache HTTP Server, Squid etc.).
+ - Server-side request forgery (SSRF) vulnerabilities.
+ - Open router.
+ - Open Layer 3 Firewall.
+ - Virtual private network (VPN).
+ - Tunnel.
+ - Network address translation (NAT).
+ For more details see [article](https://aws.amazon.com/blogs/security/defense-in-depth-open-firewalls-reverse-proxies-ssrf-vulnerabilities-ec2-instance-metadata-service/) from AWS Security Blog and [talk](https://youtu.be/2B5bhZzayjI) from AWS re:Invent 2019
+
+* The size of boot partition (`/boot`) increased from `512 MiB` to `1024 MiB / 1GiB`.
+
+* Included EC2 Instance Connect. See: https://wiki.almalinux.org/cloud/EC2-instance-connect.html
+
+## Generic Cloud
+
+### AlmaLinux OS versions **9.4-20240507** and 8.10-20240530 with Cloud-init (OpenStack compatible)
+
+**Impacted architectures: x86_64, AArch64, ppc64le, s390x**
+
+The size of boot partition (`/boot`) increased from `512 MiB` to `1024 MiB / 1GiB`. This means that three and more kernels can be installed and enables larger initramfs (initial ram file system) and kernel related development.
+
+### AlmaLinux OS version 8.9-20231128
+
+**Impacted architecture: x86_64**
+
+AlmaLinux Generic Cloud images have now unified - BIOS and UEFI - boot support. The download URLs of the UEFI images are symlinked to the current image for compatibility: `$MIRROR/almalinux/8/cloud/x86_64/images/AlmaLinux-8-GenericCloud-UEFI-latest.x86_64.qcow2`
+
+## OpenNebula
+
+### AlmaLinux OS version **8.10-20240530**
+
+**Impacted architecture: x86_64**
+
+AlmaLinux OpenNebula images have now unified - BIOS and UEFI - boot support. The download URLs of the UEFI images are symlinked to the current image for compatibility.
+
+
diff --git a/docs/installation/vagrant-boxes.md b/docs/installation/vagrant-boxes.md
new file mode 100644
index 000000000..bce90443d
--- /dev/null
+++ b/docs/installation/vagrant-boxes.md
@@ -0,0 +1,22 @@
+---
+title: 'Vagrant Boxes'
+---
+
+###### last updated: 2024-07-04
+
+# Vagrant Boxes
+
+AlmaLinux offers official AlmaLinux OS images for Vagrant Boxes. Images are delivered by the AlmaLinux [Cloud SIG](https://wiki.almalinux.org/sigs/Cloud.html).
+
+The following [AlmaLinux OS 9](https://app.vagrantup.com/almalinux/boxes/9) and [AlmaLinux OS 8](https://app.vagrantup.com/almalinux/boxes/8) images are available on Vagrant Cloud:
+| Vagrant Box| AlmaLinux OS 9 | AlmaLinux OS 8 |
+| --- | --- | --- |
+| Libvirt | Intel/AMD (x86_64) | Intel/AMD (x86_64) |
+| Virtual Box | Intel/AMD (x86_64) | Intel/AMD (x86_64) |
+| Hyper-V | Intel/AMD (x86_64) | Intel/AMD (x86_64) |
+| VMWare | Intel/AMD (x86_64)
ARM64 (AArch64) | Intel/AMD (x86_64) |
+| Parallels | ARM64 (AArch64) | - |
+
+## Contribute and Get Help
+
+If you are interested in contributing or need any assistance, check the [SIG/Cloud](/sigs/Cloud) wiki page and join the *~SIG/Cloud* chat channel in [Mattermost](https://chat.almalinux.org/almalinux/channels/sigcloud) chat channel on [chat.almalinux.org](https://chat.almalinux.org).