# Провайдер Proxmox

Данный тип сервис-провайдера предоставляет возможность публикации сервисов виртуальных рабочих столов в среде гипервизора ProxmoxVE.

## Создание сервис-провайдера <a href="#provider" id="provider"></a>

Для создания сервис-провайдера зайдите в раздел "Сервисы", нажмите "Новый" и выберите тип провайдера "Proxmox".

<figure><img src="https://raw.githubusercontent.com/hostco-ru/hostvm/master/.gitbook/assets/proxmox1.png" alt=""><figcaption></figcaption></figure>

### Основные настройки <a href="#main" id="main"></a>

**Имя (Name)** - наименование сервис-провайдера;

**Хост (Host)** - имя/IP-адрес кластера или сервера виртуализации Proxmox;

**Порт (Port)** - порт подключения;

**Имя пользователя (Username)** - имя пользователя с административными правами в ProxmoxVE, вводить в формате user\@authenticator;

**Пароль (Password)** - пароль от учётной записи пользователя.

<figure><img src="https://raw.githubusercontent.com/hostco-ru/hostvm/master/.gitbook/assets/proxmox2.png" alt=""><figcaption></figcaption></figure>

### Расширенные настройки <a href="#advanced" id="advanced"></a>

**Одновременное создание (Creation concurrency)** - количество одновременных задач создания рабочих столов;

**Одновременное удаление (Removal concurrency)** - количество одновременных задач удаления рабочих столов;

**Таймаут (Timeout)** - тайм-аут подключения к ProxmoxVE (в секундах);

**Диапазон MAC-адресов (Macs range)** - диапазон MAC-адресов для присвоения создаваемым виртуальным рабочим столам. Принимаются любые допустимые для Proxmox значения;

**Начальный VmId** - идентификатор ВМ, с которого брокер начнёт создавать ВМ в Proxmox (≥ 10000).

<figure><img src="https://raw.githubusercontent.com/hostco-ru/hostvm/master/.gitbook/assets/proxmox3.png" alt=""><figcaption></figcaption></figure>

## Создание сервисов <a href="#services" id="services"></a>

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

* Cвязанный клон Proxmox (Linked Clone Proxmox) - для публикации виртуальных рабочих столов на основе "золотого" образа.

<figure><img src="https://raw.githubusercontent.com/hostco-ru/hostvm/master/.gitbook/assets/proxmox4.png" alt=""><figcaption></figcaption></figure>

* Фиксированные машины Proxmox (Proxmox Fixed Machines) - для подключения пользователей к существующим виртуальным машинам платформы виртуализации. *Данный тип сервиса доступен начиная с версии брокера 4.0.*

### Связанные клоны <a href="#linked-clones" id="linked-clones"></a>

#### Основные настройки <a href="#linked-main" id="linked-main"></a>

**Имя (Name)** - наименование создаваемого сервиса;

**Пул (Pool)** - пул, в котором будут находиться ВМ, созданные брокером;

**Высокая доступность (HA)** - включать ли созданные ВМ в группу HA PVE;

**Сначала попробовать SOFT Shutdown (Try SOFT Shutdown first)** - если включено, брокер попытается выполнить контролируемое выключение виртуального рабочего стола перед его уничтожением.

#### Машина <a href="#linked-machine" id="linked-machine"></a>

**Базовая машина (Base Machine)** - "золотой" образ ВМ, используемый брокером для развертывания виртуальных рабочих столов;

**Хранилище (Storage)** - хранилище для размещения виртуальных рабочих столов. Поддерживаются типы хранилищ, позволяющие создавать снапшоты (Snapshot);

**Доступность GPU (GPU Availability)** - метод проверки доступности GPU;

**Имена машин (Machine Names)** - базовое имя машины, используемое для создаваемых виртуальных рабочих столов (например, CloneVM- );

**Длина имени (Name Length)** - длина числового суффикса, добавляемого к базовому имени машины (например, Длина имени = 2 -> CloneVM-00, CloneVM-01 и т.д).

### Фиксированные машины <a href="#fixed-machines" id="fixed-machines"></a>

> Данный тип сервиса доступен начиная с версии брокера 4.0.

#### Основные настройки <a href="#fixed-main" id="fixed-main"></a>

**Имя (Name)** - наименование создаваемого сервиса для отображения в системе.

**Токен сервиса (Service token)** - токен, используемый агентами для связи с сервисом (задается в виде произвольной последовательности букв и цифр). Если задано, брокер будет отслеживать "вход" и "выход" пользователя в сеанс ОС машины, и при выходе из сеанса автоматически освобождать машину, делая ее доступной для подключения другого пользователя. Если поле оставить пустым, машина будет оставаться постоянно закрепленной за пользователем (до ручного сброса администратором системы).

> Если поле `Токен сервиса` заполнено, на машины, заданные в качестве используемых сервисом, необходимо установить соответствующий агент VDI типа `Unmanaged`, и при его настройке задать такое же значение поля `Токен сервиса`, как и в настройках базового сервиса.

#### Машина <a href="#fixed-machine" id="fixed-machine"></a>

**Пул ресурсов (Resource Pool)** - пул ресурсов, в котором находятся машины.

**Машины (Machines)** - виртуальные машины выбранного пула ресурсов, предоставляемые пользователям данного сервиса. Отметьте нужные машины в списке.

#### Расширенные настройки <a href="#fixed-advanced" id="fixed-advanced"></a>

**Оставлять при ошибке (Keep on error)** - если включено, при обнаружении ошибок доступа к машине она не будет переведена в статус "Ошибка".

**Использовать снапшоты (Use snapshots)** - если включено, брокер попытается создать снапшот (если еще не создан) перед доступом к машине и восстановить ее состояние после использования.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET http://localhost:3000/url/kb.pvhostvm.ru/hostvm-vdi/hostvm-vdi-admin-guide/service-providers/proxmox.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.