Skip to content

Multi-Team: Add teams verify command to validate multi-team configuration - #70947

Draft
SameerMesiah97 wants to merge 6 commits into
apache:mainfrom
SameerMesiah97:Multi-Team-Verify-Command
Draft

Multi-Team: Add teams verify command to validate multi-team configuration#70947
SameerMesiah97 wants to merge 6 commits into
apache:mainfrom
SameerMesiah97:Multi-Team-Verify-Command

Conversation

@SameerMesiah97

Copy link
Copy Markdown
Contributor

Description

This change introduces a new airflow teams verify CLI command for validating the consistency of multi-team deployments.

The command performs a series of integrity checks over the multi-team configuration, including verifying that every team has its system-managed default pool, that configured DAG bundles reference existing teams, and that team-managed pools follow the expected naming convention. All detected issues are reported in a single run before the command exits with a non-zero status.

Rationale

As multi-team support expands, it becomes increasingly important to detect configuration drift before it results in scheduling or operational issues.

The teams verify command provides administrators with a simple way to validate that the database and DAG bundle configuration remain consistent. Reporting all detected issues in a single run makes it suitable for operational checks, troubleshooting, and CI/CD validation.

Tests

Added unit tests verifying that:

  • Verification succeeds for a valid multi-team configuration.
  • Verification exits successfully when multi-team mode is disabled.
  • Missing team default pools are detected and reported.
  • DAG bundles referencing unknown teams are detected and reported.

Documentation

Added CLI help text describing the new teams verify command.

Backwards Compatibility

This change is additive. Existing behaviour is unchanged unless the new teams verify command is explicitly invoked.

Was generative AI tooling used to co-author this PR?
  • Yes (please specify the tool below)

Generated-by: [GPT 5.5] following the guidelines

Sameer Mesiah added 5 commits August 2, 2026 19:50
assign tasks without an explicit pool to the team's default pool during DAG
parsing. Add unit tests covering pool assignment and team creation, and
update the multi-team documentation to describe the new behaviour.
…missing pools for existing teams. Automatically remove the system-managed

default team pool during  while preserving protection for
user-created team pools. Add tests covering reconciliation and cleanup.
Only create missing default team pools during teams sync,
improve cleanup during team deletion, and update the
documentation and tests.
Adds a new  command to validate multi-team
configuration consistency. The command checks that every team has its
system-managed default pool, that DAG bundles reference existing teams,
and that team-owned pools follow the expected naming convention. Any
issues are reported together before the command exits with a non-zero
status.

Added unit tests covering successful verification, disabled multi-team
mode, missing default pools, and invalid DAG bundle team references.
@SameerMesiah97
SameerMesiah97 force-pushed the Multi-Team-Verify-Command branch from 89d2d7e to e1e279a Compare August 2, 2026 18:57
@SameerMesiah97

Copy link
Copy Markdown
Contributor Author

Depends on PR #69768. Do not review this until that is merged.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant