サービス

技能：エンジニア

技能：デザイナー

技能：ビジネス職

技能：バックオフィス

ジャンル

<blockquote>
<a href="https://qiita.com/advent-calendar/2021/dmm" target="_blank">DMMグループ Advent Calendar 2021</a>&nbsp;4日目の記事です。
</blockquote>

DMMの動画配信におけるインフラを担当している菅野です。

普段はオンプレで物理サーバ買ったりいじったりしてますが、最近ではGCPをいろいろ触ったりもしてます。

今回はオンプレサーバを管理するためにansibleを触っていたとき少しハマってしまった内容を記事にします。

<h2>事の起こり</h2>

サーバに入れてるミドルウェアのアップデートしたいので、ansibleでミドルウェアインストール用に切り出した&nbsp;<code>role</code>&nbsp;にフラグ判定で&nbsp;<code>latest</code>&nbsp;を入れる処理を入れてみました。

<pre>
<code>nginx.yml
--
tasks:
 # nginxを入れるtask
 - name: install nginx
 yum:
 name: nginx
 state: present

 # nginx.updateがtrueならlatestを入れることで最新版に上げる処理
 - name: update nginx 
 yum:
 name: nginx
 state: latest
 when: ( nginx.update | default(false) | bool ) 
group_vars/all.yml
--
nginx:
 update: true</code></pre>

これで&nbsp;<code>nginx.update</code>&nbsp;に&nbsp;<code>true</code>&nbsp;が入り本来であれば&nbsp;<code>latest</code>&nbsp;の方も実行されて最新版に更新される想定でした。

しかし、実際の実行結果では&nbsp;<code>nginx.update != true</code>&nbsp;と判定され&nbsp;<code>skip</code>&nbsp;になりました。

<pre>
<code>PLAY [all] ********************************************************************************************************************************************************************************************************************************************************************************************

TASK [Gathering Facts] ********************************************************************************************************************************************************************************************************************************************************************************
ok: [server01]

TASK [install nginx] **********************************************************************************************************************************************************************************************************************************************************************************
changed: [server01]

TASK [update nginx] ***********************************************************************************************************************************************************************************************************************************************************************************
skipping: [server01]

PLAY RECAP ********************************************************************************************************************************************************************************************************************************************************************************************
server01 : ok=3 changed=2 unreachable=0 failed=0 skipped=1 rescued=0 ignored=0 </code></pre>

<h2>原因</h2>

ansibleの変数は基本的にjinja2のテンプレートで処理が実施されるのですが、中身的にはpythonのdict型なため、pythonのdict型に組み込まれているメソッドがそのまま組み込まれています。

そして、そのメソッド名と同じ変数名をつけると外から見る分には見れるのですが、実際に参照しようと思うとメソッド呼び出し扱いになり、想定外の挙動になりました。

試しに&nbsp;<code>hoge</code>&nbsp;というdictを用意してその下に&nbsp;<code>update, upgrade, var1</code>&nbsp;というkeyで値を設定し、&nbsp;<code>hoge</code>&nbsp;全体と各key毎の値を出力してみました。

<pre>
<code>group_vars/all.yml
--
hoge:
 update: "update"
 upgrade: "upgrade"
 var1: "var1"
echo-vars.yml
--
- hosts: all
 tasks:
 - name: debug hoge
 debug:
 var: hoge
 - name: debug hoge.var1
 debug:
 var: hoge.var1
 - name: debug hoge.upgrade
 debug:
 var: hoge.upgrade
 - name: debug hoge.update
 debug:
 var: hoge.update</code></pre>

上記の&nbsp;<code>playbook</code>&nbsp;を実行した結果が下記になります。

<pre>
<code>PLAY [all] ********************************************************************************************************************************************************************************************************************************************************************************************

TASK [Gathering Facts] ********************************************************************************************************************************************************************************************************************************************************************************
ok: [server01]

TASK [debug hoge] *************************************************************************************************************************************************************************************************************************************************************************************
ok: [server01] =&gt; {
 "hoge": {
 "update": "update",
 "upgrade": "upgrade",
 "var1": "var1"
 }
}

TASK [debug hoge.var1] ********************************************************************************************************************************************************************************************************************************************************************************
ok: [server01] =&gt; {
 "hoge.var1": "var1"
}

TASK [debug hoge.upgrade] *****************************************************************************************************************************************************************************************************************************************************************************
ok: [server01] =&gt; {
 "hoge.upgrade": "upgrade"
}

TASK [debug hoge.update] ******************************************************************************************************************************************************************************************************************************************************************************
ok: [server01] =&gt; {
 "hoge.update": "&lt;built-in method update of dict object at 0x7f559978d240&gt;"
}

PLAY RECAP ********************************************************************************************************************************************************************************************************************************************************************************************
server01 : ok=5 changed=0 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0 </code></pre>

