Merge pull request #264397 from rsgel/rigel-chaosmesh-versions

add Chaos Studio version compat page

Author: v-dirichards

articles/chaos-studio/TOC.yml

@@ -96,6 +96,8 @@
     href: chaos-studio-fault-library.md
   - name: Fault providers
     href: chaos-studio-fault-providers.md
+  - name: Version compatibility
+    href: chaos-studio-versions.md
   - name: Limitations and known issues
     href: chaos-studio-limitations.md
   - name: Service limits
@@ -110,13 +112,11 @@
     href: https://www.npmjs.com/package/@azure/arm-chaos/
 - name: Resources
   items:
-  - name: Azure roadmap
-    href: https://azure.microsoft.com/roadmap/
+  - name: Service updates
+    href: https://azure.microsoft.com/updates/?query=chaos%20studio
   - name: Pricing
-    href: https://azure.microsoft.com/pricing/
+    href: https://azure.microsoft.com/pricing/details/chaos-studio/
   - name: Pricing calculator
     href: https://azure.microsoft.com/pricing/calculator/
-  - name: Service updates
-    href: https://azure.microsoft.com/updates/?product=
-  - name: Stack Overflow
-    href: https://stackoverflow.com/questions
+  - name: Feedback
+    href: https://aka.ms/ChaosStudioFeedback

articles/chaos-studio/chaos-studio-limitations.md

