Дополнительная информация#

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

Команды Docker#

Показать контейнеры#

Чтобы показать список запущенных Docker контейнеров, используйте команду:

docker ps

Чтобы показать все имеющиеся Docker контейнеры, используйте команду:

docker ps -a

Копировать файлы в контейнер#

Можно переносить файлы в контейнер. Используйте команду docker cp для копирования файла в контейнер.

docker cp <file_location> <container_name>:<folder_inside_container>

Вход в контейнер#

Можно входить в отдельные контейнеры с помощью следующей команды:

docker exec -it <container_name> bash

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

exit

Имена образов#

Можно увидеть все имена образов с помощью команды

docker images

Просмотр логов контейнера#

Просмотреть логи контейнера можно с помощью следующей команды:

docker logs <container_name>

Удаление образа#

Если требуется удаление образа:

запустите команду docker images
найдите требуемый образ, например: dockerhub.visionlabs.ru/luna/facestream:v.5.2.8
скопируйте соответствующий ID образа из IMAGE ID, например, "61860d036d8c"
укажите его в команде удаления:

docker rmi -f 61860d036d8c

Удаление всех существующих образов:

docker rmi -f $(docker images -q)

Остановка контейнера#

Контейнер можно остановить с помощью следующей команды:

docker stop <container_name>

Остановка всех контейнеры:

docker stop $(docker ps -a -q)

Удаление контейнера#

Если необходимо удалить контейнер:

запустите команду "docker ps"
остановите контейнер (см. Остановка контейнера)
найдите требуемый образ, например: dockerhub.visionlabs.ru/luna/facestream:v.5.2.8
скопируйте соответствующий ID контейнера из столбца CONTAINER ID, например, "23f555be8f3a"
укажите его в команде удаления:

docker container rm -f 23f555be8f3a

Удаление всех контейнеров:

docker container rm -f $(docker container ls -aq)

Ключи запуска#

Ключи запуска задаются с помощью переменных окружения:

--env= — этот параметр задает переменные окружения, требуемые для запуска контейнера. Указываются следующие основные значения:
- CONFIGURATOR_HOST — хост, на котором запущен сервис Configurator. Локальный хост задается в случае, если контейнер запущен на том же сервере, где работает Configurator.
- CONFIGURATOR_PORT — порт прослушивания для сервиса Configurator. По умолчанию используется порт 5070.
- PORT — порт, где FaceStream будет слушать.
- STREAMS_ID — в теге задается список идентификаторов потоков, которые будут запрошены из LUNA Streams для обработки. Остальные потоки будут отфильтрованы. Параметр "stream_id" выдается в ответе на запрос "create stream".
  
  Если значение равно " " или тег "STREAMS_ID" не задан, то FaceStream будет брать из очереди все существующие "stream_id".
  
  Если задано несуществующее значение, то при запуске FaceStream будет указана ошибка о некорректном UUID.
  
  По умолчанию значение равно " ".
  
  Для использования ключа должны быть указаны переменные "CONFIGURATOR_HOST" и "CONFIGURATOR_PORT".
- STREAMS_NAME — в теге задается список имен потоков. Имена потоков задаются с помощью параметра "name" во время их создания (запрос "create streams"). Потоки с данными именами будут запрошены из LUNA Streams для обработки. Остальные потоки будут отфильтрованы.
  
  В остальном принцип работы схож с тегом "STREAMS_ID".
- GROUPS_ID и GROUPS_NAME — в тегах задаются список идентификаторов групп или список имён групп. Параметры "group_id" или "group_name" задаются во время создания потока (запрос "create stream"). Потоки с данными параметрами будут запрошены из LUNA Streams для обработки. Остальные потоки будут отфильтрованы.
  
  Если значение равно " " или теги "GROUPS_ID"/"GROUPS_NAME" не заданы, то FaceStream не будет фильтровать потоки по группам.
  
  Если задано несуществующее значение, то при запуске FaceStream будет указана ошибка о некорректном UUID.
  
  По умолчанию значение равно " ".
  
  Для использования ключей должны быть указаны переменные "CONFIGURATOR_HOST" и "CONFIGURATOR_PORT".
  
  Для тегов "STREAMS_NAME", "STREAMS_ID", "GROUPS_NAME" и "GROUPS_ID" можно задать несколько значений. Пример синтаксиса: --env=STREAMS_ID="037f3196-c874-4eca-9d7c-91fd8dfc9593 4caf7cf7-dd0d-4ad5-a35e-b263e742e28a"
