Быстрый старт

Описание

В данном разделе описываются методы тестового развертывания "Feecc Рабочее Место Инженера" для тестирования и оценки системы в производственной среде. В качестве инструмента развертывания системы "Feecc Рабочее Место Инженера" используется инструмент Docker Compose.

Предварительные настройки

Установка Docker Engine

  1. Обновите систему и установите служебные пакеты для установки Docker:

    Для Debian-based систем:

    sudo apt update -y
    sudo apt upgrade -y
    sudo apt dist-upgrade -y
    sudo apt autoremove -y
    sudo apt-get install \
        ca-certificates \
        curl \
        gnupg \
        lsb-release \
        git  
  2. Удалите старую версию Docker если она была

    Для Debian-based систем:

    sudo apt-get remove docker docker-engine docker.io containerd runc
  3. Добавьте официальный GPG ключ Docker и настройте список репозиториев

    Для Debian-based систем:

    sudo mkdir -p /etc/apt/keyrings
    curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
    
    echo \
    "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
    $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
  4. Установите Docker Engine

    Для Debian-based систем:

     sudo apt-get update
     sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin

В данный комплект поставки Docker Engine уже входит Docker Compose, по этому дополнительных манипуляций с Docker проводить не нужно.

Подготовка базы данных MongoDB

Для оперативного хранения и доступа к данным в "Feecc Рабочее Место Инженера" используется база данных MongoDB. В ходе подготовки к развертыванию "Feecc Рабочее Место Инженера" вы можете выбрать любой подходящий вам метод развертывания MongoDB, как на своей инфраструктуре так и на облачной, мы приложили несколько ссылок чтобы вам было удобнее ориентироваться:

Мы в свою очередь на первом этапе рекомендуем воспользоваться бесплатным MongoDB кластером в Atlas, данная платформа является крайне удобной и гибкой в рабочих задачах. Ниже будет инструкция как воспользоваться MongoDB Atlas в связке с "Feecc Рабочее Место Инженера" 1. Вам необходимо зарегистрироваться в MongoDB Atlas, указать свою почту, логин и пароль. 2. Вам необходимо создать свой первый бесплатный MongoDB кластер нажав на кнопку "Create" в разделе "Database" как на картинке ниже mongodb-step1 3. В разделе "Создание своего MongoDB кластера" вы можете выбрать бесплатный режим "Shared", а также провайдера услуги и месторасположение MongoDB кластера как на рисунке ниже mongodb-step2 4. После того как ваш первый MongoDB кластер был создан вы должны нажать на кнопку "Connect" для уточняния информации по методу подключения к MongoDB кластеру как на рисунке ниже mongodb-step3 5. В разделе методы подключения выберете "Connect your application" как на рисунке ниже mongodb-step4 6. В разделе "Select your driver and version" вам нужно выбрать Python и любую последнию версию от 3.10 как на рисунке ниже mongodb-step5

В результате всех манипуляций у вас будет строка в которой будет храниться информация о методе подключения к вашему MongoDB кластеру , где вместо черного прямоугольника будет ваш логин, а вместо поля <password> вам необходимо будет вписать ваш пароль, в формате mongodb+srv://yourlogin:yourpassword@...... эта строка будет использоваться в качестве значения переменной MONGODB_URI в .env файле при развертывании системы.

Создание аккаунта в Pinata.cloud

Для обеспечения быстрой доступности файлов из IPFS в обычной сети связи используется сервис Pinata.cloud. Чтобы завести аккаунт вам необходимо пройти по ссылке и завести собственный аккаунт, это бесплатно. Вам необходимо сохранить логин и пароль а также дополнительные данные API так как в дальнейшем они будет использоваться в "Feecc Рабочее Место Инженера" в переменных PINATA_API, PINATA_SECRET_API .

Создание аккаунта в YOURLS

Для обеспечения работы сокращателя ссылок вы можете развернуть как свой сервис YOURLS так и временно воспользоваться нашим сервисом YOURLS по ссылке utl.today Вам необходимо сохранить логин и пароль а также ссылку на ваш YOURLS сервис, так как в дальнейшем эти данные будут использоваться в "Feecc Рабочее Место Инженера" в переменных YOURLS_SERVER, YOURLS_USERNAME, YOURLS_PASSWORD

ВАЖНО, использование тестового аккаунта utl.today в реальном производстве строго запрещено, его можно использовать только для тестовТестовый аккаунт YOURLSYOURLS_SERVER:url.todayYOURLS_USERNAME:demouserYOURLS_PASSWORD:Jhvw*s4ndnEc6ttm

Создание аккаунта Robonomics parachain в экосистеме Polkadot

