Ansible のドキュメントがRead The Docs への移行で URL が変更される（2025/11/10予定）→完了

はじめに

※ 移行前に記事を書きましたが、2025/11/10 20:00 (JST) 確認時点で移行が完了していました。記事を書いた当初の理解が違っていた事がわかったので全面的に修正しました。

「Ansible のドキュメント」と聞いて思い浮かぶのは https://docs.ansible.com/ansible/latest/ かなと思います。

2025/11/10 にdocs.ansible.com が Read The Docs 側コンテンツを示すように変更されました。

URL 的には、以下の変化があります。

• 旧: https://docs.ansible.com/ansible/latest/ （新URLにリダイレクトされます）
• 新: https://docs.ansible.com/projects/ansible/latest/

移行前では、Ansible Forum のトップにもこんな案内が表示されていました。

移行前の案内

2025/11/10 20:10 (JST) 時点で、移行完了のお知らせになっていました。

移行完了の案内

経緯

詳細は、Ansible Forum の以下のトピックにあります。

forum.ansible.com

ansible-lint や ansible-builder あたりの周辺ツールは既に Read The Docs 上（の ansible.readthedocs.io ）にコンテンツがあり、これに合わせるかたちのようです。こういう経緯もあって、逆に ansible-lint や ansible-nabigator などは、docs.ansible.com で見れるようになりました。

ansible-builder の例:

• 旧: https://ansible.readthedocs.io/projects/builder/en/latest/
• 新: https://docs.ansible.com/projects/builder/en/latest/

つまり、周辺ツール含めて docs.ansible.com 配下で見れるようになりました。

影響は？

旧 URL から新 URL にリダイレクされるので、たとえば既存の資料内の旧URLを急いで書き換えないといけないって話ではなさそうです。

ただ、いつまでリダイレクトが有効なのかは分かりません。

これから書く資料は、リダイレクトに依存せずに 新 URL を指すのがよいでしょう。

たとえば、cisco.ios.ios_command モジュールの説明ページであれば以下の対応です。（projects が含まれているのが特徴）

• 旧: https://docs.ansible.com/ansible/latest/collections/cisco/ios/ios_command_module.html
• 新: https://docs.ansible.com/projects/ansible/latest/collections/cisco/ios/ios_command_module.html

なお、Ansible 2.9 までのコレクションという概念がまだない時代のURLはいよいよ利用できなくなりました。もともとは例えば https://docs.ansible.com/ansible/latest/modules/ios_config_module.html が https://docs.ansible.com/ansible/latest/collections/cisco/ios/ios_config_module.html のように コレクションを示すパス cisco/ios を含む URL にリダイレクトされていましたが、移行後は https://docs.ansible.com/collections.html というコレクションを束ねる感じのページにリダイレクトされるようになりました。