"
is_manual_connection = true
}
}
```
### Получение Resource ID частной конечной точки
Чтобы использовать Private Link, необходимо добавить Resource ID подключения частной конечной точки в список разрешённых для вашего сервиса.
Resource ID частной конечной точки доступен в Azure Portal. Откройте частную конечную точку, созданную на предыдущем шаге, и нажмите **JSON View**:
В разделе properties найдите поле `id` и скопируйте его значение:
**Предпочтительный способ: использование Resource ID**
**Устаревший способ: использование resourceGUID**
resourceGUID по-прежнему можно использовать для обратной совместимости. Найдите поле `resourceGuid` и скопируйте его значение:
## Настройка DNS для Private Link
Вам потребуется создать зону Private DNS (`${location_code}.privatelink.azure.clickhouse.cloud`) и привязать её к вашей VNet, чтобы получить доступ к ресурсам через Private Link.
### Создание зоны Private DNS
**Вариант 1: Через Azure Portal**
Следуйте этому руководству, чтобы [создать частную зону DNS в Azure через Azure Portal](https://learn.microsoft.com/en-us/azure/dns/private-dns-getstarted-portal).
**Вариант 2: С помощью Terraform**
Используйте следующий шаблон Terraform, чтобы создать зону Private DNS:
```json theme={null}
resource "azurerm_private_dns_zone" "clickhouse_cloud_private_link_zone" {
name = "${var.location}.privatelink.azure.clickhouse.cloud"
resource_group_name = var.resource_group_name
}
```
### Создайте подстановочную DNS-запись
Создайте подстановочную запись и направьте её на свою частную конечную точку:
**Вариант 1: через Azure Portal**
1. Откройте группу ресурсов `MyAzureResourceGroup` и выберите частную зону `${region_code}.privatelink.azure.clickhouse.cloud`.
2. Выберите + Record set.
3. В поле Name введите `*`.
4. В поле IP Address введите IP-адрес, указанный для Private Endpoint.
5. Выберите **OK**.
**Вариант 2: с помощью Terraform**
Используйте следующий шаблон Terraform, чтобы создать подстановочную DNS-запись:
```json theme={null}
resource "azurerm_private_dns_a_record" "example" {
name = "*"
zone_name = var.zone_name
resource_group_name = var.resource_group_name
ttl = 300
records = ["10.0.0.4"]
}
```
### Создайте связь с виртуальной сетью
Чтобы связать зону Private DNS с виртуальной сетью, необходимо создать связь с виртуальной сетью.
**Вариант 1: Через Azure Portal**
Следуйте этому руководству, чтобы [связать виртуальную сеть с вашей зоной Private DNS](https://learn.microsoft.com/en-us/azure/dns/private-dns-getstarted-portal#link-the-virtual-network).
**Вариант 2: Через Terraform**
DNS можно настроить разными способами. Настройте его в соответствии с вашим сценарием использования.
Нужно, чтобы «DNS name», полученное на шаге [Получение псевдонима подключения Azure для Private Link](#obtain-azure-connection-alias-for-private-link), указывало на IP-адрес частной конечной точки. Это гарантирует, что сервисы/компоненты в вашей VPC/сети смогут корректно его разрешать.
### Проверьте настройку DNS
Домен `xxxxxxxxxx.westus3.privatelink.azure.clickhouse.cloud` должен разрешаться в IP-адрес частной конечной точки (в этом примере — 10.0.0.4).
```bash theme={null}
nslookup xxxxxxxxxx.westus3.privatelink.azure.clickhouse.cloud.
Server: 127.0.0.53
Address: 127.0.0.53#53
Non-authoritative answer:
Name: xxxxxxxxxx.westus3.privatelink.azure.clickhouse.cloud
Address: 10.0.0.4
```
## Добавьте Resource ID частной конечной точки в организацию ClickHouse Cloud
### Вариант 1: консоль ClickHouse Cloud
Чтобы добавить конечную точку в организацию, перейдите к шагу [Добавьте Resource ID частной конечной точки в список разрешённых сервисов](#add-private-endpoint-id-to-services-allow-list). Если добавить Resource ID частной конечной точки в список разрешённых сервисов через консоль ClickHouse Cloud, он автоматически будет добавлен и в организацию.
Чтобы удалить конечную точку, откройте **Сведения об организации -> Частные конечные точки** и нажмите кнопку удаления.
### Вариант 2: API
Перед запуском любых команд задайте следующие переменные окружения:
```bash theme={null}
PROVIDER=azure
KEY_ID=
KEY_SECRET=
ORG_ID=
ENDPOINT_ID=
REGION=
```
Задайте переменную окружения `ENDPOINT_ID`, используя данные из шага [Obtaining the Private Endpoint Resource ID](#obtaining-private-endpoint-resourceid).
Выполните следующую команду, чтобы добавить частную конечную точку:
```bash theme={null}
cat <
## Добавьте Resource ID частной конечной точки в список разрешённых для ваших сервисов
По умолчанию сервис ClickHouse Cloud недоступен через Private Link, даже если подключение по Private Link одобрено и установлено. Вам нужно явно добавить Resource ID частной конечной точки для каждого сервиса, который должен быть доступен через Private Link.
### Вариант 1: консоль ClickHouse Cloud
В консоли ClickHouse Cloud откройте сервис, к которому нужно подключиться через PrivateLink, затем перейдите в раздел **Настройки**. Введите `Resource ID`, полученный на [предыдущем](#obtaining-private-endpoint-resourceid) шаге.
Если вы хотите разрешить доступ через существующее подключение PrivateLink, выберите существующую конечную точку в раскрывающемся меню.
### Вариант 2: API
Перед выполнением команд задайте эти переменные окружения:
```bash theme={null}
PROVIDER=azure
KEY_ID=
KEY_SECRET=
ORG_ID=
ENDPOINT_ID=
INSTANCE_ID=
```
Выполните это для каждого сервиса, который должен быть доступен через Private Link.
Выполните следующую команду, чтобы добавить частную конечную точку в список разрешённых для сервиса:
```bash theme={null}
cat <
## Доступ к вашему сервису ClickHouse Cloud через Private Link
У каждого сервиса с включенным Private Link есть публичная и частная конечная точка. Чтобы подключиться через Private Link, нужно использовать частную конечную точку — `privateDnsHostname`API или `DNS name`console, указанные в разделе [Получение псевдонима подключения Azure для Private Link](#obtain-azure-connection-alias-for-private-link).
### Получение имени хоста Private DNS
#### Вариант 1: консоль ClickHouse Cloud
В консоли ClickHouse Cloud перейдите в раздел **Настройки**. Нажмите кнопку **Set up private endpoint**. В открывшейся выдвижной панели скопируйте **DNS Name**.
#### Вариант 2: API
Задайте следующие переменные окружения перед запуском любых команд:
```bash theme={null}
KEY_ID=
KEY_SECRET=
ORG_ID=
INSTANCE_ID=
```
Выполните следующую команду:
```bash theme={null}
curl --silent --user "${KEY_ID:?}:${KEY_SECRET:?}" "https://api.clickhouse.cloud/v1/organizations/${ORG_ID:?}/services/${INSTANCE_ID:?}/privateEndpointConfig" | jq .result
```
Вы должны получить ответ примерно следующего вида:
```response theme={null}
{
...
"privateDnsHostname": "xxxxxxx..privatelink.azure.clickhouse.cloud"
}
```
В этом примере соединение с именем хоста `xxxxxxx.region_code.privatelink.azure.clickhouse.cloud` будет направляться через Private Link. В то же время `xxxxxxx.region_code.azure.clickhouse.cloud` будет направляться через интернет.
Используйте `privateDnsHostname`, чтобы подключаться к вашему сервису ClickHouse Cloud через Private Link.
## Устранение неполадок
### Проверка настроек DNS
Выполните следующую команду:
```bash theme={null}
nslookup
```
где "имя DNS" — это `privateDnsHostname`API или `DNS name`console из [Получение псевдонима подключения Azure для Private Link](#obtain-azure-connection-alias-for-private-link)
В ответ вы должны получить следующее:
```response theme={null}
Non-authoritative answer:
Name:
Address: 10.0.0.4
```
### Соединение сброшено удалённой стороной
Скорее всего, Resource ID частной конечной точки не был добавлен в список разрешённых для сервиса. Вернитесь к [шагу *Добавьте Resource ID частной конечной точки в список разрешённых для ваших сервисов*](#add-private-endpoint-id-to-services-allow-list).
### Частная конечная точка находится в состоянии ожидания
Скорее всего, Resource ID частной конечной точки не был добавлен в список разрешённых для этого сервиса. Вернитесь к [шагу *Добавьте Resource ID частной конечной точки в список разрешённых для сервиса*](#add-private-endpoint-id-to-services-allow-list).
### Проверка подключения
Если у вас возникают проблемы с подключением через Private Link, проверьте соединение с помощью `openssl`. Убедитесь, что статус конечной точки Private Link — `Accepted`.
OpenSSL должен успешно подключаться (в выводе должно отображаться CONNECTED). `errno=104` — ожидаемое значение.
```bash theme={null}
openssl s_client -connect abcd.westus3.privatelink.azure.clickhouse.cloud:9440
```
```response highlight={1} theme={null}
CONNECTED(00000003)
write:errno=104
---
no peer certificate available
---
No client certificate CA names sent
---
SSL handshake has read 0 bytes and written 335 bytes
Verification: OK
---
New, (NONE), Cipher is (NONE)
Secure Renegotiation IS NOT supported
Compression: NONE
Expansion: NONE
No ALPN negotiated
Early data was not sent
Verify return code: 0 (ok)
```
### Проверка фильтров для частной конечной точки
Установите следующие переменные среды перед запуском любых команд:
```bash theme={null}
KEY_ID=
KEY_SECRET=
ORG_ID=
INSTANCE_ID=
```
Выполните следующую команду, чтобы проверить фильтры частной конечной точки:
```bash theme={null}
curl --silent --user "${KEY_ID:?}:${KEY_SECRET:?}" -X GET -H "Content-Type: application/json" "https://api.clickhouse.cloud/v1/organizations/${ORG_ID:?}/services/${INSTANCE_ID:?}" | jq .result.privateEndpointIds
```
## Дополнительная информация
Подробнее об Azure Private Link см. на [azure.microsoft.com/en-us/products/private-link](https://azure.microsoft.com/en-us/products/private-link).