Использование FQCN: namespace.collection.module
Обращайтесь к содержимому современным способом
«Использование FQCN: namespace.collection.module» — бесплатный урок DevOps Bootcamp на CoddyKit. Это урок 3 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения DevOps Bootcamp, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс DevOps Bootcamp содержит 4 уроков всего.
Короткие имена неоднозначны
Вызов модуля с именем copy работает, но две коллекции могут поставлять каждая свой copy. FQCN устраняет любые сомнения относительно того, какой именно модуль Вы имеете в виду.
Расшифровка FQCN
FQCN означает полное имя коллекции: полный адрес модуля в формате namespace.collection.module.
Три части, один путь с точками
Читайте слева направо: пространство имён (владелец), коллекция (пакет), затем модуль. Каждая часть точнее определяет, что именно будет выполнено.
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. Оно однозначно указывает на один модуль и делает плейбуки безопасными при обновлении. 🎯
Часто задаваемые вопросы
Урок «Использование FQCN: namespace.collection.module» бесплатный?
Да — полный текст урока «Использование FQCN: namespace.collection.module» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс DevOps Bootcamp, подпишись на CoddyKit PRO. Курс DevOps Bootcamp содержит 4 уроков всего.
Чему я научусь в уроке «Использование FQCN: namespace.collection.module»?
Обращайтесь к содержимому современным способом Ты практикуешь DevOps Bootcamp с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.
Нужен ли мне опыт, чтобы начать DevOps Bootcamp?
Предыдущий опыт не требуется. DevOps Bootcamp на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 3 из 4.
Сколько времени занимает урок «Использование FQCN: namespace.collection.module»?
Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.
Можно ли писать и запускать код в этом уроке DevOps Bootcamp?
Да. Каждый урок DevOps Bootcamp включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.
Все уроки этого курса
- Роли и коллекции в Galaxy
- Установка ролей с requirements.yml
- Использование FQCN: namespace.collection.module
- Публикация собственной роли в Galaxy