Most links off of the docs.ansible.com site are currently 404ing

This started to occur a few minutes ago; I had been reading docs before that.

The issue has been confirmed and we are notifying the proper teams and looking into it. Thanks!

ps. You also reported it in this thread: We’re moving to Read The Docs

I will let both comments in, as it might or might not be related and this one is in Get Help, so it will get more visibility for those impacted.

1 Like

This is known and the team is rerunning the jobs that build the docs website.

Thank you. What’s the story with readthedocs.io? I just got started with ansible in the last two months, and I was using docs from docs.ansible.com without issue. When, today, I saw the entire latest directory in was empty, I came to this forum to see that you’re supposed to be moving to readthedocs – but that post was dated 2023, two years ago.

What happened? Clearly, docsansiblecom is still functional, and most of the links on this forum outside the one thread point there.

Sorry all. Fix is incoming. This only affects the latest version of the docs which are also the Ansible 12 docs which you can find here: Ansible Documentation — Ansible Community Documentation

docs.ansible.com is the official home of the Ansible documentation. We’re planning to move the subdomain to Read The Docs hosting soon. It has just taken much longer than expected for a variety of reasons.

Edit for clarity

4 Likes

I’m sorry, but as of 1:34PM Eastern on 20 Oct docs.ansible.com/latest is once again down. I assume the issue is already being worked; can we have an ETA for restoration of service?

This isn’t related to the ongoing AWS outage, by any chance?

Are you looking for Ansible Documentation — Ansible Community Documentation (https://docs.ansible.com/ansible/latest/)? I’m not sure whether the URL without /ansible/ ever worked.

The latest version of the docs kept getting nuked but they should be back now. @bpendell apologies for the inconvenience that caused and thank you for reporting it.

Here is an explanation:

  • Docs are on the web server at /var/www/html/docs/ansible and the latest subdirectory is actually a symlink to whatever the corresponding version is. Right now that is /var/www/html/docs/ansible/12. This gets created during the build with ln -s 12 latest.
  • There was a change in the ansible/docsite repo to change the ansible/<version>/.htaccess file to ansible/latest/.htaccess when we released version 12. This was my idea. It turned out to be a bad one (sorry).
  • As a result the symlink was getting replaced by latest/.htaccess. This effectively turned the latest subdirectory into an empty folder on the hosts.

Here’s a link to the fix: Fix latest by oraNod · Pull Request #291 · ansible/docsite · GitHub

2 Likes

Thank you , yes, it appears to be working now. Kudos for the quick response!

Respectfully,

Brian P.

1 Like