はじめに ネットワークモジュールが長らく内部的に利用している SSH クライアントライブラリとして、paramiko があります。 最近は ansible-pylibssh というもの新しいものもあります。登場した経緯は Ansible の公式ブログの記事に書かれています。 そして…

はじめに 最近のバージョンの Ansible で Cisco IOS などのネットワーク機器に操作する Playbook を実行すると、以下のような警告（WARNING）を見かけたことはないでしょうか、 [WARNING]: ansible-pylibssh not installed, falling back to paramiko エラー…

はじめに 先日、Ansible 4系から 6系にバージョンアップしたら、今まで正常に動いていた Cisco IOS に対して処理する Playbook が動かなくなる現象に出会いました。 以下のように、認証エラーです。 fatal: [sw01]: FAILED! => {"changed": false, "msg": "F…

はじめに 最近、ansible/ansible-sdk というリポジトリが公開されました。 Python から Playbook を実行できるようです。とりあえず気になるので試してみました。 リポジトリ内にサンプルの Python スクリプトと、Playbookが入ってるので試すだけならかなり…

はじめに 先日 Ansible の公式ブログで、Event-Driven Ansible という言葉が含まれるブログが次々と投稿されました。 Introducing the Event-Driven Ansible developer preview Getting Started with Event-Driven Ansible It takes a community: how partne…

はじめに 2022/09/30 に Ansible Automation Platform の Automation Controller を中心とした各プロダクト、サービスについて解説している「Demystifying Ansible Automation Platform」という書籍が発売されました。 demystifying と言う言葉は今回はじめ…

はじめに 2022/09/30 に、Ansible Automation Platform（AAP）について解説された書籍（洋書）「Demystifying Ansible Automation Platform」が発売されました。 Ansible をとりまくツールやプロダクト群を学んだり、Automation Controller （旧Ansible Towe…

はじめに AWX の UI （画面）で一部修正したい箇所があり、修正してPRを出したところマージしていただきました。 github.com AWX の UI 修正は今回が初めてでした。特にフロントエンドは分からないことが多い状態からでしたが、どうにか無事にマージしていた…

はじめに 以前の記事で、VS Code の Ansible 拡張で「ファイル名やモードライン」によって、ファイルが関連付けされるようになったことを書きました。 tekunabe.hatenablog.jp その後のアップデートで、バージョン 0.14.0では、ファイルの内容までチェックし…

はじめに リリースされたばかりの netbox.netbox コレクション 3.8.0で、こんな changelog がありました。 Allow netbox api access token to be templated by @TWitzenrath in #806 パッと見では分からなかったのですが、元の PR #806を見ると、netbox.netb…

はじめに Playbookではモジュールにオプションを指定してさまざまな処理を自動化していきます。 Playbookを書いていくうちに、このモジュール（またはコレクション単位）のこのオプションにはいつも同じ値を設定する、というときはないでしょうか。 たとえば…

はじめに コレクションをインストールするには ansible-galaxy collection install コレクション名やアーカイブファイル名前 という書式が一番シンプルかなと思います。 docs.ansible.com 複数のコレクションをいっぺんにインストールしたい場合は、]require…

はじめに VS Code で Ansible の Playbook を作成するときに便利な、Ansible という拡張があります。モジュール名やキーワードを自動補完してくたり、ansible-lint と連携してくれたり、とても便利な拡張です。 marketplace.visualstudio.com この拡張を有効…

Ansible のどのバージョンで、どのバージョンの Python をサポートしているか、ぱっと出てきますでしょうか。それはマネージドノード側の話でしょうか、コントロールノード側の話でしょうか。 私は、ansible-core 2.11 をよく触ってる時期があって、Python 3…

はじめに AWX のユーザーインターフェイスを少し修正したい機会があって、どうやって試す環境を作れるのだろうと調べていました。 このあたりは公式ドキュメントがしっかりしていて、以下のページが非常に参考になりました。 UI を用意: https://github.com/…

