Интеграция с S3-хранилищем

Primo RPA Orchestrator позволяет хранить файлы в файловой системе или S3-совместимом объектном хранилище. Для некоторых типов файлов также предусмотрено хранение в базе данных.

В S3 могут размещаться:

• архивы дистрибутивов роботов и агентов – служба WebApi;
• архивы RPA-проектов – служба WebApi;
• скриншоты, передаваемые роботами вместе с журналами выполнения, – служба RobotLogs;
• NuGet-пакеты – служба NuGet.

Начиная с Orchestrator 1.26.9, для WebApi и RobotLogs добавлена поддержка Ceph наряду с MinIO. Также появилась возможность хранить архивы RPA-проектов в S3 вместо базы данных. Настройка S3 необязательна: используемый способ хранения определяется конфигурацией каждой службы.

Перед началом настройки

1. Подготовьте доступное из сети Оркестратора S3-совместимое хранилище и необходимые бакеты.
2. Получите у администратора хранилища адрес подключения, ключ доступа (AccessKey) и секретный ключ (SecretKey) с правами на требуемые операции.
3. Определите, какие файлы будут храниться в S3. Настройки WebApi, RobotLogs и NuGet задаются раздельно.
4. Создайте резервную копию действующей конфигурации и данных перед изменением способа хранения.

Во всех примерах используются условные адреса и значения ключей. Подставьте параметры своей инфраструктуры. Значение SecretKey должно быть зашифровано с помощью предусмотренного продуктом механизма. Не вставляйте незашифрованные ключи в примеры, документацию или репозиторий.

Настройка WebApi

В конфигурации WebApi секция FileStore определяет способ хранения файлов, в том числе архивов дистрибутивов роботов и агентов.

Выбор хранилища в FileStore

Пример настройки WebApi для Ceph:

{
  "FileStore": {
    "Type": 1,
    "S3": 1,
    "Ceph": {
      "Endpoint": "https://ceph.example.local:8080",
      "AccessKey": "YOUR_ACCESS_KEY",
      "SecretKey": "YOUR_ENCRYPTED_SECRET_KEY",
      "ForcePathStyle": true,
      "IgnoreValidateCert": false
    }
  }
}

Пример настройки WebApi для MinIO:

{
  "FileStore": {
    "Type": 1,
    "S3": 0,
    "Minio": {
      "Endpoint": "minio.example.local:9000",
      "AccessKey": "YOUR_ACCESS_KEY",
      "SecretKey": "YOUR_ENCRYPTED_SECRET_KEY",
      "SSL": true,
      "Bucket": "common-bucket",
      "Folder": "webapi",
      "IgnoreValidateCert": false
    }
  }
}

Хранение архивов RPA-проектов

Начиная с Orchestrator 1.26.9, хранилище архивов RPA-проектов можно выбирать отдельно. За это отвечает параметр StoreType в конфигурации хранения архивов проектов WebApi.

Для хранения новых загружаемых архивов проектов в S3 используется значение:

"StoreType": 2

Хранение файлов Kerberos keytab

В WebApi используется параметр S3KerberosKeytabs, который до версии 1.26.9 назывался MinioKerberosKeytab.

Если FileStore.Type равен 1 (S3) и словарь S3KerberosKeytabs заполнен, указанные keytab-файлы также хранятся в S3.

Пример фрагмента внутри секции FileStore:

"S3KerberosKeytabs": {
  "example.local": {
    "BucketName": "keytab",
    "ObjectName": "krb5.keytab"
  }
}

Если хранение keytab в S3 не используется, добавлять этот параметр не требуется.

Настройка RobotLogs

В службе RobotLogs за хранение скриншотов, передаваемых роботами вместе с журналами выполнения, отвечает секция ScreenFileUpload.

Пример настройки хранения скриншотов в Ceph:

{
  "ScreenFileUpload": {
    "StoreType": 1,
    "S3": 1,
    "Ceph": {
      "Endpoint": "https://ceph.example.local:8080",
      "AccessKey": "YOUR_ACCESS_KEY",
      "SecretKey": "YOUR_ENCRYPTED_SECRET_KEY",
      "ForcePathStyle": true,
      "IgnoreValidateCert": false
    }
  }
}

Пример настройки хранения скриншотов в MinIO:

{
  "ScreenFileUpload": {
    "StoreType": 1,
    "S3": 0,
    "Minio": {
      "Endpoint": "minio.example.local:9000",
      "AccessKey": "YOUR_ACCESS_KEY",
      "SecretKey": "YOUR_ENCRYPTED_SECRET_KEY",
      "SSL": true,
      "IgnoreValidateCert": false
    }
  }
}

В существующей секции ScreenFileUpload могут быть и другие настройки: MaxBatch, ScreenFilePath, AgentTimeOut и т. д. Не удаляйте их при добавлении параметров S3.

Параметры подключения к MinIO и Ceph

Настройка NuGet

Хранилище NuGet-пакетов настраивается отдельно от WebApi и RobotLogs – в секции Storage службы NuGet.

Использование MinIO

{
  "Storage": {
    "Type": "Minio"
  },
  "Minio": {
    "Endpoint": "minio.example.local:9000",
    "AccessKey": "YOUR_ACCESS_KEY",
    "SecretKey": "YOUR_ENCRYPTED_SECRET_KEY",
    "Bucket": "common-bucket",
    "Folder": "nuget",
    "SSL": true
  }
}

Использование файловой системы

{
  "Storage": {
    "Type": "FileSystem"
  },
  "FileSystem": {
    "Path": "C:\\OrchNuget"
  }
}

В Windows примером каталога является C:\OrchNuget, в Linux – /opt/Primo. Если FileSystem.Path отсутствует или пуст, используется каталог по умолчанию для соответствующей ОС.

Общий бакет для WebApi и NuGet

WebApi и NuGet могут использовать один бакет MinIO, записывая файлы в разные директории. Такая возможность поддерживается начиная с Orchestrator 1.25.9.

Например, для общего бакета common-bucket настройте:

WebApi – внутри секции FileStore.Minio:

{
  "Bucket": "common-bucket",
  "Folder": "webapi"
}

NuGet – внутри секции Minio:

{
  "Bucket": "common-bucket",
  "Folder": "nuget"
}

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

В конфигурации MinIO для NuGet пустое значение Folder ("") и "/" означают корневую директорию бакета.

Особенности обновления до Orchestrator 1.26.9

При обновлении конфигурации проверьте следующие изменения:

Проверка работоспособности

После изменения конфигурации перезапустите соответствующие службы, затем проверьте:

1. WebApi: загрузите и скачайте архив дистрибутива робота или агента.
2. WebApi: загрузите и скачайте новый архив RPA-проекта, убедитесь, что он попал в выбранное хранилище.
3. RobotLogs: выполните процесс, создающий скриншот, и проверьте его доступность в журнале робота.
4. NuGet: если используется MinIO, загрузите и получите тестовый пакет.
5. Проверьте журналы служб на ошибки доступа, TLS и обращения к S3.

При изменении конфигурации продуктивной системы полезно дополнительно проверить работу с крупными архивами (например, около 500 МБ), если такой объём характерен для ваших процессов.

Возможные проблемы