Skip to content

Incorrect tag fails silently (RDT-1591) #11

@loozhengyuan

Description

@loozhengyuan

Checklist

  • Checked the issue tracker for similar issues to ensure this is not a duplicate
  • Read the documentation to confirm the issue is not addressed there and your configuration is set correctly
  • Tested with the latest version to ensure the issue hasn't been fixed

How often does this bug occurs?

always

Expected behavior

Ideally, if any version tag does not exist, we should exit with non-zero exit-code.

Actual behavior (suspected bug)

In my case, I used 5.5.1 even though the correct version input should have been v5.5.1. Instead of throwing error, it goes on to give an illusion that 5.5.1 is correctly installed (judging from the file paths). The idf.py --version output:

Run idf.py --version
  idf.py --version
  shell: /usr/bin/bash --noprofile --norc -e -o pipefail {0}
  env:
    SYSTEM_PATH: /snap/bin:/home/runner/.local/bin:/opt/pipx_bin:/home/runner/.cargo/bin:/home/runner/.config/composer/vendor/bin:/usr/local/.ghcup/bin:/home/runner/.dotnet/tools:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/snap/bin:/tmp/esp/idf/5.5.1/esp-idf
    ESP_IDF_VERSION: 6.1
    IDF_TOOLS_PATH: /tmp/esp
    IDF_PATH: /tmp/esp/idf/5.5.1/esp-idf
    ESP_ROM_ELF_DIR: /tmp/esp/esp-rom-elfs/20241011
    OPENOCD_SCRIPTS: /tmp/esp/openocd-esp32/v0.12.0-esp32-20251215/openocd-esp32/share/openocd/scripts
    IDF_PYTHON_ENV_PATH: /tmp/esp/python/5.5.1/venv
fatal: No names found, cannot describe anything.
WARNING: Git version unavailable, reading from source
ESP-IDF v6.1.0

The installation logs correctly indicate that the tag does not exist but I think the more appropriate behaviour is to fail:

2025-12-29T12:21:12.797604104+00:00 - ERROR - Failed to checkout reference: The reference 'refs/tags/5.5.1' did not exist

Error logs or terminal output

