0Pricing
Ansible Academy · レッスン

FQCN の利用：namespace.collection.module

現代的な方法でコンテンツを参照します。

「FQCN の利用：namespace.collection.module」はCoddyKit上の無料Ansible Academyレッスンです。 これはレッスン3/4です。 下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。 これはAnsible Academy学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 Ansible Academyコースには全4レッスンが含まれています。

短縮名は曖昧です

モジュールを単にcopyと呼んでも動作しますが、2つのコレクションがそれぞれcopyを提供する可能性があります。FQCNを使えば、どのモジュールを指しているか迷うことはありません。

FQCNの正式名称

FQCNはFully Qualified Collection Nameの略です。namespace.collection.moduleという形式で記述する、モジュールの完全なアドレスです。

3つの部分、1つのドット区切り

左から順に読みます。namespace（所有者）、コレクション（パッケージ）、そしてモジュールです。それぞれの要素によって、実行されるものを正確に絞り込めます。

ansible.builtin.copy
# namespace.collection.module

コアはansible.builtinにある

これまで使ってきたおなじみのモジュールは、ansible.builtinコレクションにあります。そのため、copyの実体はansible.builtin.copyです。

- ansible.builtin.copy:
    src: app.conf
    dest: /etc/app.conf

デフォルトになった理由

現在はモジュールが多くのコレクションに分散しているため、毎回確実に正しいモジュールを解決できる名前はFQCNだけです。

コミュニティモジュールも同じ形式

他のパッケージのコンテンツも同じ形式に従います。たとえば、そのコレクションのファイアウォールモジュールはcommunity.general.ufwです。

- community.general.ufw:
    rule: allow
    port: "22"

短縮名も引き続き使える

copyのような通常の名前は組み込みモジュールで引き続き有効ですが、現在はリンターが警告します。完全なFQCNを使うことが推奨されています。

将来の変更にも強いプレイブック

FQCNを使えば、将来のAnsibleで短縮名の参照先が変更されても動作し続けるため、アップグレード後もプレイを安定して保てます。

FQCNはロールにも適用される

コレクションにはロールも含まれます。プレイでは、community.general.role_nameのように、同じドット区切りのアドレスで参照します。

roles:
  - role: geerlingguy.nginx

collectionsで入力を減らす

プレイのcollectionsキーにコレクションを指定すると、そのコレクションのモジュールを完全なプレフィックスなしの短縮名で使えるようになります。

collections:
  - community.general

FQCNを習慣にする

最初から完全なFQCNを書くと、プレイブックが曖昧にならず、リンターにも適合し、チームメンバーがソースを簡単に追跡できます。

クイックチェック

完全修飾モジュール名を構成する要素を確認してください。

まとめ

FQCNはnamespace.collection.moduleという形式で、たとえばansible.builtin.copyのように記述します。1つのモジュールを明確に指し、アップグレード後も安全にプレイブックを使えます。🎯

よくある質問

「FQCN の利用：namespace.collection.module」レッスンは無料ですか？

はい。「FQCN の利用：namespace.collection.module」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し（組み込みコードエディタと24時間対応のAIチューター）、Ansible Academyコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 Ansible Academyコースには全4レッスンが含まれています。

「FQCN の利用：namespace.collection.module」で何を学びますか？

現代的な方法でコンテンツを参照します。 ブラウザで直接実行するハンズオンコードでAnsible Academyを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。

Ansible Academyを始めるのに経験は必要ですか？

事前経験は必要ありません。CoddyKitのAnsible Academyは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。 これはレッスン3/4です。

「FQCN の利用：namespace.collection.module」レッスンにはどのくらい時間がかかりますか？

ほとんどのCoddyKitレッスンは約5～10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。

このAnsible Academyレッスンでコードを書いて実行できますか？

はい。すべてのAnsible Academyレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。

このコースのすべてのレッスン

  1. Galaxy における Role と Collection
  2. requirements.yml で Role をインストールする
  3. FQCN の利用：namespace.collection.module
  4. 自作 Role を Galaxy に公開する
← Ansible Academyに戻る