From 167677aa0ff2b3fe6de9f214531182fa5e4ced98 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mete=20Fatih=20C=C4=B1r=C4=B1t?= Date: Fri, 24 Apr 2026 12:57:23 +0300 Subject: [PATCH 1/2] docs(ansible): point role READMEs at install_dev_env + --tags MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Phase 2 prep for https://github.com/autowarefoundation/autoware/issues/7052. Replaces the role-specific playbook invocations with the tag-based entry on install_dev_env.yaml so the old wrappers can be deleted. - acados: autoware.dev_env.setup_acados -> install_dev_env --tags acados - artifacts: download_artifacts -> install_dev_env --tags artifacts - qt5ct_setup: install_rviz_theme -> install_dev_env --tags qt5ct_setup - spconv: install_spconv.yaml -> install_dev_env --tags spconv (both standard and Jetson invocations) Signed-off-by: Mete Fatih Cırıt --- ansible/roles/acados/README.md | 2 +- ansible/roles/artifacts/README.md | 2 +- ansible/roles/qt5ct_setup/README.md | 2 +- ansible/roles/spconv/README.md | 4 ++-- 4 files changed, 5 insertions(+), 5 deletions(-) diff --git a/ansible/roles/acados/README.md b/ansible/roles/acados/README.md index 6b359a6ee00..64227ac6403 100644 --- a/ansible/roles/acados/README.md +++ b/ansible/roles/acados/README.md @@ -24,7 +24,7 @@ ansible-galaxy collection install -f -r "ansible-galaxy-requirements.yaml" This step should be repeated when the ansible directory is updated. ```bash -ansible-playbook autoware.dev_env.setup_acados --ask-become-pass +ansible-playbook autoware.dev_env.install_dev_env --tags acados --ask-become-pass ``` ## Directory layout diff --git a/ansible/roles/artifacts/README.md b/ansible/roles/artifacts/README.md index 8ed4ea92850..1dc63cab4cf 100644 --- a/ansible/roles/artifacts/README.md +++ b/ansible/roles/artifacts/README.md @@ -65,7 +65,7 @@ This step should be repeated when a new playbook is added. #### Run the playbook ```bash -ansible-playbook autoware.dev_env.download_artifacts -e "data_dir=$HOME/autoware_data" --ask-become-pass +ansible-playbook autoware.dev_env.install_dev_env --tags artifacts -e "data_dir=$HOME/autoware_data" --ask-become-pass ``` This will download and extract the artifacts to the specified directory and validate the checksums. diff --git a/ansible/roles/qt5ct_setup/README.md b/ansible/roles/qt5ct_setup/README.md index 41fc944eb4e..c9b986cde07 100644 --- a/ansible/roles/qt5ct_setup/README.md +++ b/ansible/roles/qt5ct_setup/README.md @@ -14,7 +14,7 @@ Follow the instructions below to **install** or **update** the custom theme for ```bash cd ~/autoware # The root directory of the cloned repository ansible-galaxy collection install -f -r "ansible-galaxy-requirements.yaml" -ansible-playbook autoware.dev_env.install_rviz_theme --ask-become-pass +ansible-playbook autoware.dev_env.install_dev_env --tags qt5ct_setup --ask-become-pass ``` ## How to use the custom theme in RViz2 diff --git a/ansible/roles/spconv/README.md b/ansible/roles/spconv/README.md index 0a6ef89603e..21d05666af1 100644 --- a/ansible/roles/spconv/README.md +++ b/ansible/roles/spconv/README.md @@ -25,7 +25,7 @@ The following command will install a particular version of the packages using an ```bash export SPCONV_CUMM_VERSION=0.5.3 export SPCONV_VERSION=2.3.8 -ansible-playbook autoware.dev_env.install_spconv.yaml -e spconv_cumm_version=${SPCONV_CUMM_VERSION} -e spconv_version=${SPCONV_VERSION} --ask-become-pass +ansible-playbook autoware.dev_env.install_dev_env --tags spconv -e spconv_cumm_version=${SPCONV_CUMM_VERSION} -e spconv_version=${SPCONV_VERSION} --ask-become-pass ``` ### Installation for NVIDIA Jetson platforms @@ -33,5 +33,5 @@ ansible-playbook autoware.dev_env.install_spconv.yaml -e spconv_cumm_version=${S ```bash export SPCONV_CUMM_VERSION=0.5.3 export SPCONV_VERSION=2.3.8 -ansible-playbook autoware.dev_env.install_spconv.yaml -e spconv_cumm_version=${SPCONV_CUMM_VERSION} -e spconv_version=${SPCONV_VERSION} -e spconv_is_jetson=true --ask-become-pass +ansible-playbook autoware.dev_env.install_dev_env --tags spconv -e spconv_cumm_version=${SPCONV_CUMM_VERSION} -e spconv_version=${SPCONV_VERSION} -e spconv_is_jetson=true --ask-become-pass ``` From 010eab88af70f48f8a07b911e0490866498a13bc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mete=20Fatih=20C=C4=B1r=C4=B1t?= Date: Fri, 24 Apr 2026 13:01:03 +0300 Subject: [PATCH 2/2] docs(ansible): drop lingering setup-dev-env.sh and universe.yaml refs MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Follow-up on the role README sweep. Two prose references still pointed at the deprecated entrypoints after the tag migration commit. - artifacts: the intro line claimed models download as part of setup-dev-env.sh; point at the ansible-playbook + --tags artifacts invocation instead. - ros2: the Manual Installation section linked universe.yaml as the canonical rosdistro source; point at install_dev_env.yaml which now owns that variable. Signed-off-by: Mete Fatih Cırıt --- ansible/roles/artifacts/README.md | 2 +- ansible/roles/ros2/README.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/ansible/roles/artifacts/README.md b/ansible/roles/artifacts/README.md index 1dc63cab4cf..438a0a805ee 100644 --- a/ansible/roles/artifacts/README.md +++ b/ansible/roles/artifacts/README.md @@ -1,6 +1,6 @@ # Autoware artifacts -The Autoware perception stack uses models for inference. These models are automatically downloaded as part of the `setup-dev-env.sh` script. +The Autoware perception stack uses models for inference. These models are downloaded by running `ansible-playbook autoware.dev_env.install_dev_env --tags artifacts`. The models are hosted by Web.Auto. diff --git a/ansible/roles/ros2/README.md b/ansible/roles/ros2/README.md index c1267954e14..6fd0b313c2b 100644 --- a/ansible/roles/ros2/README.md +++ b/ansible/roles/ros2/README.md @@ -29,7 +29,7 @@ The `ros2_installation_type` variable can also be found in: [./defaults/main.yaml](./defaults/main.yaml) For Universe, the `rosdistro` variable can also be found in: -[../../playbooks/universe.yaml](../../playbooks/universe.yaml) +[../../playbooks/install_dev_env.yaml](../../playbooks/install_dev_env.yaml) ```bash # Choose your ROS distribution