結構検索したときにもヒットしますが、Ansibleに日本語の公式ドキュメントがあります。 2020年に公開されました。 docs.ansible.com バージョンスイッチャーに、最近のバージョンがないので 2.9 までしかない、と思われるかもしれません。私もそう思っていま…

はじめに Ansible のドキュメントは Sphinx で生成されるようになっています。 これまでちょっとした文言修正は、ちゃんとビルドして確認してこなかったのですが、先日書式レベルで修正したことがありました。そのため、ビルドする方法をしらべて試しました…

はじめに コレクションの不具合を調べたりする際、どのリポジトリで管理されてるかを特定する必要があります。その方法はいくつかありますが、2つご紹介します。 コレクション詳細ページから コレクション詳細ページ（azure.azcollection であればここ）に、…

インストール方法 コレクションは各リポジトリで開発が進んでいて、適宜リリースされます。 リリースされたものは ansible-gallaxy collection install コレクション名 でインストールできます。 一方、バグ修正されたり、機能追加されたけどまだリリースさ…

こんな変更がありました。 github.com コントロールノードで Python 3.9 以上を必要とするようになるようです。これまでは 3.8 以上でした。 devel ブランチへのマージのみです。おそらくこのまま行けば、2022年11月リリース予定の ansible-core 2.14が、こ…

私や私の周辺では、Ansible Automation Platformのことを、よく略して AAP と呼んでいます。 しかし、人によって AAP が指す範囲が微妙に違うように感じることがあります。 特に AAP 2 のリリース以降です。AAP は AAP 1 時代から AAP ですが（変な言い方で…

議論される場所 Ansible community package (pip install ansible でインストールされる方)は、ansible-core に加えて、さまざまなコレクションがインストールされます。 インストールされるコレクションは、公式ドキュメントの Collection Indexや、リポジ…

ansible 2.9 では、コレクション一覧を表示する ansible-galaxy collection list コマンドが利用できません（ansible-base 2.10から）。 そのため、コレクションの一覧やバージョンを確認するには、別の方法が必要です。 デフォルトのコレクションインストー…

コミュニティとしてはすでに EOL Ansible 2.10 で大きくパッケージング、配布の方式が変わったからなのか、前のバージョン Ansible 2.9 の開発がしばらく続いていました。ですが、2021年10月の 2.9.27を最後にリリースが止まっています。 コミュニティとして…

はじめに Cisco IOS のネットワーク機器に任意のコンフィグを投入する、cisco.ios.ios_config というモジュールがあります。 本モジュールを使ったPlaybookを実行して changed になると、以下のような冪等性に関する警告が表示されます。 % ansible-playbook…

少しややこしい ansible まわりのバージョン表記 ansible 2.10 から、ansible-base(2.10)や、ansible-core(2.11から)というコア部分のパッケージと、各種コレクションも含むパッケージ（Ansible community packageと呼ばれたりします）が登場しました。 pip …

Ansibleもくもく会 2022.6に参加しました。 そこで、copy モジュールの src オプションで相対パスで指定されたファイルはどこから探してくるか、という話題がありました。 files ディレクトリを先に探しに行くことは知っていたのですが、細かく公式ドキュメ…

はじめに AWS上のEC2インスタンスの情報を動的にインベントリとして利用できる、amazon.aws.aws_ec2というインベントリープラグインがあります。 その中に、include_filtersというオプションがあり、Nameタグの情報などで抽出条件を指定できます。 include_f…

はじめに Ansibleもくもく会 2022.5にて、質疑応答を担当するメンターにて参加させていただきました。 "" で書こう意味について質問いただいたので、分かる範囲でお答えしました。その内容についてまとめます。 ディクショナリと区別するために "" で囲う Pl…

はじめに Ansible(-base) 2.10 から、多くのモジュールはコレクションという管理、配布方式に移行しました。 その関係で「前あったあのモジュール、プラグインはどのコレクションにいったんだ？」と気になることがあるかもしれません。 正確には、しれません…