- CONFIGS_ID — тег LUNA Configurator, который связан с основными конфигурациями для работы FaceStream. Единый тег должен быть задан для "TRACK_ENGINE_CONFIG" и "FACE_STREAM_CONFIG".
  
  Если задано значение " "\, то будут использованы записи по умолчанию "TRACK_ENGINE_CONFIG" и "FACE_STREAM_CONFIG" из LUNA Configurator. Если запись по умолчанию не существует или содержит недопустимый для JSON синтаксис, то будет использован конфигурационный файл из комплекта поставки.
  
  По умолчанию значение равно " ".
  
  Для использования ключа должны быть указаны переменные "CONFIGURATOR_HOST" и "CONFIGURATOR_PORT".
- CONFIG_RELOAD — тег, включающий проверку наличия изменений в секции "FACE_STREAM_CONFIG" сервиса LUNA Configurator и принимающий следующие значения:
  - "1" — отслеживание изменений включено, при наличии изменений в конфигурации будут автоматически перезапущены все контейнеры FaceStream;
  - "0" — отслеживание изменений отключено.
  По умолчанию значение равно "1".
- PULLING_TIME — тег, задающий период получения новых параметров из секции "FACE_STREAM_CONFIG" сервиса LUNA Configurator в диапазоне [1...3600] сек. Используется совместно с тегом "CONFIG-RELOAD".
  
  По умолчанию значение равно "10".
--device= — данный параметр необходим для указания адреса USB устройства. Адрес должен быть указан в источнике потока при его создании. Пример: --device=/dev/video0.

См. принцип работы FaceStream с LUNA Configurator в разделе "Использование FaceStream с LUNA Configurator" руководства администратора.

Расшифровка параметров запуска контейнера#

Ниже приведена расшифровка параметров запуска контейнера:

docker run — команда для запуска выбранного образа в качестве нового контейнера.
-v — параметр volume позволяет загружать содержимое серверной папки в объем контейнера. Таким образом содержимое синхронизируется.
-v /var/lib/fs/fs-current/extras/conf/configs/faceengine.conf:/srv/facestream/data/faceengine.conf \ — этот параметр позволяет использовать настройки FaceEngine из конфигурационного файла "faceengine.conf".
-v /var/lib/fs/fs-current/extras/conf/configs/runtime.conf:/srv/facestream/data/runtime.conf \ — этот параметр позволяет монтировать конфигурационный файл среды выполнения в контейнер FaceStream. Перед изменением стандартных настроек требуется проконсультироваться со специалистами VisionLabs.
--network=host — этот параметр указывает, что отсутствует симуляция сети и используется серверная сеть. При необходимости изменить порт для сторонних контейнеров следует заменить эту строку на -p 5440:5432. Здесь первый порт 5440 — это локальный порт, а 5432 — это порт, используемый в контейнере.
/etc/localtime:/etc/localtime:ro — задает текущий часовой пояс, используемый системой контейнера.
--name=facestream — этот параметр задает имя запускаемого контейнера. Имя должно быть уникальным. Если уже существует контейнер с таким же именем, произойдет ошибка.
--restart=always — этот параметр определяет политику перезагрузки. Daemon всегда перезагружает контейнер вне зависимости от кода завершения.
--detach=true — запуск контейнера в фоновом режиме.

Настройка ротации логов Docker#

Чтобы ограничить размер логов, генерируемых Docker, можно настроить автоматическую ротацию логов. Для этого необходимо добавить в файл /etc/docker/daemon.json следующие данные:

{
    "log-driver": "json-file",
    "log-opts": {
        "max-size": "100m",
        "max-file": "5"
    }
}

Это позволит Docker хранить до 5 файлов логов на контейнер, при этом каждый файл будет ограничен 100 Мб.

После изменения файла необходимо перезапустить Docker:

systemctl reload docker

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