> ## Documentation Index
> Fetch the complete documentation index at: https://docs.axottle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Первый рабочий сценарий

> Подключите тестовую ноду, откройте терминал и файлы, выдайте доступ оператору и выполните первый плейбук.

Этот маршрут знакомит с полным циклом Telepúrte на одной тестовой Linux-машине. К концу у вас будет подготовленная нода, доступ оператора, рабочие SSH и файлы, результат задания и запись действий.

## Перед началом

Нужны установленная панель с HTTPS, локальный владелец с настроенным MFA и тестовый Linux-сервер с systemd. Для добавления сервера подготовьте адрес, SSH-порт и разовый административный вход. Для терминала понадобится действующий бастион, для заданий — агент с поддержкой выбранного действия.

Если Telepúrte ещё не установлен, пройдите [установку](https://docs.axottle.com/ru/telepurte/installation.md). Если нода уже есть в Axottle, используйте [импорт](https://docs.axottle.com/ru/telepurte/access.md), затем продолжите с проверки подключения.

## 1. Добавьте ноду

В **Парк нод → Добавить ноды** выберите подключение существующего Linux-сервера. Укажите понятное имя, например `test-web-01`, адрес и SSH-порт. Заполните разовый SSH-доступ и пройдите итоговую проверку мастера. При первом подключении SSH-ключ закрепляется автоматически; после подготовки сверьте его с независимым доверенным источником, например консолью провайдера.

Дождитесь результата подготовки. Появление строки в парке недостаточно: откройте карточку и проверьте SSH-готовность. При ошибке сначала разберите причину по [инструкции подключения](https://docs.axottle.com/ru/telepurte/nodes.md).

## 2. Проверьте маршрут подключения

На вкладке **Подключение** посмотрите адрес, SSH-порт, транспорт и выбранный бастион. Прямой SSH требует сетевой достижимости ноды; туннель через агент — работающего агентного канала. В **Бастионы** должны быть доступны нужные SSH/Web-точки входа.

Откройте терминал и выполните читающие команды:

```bash theme={null}
whoami
hostname
pwd
```

Сверьте системного пользователя и имя сервера. Это проверяет фактический вход, а не только состояние значка в каталоге.

## 3. Откройте файлы

Перейдите в файловую вкладку ноды и откройте домашний каталог текущего пользователя. Посмотрите список, откройте небольшой текстовый файл и скачайте его. Для проверки записи используйте новый тестовый файл в каталоге, где пользователь имеет право записи.

Если терминал работает, а файлы недоступны, проверьте SFTP, разрешённые корневые каталоги и файловые запреты. Для этих действий действуют отдельные ограничения; подробности — в [руководстве Web SFTP](https://docs.axottle.com/ru/telepurte/files.md).

## 4. Дайте доступ оператору

Создайте локального пользователя или пригласите его в разделе **Пользователи**. Для первого опыта удобнее отдельная роль с просмотром нод и доступом только к `test-web-01`. Выберите личную Linux-учётку, если её подготовку поддерживает агент, либо укажите существующий системный логин.

Назначьте роль пользователю. Для личной учётки дождитесь подтверждения подготовки на ноде. Откройте другую браузерную сессию и войдите под оператором: завершите MFA, проверьте видимость ноды и выполните `whoami`. Наличие учётки в панели само по себе не даёт SSH.

## 5. Выполните первый плейбук

В **Плейбуки и расписания** создайте сценарий с одним действием **Диагностика хоста**. Это читающая операция: она возвращает снимок CPU, uptime, памяти и корневого диска. Сохраните плейбук, нажмите **Запустить**, выберите тестовую ноду и проверьте цели.

Подтвердите **Выполнить сейчас**. Откройте задание из списка выполняющихся или истории. Дождитесь конечного результата именно для выбранной ноды и посмотрите результат шага. Если предварительная проверка сообщает, что агент не готов, сначала исправьте его состояние; SSH-подключение не заменяет агентную поддержку.

После этого можно перейти к [Bash и Ansible](https://docs.axottle.com/ru/telepurte/scripts.md), нескольким шагам и [расписаниям](https://docs.axottle.com/ru/telepurte/schedules.md).

## 6. Найдите следы работы

Закройте терминал и откройте **Сессии**. Найдите подключение по пользователю и ноде, откройте запись и проверьте вывод тестовых команд. В **Аудит** найдите выдачу доступа и события подключения. Результат плейбука проверяйте в истории заданий: это отдельный источник от записи интерактивного терминала.

## Проверка

Оператор входит под ожидаемой Linux-учёткой, разрешённая файловая операция выполняется, диагностика заканчивается результатом, сессия и выдача доступа находятся в истории. Дополнительно убедитесь, что оператору недоступна нода, которую вы ему не выдавали.

## Откат

Удалите созданный тестовый файл, отзовите тестовый доступ и проверьте отказ нового входа. Ненужный плейбук архивируйте; расписание, если создавали, приостановите. Отзыв роли не удаляет созданные пользователем файлы на сервере. Отключение тестовой ноды сохраняет историю, но закрывает новые подключения.

Доступность функций зависит от версии панели, бастионов и агентов; старые сборки могут не содержать описанных возможностей.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.