Ansible lintのチェックでsyntax-checkのエラーが解消できない

Question

実現したいこと

roles配下のディレクトリに配置しているタスクのymlをimport_roleで取り込みたいです。

playbook自体のタスクは成功します。ただしlintによるチェックで
ロールが見つからないというsyntax-checkのエラーが解消出来ません。
どうすればエラーを解消できるのか何かお気づきの方がいらっしゃいましたら
ご教授頂けないでしょうか。
宜しくお願い致します。

発生している問題・エラーメッセージ

syntax-check[specific]: the role 'vip' was not found in <サーチ対象となっている複数のディレクトリのpathが出力されている>
playbook/roles/release/tasks/main.yml:4:11


                  Rule Violation Summary
 count tag                    profile rule associated tags
     1 syntax-check[specific] min     core, unskippable

Failed after : 1 failure(s), 0 warning(s) on 15 files.

該当のソースコード

playbook
    ├── playbook.yml
    ├── roles
    │     ├── deploy
    │     │     └── tasks
    │     │         └── deploy.yml
    │     ├── hoge
    │     │     └── tasks
    │     │         └── check_hoge.yml
    │     ├── release
    │     │     └── tasks
    │     │         └── main.yml
    │     └── vip
    │         └── tasks
    │             ├── service_in.yml
    │             └── service_out.yml
    └── vars
        └── main.yml

---
- name: Release Playbook
  hosts: all
  gather_facts: false
  roles:
    - release

---
- name: Import service_out.yml
  ansible.builtin.import_role:
    name: vip
    tasks_from: service_out.yml
  tags: service_out
- name: Import deploy.yml
  ansible.builtin.import_role:
    name: deploy
    tasks_from: deploy.yml
  tags: deploy
- name: Import check_hoge.yml
  ansible.builtin.import_role:
    name: hoge
    tasks_from: check_hoge.yml
  tags: check_hoge
- name: Import service_in.yml
  ansible.builtin.import_role:
    name: vip
    tasks_from: service_in.yml
  tags: service_in

試したこと

playbook.ymlのrolesにrelease以外のディレクトリも追加したがだめだった

---
- name: Release Playbook
  hosts: all
  gather_facts: false
  roles:
    - release
    - vip
    - deploy
    - hoge

補足情報（FW/ツールのバージョンなど）

Ansible 8

Answer 1

the role 'vip' was not found in <サーチ対象となっている複数のディレクトリのpathが出力されている>
playbook/roles/release/tasks/main.yml:4:11

なぜreleaseロールからvipロールを呼び出しているのですか？
release/tasks/main.ymlのソースを見る限りplaybook側に書くべきでは？と思いました。

Comments

[khaii21]

ご確認ありがとうございます。
ご指摘頂いた内容がきちんと把握できておらず申し訳ございません。
今まではエラーになっていなかったので構文的に問題無いと考えていました。
roles配下にimportする対象を配置しておけばimport_roleをすることによって呼び出せると考えていたのですが
違いましたでしょうか。
>playbook側に書くべきでは
これがきちんと理解しておらずイメージがつきませんでした。
もし宜しければどのようにすれば良いのかご教授頂けないでしょうか。

[comefigo]

謝らなくてもよいですよ。
エラーになっていないが、本来のロールの使い方ではないように思います。
ロール（Role）はその名前通りに一つの役割（英語でRole）を担う処理をまとめたものになります。

例えば、Linuxサーバに①Apacheをインストール、②Apacheの設定ファイルの配置、③Apacheのサービスの起動、④公開するコンテンツ（HTML、CSS、画像など）を配置するという一連の処理があるとします。

一連のApache関連の処理（①～③）をapacheロールにまとめることになります。
playbookでは全体（Apacheロールの呼び出し、コンテンツ配置）をコントロールします。

[khaii21]

ありがとうございます。
もう1点お伺いさせて下さい。
タスクを細分化しておき、ケースに合わせて個々のタスクをパーツのように使用したいです。
下記のように release/tasks 配下に配置して、main.ymlの中で
import_tasksするやり方は如何でしょうか。
これでエラーが解消できましたので、もし設定方法がおかしくなければこれで対応しようと考えています。

```
release/tasks/main.yml
│
release/tasks/deploy/tasks/deploy.yml
│
release/tasks/hoge/tasks/check_hoge.yml
│
release/tasks/vip/tasks/service_in.yml
│
release/tasks/vip/tasks/service_out.yml
```

[comefigo]

配置場所については、管理しやすさ、使いやすさ（プログラムでいう可読性、可用性など）などを考慮して決めればよいかと思います。正直そこは決めの問題です。
ただ、このスレの質問のようにLintを通したいとなると一般的な構成に従ってチェックされるので、一般的ではない使い方をされるとLintもきちんと判断できずにエラーになると思います。

ちなみにreleaseはroleの下でしょうか？

[khaii21]

>ちなみにreleaseはroleの下でしょうか？
はい。releaseだけroles直下に配置しています。

[comefigo]

releaseロールを実行したときに配下のタスクはすべて実行されますか？

[khaii21]

はい。想定どおりに全てのタスクが実行されます。

[comefigo]

であればそのままでよいですね。これもまた決めの問題です。
単純にreleaseロールの単位が大きすぎだと思います。
今時点動作していて、Lintも通っているとのことなので、無理に変更する必要もないと思いますので、このままでよいと思います。

[khaii21]

色々とご教授ありがとうございました。
とても勉強になりました。
大変助かりました。

[comefigo]

playbookは手順書になりますので、繰り返しますが、playbookでは全体の処理をコントロールします。

今の構成では手順書(playbook)の１章（role）にリリースの手順がすべて詰まっている状態です。
結果として正常に実行ができれば問題ないといえば問題ないですが、他の手順書で同じような手順を再利用したいときには都度１章の中のとある手順（tasks_from）を参照してくださいと書くことになるので、わかりづらくなり、コードの保守もしづらくなります。

なので、ほかのplaybookで再利用することがないのであればこのままでよいと思います。
まだピンと来ていないならばとりあえず現状のままで、今後運用していくうちに感覚がつかめてくるかと思います。