Repository navigation
[AIP-94] airflowctl command migration #68402
Copy link
Copy link
Open
Labels
area:CLIarea:airflow-ctlkind:featureFeature RequestsFeature Requestskind:metaHigh-level information important to the communityHigh-level information important to the community
Milestone
Description
Activity
- addedkind:metaHigh-level information important to the communityHigh-level information important to the community
on Jun 11, 2026 - moved this to Backlog (Not Ready) in AIP-94: Decouple Remote Commands from airflow CLI (to airflowctl)
on Jun 11, 2026 - moved this from Backlog (Not Ready) to Ready in AIP-94: Decouple Remote Commands from airflow CLI (to airflowctl)
on Jun 11, 2026 - moved this from Ready to In progress in AIP-94: Decouple Remote Commands from airflow CLI (to airflowctl)
on Jun 11, 2026 I'm working on
connectionsReacted by Bugra Ozturk@ElangoSubramani, you mentioned you would like to work. Pick a single command. That would be easier rather than going for full. It would be helpful for reviews too.
Reacted by ELANGO SI'm going to take assets if that's cool.
I'm working on variables / config / jobs commands.
I'd like to take
backfill createandproviders get.12 remaining items
- added a commit that references this issue
on Jul 25, 2026 - added a commit that references this issue
on Jul 26, 2026 Moving to 3.4.0 as its more appropriate for minor
- added 2 commits that reference this issue
on Jul 30, 2026 - added a commit that references this issue
on Jul 31, 2026 - added a commit that references this issue
on Aug 7, 2026 - added a commit that references this issue
on Sep 24, 2026 All the items tracked here are now closed or merged. Can this be closed, or is there remaining work it should track?
I checked the unchecked items against
main.dags clearhas no marker yet. The airflowctl command landed in Add airflowctl dags clear command #68706, and [AIP-94] Mark dags clear as migrated to airflowctl #74384 adds the marker.dags reporthas no airflowctl equivalent. Likedags showanddags reserialize, it parses Dag files locally, so I think it belongs in the Admin section above.
Two checked items have the marker but no airflowctl command on
mainyet.providers getdepends on [AIP-94] Add airflowctl providers get #68854, which adds the REST endpoint.tasks listwas implemented in [AIP-94] Add airflowctl Tasks List Command #70472, which was closed by the open PR limit.
Apart from these, everything else looks done to me.
Metadata
Metadata
Assignees
Labels
area:CLIarea:airflow-ctlkind:featureFeature RequestsFeature Requestskind:metaHigh-level information important to the communityHigh-level information important to the community
Type
Projects
- StatusShow more project fieldsIn progress
Body
Goal: move every remote
airflowCLI command (anything backed by a public REST API endpoint)into
airflowctl. Admin commands have no API and are local-only. They run components (scheduler,api-server, triggerer, dag-processor, kerberos, standalone), manage the DB, or reach internals
directly (DAG parsing/rendering, local provider manager). Those remain in the
airflowCLI and areout of scope here.
Why:
AIP-81: Enhanced Security in CLI via Integration of API
and its sub-proposal
AIP-94: Decouple Remote Commands from the airflow CLI.
Status: converted. The only work per command now is to add the marker decorator to the
listed commands so they are frozen for development. There is no airflowctl migration to
do.
What to do:
decorator is converted to a maintainer and developer facing marker (it replaces the
user facing deprecation warning). Apply that same decorator to each command.
equivalent and adds a note in the code, and it does not print anything to users or
change behavior.
marked, no new features or behavior changes should land on it.
Admin (no API, local-only, not migrated, stay in the
airflowCLI):dags:show,show-dependencies,test,reserialize(parse/render DAGs directly)tasks:test,render(execute/render DAG files directly)providers:links,widgets,hooks,triggers,behaviours,logging,secrets,executors,queues,notifications,configs,lazy-loaded,auth-managers(read the localprovider manager)
dags
dags trigger[AIP-94] Create a CLI airflowctl client and adopt it in existing commands #68175dags delete[AIP-94] Create a CLI airflowctl client and adopt it in existing commands #68175dags listdags details[AIP-94] Migrate airflow dags details to the API server #68529dags statedags list-runsdags list-jobsdags list-import-errors[AIP-94] Mark dags list-import-errors as migrated to airflowctl #68602dags reportdags cleardags pausedags unpausedags next-executiontasks
taskstasks statetasks states-for-dag-runtasks cleartasks listtasks failed-depsassets
assets materialize([AIP-94] Create a CLI airflowctl client and adopt it in existing commands #68175)assets list[AIP-94] Add deprecation marker to assets list/details cli commands #68531assets details[AIP-94] Add deprecation marker to assets list/details cli commands #68531pools
pools: list / get / set / delete / import / export ([AIP-94] Create a CLI airflowctl client and adopt it in existing commands #68175)variables
variables list[AIP-94] Mark variables CLI commands as migrated to airflowctl #68932variables get[AIP-94] Mark variables CLI commands as migrated to airflowctl #68932variables set[AIP-94] Mark variables CLI commands as migrated to airflowctl #68932variables delete[AIP-94] Mark variables CLI commands as migrated to airflowctl #68932variables import[AIP-94] Mark variables CLI commands as migrated to airflowctl #68932connections
connections list[AIP-94] Mark connections commands as migrated to airflowctl #68972connections add[AIP-94] Mark connections commands as migrated to airflowctl #68972connections delete[AIP-94] Mark connections commands as migrated to airflowctl #68972connections import[AIP-94] Mark connections commands as migrated to airflowctl #68972connections test[AIP-94] Mark connections commands as migrated to airflowctl #68972connections create-default-connections[AIP-94] Mark connections commands as migrated to airflowctl #68972backfill
backfill createjobs
jobs checkconfig
config get-value[AIP-94] Mark config CLI commands as migrated to airflowctl #68958config list[AIP-94] Mark config CLI commands as migrated to airflowctl #68958providers
providers list[AIP-94] Migrate airflow providers command to the API server #68525providers get[AIP-94] Migrate airflow providers command to the API server #68525Committer