Add env qa command group

Author: ofek

CHANGELOG.md

@@ -8,6 +8,11 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 ## Unreleased
 
+***Added:***
+
+- Add `env qa` command group for managing QA environments
+- Add the `linux-container` QA environment type
+
 ## 0.23.1 - 2025-07-25
 
 ***Fixed:***

docs/reference/interface/env/metadata.md

@@ -0,0 +1,11 @@
+# Environment metadata
+
+-----
+
+::: dda.env.models.EnvironmentMetadata
+
+::: dda.env.models.EnvironmentNetworkMetadata
+
+::: dda.env.models.EnvironmentPortMetadata
+
+::: dda.env.models.EnvironmentPort

docs/reference/interface/env/types/qa.md

@@ -0,0 +1,15 @@
+# QA environment interface
+
+-----
+
+Environment types implementing the [`QAEnvironmentInterface`][dda.env.qa.interface.QAEnvironmentInterface] interface may be managed by the [`env qa`](../../../cli/commands.md#dda-env-qa) command group.
+
+::: dda.env.qa.interface.QAEnvironmentConfig
+    options:
+      show_labels: true
+      unwrap_annotated: true
+
+::: dda.env.qa.interface.QAEnvironmentInterface
+    options:
+      show_labels: true
+      show_if_no_docstring: false

hatch.toml

@@ -15,9 +15,10 @@ extra-dependencies = [
 extra-dependencies = [
   "mypy",
   "pytest",
+  "types-pyyaml",
 ]
 [envs.types.scripts]
-check = "mypy --install-types --non-interactive {args:src/dda tests}"
+check = "mypy {args:src/dda tests}"
 
 [envs.docs]
 dependencies = [

mkdocs.yml

@@ -83,9 +83,11 @@ nav:
   - Interface:
     - Tool: reference/interface/tool.md
     - Environments:
-      - Status: reference/interface/env/status.md
       - Types:
         - Developer: reference/interface/env/types/dev.md
+        - QA: reference/interface/env/types/qa.md
+      - Status: reference/interface/env/status.md
+      - Metadata: reference/interface/env/metadata.md
 - Guidelines:
   - CLI: guidelines/cli.md
   - Documentation: guidelines/docs.md

pyproject.toml

@@ -40,6 +40,7 @@ dependencies = [
   "psutil~=7.0",
   "pyjson5~=1.6.9",
   "pywinpty~=2.0.15; sys_platform == 'win32'",
+  "pyyaml~=6.0.2",
   "rich~=14.0",
   "rich-click~=1.8.9",
   "tomlkit~=0.13",
@@ -178,7 +179,6 @@ legacy-notifications = [
     "codeowners==0.6.0",
     "invoke==2.2.0",
     "requests==2.32.3",
-    "pyyaml==6.0.1",
     "slack-sdk~=3.27.1",
     "tabulate[widechars]==0.9.0",
 ]

src/dda/cli/env/qa/__init__.py

@@ -0,0 +1,13 @@
+# SPDX-FileCopyrightText: 2025-present Datadog, Inc. <dev@datadoghq.com>
+#
+# SPDX-License-Identifier: MIT
+from __future__ import annotations
+
+from dda.cli.base import dynamic_group
+
+
+@dynamic_group(
+    short_help="Work with QA environments",
+)
+def cmd() -> None:
+    pass

src/dda/cli/env/qa/config/__init__.py

@@ -0,0 +1,13 @@
+# SPDX-FileCopyrightText: 2025-present Datadog, Inc. <dev@datadoghq.com>
+#
+# SPDX-License-Identifier: MIT
+from __future__ import annotations
+
+from dda.cli.base import dynamic_group
+
+
+@dynamic_group(
+    short_help="Manage Agent configuration",
+)
+def cmd() -> None:
+    pass

src/dda/cli/env/qa/config/explore/__init__.py

@@ -0,0 +1,35 @@
+# SPDX-FileCopyrightText: 2025-present Datadog, Inc. <dev@datadoghq.com>
+#
+# SPDX-License-Identifier: MIT
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+import click
+
+from dda.cli.base import dynamic_command, pass_app
+from dda.cli.env.qa.utils import option_env_type
+
+if TYPE_CHECKING:
+    from dda.cli.application import Application
+
+
+@dynamic_command(short_help="Open the Agent config location in your file manager")
+@option_env_type()
+@click.option("--id", "instance", default="default", help="Unique identifier for the environment")
+@pass_app
+def cmd(app: Application, *, env_type: str, instance: str) -> None:
+    """
+    Open the Agent config location in your file manager.
+    """
+    from dda.env.qa import get_qa_env
+
+    env = get_qa_env(env_type)(
+        app=app,
+        name=env_type,
+        instance=instance,
+    )
+    if not env.agent_config_dir.is_dir():
+        app.abort(f"QA environment `{instance}` of type `{env_type}` does not exist")
+
+    click.launch(str(env.agent_config.path), locate=True)

src/dda/cli/env/qa/config/find/__init__.py

@@ -0,0 +1,35 @@
+# SPDX-FileCopyrightText: 2025-present Datadog, Inc. <dev@datadoghq.com>
+#
+# SPDX-License-Identifier: MIT
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+import click
+
+from dda.cli.base import dynamic_command, pass_app
+from dda.cli.env.qa.utils import option_env_type
+
+if TYPE_CHECKING:
+    from dda.cli.application import Application
+
+
+@dynamic_command(short_help="Output the location of the Agent config")
+@option_env_type()
+@click.option("--id", "instance", default="default", help="Unique identifier for the environment")
+@pass_app
+def cmd(app: Application, *, env_type: str, instance: str) -> None:
+    """
+    Output the location of the Agent config.
+    """
+    from dda.env.qa import get_qa_env
+
+    env = get_qa_env(env_type)(
+        app=app,
+        name=env_type,
+        instance=instance,
+    )
+    if not env.agent_config_dir.is_dir():
+        app.abort(f"QA environment `{instance}` of type `{env_type}` does not exist")
+
+    app.display(str(env.agent_config.root_dir))