Проекты#
Окно Проекты (Projects) предназначено для управления источниками кода с помощью следующих операций:
подключение репозиториев Git, SVN и других источников сценариев;
синхронизация контента вручную или автоматически;
отслеживание версий кода, используемых платформой;
обеспечение контроля соответствия инфраструктурному репозиторию.
Для перехода к окну Проекты (Projects) выберите на панели навигации ().
Таблица проектов#
Внешний вид окна Проекты (Projects) представлен на схеме:
На панели инструментов размещаются кнопка для выбора всех записей в таблице, поле поиска, кнопка Создать проект (Create project) для создания проекта, кнопка ⋮ для вызова действий над выделенными записями, поле сортировки записей, кнопка Настроить столбцы (Manage columns) для настройки отображения столбцов, кнопки выбора формата таблицы.
Таблица проектов состоит из следующих столбцов, включая те, отображение которые может быть включено с помощью кнопки Настроить столбцы (Manage columns):
флаги для выбора нескольких проектов;
Название (Name) – название проекта;
Описание (Description) – описание проекта;
Статус (Status) – текущее состояние проекта;
Тип (Type) – тип источника кода проекта;
Пересмотр (Revision) – версия кода проекта;
Организация (Organization) – организация, которой принадлежит проект;
Дата создания (Created) – дата и время создания проекта;
Последнее изменение (Last modified) – дата и время последнего изменения проекта;
Последний раз использовался (Last used) – дата и время последнего использования проекта;
Среда по умолчанию (Default environment) – среда исполнения, назначенная проекту и используемая при запуске заданий из этого проекта, если иная среда исполнения не указана на уровне шаблона задания или рабочего процесса;
кнопки для быстрого вызова часто выполняемых действий:
синхронизация кода проекта с источником;
переход в окно редактирования свойств проекта;
создание копии проекта;
удаление проекта.
Просмотр#
Для получения подробных сведений о проекте нажмите на его название в таблице проектов.
Окно сведений о проекте состоит из следующих вкладок:
Подробности (Details) – общие сведения о проекте;
Расписания (Schedules) – таблица заданий по обновлению кода проекта из источника;
Шаблоны заданий (Job Templates) – таблица шаблонов заданий, использующих код проекта;
Доступ пользователей (User Access) – таблица пользователей и назначенных им ролей;
Командный доступ (Team Access) – таблица команд и назначенных им ролей;
Уведомления (Notifications) – таблица уведомлений.
Примечание
Эта вкладка недоступна для локальных проектов.
Создание#
Для создания проекта выполните следующие действия:
В окне Проекты (Projects) нажмите кнопку Создать проект (Create project).
Заполните форму Создать проект (Create project):
Название (Name) – укажите название проекта.
Особенности заполнения поля:
в рамках одной организации не допускается создание проектов с одним и тем же названием;
название проекта не может состоять из одних пробельных символов (пробелы, табуляции и так далее);
допускается использование символов кириллицы и специальных символов.
Описание (Description) – укажите описание проекта, например, его назначение или особенности использования.
Организация (Organization) – выберите организацию, которой принадлежит проект. В проекте должна быть хотя бы одна организация. После создания проекта вы сможете добавить другие организации.
Среда исполнения (Execution environment) – выберите среду исполнения, используемую для запуска заданий, созданных на основе проекта.
Примечание
Это поле становится доступным для редактирования после выбора организации. Среда исполнения, выбранная на уровне проекта, имеет более высокий приоритет, чем среды исполнения, выбранные на уровне контроллера и организации.
Тип системы управления исходным кодом (Source control type) – выберите тип источника кода проекта.
Особенности работы контроллера с различными типами источников описаны в разделе Источники кода.
Полномочия для проверки подписи контента (Content signature validation credential) – если для проверки аутентичности кода проекта следует использовать GPG, выберите соответствующие полномочия типа «Публичный ключ GPG».
Заполните поля, соответствующие выбранному источнику кода.
Базовый путь проекта (Project base path)
Значение в этом поле недоступно для изменения. Оно указывает на каталог, в котором выполняется поиск проекта.
Каталог сценариев автоматизации (Playbook Directory) – выберите локальный каталог с кодом проекта.
URL системы управления исходным кодом (Source control URL) – ссылка на репозиторий Subversion, в котором хранится код проекта.
Ветвь/Тег/Коммит системы управления исходным кодом (Source control branch/tag/commit) – если требуется использовать версию кода, отличную от последнего коммита в основной ветке, укажите в этом поле название необходимой ветки, название тега или хеш коммита.
Специальная ссылка системы управления исходным кодом (refspec) (Source control refspec) – если требуется использовать специфичную версию кода, укажите в этом поле правила получения необходимых ссылок из репозитория Git.
Полномочие на систему управления исходным кодом (Source control credential) – если для доступа к репозиторию требуется аутентификация, выберите в этом поле соответствующие полномочия типа Система управления версиями (Source Control).
Опции (Options) – настройки, отвечающие за поведение запуска:
Стереть (Clean)
Если эта настройка включена, перед обновлением будут сброшены все локальные изменения кода.
Удалить (Delete)
Если эта настройка включена, при обновлении локальная копия кода проекта будет удалена, после чего загружена заново.
В зависимости от размера репозитория это может значительно увеличить время, необходимое для завершения обновления.
Отслеживать подмодули (Track submodules)
Если эта настройка включена, при обновлении проекта будут также обновлены все его субмодули.
Обновлять ревизию при запуске (Update revision on launch)
Если эта настройка включена, перед запуском заданий на основе проекта его код будет обновляться автоматически.
Разрешить переопределение ветви (Allow branch override)
Если эта настройка включена, в шаблоне задания можно выбрать ветку или версию кода, отличные от указанных в свойствах проекта.
URL системы управления исходным кодом (Source control URL) – ссылка на репозиторий Subversion, в котором хранится код проекта.
Номер редакции (Revision number) – если требуется использовать ревизию кода, отличную от последнего коммита в основной ветке, укажите в этом поле номер необходимой ревизии.
Полномочие на систему управления исходным кодом (Source control credential) – если для доступа к репозиторию требуется аутентификация, выберите в этом поле соответствующие полномочия типа Система управления версиями (Source Control).
Опции (Options) – настройки, отвечающие за поведение запуска:
Стереть (Clean)
Если эта настройка включена, перед обновлением будут сброшены все локальные изменения кода.
Удалить (Delete)
Если эта настройка включена, при обновлении локальная копия кода проекта будет удалена, после чего загружена заново.
В зависимости от размера репозитория это может значительно увеличить время, необходимое для завершения обновления.
Обновлять ревизию при запуске (Update revision on launch)
Если эта настройка включена, перед запуском заданий на основе проекта его код будет обновляться автоматически.
Разрешить переопределение ветви (Allow branch override)
Если эта настройка включена, в шаблоне задания можно выбрать ветку или версию кода, отличные от указанных в свойствах проекта.
Учетные данные Insights (Insights credential) – выберите соответствующее полномочие для использования Red Hat Insights.
Опции (Options) – настройки, отвечающие за поведение запуска:
Стереть (Clean)
Если эта настройка включена, перед обновлением будут сброшены все локальные изменения кода.
Удалить (Delete)
Если эта настройка включена, при обновлении локальная копия кода проекта будет удалена, после чего загружена заново.
В зависимости от размера репозитория это может значительно увеличить время, необходимое для завершения обновления.
Обновлять ревизию при запуске (Update revision on launch)
Если эта настройка включена, перед запуском заданий на основе проекта его код будет обновляться автоматически.
URL системы управления исходным кодом (Source control URL) – ссылка на архив, в котором хранится код проекта.
Полномочие на систему управления исходным кодом (Source control credential) – если для доступа к репозиторию требуется аутентификация, выберите в этом поле соответствующие полномочия типа Система управления версиями (Source Control).
Опции (Options) – настройки, отвечающие за поведение запуска:
Стереть (Clean)
Если эта настройка включена, перед обновлением будут сброшены все локальные изменения кода.
Удалить (Delete)
Если эта настройка включена, при обновлении локальная копия кода проекта будет удалена, после чего загружена заново.
В зависимости от размера репозитория это может значительно увеличить время, необходимое для завершения обновления.
Обновлять ревизию при запуске (Update revision on launch)
Если эта настройка включена, перед запуском заданий на основе проекта его код будет обновляться автоматически.
Разрешить переопределение ветви (Allow branch override)
Если эта настройка включена, в шаблоне задания можно выбрать ветку или версию кода, отличные от указанных в свойствах проекта.
Нажмите кнопку Создать проект (Create project).
После создания проекта его настройки можно изменять с помощью различных групп параметров, описанных в последующих секциях.
Настройка доступа#
Во вкладках Доступ пользователей (User Access) и Командный доступ (Team Access) выводятся списки пользователей или команд и назначенных им ролей.
Назначение ролей отдельным пользователям#
Чтобы настроить доступ к проекту для отдельных пользователей, выполните следующие действия:
Во вкладке Доступ пользователей (User Access) нажмите кнопку Добавить роль (Add roles).
Выберите пользователей, которым хотите назначить роли, и нажмите кнопку Далее (Next).
Выберите роли, которые хотите назначить выбранным на предыдущем шаге пользователям.
Нажмите кнопку Завершить (Finish).
Назначение командных ролей#
Чтобы настроить доступ к проекту для всех участников одной или нескольких команд, выполните следующие действия:
Во вкладке Командный доступ (Team Access) нажмите кнопку Добавить роль (Add roles).
Выберите команды, участникам которых хотите назначить роли, и нажмите кнопку Далее (Next).
Выберите роли, которые хотите назначить выбранным на предыдущем шаге командам.
Нажмите кнопку Завершить (Finish).
Отзыв ролей#
Чтобы отозвать пользовательские или командные роли, выполните следующие действия:
Во вкладке Доступ пользователей (User Access) или Командный доступ (Team Access) установите флаги в строках с пользователями или командами, соответственно, у которых следует отозвать роли.
На панели инструментов нажмите кнопку ⋮ и в открывшемся меню выберите пункт Удалить роли (Remove roles).
Подтвердите отзыв роли.
Примечание
Роли «Системный администратор» (System Administrator) и «Системный аудитор» (System Auditor) нельзя отозвать через настройку доступа на уровне проекта, однако, можно изменить тип пользователя.
Удаление#
Удаление проектов имеет следующие особенности:
при удалении проекта связанные с ним шаблоны заданий и инвентарные списки не удаляются и могут быть связаны с новым проектом;
при удалении проекта, использующего в качестве источника локальный каталог, файлы проекта не удаляются с диска.
Чтобы удалить проект, выполните следующие действия:
В таблице установите флаги в строках с проектами, которые необходимо удалить.
На панели инструментов нажмите кнопку ⋮ и в открывшемся меню выберите пункт Удалить проекты (Delete projects).
Подтвердите удаление.
Обновление#
Если проект использует внешний источник кода, для поддержания локальной копии в актуальном состоянии необходимо обновлять проект. Automation Controller позволяет обновлять код проектов вручную или автоматически, при этом автоматическое обновление может выполняться при запуске связанных с проектом заданий или по расписанию.
Чтобы обновить проект вручную, во вкладке Подробности (Details) нажмите кнопку Синхронизировать проект (Sync project).
Совет
Для быстрого запуска обновления проекта можно использовать кнопку Синхронизировать проект (Sync project), доступную в строке проекта, который необходимо обновить.
Чтобы проект автоматически обновлялся перед запуском связанных с ним заданий, в настройках источника включите соответствующие флаги в блоке Опции (Options).
Чтобы проект обновлялся по расписанию, настройте его следуя инструкциям в документе Расписания.