Для создания аккаунта Robonomics parachain в экосистеме Polkadot воспользуйтесь инструкцией по ссылке. Вам необходимо сохранить ключевые фразы аккаунта так как в дальнейшем они будут использованны в переменной ROBONOMICS_ACCOUNT_SEED.

Развертывание Feecc Рабочее Место Инженера

Для быстрого запуска Feecc Рабочее Место Инженера вы можете воспользоваться репозиторием feecc-demo в котором мы собрали несколько docker-compose и служебных файлов для развертывания Feecc Рабочее Место Инженера с использованием рекомендованного оборудования а также в режиме эмуляции рекомендованного оборудования.

Развертывание Feecc Рабочее Место Инженера с использованием рекомендованного оборудования

Для развертывания Feecc Рабочее Место Инженера с использованием рекомендованного оборудования вам необходимо выполнить следующие условия:

  1. Подключите все устройства к компьютеру/серверу на котором будет запущен Feecc Рабочее Место Инженера

    • Принтер этикеток к компьютеру/серверу используя USB
    • Сканер штрихкодов и RFID сканер используя USB
    • IP камера через PoE маршрутизатор/коммутатор
    • Опционально Сенсорный экран используя USB и HDMI/VGA
  1. Склонируйте репозиторий feecc-demo

    git clone https://github.com/Multi-Agent-io/feecc-demo.git
  2. Установите mongosh для управления вашей базой данных MongoDB.

    sudo apt-get install gnupg
    wget -qO - https://www.mongodb.org/static/pgp/server-6.0.asc | sudo apt-key add -
    echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list
    sudo apt-get update
    sudo apt-get install -y mongodb-mongosh
  3. Перейдите в папку проекта и в папке проекта перейдите в раздел "feecc-quickstart-supporthardware"

    cd ./feecc-demo/feecc-quickstart-supporthardware

    Импортируйте размеченную базу данных с коллекциями для MongoDB

    mongoimport --uri="mongodb+srv://....yourcluster...." --file=./

    Добавьте в размеченную базу данных ID вашей RFID карты, ФИО и права доступа пользователя

    mongosh "mongodb+srv://....yourcluster.... --apiVersion 1 --username yourusername"
  4. В разделе "feecc-quickstart-supporthardware" откройте файл .env любым файловым редактором и внесите информацию о переменных. Пример заполнения переменных указан в .env файле.

  5. Авторизуйтесь в Digital Ocean Contaier Registry который предоставляет компания Multi-Agent Systems для скачивания готовых контейнеров необходимых для развертывание Feecc Рабочее Место Инженера и запустите docker-compose

    docker login -u dop_v1_6debfd8d476d14847bf81aecc74dfcda1fb63a503ba2d61d66eaa113cc272596 -p dop_v1_6debfd8d476d14847bf81aecc74dfcda1fb63a503ba2d61d66eaa113cc272596 registry.digitalocean.com
    sudo docker-compose up -d --build --env-file=./.env
  6. Дождитесь окончания развертывания и проверьте работу системы "Feecc Рабочее Место Инженера" перейдя по ссылке в браузере http://localhost:3000/ и попытайтесь авторизоваться используя личную RFID карту которую вы указалии ранее.

Развертывание Feecc Рабочее Место Инженера в режиме эмуляции рекомендованного оборудования

Для развертывания Feecc Рабочее Место Инженера в режиме эмуляции рекомендованного оборудования необходимо выполнить следующие условия:

  1. Склонируйте репозиторий feecc-demo

    git clone https://github.com/Multi-Agent-io/feecc-demo.git
  2. Перейдите в папку проекта и в папке проекта перейдите в раздел "feecc-quickstart-hardwareemulation"

    cd ./feecc-demo/feecc-quickstart-supporthardware
  3. Авторизуйтесь в Digital Ocean Contaier Registry который предоставляет компания Multi-Agent Systems для скачивания готовых контейнеров необходимых для развертывание Feecc Рабочее Место Инженера и запустите docker-compose

    docker login -u dop_v1_6debfd8d476d14847bf81aecc74dfcda1fb63a503ba2d61d66eaa113cc272596 -p dop_v1_6debfd8d476d14847bf81aecc74dfcda1fb63a503ba2d61d66eaa113cc272596 registry.digitalocean.com
    sudo docker-compose up -d --build --env-file=./.env
  4. Дождитесь окончания развертывания и проверьте работу системы "Feecc Рабочее Место Инженера" перейдя по ссылке в браузере http://localhost:3000/ и проверьте работу системы в соответствии с инструкцией feecc-demo

previous ← Systems architecture next Support hardware →