@@ -21,14 +21,7 @@ The following are known limitations in Chaos Studio.
     - Regional endpoints to allowlist are listed in [Permissions and security in Azure Chaos Studio](chaos-studio-permissions-security.md#network-security).
     - If you're sending telemetry data to Application Insights, the IPs in [IP addresses used by Azure Monitor](../azure-monitor/ip-addresses.md) are also required.
 
-- **Supported VM operating systems** - If you run an experiment that makes use of the Chaos Studio agent, the virtual machine must run one of the following operating systems:
-
-    - Windows Server 2019, Windows Server 2016, and Windows Server 2012 R2
-    - Red Hat Enterprise Linux 8, Red Hat Enterprise Linux 8.2, openSUSE Leap 15.2, CentOS 8, Debian 10 Buster (with unzip installation required), Oracle Linux 8.3, and Ubuntu Server 18.04 LTS
-- **Hardened Linux untested** -  The Chaos Studio agent isn't currently tested against custom Linux distributions or hardened Linux distributions (for example, FIPS or SELinux).
-- **Supported browsers** - The Chaos Studio portal experience has only been tested on the following browsers:
-    * **Windows:** Microsoft Edge, Google Chrome, and Firefox
-    * **MacOS:** Safari, Google Chrome, and Firefox
+- **Version support** - Review the [Azure Chaos Studio version compatibility](chaos-studio-versions.md) page for more information on operating system, browser, and integration version compatibility.
 - **Terraform** - Chaos Studio doesn't support Terraform at this time.
 - **PowerShell modules** - Chaos Studio doesn't have dedicated PowerShell modules at this time. For PowerShell, use our REST API
 - **Azure CLI** - Chaos Studio doesn't have dedicated AzCLI modules at this time. Use our REST API from AzCLI

articles/chaos-studio/chaos-studio-quickstart-azure-portal.md

@@ -14,7 +14,7 @@ Get started with Azure Chaos Studio by using a virtual machine (VM) shutdown ser
 
 ## Prerequisites
 - An Azure subscription. [!INCLUDE [quickstarts-free-trial-note](../../includes/quickstarts-free-trial-note.md)] 
-- A Linux VM. If you don't have a VM, [follow these steps to create one](../virtual-machines/linux/quick-create-portal.md).
+- A Linux VM running an operating system in the [Azure Chaos Studio version compatibility](chaos-studio-versions.md) list. If you don't have a VM, [follow these steps to create one](../virtual-machines/linux/quick-create-portal.md).
 
 ## Register the Chaos Studio resource provider
 If it's your first time using Chaos Studio, you must first register the Chaos Studio resource provider before you onboard the resources and create an experiment. You must do these steps for each subscription where you use Chaos Studio:

articles/chaos-studio/chaos-studio-tutorial-agent-based-cli.md

@@ -19,7 +19,7 @@ You can use these same steps to set up and run an experiment for any agent-based
 ## Prerequisites
 
 - An Azure subscription. [!INCLUDE [quickstarts-free-trial-note](../../includes/quickstarts-free-trial-note.md)]
-- A virtual machine. If you don't have a VM, you can [create one](../virtual-machines/linux/quick-create-portal.md).
+- A virtual machine running an operating system in the [version compatibility](chaos-studio-versions.md) list. If you don't have a VM, you can [create one](../virtual-machines/linux/quick-create-portal.md).
 - A network setup that permits you to [SSH into your VM](../virtual-machines/ssh-keys-portal.md).
 - A user-assigned managed identity. If you don't have a user-assigned managed identity, you can [create one](../active-directory/managed-identities-azure-resources/how-manage-user-assigned-managed-identities.md).
 

articles/chaos-studio/chaos-studio-tutorial-agent-based-portal.md

@@ -18,7 +18,7 @@ You can use these same steps to set up and run an experiment for any agent-based
 ## Prerequisites
 
 - An Azure subscription. [!INCLUDE [quickstarts-free-trial-note](../../includes/quickstarts-free-trial-note.md)]
-- A Linux VM. If you don't have a VM, you can [create one](../virtual-machines/linux/quick-create-portal.md).
+- A Linux VM running an operating system in the [version compatibility](chaos-studio-versions.md) list. If you don't have a VM, you can [create one](../virtual-machines/linux/quick-create-portal.md).
 - A network setup that permits you to [SSH into your VM](../virtual-machines/ssh-keys-portal.md).
 - A user-assigned managed identity *that was assigned to the target VM or virtual machine scale set*. If you don't have a user-assigned managed identity, you can [create one](../active-directory/managed-identities-azure-resources/how-manage-user-assigned-managed-identities.md).
 

articles/chaos-studio/chaos-studio-versions.md

@@ -0,0 +1,54 @@
+---
+title: Azure Chaos Studio compatibility
+description: Understand the compatibility of Azure Chaos Studio with operating systems and tools.
+services: chaos-studio
+author: rsgel 
+ms.topic: overview
+ms.date: 01/26/2024
+ms.author: carlsonr
+ms.service: chaos-studio
+---
+
+# Azure Chaos Studio version compatibility
+
+The following reference shows relevant version support and compatibility for features within Chaos Studio. 
+
+## Operating systems supported by the agent
+
+The Chaos Studio agent is tested for compatibility with the following operating systems on Azure virtual machines. This testing involves deploying an Azure virtual machine with the specified SKU, installing the agent as a virtual machine extension, and validating the output of the available agent-based faults.
+
+| Operating system | Chaos agent compatibility | Notes |
+|:---:|:---:|:---:|
+| Windows Server 2019             | ✓ |   |
+| Windows Server 2016             | ✓ |   |
+| Windows Server 2012 R2          | ✓ |   |
+| Red Hat Enterprise Linux 8      | ✓ | Currently tested up to 8.9 |
+| openSUSE Leap 15.2              | ✓ |   |
+| CentOS 8                        | ✓ |   |
+| Debian 10 Buster                | ✓ | Installation of `unzip` utility required |
+| Oracle Linux 8.3                | ✓ |   |
+| Ubuntu Server 18.04 LTS         | ✓ |   |
+
+The agent isn't currently tested against custom Linux distributions or hardened Linux distributions (for example, FIPS or SELinux).
+
+If an operating system isn't currently listed, you may still attempt to install, use, and troubleshoot the virtual machine extension, agent, and agent-based capabilities, but Chaos Studio cannot guarantee behavior or support for an unlisted operating system.
+
+To request validation and support on more operating systems or versions, use the [Chaos Studio Feedback Community](https://aka.ms/ChaosStudioFeedback).
+
+## Chaos Mesh compatibility
+
+Faults within Azure Kubernetes Service resources currently integrate with the open-source project [Chaos Mesh](https://chaos-mesh.org/), which is part of the [Cloud Native Computing Foundation](https://www.cncf.io/projects/chaosmesh/). Review [Create a chaos experiment that uses a Chaos Mesh fault to kill AKS pods with the Azure portal](chaos-studio-tutorial-aks-portal.md) for more details on using Azure Chaos Studio with Chaos Mesh.
+
+Find Chaos Mesh's support policy and release dates here: [Supported Releases](https://chaos-mesh.org/supported-releases/).
+
+Chaos Studio currently tests with the following version combinations. 
+
+| Chaos Studio fault version | Kubernetes version | Chaos Mesh version | Notes |
+|:---:|:---:|:---:|:---:|
+| 2.1 | 1.25.11 | 2.5.1 | |
+
+The *Chaos Studio fault version* column refers to the individual fault version for each AKS Chaos Mesh fault used in the experiment JSON, for example `urn:csci:microsoft:azureKubernetesServiceChaosMesh:podChaos/2.1`. If a past version of the corresponding Chaos Studio fault remains available from the Chaos Studio API (for example, `...podChaos/1.0`), it is within support.
+
+## Browser compatibility
+
+Review the Azure portal documentation on [Supported devices](../azure-portal/azure-portal-supported-browsers-devices.md) for more information on browser support.