Read the Docs build information Build id: 4334305 Project: canonical-k8s-snap Version: latest Commit: b26ef13fd1ef0a705a82d43e1210261bae86d3fd Date: 2026-08-19T06:33:11.813930Z State: finished Success: False [rtd-command-info] start-time: 2026-08-19T06:33:12.576284Z, end-time: 2026-08-19T06:33:13.260915Z, duration: 0, exit-code: 0 git clone --depth 1 https://github.com/canonical/k8s-snap.git . Cloning into '.'... [rtd-command-info] start-time: 2026-08-19T06:33:13.337689Z, end-time: 2026-08-19T06:33:13.956038Z, duration: 0, exit-code: 0 git fetch origin --force --prune --prune-tags --depth 50 refs/heads/main:refs/remotes/origin/main [rtd-command-info] start-time: 2026-08-19T06:33:14.632215Z, end-time: 2026-08-19T06:33:14.699547Z, duration: 0, exit-code: 0 git checkout --force origin/main Note: switching to 'origin/main'. You are in 'detached HEAD' state. You can look around, make experimental changes and commit them, and you can discard any commits you make in this state without impacting any branches by switching back to a branch. If you want to create a new branch to retain commits you create, you may do so (now or later) by using -c with the switch command. Example: git switch -c Or undo this operation with: git switch - Turn off this advice by setting config variable advice.detachedHead to false HEAD is now at b26ef13 docs: add charm cluster annotations reference page (#2694) [rtd-command-info] start-time: 2026-08-19T06:33:14.773402Z, end-time: 2026-08-19T06:33:14.815781Z, duration: 0, exit-code: 0 cat docs/canonicalk8s/.readthedocs.yaml # .readthedocs.yaml # Read the Docs configuration file # See https://docs.readthedocs.io/en/stable/config-file/v2.html for details # Required version: 2 # Set the version of Python and other tools you might need build: os: ubuntu-22.04 tools: python: "3.12" jobs: post_checkout: # Cancel building pull requests when there aren't changed in the docs directory or YAML file. # # https://docs.readthedocs.io/en/latest/build-customization.html#cancel-build-based-on-a-condition # If there are no changes (git diff exits with 0) we force the command to return with 183. # This is a special exit code on Read the Docs that will cancel the build immediately. - | git fetch --unshallow || true if [ "$READTHEDOCS_VERSION_TYPE" = "external" ] && git diff --quiet origin/main -- docs/ .readthedocs.yaml; then exit 183; fi ls # Build documentation in the docs/ directory with Sphinx sphinx: builder: dirhtml configuration: docs/canonicalk8s/conf.py # If using Sphinx, optionally build your docs in additional formats such as PDF # formats: # - pdf # Optionally declare the Python requirements required to build your docs python: install: - requirements: docs/canonicalk8s/requirements.txt [rtd-command-info] start-time: 2026-08-19T06:33:14.894558Z, end-time: 2026-08-19T06:33:15.987590Z, duration: 1, exit-code: 0 git fetch --unshallow || true if [ "$READTHEDOCS_VERSION_TYPE" = "external" ] && git diff --quiet origin/main -- docs/ .readthedocs.yaml; then exit 183; fi ls AGENTS.md CODE_OF_CONDUCT.md CONTRIBUTING.md LICENSE README.md SECURITY.md build-scripts ci docs k8s pyproject.toml snap tests [rtd-command-info] start-time: 2026-08-19T06:33:20.060843Z, end-time: 2026-08-19T06:33:20.119983Z, duration: 0, exit-code: 0 asdf global python 3.12.13 [rtd-command-info] start-time: 2026-08-19T06:33:20.505291Z, end-time: 2026-08-19T06:33:21.141867Z, duration: 0, exit-code: 0 python -mvirtualenv $READTHEDOCS_VIRTUALENV_PATH created virtual environment CPython3.12.13.final.0-64 in 358ms creator CPython3Posix(dest=/home/docs/checkouts/readthedocs.org/user_builds/canonical-k8s-snap/envs/latest, clear=False, no_vcs_ignore=False, global=False) seeder FromAppData(download=False, pip=bundle, setuptools=bundle, wheel=bundle, via=copy, app_data_dir=/home/docs/.local/share/virtualenv) added seed packages: pip==23.1, setuptools==67.6.1, wheel==0.40.0 activators BashActivator,CShellActivator,FishActivator,NushellActivator,PowerShellActivator,PythonActivator [rtd-command-info] start-time: 2026-08-19T06:33:21.222753Z, end-time: 2026-08-19T06:33:26.996366Z, duration: 5, exit-code: 0 python -m pip install --upgrade --no-cache-dir pip setuptools Requirement already satisfied: pip in /home/docs/checkouts/readthedocs.org/user_builds/canonical-k8s-snap/envs/latest/lib/python3.12/site-packages (23.1) Collecting pip Downloading pip-26.2.1-py3-none-any.whl (1.8 MB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1.8/1.8 MB 14.0 MB/s eta 0:00:00 Requirement already satisfied: setuptools in /home/docs/checkouts/readthedocs.org/user_builds/canonical-k8s-snap/envs/latest/lib/python3.12/site-packages (67.6.1) Collecting setuptools Downloading setuptools-84.0.0-py3-none-any.whl (818 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 818.2/818.2 kB 27.0 MB/s eta 0:00:00 Installing collected packages: setuptools, pip Attempting uninstall: setuptools Found existing installation: setuptools 67.6.1 Uninstalling setuptools-67.6.1: Successfully uninstalled setuptools-67.6.1 Attempting uninstall: pip Found existing installation: pip 23.1 Uninstalling pip-23.1: Successfully uninstalled pip-23.1 Successfully installed pip-26.2.1 setuptools-84.0.0 [rtd-command-info] start-time: 2026-08-19T06:33:27.078556Z, end-time: 2026-08-19T06:33:35.577759Z, duration: 8, exit-code: 1 python -m pip install --upgrade --no-cache-dir sphinx Collecting sphinx ERROR: Could not install packages due to an OSError: HTTPSConnectionPool(host='files.pythonhosted.org', port=443): Max retries exceeded with url: /packages/73/f7/b1884cb3188ab181fc81fa00c266699dab600f927a964df02ec3d5d1916a/sphinx-9.1.0-py3-none-any.whl.metadata (Caused by ResponseError('too many 502 error responses'))