/usr/bin/which apt-get
/usr/bin/apt-get
/usr/bin/sudo apt-get update
Get:1 file:/etc/apt/apt-mirrors.txt Mirrorlist [144 B]
Hit:2 http://azure.archive.ubuntu.com/ubuntu noble InRelease
Hit:6 https://packages.microsoft.com/repos/azure-cli noble InRelease
Get:7 https://packages.microsoft.com/ubuntu/24.04/prod noble InRelease [3600 B]
Get:3 http://azure.archive.ubuntu.com/ubuntu noble-updates InRelease [126 kB]
Get:4 http://azure.archive.ubuntu.com/ubuntu noble-backports InRelease [126 kB]
Get:5 http://azure.archive.ubuntu.com/ubuntu noble-security InRelease [126 kB]
Get:8 https://packages.microsoft.com/ubuntu/24.04/prod noble/main arm64 Packages [58.9 kB]
Get:9 https://packages.microsoft.com/ubuntu/24.04/prod noble/main armhf Packages [11.4 kB]
Get:10 https://packages.microsoft.com/ubuntu/24.04/prod noble/main amd64 Packages [77.2 kB]
Get:11 http://azure.archive.ubuntu.com/ubuntu noble-updates/main amd64 Packages [1684 kB]
Get:12 http://azure.archive.ubuntu.com/ubuntu noble-updates/main Translation-en [311 kB]
Get:13 http://azure.archive.ubuntu.com/ubuntu noble-updates/main amd64 Components [175 kB]
Get:14 http://azure.archive.ubuntu.com/ubuntu noble-updates/main amd64 c-n-f Metadata [15.8 kB]
Get:15 http://azure.archive.ubuntu.com/ubuntu noble-updates/universe amd64 Packages [1506 kB]
Get:16 http://azure.archive.ubuntu.com/ubuntu noble-updates/universe Translation-en [306 kB]
Get:17 http://azure.archive.ubuntu.com/ubuntu noble-updates/universe amd64 Components [378 kB]
Get:18 http://azure.archive.ubuntu.com/ubuntu noble-updates/universe amd64 c-n-f Metadata [31.4 kB]
Get:19 http://azure.archive.ubuntu.com/ubuntu noble-updates/restricted amd64 Packages [2413 kB]
Get:20 http://azure.archive.ubuntu.com/ubuntu noble-updates/restricted Translation-en [550 kB]
Get:21 http://azure.archive.ubuntu.com/ubuntu noble-updates/restricted amd64 Components [212 B]
Get:22 http://azure.archive.ubuntu.com/ubuntu noble-updates/restricted amd64 c-n-f Metadata [516 B]
Get:23 http://azure.archive.ubuntu.com/ubuntu noble-updates/multiverse amd64 Packages [30.3 kB]
Get:24 http://azure.archive.ubuntu.com/ubuntu noble-updates/multiverse Translation-en [6048 B]
Get:25 http://azure.archive.ubuntu.com/ubuntu noble-updates/multiverse amd64 Components [940 B]
Get:26 http://azure.archive.ubuntu.com/ubuntu noble-updates/multiverse amd64 c-n-f Metadata [488 B]
Get:27 http://azure.archive.ubuntu.com/ubuntu noble-backports/main amd64 Packages [40.4 kB]
Get:28 http://azure.archive.ubuntu.com/ubuntu noble-backports/main amd64 Components [7284 B]
Get:29 http://azure.archive.ubuntu.com/ubuntu noble-backports/main amd64 c-n-f Metadata [368 B]
Get:30 http://azure.archive.ubuntu.com/ubuntu noble-backports/universe amd64 Packages [29.5 kB]
Get:31 http://azure.archive.ubuntu.com/ubuntu noble-backports/universe Translation-en [17.9 kB]
Get:32 http://azure.archive.ubuntu.com/ubuntu noble-backports/universe amd64 Components [10.5 kB]
Get:33 http://azure.archive.ubuntu.com/ubuntu noble-backports/universe amd64 c-n-f Metadata [1444 B]
Get:34 http://azure.archive.ubuntu.com/ubuntu noble-backports/restricted amd64 Components [216 B]
Get:35 http://azure.archive.ubuntu.com/ubuntu noble-backports/multiverse amd64 Components [212 B]
Get:36 http://azure.archive.ubuntu.com/ubuntu noble-security/main Translation-en [225 kB]
Get:37 http://azure.archive.ubuntu.com/ubuntu noble-security/main amd64 Components [21.5 kB]
Get:38 http://azure.archive.ubuntu.com/ubuntu noble-security/main amd64 c-n-f Metadata [9504 B]
Get:39 http://azure.archive.ubuntu.com/ubuntu noble-security/universe amd64 Components [71.5 kB]
Get:40 http://azure.archive.ubuntu.com/ubuntu noble-security/restricted amd64 Components [212 B]
Get:41 http://azure.archive.ubuntu.com/ubuntu noble-security/multiverse amd64 Components [212 B]
Fetched 8375 kB in 2s (5034 kB/s)
Reading package lists...
    Permission denied (os error 13)
Configuration saved successfully to config.toml
You have successfully installed ESP-IDF
for using the ESP-IDF tools inside the terminal, you will find activation scripts inside the base install folder
sourcing the activation script will setup environment in the current terminal session
============================================
to activate the environment, run the following command in your terminal:
       source "/home/runner/.espressif/tools/activate_idf_5.5.1.sh"
