Skip to main content

Создание организации

После развертывания ArcGIS Enterprise on Kubernetes в вашем кластере Kubernetes необходимо создать организацию ArcGIS Enterprise. Вы можете создать организацию двумя способами:

  • Использовать браузер для запуска мастера установки.

  • Используйте сценарий выполнения configure.sh для автоматического создания организации.

Скрипт конфигурации включен в пакет развертывания, который поставляется в виде файла .tar.gz и доступен для загрузки из My Esri.

Обе опции выполняют следующее:

  • Загрузка образов Esri Docker для ArcGIS Enterprise on Kubernetes

  • Развертывание контейнеров ArcGIS Enterprise on Kubernetes в кластере ArcGIS Enterprise on Kubernetes

  • Создание организации ArcGIS Enterprise

Использование мастера установки

После развертывания ArcGIS Enterprise on Kubernetes выполните следующие шаги с помощью мастера конфигурации, чтобы завершить настройку организации:

Откройте ссылку Создать новую организацию в веб-браузере. Перейдите к URL балансировщика нагрузки и присоедините /manager к концу URL. Например, если контекст вашего балансировщика — arcgis, откройте URL-адрес https://organization.example.com/arcgis/manager.

Страница перенаправляет на мастер настройки ArcGIS Enterprise on Kubernetes. Щелкните Продолжить. В мастере выполните следующие шаги:

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

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

  3. На странице Укажите лицензию загрузите файл лицензии ArcGIS Enterprise on Kubernetes и укажите тип пользователя для основной учетной записи администратора:

    1. Выберите файл лицензии (файл .json) , который лицензирует ваши типы пользователей и приложения в организации. Этот файл получен из My Esri.

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

      Вы можете изменить тип пользователя администратора после того, как организация будет создана.

    3. Щелкните Далее.

  4. На странице Создать учетную запись администратора создайте основную учетную запись администратора для вашей организации ArcGIS Enterprise. Укажите имя пользователя, пароль, адрес электронной почты, имя и фамилию, а также контрольный вопрос и ответ на него и щелкните Далее.

    Имя пользователя должно содержать не менее 6 символов. Допустимы следующие специальные символы: собака (@), тире (-), точка (.) и нижнее подчеркивание (_).

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

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

    1. Для Тип тома выберите Динамический или Статический, чтобы задать способ подготовки постоянных томов (PV).

      Используйте Статический, если PVC должен быть привязан к существующему PV. Используйте Динамический, если новый PV должен быть представлен через заданный класс хранилища.

    2. Для Имя класса хранилища укажите свое собственное имя класса хранилища или, если вы задали класс хранилища, укажите имя класса хранилища для каждого тома.

      Примечание:

      При привязке к существующему PV, для которого не определен класс хранилища, оставьте имя класса пустым. Если в кластере настроен класс хранения по умолчанию, контроллер допуска DefaultStorageClass добавляет класс хранения по умолчанию и предотвращает привязку PVC. В этом случае администратор может либо добавить спецификацию класса хранилища к PV, либо удалить конфигурацию класса хранилища по умолчанию.

    3. В качестве Размера (ГБ) задайте размер PV.

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

    4. Для Выбор надписи выберите надписи.

      Для статического соединения это обязательно. Надписи должны соответствовать надписям существующего PV. Примеры надписей см. в разделе Статическая подготовка.

    5. Если вам необходимо управлять узлами, на которых запланировано размещение системного хранилища данных, разверните Управление размещением модулей (дополнительно) и щелкните Управление правилами, чтобы настроить привязку узлов, или Управление допусками, чтобы задать допуски.

      На этом этапе рекомендуется применить политику размещения модулей, чтобы избежать необходимости переводить активную организацию в режим «только для чтения», если политика размещения модулей будет применена позже. Дополнительную информацию о размещении модулей см. в разделе Размещение модулей.

  6. Если вы используете облачное хранилище объектов, выберите сервис хранилища в ниспадающем меню и укажите информацию, необходимую для этого сервиса.

    1. В случае использования Amazon S3, предусмотрите следующую информацию:

      • Имя бакета — имя бакета, созданного в Amazon S3.

      • Регион - регион, где находится бакет.

        Примечание:

        Чтобы подключиться к частной конечной точке S3, выберите Пользовательские в качестве региона. Укажите URL-адрес для доступа к частному облаку в поле Частный URL.

      • Папка (необязательно) — имя существующей или несуществующей корневой директории в Amazon S3, которую можно использовать для объектного хранилища. Корневая директория не должна содержать файлы, созданные или используемые существующей организацией. Если значение не указано, используется значение по умолчанию arcgis. Если в бакете уже есть корневая директория, названная arcgis, вам необходимо указать новое уникальное имя корневой директории.

      • Тип аутентификации - Ключ доступа или Роль IAM.

      В случае использования Ключа доступа в качестве типа аутентификации, предусмотрите следующую информацию:

      • Ключ доступа - ключ доступа для пользователя IAM

      • Секретный ключ - секретный ключ для пользователя IAM

    2. В случае использования Azure Blob, предусмотрите следующую информацию:

      • Имя контейнера — имя контейнера, созданного в Azure.

      • Папка (дополнительно) - Имя существующей или несуществующей корневой директории в Azure Blob, которую можно использовать для хранилища объектов. Корневая директория не должна содержать файлы, созданные или используемые существующей организацией. Если значение не указано, используется значение по умолчанию arcgis. Если в бакете уже есть корневая директория, названная arcgis, вам необходимо указать новое уникальное имя корневой директории.

      • Учетная запись хранилища - Имя родительской учетной записи хранилища, под которой находится контейнер.

      • Домен хранилища — домен хранилища Azure, в котором существует контейнер хранилища BLOB-объектов.

        Примечание:

        Чтобы подключиться к пользовательской конечной точке Azure Blob, выберите Прочее в качестве домена хранилища и укажите URL-адрес или DNS-имя конечной точки для доступа к расположению хранилища.

      • Тип аутентификации - либо Ключ учетной записи хранилища, либо Управляемая идентификация.

      • В случае использования Ключа учетной записи хранилища в качестве типа аутентификации, предусмотрите следующую информацию:

        • Учетная запись хранилища - имя родительской учетной записи, под которой находится контейнер.

        • Ключ учетной записи - основной или вторичный ключ учетной записи для связанной учетной записи хранения.

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

        Примечание:

        Назначенные пользователем идентификаторы должны быть присвоены экземплярам, на которых запущены хостинговый и интегрированный сайты ArcGIS Server, и иметь как минимум доступ только для чтения к контейнеру учетной записи хранения. Если экземпляру или контейнеру хранилища назначено более одного управляемого удостоверения, назначенного пользователем, необходимо указать идентификатор клиента.

    3. При использовании хранилища Google Cloud, предусмотрите следующую информацию:

      • Имя бакета — имя бакета, созданного в хранилище Google Cloud.

      • Папка (необязательно) — имя существующей или несуществующей корневой директории в хранилище Google Cloud, которую можно использовать для объектного хранилища. Корневая директория не должна содержать файлы, созданные или используемые существующей организацией. Если значение не указано, используется значение по умолчанию arcgis. Если в бакете уже есть корневая директория, названная arcgis, вам необходимо указать новое уникальное имя корневой директории.

      • Ключ доступа - ключ доступа для сервисной учетной записи.

      • Секретный ключ - секретный ключ для сервисной учетной записи.

      Примечание:

      Хотя межрегиональный бакет повышает доступность и избыточность хранилища, он может привести к снижению производительности и непредсказуемой задержке при создании или восстановлении резервных копий. См. документацию Google Cloud для получения сведений о различиях между региональным, двухрегиональным и мультирегиональным облачным хранилищем и соображениями относительно местоположения.

  7. Если вы используете облачное реляционное хранилище, выберите сервис базы данных в ниспадающем меню и задайте приведенную далее информацию: Ознакомьтесь с разделом Рекомендации по использованию облачного хранилища, чтобы убедиться в том, что требования для этого варианта соблюдены.

    • Конечная точка базы данных — точка доступа базы данных, которая позволяет выполнять операции чтения и записи. Обычно это указывает на основной экземпляр базы данных, где происходят все изменения данных.

    • Конечная точка только для чтения (дополнительно) — конечная точка базы данных, которая используется только для операций чтения. Обычно это указывает на одну или несколько реплик чтения базы данных, которые синхронизированы с основным экземпляром. Конечные точки, доступные только для чтения, помогают распределить нагрузку, повышая производительность и доступность.

    • Порт базы данных — сетевой порт, на котором сервер базы данных прослушивает соединения. Порт по умолчанию - 5432.

    • Имя пользователя — имя пользователя учетной записи администратора базы данных, используемое для аутентификации в базе данных. Убедитесь, что у него есть необходимые для выполнения требуемых операций права доступа.

    • Пароль — пароль администратора базы данных.

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

    1. Введите имя папки хранилища данных.

    2. Выберите тип регистрации папки из ниспадающего меню.

    3. Если вы регистрируете сетевую файловую систему (NFS), укажите следующую информацию:

      • Путь к папке издателя — (дисковое или общее) местоположение, где исходные данные могут быть доступны и опубликованы клиентами, такими как ArcGIS Pro.

      • Имя хоста NFS — имя компьютера, на котором хранятся общие данные и к которому можно получить доступ через путь сетевой файловой системы (NFS).

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

    4. Если вы регистрируете Требование постоянного тома (PVC), укажите следующую информацию:

      • В поле Путь к папке издателя укажите общие местоположения, где исходные данные могут быть доступны и опубликованы клиентами, такими как ArcGIS Pro. Если вы используете путь к папке издателя с буквой диска, укажите имя хоста папки издателя.

      • Если вы используете хранилище данных на основе папок PV для сервисов геокодирования, выполните следующее:

        • Поставьте отметку Будет использоваться для сервисов маршрутизации или геокодирования.

        • Укажите локальный путь на узлах для локального PV в поле Путь к тому. Путь к тому доступен в файле определения постоянного тома.

      • Если хранилище данных для сервисов геокодирования не используется, выберите Linux или Windows в качестве типа общего ресурса.

      • Если вы выбрали Linux, предоставьте следующую информацию:

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

        • Для Имя хоста NFS укажите имя компьютера, на котором хранятся общие данные и к которому можно получить доступ через путь сетевой файловой системы (NFS).

      • Если вы выбрали Windows, укажите исходный путь общего ресурса Windows в Путь к тому. Путь к тому доступен в файле определения постоянного тома.

      • Предоставьте следующую информацию о спецификации тома PV. Эта информация будет использоваться для создания заявления постоянного тома (PVC), который привязывается к PV.

        • Режим доступа

        • Имя класса хранилища (необязательно)

        • Размер (ГиБ)

        • Имя постоянного тома

        • Имя заявления постоянного тома (необязательно)

    Чтобы зарегистрировать более одного пути, нажмите Зарегистрируйте папку и повторите этот шаг.

    Примечание:

    Рекомендуется регистрировать папки на этом шаге, так как регистрация позже может быть сопряжена с простоем системы.

  9. Щелкните Далее и просмотрите краткое описание конфигурации, представленное на странице Краткое описание конфигурации.

  10. Щелкните Завершить, чтобы начать установку.

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

