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

Get Help
1

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

2

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
3

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

4

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.

5

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

6

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
7

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?

8

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.

9

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.

10

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
11

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

Respectfully,

Brian P.

1 Like