============================================
2025-12-29T12:24:36.899760669+00:00 - INFO - Wizard result: Ok
2025-12-29T12:24:36.899772221+00:00 - INFO - Successfully installed IDF
2025-12-29T12:24:36.899780166+00:00 - INFO - Now you can start using IDF tools
Finding environment setup script...
/usr/bin/chmod +x /home/runner/.espressif/tools/activate_idf_5.5.1.sh
/home/runner/.espressif/tools/activate_idf_5.5.1.sh -e
PATH=/tmp/esp/cmake/4.0.3/cmake-4.0.3-linux-x86_64/bin:/tmp/esp/esp-clang/esp-20.1.1_20250829/esp-clang/bin:/tmp/esp/esp-rom-elfs/20241011/:/tmp/esp/esp32ulp-elf/2.38_20240113/esp32ulp-elf/bin:/tmp/esp/esp32ulp-elf/2.38_20240113/esp32ulp-elf/esp32ulp-elf/bin:/tmp/esp/ninja/1.12.1/:/tmp/esp/openocd-esp32/v0.12.0-esp32-20251215/openocd-esp32/bin:/tmp/esp/qemu-riscv32/esp_develop_9.2.2_20250817/qemu/bin:/tmp/esp/qemu-xtensa/esp_develop_9.2.2_20250817/qemu/bin:/tmp/esp/riscv32-esp-elf-gdb/16.3_20250913/riscv32-esp-elf-gdb/bin:/tmp/esp/riscv32-esp-elf/esp-15.2.0_20251204/riscv32-esp-elf/bin:/tmp/esp/riscv32-esp-elf/esp-15.2.0_20251204/riscv32-esp-elf/riscv32-esp-elf/bin:/tmp/esp/xtensa-esp-elf-gdb/16.3_20250913/xtensa-esp-elf-gdb/bin:/tmp/esp/xtensa-esp-elf/esp-15.2.0_20251204/xtensa-esp-elf/bin:/tmp/esp/xtensa-esp-elf/esp-15.2.0_20251204/xtensa-esp-elf/xtensa-esp-elf/bin:/tmp/esp/python/5.5.1/venv/bin
SYSTEM_PATH=/snap/bin:/home/runner/.local/bin:/opt/pipx_bin:/home/runner/.cargo/bin:/home/runner/.config/composer/vendor/bin:/usr/local/.ghcup/bin:/home/runner/.dotnet/tools:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/snap/bin:/tmp/esp/idf/5.5.1/esp-idf
ESP_IDF_VERSION=6.1
IDF_TOOLS_PATH=/tmp/esp
IDF_PATH=/tmp/esp/idf/5.5.1/esp-idf
ESP_ROM_ELF_DIR=/tmp/esp/esp-rom-elfs/20241011
OPENOCD_SCRIPTS=/tmp/esp/openocd-esp32/v0.12.0-esp32-20251215/openocd-esp32/share/openocd/scripts
IDF_PYTHON_ENV_PATH=/tmp/esp/python/5.5.1/venv
Set PATH
Set SYSTEM_PATH
Set ESP_IDF_VERSION
Set IDF_TOOLS_PATH
Set IDF_PATH
Set ESP_ROM_ELF_DIR
Set OPENOCD_SCRIPTS
Set IDF_PYTHON_ENV_PATH
Creating wrapper script for idf.py at /tmp/esp/bin/idf.py
/usr/bin/chmod +x /tmp/esp/bin/idf.py
Creating wrapper script for esptool.py at /tmp/esp/bin/esptool.py
/usr/bin/chmod +x /tmp/esp/bin/esptool.py
Creating wrapper script for espefuse.py at /tmp/esp/bin/espefuse.py
/usr/bin/chmod +x /tmp/esp/bin/espefuse.py
Creating wrapper script for espsecure.py at /tmp/esp/bin/espsecure.py
/usr/bin/chmod +x /tmp/esp/bin/espsecure.py
Creating wrapper script for otatool.py at /tmp/esp/bin/otatool.py
/usr/bin/chmod +x /tmp/esp/bin/otatool.py
Creating wrapper script for parttool.py at /tmp/esp/bin/parttool.py
/usr/bin/chmod +x /tmp/esp/bin/parttool.py
ESP-IDF installation and environment setup completed successfully

Steps to reproduce the behavior

steps:
  - uses: actions/checkout@v4
  - name: Install ESP-IDF
    uses: espressif/install-esp-idf-action@v1
    with:
      version: '5.5.1' # Missing the `v`-prefix
  - name: Output ESP-IDF version
    run: |
      idf.py build

Project release version

latest

System architecture

Intel/AMD 64-bit (modern PC, older Mac)

Operating system

Linux

Operating system version

Ubuntu 24.04

Shell

ZSH

Additional context

No response

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions