[Документация Yandex Cloud](../../index.md) > [Yandex Data Processing](../index.md) > [Пошаговые инструкции](index.md) > Сервисы Apache и другие сторонние сервисы > Подключение к интерфейсам компонентов

# Подключение к интерфейсам компонентов

Вы можете подключиться к интерфейсам компонентов Yandex Data Processing либо с помощью [UI Proxy](#ui-proxy), либо с помощью [промежуточной виртуальной машины](#routing). Подробнее в разделе [Интерфейсы и порты компонентов](../concepts/interfaces.md).

## UI Proxy {#ui-proxy}

{% note warning %}

Для корректной работы UI Proxy необходимо обеспечить сетевое соединение между вашим устройством, мастер-узлом кластера и серверами UI Proxy.

Убедитесь, что ваше устройство и мастер-узел кластера имеют разрешенный исходящий доступ к IP-адресам сервиса:
* `158.160.167.170`
* `2a0d:d6c1:0:1c::23e`

При необходимости [настройте группы безопасности](security-groups.md).

{% endnote %}

### Включить веб-интерфейсы компонентов {#ui-proxy-enable}

{% list tabs group=instructions %}

- Консоль управления {#console}

    1. Перейдите на [страницу каталога](https://console.yandex.cloud).
    1. Перейдите в сервис **Yandex Data Processing**.
    1. Выберите кластер и нажмите кнопку ![pencil](../../_assets/console-icons/pencil.svg) **Редактировать** на панели сверху.
    1. В блоке **Настройки** включите опцию **UI Proxy**.
    1. Нажмите кнопку **Сохранить изменения**.

- CLI {#cli}

    Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), [установите и инициализируйте его](../../cli/quickstart.md#install).

    По умолчанию используется каталог, указанный при [создании](../../cli/operations/profile/profile-create.md) профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду `yc config set folder-id <идентификатор_каталога>`. Также для любой команды вы можете указать другой каталог с помощью параметров `--folder-name` или `--folder-id`. Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.

    Чтобы включить доступ к веб-интерфейсам компонентов кластера, задайте значение `true` для параметра `--ui-proxy`:

    ```bash
    yc dataproc cluster update <имя_или_идентификатор_кластера> \
       --ui-proxy=true
    ```

    Идентификатор и имя кластера можно получить со [списком кластеров в каталоге](cluster-list.md#list).

- API {#api}

    Воспользуйтесь методом [update](../api-ref/Cluster/update.md) и передайте в запросе:

    * Идентификатор кластера в параметре `clusterId`. Чтобы узнать идентификатор, [получите список кластеров в каталоге](cluster-list.md#list).
    * Значение `true` в параметре `uiProxy`.
    * Список изменяемых полей конфигурации кластера в параметре `updateMask` (в данном случае — `uiProxy`).

    {% note warning %}
    
    Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре `updateMask` (одной строкой через запятую).
    
    {% endnote %}

{% endlist %}

### Получить список URL для подключения {#ui-proxy-list}

{% list tabs group=instructions %}

- Консоль управления {#console}

    1. Перейдите на [страницу каталога](https://console.yandex.cloud).
    1. Перейдите в сервис **Yandex Data Processing**.
    1. Нажмите на имя нужного кластера.
    1. Ссылки для подключения к веб-интерфейсам компонентов находятся в блоке **UI Proxy**.

- CLI {#cli}

    Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), [установите и инициализируйте его](../../cli/quickstart.md#install).

    По умолчанию используется каталог, указанный при [создании](../../cli/operations/profile/profile-create.md) профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду `yc config set folder-id <идентификатор_каталога>`. Также для любой команды вы можете указать другой каталог с помощью параметров `--folder-name` или `--folder-id`. Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.

    Чтобы получить список URL для подключения к веб-интерфейсам компонентов кластера Yandex Data Processing, выполните команду:

    ```bash
    yc dataproc cluster list-ui-links <имя_или_идентификатор_кластера>
    ```

    Идентификатор и имя кластера можно получить со [списком кластеров в каталоге](cluster-list.md#list).

- API {#api}

    Воспользуйтесь методом API [listUILinks](../api-ref/Cluster/listUILinks.md) и передайте в запросе идентификатор кластера в параметре `clusterId`.

    Идентификатор кластера можно получить со [списком кластеров в каталоге](cluster-list.md#list).

{% endlist %}

## Перенаправление портов {#routing}

Чтобы получить доступ к сетевому интерфейсу компонента из интернета, [создайте](../../compute/operations/vm-create/create-linux-vm.md) промежуточную виртуальную машину в сервисе Yandex Compute Cloud.

Требования к промежуточной ВМ:

* Наличие публичного IP-адреса.
* Размещение в одной сети с нужным кластером Yandex Data Processing.
* [Настройки групп безопасности](../concepts/network.md#security-groups) должны разрешать обмен трафиком с кластером через порты соответствующих компонентов.

[Подробнее о настройке групп безопасности для подключения с перенаправлением портов](security-groups.md).

Чтобы соединиться с нужным портом хоста Yandex Data Processing, выполните команду:

```bash
ssh -A \
    -J <имя_пользователя_ВМ>@<публичный_IP-адрес_ВМ> \
    -L <номер_порта>:<FQDN_хоста_Yandex_Data_Processing>:<номер_порта> <имя_пользователя>@<FQDN_хоста_Yandex_Data_Processing>
```

Где:

* `-A` — включает перенаправление соединения от агента аутентификации с промежуточной ВМ (jump host) на целевой хост кластера Yandex Data Processing.
* `-J` — подключение к целевому хосту через промежуточную ВМ. Устанавливает SSH-соединение с промежуточной ВМ, которая будет перенаправлять пакеты к целевому хосту в кластере Yandex Data Processing.
* `-L` — перенаправление локального порта на хост кластера Yandex Data Processing.

    Для подключения к хостам кластера с [версией образа](../concepts/environment.md) 1.x используйте имя пользователя `root`, для версии 2.x — `ubuntu`.

Найти FQDN хоста Yandex Data Processing можно на странице кластера Yandex Data Processing, на вкладке **Хосты**, в столбце **FQDN хоста**.

Номера портов для компонентов Yandex Data Processing приведены в разделе [Интерфейсы и порты компонентов](../concepts/interfaces.md#port-numbers).