Использование скрипта конфигурации

В качестве альтернативы использованию мастера установки можно выполнить создание организации в автоматическом режиме. После развертывания ArcGIS Enterprise on Kubernetes вы можете запустить сценарий выполнения configure.sh.

Примечание:

Рекомендуется запустить инструмент password-encrypt.sh, чтобы сгенерировать зашифрованные пароли для использования в файле configure.properties.

Запуск сценария

Сценарий configure.sh доступен для загрузки из My Esri и поставляется в виде файла .tar.gz. Сценарий поставляется в комплекте с файлом configure.properties, который предоставляет набор параметров, запрашивающих уникальные входные данные для вашей организации ArcGIS Enterprise, и инструментом password-encrypt.sh, который используется для создания зашифрованных паролей AES-256

Сценарий выполнения configure.sh выполняет следующее:

  • Проверка допустимых параметров в файле configure.properties

  • Создание JSON хранилища на основе предоставленных свойств хранилища, найденных в файле configure.properties

  • Создание организации ArcGIS Enterprise

Примечание:

Рабочая станция клиента, используемая для запуска этого сценария выполнения, должна иметь доступ к https://<FQDN>/<context>/admin.

Для запуска скрипта выполните следующие действия:

  1. На вашем клиентском компьютере Kubernetes откройте терминал от имени администратора.

  2. Перейдите к <ArcGIS Enterprise on Kubernetes install directory>/tools/configure.

  3. Откройте файл configure.properties.

  4. Укажите значения для каждого параметра, указанного в файле.

    Файл разделен на следующие части:

    • Архитектурный профиль

    • Организация

    • Лицензия

    • Ключевой файл шифрования

    • Учетная запись администратора

    • Настройки журналирования

    • Хранение

    Рекомендуемый размер хранилища для каждого тома зависит от указанного вами профиля доступности.

    Чтобы настроить организацию на использование облачного реляционного хранилища или облачного хранилища объектов, укажите полный путь к файлу .json для параметра CLOUD_CONFIG_JSON_FILENAME. Этот файл должен содержать информацию о вашем поставщике облачных услуг, учетных данных для доступа и конфигурации облачного сервиса. Вы можете использовать шаблоны, расположенные в папке <ArcGIS Enterprise on Kubernetes install directory>/templates/cloudconfig, в качестве примеров корректного форматирования этого файла для различных поставщиков облачных сервисов и шаблонов аутентификации. Информацию о том, как определить подходящие значения для конфигурации вашего сервиса вы найдете в документации вашего поставщика облачных сервисов.

  5. Сохраните файл. При необходимости переименуйте файл.

  6. В терминале запустите скрипт конфигурации, используя следующий формат командной строки:

    ./configure.sh [options] -f <user_properties>

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

      Примечание:

      В примере JSON ниже указаны сведения для сетевого файлового ресурса (NFS) с клиентским путем, который указывает на сетевой ресурс, а также NFS с клиентским путем, который указывает на локальный диск.

      [
  {
    "clientPath": "\\\\sample_server\\SharedPath\\Data",
    "type": "folder",
    "info": {
      "fileServerHost": "nfsHost.example.com",
      "fileServerType": "nfs",
      "fileServerPath": "/SharedPath/Data"
    }
  },
  {
    "clientPath": "C:\\data",
    "type": "folder",
    "info": {
      "fileServerHost": "nfsHost.example.com",
      "fileServerType": "nfs",
      "fileServerPath": "/data",
      "hostName": "yourclienthost.example.com"
    }
  }
]

    • Вам также потребуется присоединить путь к файлу .json к формату команды следующим образом:

    % ./configure.sh -f my.properties -u /path/to/my_data_stores.json

Содержимое <user properties> извлекается из файла configure.properties.

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

  • Если вы укажете y, как yes (да), скрипт будет выполнен и будет создана организация. Это вводное значение для скрипта по умолчанию.

  • Если же вы укажете n, как no (нет), вы сразу же выйдете из скрипта и организация не будет создана.