Быстрый старт для администратора

Содержание

Быстрый старт для администратора#

Пройдите полный путь от подготовки окружения и создания проекта до выполнения задания. Процесс автоматизации состоит из следующих этапов:

Описание инвентаря – выбор и описание целевых узлов (инвентаря), к которым будет применяться автоматизация.
Создание проекта – создание проекта, как внутренней сущности платформы, которая использует готовый проект автоматизации. Обычно проекты размещаются в репозиториях систем управления исходным кодом (SCM, Source Control Management). Они включают один или несколько наборов сценариев автоматизации (playbooks).
Создание шаблона заданий – создание шаблона, который определяет параметры для запуска сценариев автоматизации.
Выполнение заданий – запуск заданий автоматизации с использованием созданного шаблона.

Описание инвентаря#

Этот простейший сценарий ориентирован на выполнение задания на локальном узле, который будет единственным элементом инвентаря. Создайте описание инвентаря следующим образом:

На панели навигации выберите Автоматизация процессов –> Инфраструктура –> Инвентарные списки (Automation Execution –> Infrastructure –> Inventories) .
Нажмите кнопку Создать инвентарный список (Create inventory) и выберите Создать инвентарный список (Create inventory).
В форме Создать инвентарный список (Create inventory) заполните следующие поля:
- в поле Название (Name) введите строку Quick Start Inventory;
- в поле Организация (Organization) выберите организацию Default.
Нажмите кнопку Создать инвентарный список (Create inventory). Откроется окно просмотра свойств созданного инвентарного списка.
Выберите вкладку Узлы (Hosts).
Нажмите кнопку Создать узел (Create host).
Заполните форму Создать узел (Create host):
- Название (Name): localhost.
- Переменные (Variables):
```
---
ansible_host: localhost
ansible_connection: local
```
Нажмите кнопку Создать узел (Create host).

Создание проекта#

Простейший проект автоматизации размещён в системе SCM. С помощью следующих шагов добавьте соответствующий проект, как внутреннюю сущность платформы:

На панели навигации выберите Автоматизация процессов –> Проекты (Automation Execution –> Projects).
Нажмите кнопку Создать проект (Create project).
Заполните форму Создать проект (Create project):
- Название (Name): Quick Start Project;
- Организация (Organization): Default;
- Тип системы управления исходным кодом (Source Control Type): Git;
- URL системы управления исходным кодом (Source Control URL):
```
https://gitflic.ru/project/astra_team/astra-automation-quick-start.git
```
Нажмите кнопку Создать проект (Create project).

Дождитесь завершения синхронизации проекта: убедитесь, что в поле Статус последнего задания (Last job status) отображается значение Успех (Success).

Создание шаблона заданий#

С помощью следующих шагов создайте шаблон для запуска заданий автоматизации, используя один из файлов сценариев автоматизации, входящих в созданный ранее проект:

На панели навигации выберите Автоматизация процессов –> Шаблоны (Automation Execution –> Templates).
Нажмите кнопку Создать шаблон (Create template) и в открывшемся меню выберите Создать шаблон задания (Create job template).
Заполните форму Создать шаблон задания (Create Job Template):
- Название (Name): Quick Start Template.
- Тип задания (Job Type): Выполнить (Run).
- Инвентарный список (Inventory): Quick Start Inventory.
- Проект (Project): Quick Start Project.
- Playbook: playbooks/quick-start.yml.
Нажмите кнопку Создать шаблон задания (Create job template)|. Откроется окно просмотра свойств шаблона.

С помощью шаблона задания вы сможете запускать задания вручную (см. далее) или по расписанию.

Выполнение заданий#

Запустите на выполнение задание, используя созданный ранее шаблон:

Для запуска задания нажмите кнопку Запустить шаблон (Launch template). Откроется окно с журналом выполнения задания.
Дождитесь перехода задания в статус Успех (Success), после чего обновите страницу браузера.

В окне вывода будет отображен журнал выполнения задания, например:

PLAY [Quick Start Playbook] ****************************************************

TASK [Print Quick Start] *******************************************************
ok: [localhost] => {
      "msg": "Quick Start with Astra Automation on localhost"
}

PLAY RECAP *********************************************************************
localhost                  : ok=1    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0

Заключение#

Выполненное руководство позволило вам получить первоначальный опыт по основным административным операциям в системе автоматизации. В процессе выполнения вы освоили ключевые действия:

Описание инвентаря с добавлением локального узла и определением необходимых переменных подключения.
Создание проекта, привязанного к внешнему репозиторию, с готовым сценарием автоматизации.
Формирование шаблона заданий, который связывает инвентарь, проект и требуемый playbook.
Запуск задания с контролем успешного завершения и анализом журнала выполнения.