Skip to content

README.md

Latest commit

 

History

History
135 lines (98 loc) · 6.16 KB

README.md

File metadata and controls

135 lines (98 loc) · 6.16 KB

Развертывание модуля расширения

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

Сборка в docker

Для сборки проекта необходим docker и docker-compose.

Dockerfile рекомендуется расположить в корне проекта.

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

Пример рабочего Dockerfile:

FROM golang:1.22-bullseye AS build

RUN apt-get update && \
    apt install -y protobuf-compiler && \
    apt clean
RUN go env -w GOSUMDB=off
RUN go env -w GO111MODULE=on
RUN go install google.golang.org/protobuf/cmd/protoc-gen-go@v1.32.0 && \
    go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@v1.3.0

WORKDIR /src
COPY . .
RUN make build

FROM scratch AS release
LABEL ems.hypervisor.virtual-machine-set=default
LABEL ems.service.port=8081
WORKDIR /app
COPY --from=build /src/bin ./bin
ENTRYPOINT ["./bin"]

Подробнее здесь:

Сбилдить проект можно с помощью команды docker build .

Запустить решение в контейнере можно с помощью команды docker run -dp 127.0.0.1:8080:8080 <id_образа>.

Развертывание

В процессе работы система EMS ищет docker сервис с лейблом "ems.hypervisor.virtual-machine-set.operation-system" и значением, которое совпадает с названием операционной системы устройства или которое совпадает с названием и версией операционной системы устройства (разделенных пробелом).

Eсли не находит, то ищет сервис с лейблом "ems.hypervisor.virtual-machine-set", если не находит, то ищет сервис с лейблом "ems.hypervisor".

Список лейблов с описанием:

Один на выбор:

  • LABEL ems.hypervisor.virtual-machine-set.operation-system
    • Для привязки модуля расширения к операции для конкретных операционных систем устройств.
    • Для этого объявите этот лейбл с названием и версией операционной системы устройства, разделенных пробелом, в качестве значения лейбла.
  • LABEL ems.hypervisor.virtual-machine-set
    • Для привязки модуля расширения к операции для всех устройств.
    • Для этого объявите этот лейбл с любым значением.

Дополнительные:

  • LABEL ems.service.secure=default - активация защищенного соединения, в случае использования tls на gRPC сервере.
  • LABEL ems.service.port=8081 - порт, который прослушивает сервер.
  • LABEL ems.grpc-service.healthcheck=81 - порт для проверки доступности сервера.

Лейблы необходимо указывать в Dockerfile проекта.

Далее необходимо создать docker-compose.yaml файл конфигурации для развертывания сервиса через docker-compose.

Важно определить в конфигурации работу в сети ems-network, пример рабочего файла конфигурации выглядит следующим образом:

version: "3.9"

networks:
  default:
    name: 'ems-network'

services:
  hypervisor-vm-set-handler:
    build:
      context: .
      dockerfile: Dockerfile
    restart: unless-stopped
    logging:
      options:
        max-size: '50M'
        max-file: '5'
    ulimits:
      core:
        hard: 0
        soft: 0
    hostname: hypervisor-vm-set-handler
    environment:
      ServicePort: 8081
    deploy:
      resources:
        limits:
          cpus: "3"
          memory: 2000M
        reservations:
          cpus: "0.5"
          memory: 400M

Подробнее об этом здесь:

Для запуска модуля расширения в эксплуатацию необходимо поместить папку project на ВМ, где запущен EMS и выполнить команду docker-compose up --build -d из корня проекта.

Если приложения корректно запущено, то при выполнении команды docker ps | grep project-hypervisor-vm-set-handler-1 мы увидим вот такой результат:

CONTAINER ID   IMAGE                     COMMAND   CREATED         STATUS         PORTS     NAMES
059ed982d404   project-hypervisor-vm-set-handler   "./bin"   3 seconds ago   Up 2 seconds             project-hypervisor-vm-set-handler-1

Проверить работу сервиса можно через Postman, подробнее об этом описано здесь.

Для проверки в UI EMS необходимо:

  • Авторизоваться в EMS
  • Завести оборудование с сетевым интерфейсом по WMI
  • Зайти в проводник
  • Завести гипервизор как оборудование, добавив креды от ESXI
  • Зайти в карточку устройства
  • Перейти на вкладку Гипервизор

Подробнее можно прочитать в руководстве пользователя.
⚡