見て分かる通り&nbsp;<code>update</code>&nbsp;だけが&nbsp;<code>built-in method</code>&nbsp;扱いになっていることが分かります。

しかし、<code>hoge</code>&nbsp;全体で参照しようと思うと見れてしまうことに加えて&nbsp;<code>when</code>&nbsp;で処理する際もエラー等にはならず処理自体は通ってしまうため、デバッグでも見落としやすいです。

<h2>他のbuilt-in method</h2>

pythonのドキュメントから見て判断可能だった組み込みメソッドは下記の通りです。

<a href="https://docs.python.org/3/library/stdtypes.html#mapping-types-dict" target="_blank">Built-in Types｜docs.python.org</a>

<ul>
	<li>clear</li>
	<li>copy</li>
	<li>get</li>
	<li>items</li>
	<li>keys</li>
	<li>pop</li>
	<li>popitem</li>
	<li>setdefault</li>
	<li>update</li>
	<li>values</li>
</ul>

試しに上記の一覧全てを同様に変数出力してみました。

<pre>
<code>group_vars/all.yml
--
hoge:
 update: "update"
 upgrade: "upgrade"
 var1: "var1"
PLAY [all] *************************************************************************************************************************************************************

TASK [Gathering Facts] *************************************************************************************************************************************************
ok: [server01]

TASK [debug hoge] ******************************************************************************************************************************************************
ok: [server01] =&gt; {
 "hoge": {
 "update": "update",
 "upgrade": "upgrade",
 "var1": "var1"
 }
}

TASK [clear] ***********************************************************************************************************************************************************
ok: [server01] =&gt; {
 "hoge.clear": "&lt;built-in method clear of dict object at 0x7feaab32b240&gt;"
}

TASK [copy] ************************************************************************************************************************************************************
ok: [server01] =&gt; {
 "hoge.copy": "&lt;built-in method copy of dict object at 0x7feaab2c2678&gt;"
}

TASK [get] *************************************************************************************************************************************************************
ok: [server01] =&gt; {
 "hoge.get": "&lt;built-in method get of dict object at 0x7feaac09d480&gt;"
}

TASK [items] ***********************************************************************************************************************************************************
ok: [server01] =&gt; {
 "hoge.items": "&lt;built-in method items of dict object at 0x7feaab827090&gt;"
}

TASK [keys] ************************************************************************************************************************************************************
ok: [server01] =&gt; {
 "hoge.keys": "&lt;built-in method keys of dict object at 0x7feaab2c3510&gt;"
}

TASK [pop] *************************************************************************************************************************************************************
ok: [server01] =&gt; {
 "hoge.pop": "&lt;built-in method pop of dict object at 0x7feaab2d9a20&gt;"
}

TASK [popitem] *********************************************************************************************************************************************************
ok: [server01] =&gt; {
 "hoge.popitem": "&lt;built-in method popitem of dict object at 0x7feaab760e58&gt;"
}

TASK [setdefault] ******************************************************************************************************************************************************
ok: [server01] =&gt; {
 "hoge.setdefault": "&lt;built-in method setdefault of dict object at 0x7feaab795a68&gt;"
}

TASK [update] **********************************************************************************************************************************************************
ok: [server01] =&gt; {
 "hoge.update": "&lt;built-in method update of dict object at 0x7feaab2dab88&gt;"
}

TASK [values] **********************************************************************************************************************************************************
ok: [server01] =&gt; {
 "hoge.values": "&lt;built-in method values of dict object at 0x7feaab273090&gt;"
}

PLAY RECAP *************************************************************************************************************************************************************
server01 : ok=12 changed=0 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0</code></pre>

定義していないkeyについてもメソッドとして定義があるため参照することができ、全てが組み込みメソッド扱いとしてメッセージ表示される結果となりました。

<h2>まとめ</h2>

社内では結構クラウド寄りな記事が多そうだったので、あえてAnsibleを題材にヒトネタ書いてみました。

jinja2に潜む意外な罠でしたが、考えてみると「そうだよなあ」となりそうなものなのに、dict全体であれば変数が見れてしまうためハマってしまうと意外とすぐに気付けず苦労をしました。

また、ansibleだとデバッグ方法もtaskの間にdebugモジュールの処理を混ぜるぐらいしかできず、結構しづらいこともあるかと思います。それもまたハマりどころの一因かもしれないので良い方法があれば採用していきたいですね。

今回の記事の検証は下記のリポジトリにもまとめていますので、気になる方は試してみてください。

<a href="https://github.com/sinnershiki/2021-ad-cal" target="_blank">GitHub - sinnershiki/2021-ad-cal｜github.com</a>

<a href="https://qiita.com/advent-calendar/2021/dmm" target="_blank">DMMグループのカレンダー | Advent Calendar 2021 - Qiita｜qiita.com</a>

Ansible（jinja2）のdictで使ってはいけない変数名の話

シェア

関連する記事