# Alibaba cloud

{% hint style="danger" %}
Инструкция актуальна для версии 2024.2.135 и новее!
{% endhint %}

{% embed url="<https://vkvideo.ru/video-100268702_456239058>" %}

В данной инструкции мы пошагово произведем установку MikoPBX с помощью облачной платформы Alibaba cloud.

Перед началом Вам необходимо скачать актуальный образ MikoPBX с расширением **.raw**. Сделать это можно на [github MikoPBX](https://github.com/mikopbx/core/releases).

## Загрузка образа в Alibaba cloud

### Создание Bucket

Для начала необходимо создать bucket для хранения образа. Для этого необходимо перейти в "**OSS Management Console**" ([ссылка](https://oss.console.aliyun.com/overview)).

<figure><img src="/files/g8YRBPElfb8vX6pnffih" alt=""><figcaption><p>OSS Консоль</p></figcaption></figure>

1. Перейдите в раздел "**Buckets**".

<figure><img src="/files/FnFU4tWrQXTNywlxtXCi" alt=""><figcaption><p>Раздел "Buckets"</p></figcaption></figure>

2. Нажмите "**Create Bucket**" для создания нового **Bucket'а**:

<figure><img src="/files/hypQtB69AAE9VJvWtyeN" alt=""><figcaption><p>Элемент "Create bucket"</p></figcaption></figure>

3. Заполните следующие данные:

* "**Bucket name**" - произвольное название для хранилища.
* "**Region**" - выберите регион, где будет храниться ваш образ

{% hint style="danger" %}
Регион у хранилища для образа и регион виртуальной машины должны совпадать!
{% endhint %}

Нажмите "**OK**".

<figure><img src="/files/HMpCHXFhM8QOMBUjT6vf" alt=""><figcaption><p>Параметры Bucket'а</p></figcaption></figure>

4. Перейдите в созданный bucket, нажав на его название в разделе "**Buckets**":

<figure><img src="/files/nPFN9UXEtmf7BbyNtDVN" alt=""><figcaption><p>Созданный bucket</p></figcaption></figure>

5. Нажмите "**Upload object**" и загрузите ранее скаченный файл образа диска в формате **.raw** (все параметры оставьте по умолчанию).

<figure><img src="/files/9kSstaFuNpNFM0gDwooV" alt=""><figcaption><p>Элемент "Upload object"</p></figcaption></figure>

6. После того, как файл образа диска будет загружен, Вам необходимо скопировать ссылку на него. Для этого нажмите "**View Details**" справа от названия файла, в открывшемся меню скопируйте ссылку из поля "**URL**".

<figure><img src="/files/V3GZf39TicbS60TnM9Sf" alt=""><figcaption><p>Ссылка на файл образа диска</p></figcaption></figure>

### Создание образа

1. Вернитесь в ECS Console ([ссылка](https://ecs.console.aliyun.com/home)). Перейдите в раздел "**Images**".

<figure><img src="/files/SGvPxUD1sT0p5jA10QUk" alt=""><figcaption><p>Раздел "Images"</p></figcaption></figure>

2. Нажмите "**Import Image**" для испорта образа из хранилища (**Bucket**):

<figure><img src="/files/Unyv7wdONZTsmpZDNRpR" alt=""><figcaption><p>Элемент "Import Image"</p></figcaption></figure>

3. В открывшейся вкладке выберите "**Linux Operating System**" и нажмите "**Next**".
4. Введите/выберите следующие параметры для образа:

* "**Image File URL**" - вставьте ранее скопированную ссылку на загруженный файл образа диска.
* "**Image Name**" - введите произвольное, **уникальное** название для Вашего образа.
* "**OS Type**" - linux
* "**OS Version**" - Others Linux
* "**Architecture**" - 64-bit OS
* Уберите галочку с чек-бокса "**Check After Import**".

Нажмите "**OK**" для создания образа. Дождитесь его создания (при завершении в поле Status вы увидите надпись <mark style="color:green;">Available</mark>)

<figure><img src="/files/UyCnCx5lGuaeKhKEKY78" alt=""><figcaption><p>Параметры импорта образа</p></figcaption></figure>

## Создание пары SSH-ключей

Далее необходимо создать и добавить связку SSH ключей в Alibaba Cloud.

1. В ESS Консоли перейдите в раздел "**Network Security**" -> "**Key Pairs**":

<figure><img src="/files/wRaktDQ5JjI1ikXnGXNX" alt=""><figcaption><p>Раздел "Key Pairs"</p></figcaption></figure>

2. Нажмите "**Create SSH Key Pair**".

<figure><img src="/files/MSDcd1etGi1eTPhrovtx" alt=""><figcaption><p>Элемент "Create SSH Key Pair"</p></figcaption></figure>

3. Далее необходимо сгенерировать пару SSH-ключей. Про то как это сделать - Вы можете прочитать [здесь](/mikopbx/faq/troubleshooting/connecting-to-a-pbx-using-ssh.md). Далее заполните все необходимые данные:

* "**Name**" - произвольное название для создаваемой связки ключей
* "**Creation Mode**" - Import
* "**Public Key**" - вставьте Ваш **публичный** ключ, сгенерированный ранее
* "**Resource Group**" - выберите Вашу ресурсную группу в облаке

Нажмите "**OK**" для создания связки ключей в облаке

<figure><img src="/files/03OhWGyKgeToJvKLzKZs" alt=""><figcaption><p>Параметры создаваемой связки ключей</p></figcaption></figure>

## Создание группы правил

Перед созданием виртуальной машины так же нужно создать и группу правил (firewall).

1. Перейдите в раздел "**Network & Security**" -> "**Security Groups**"

<figure><img src="/files/EzVpEDws25D4ipr2qjCX" alt=""><figcaption><p>Раздел "Security Groups"</p></figcaption></figure>

2. Нажмите "**Create Security Group**":

<figure><img src="/files/IwjPXcnvVcrWpR1Veovo" alt=""><figcaption><p>Элемент для создания новой группы правил</p></figcaption></figure>

3. Укажите следующие параметры для группы правил:

* "**Security Group**" - введите произвольное название для группы правил.
* "**Network**" - выберите вашу сеть. Если она не созданна - нажмите "**Create VPC**" справа от поля.
* "**Security Group**" - Basic Security Group.
* "**Resource Group**" - выбрите Вашу группу ресурсов.
* Разрешите все входящие подключения (пример на скриншоте ниже). Все исходящие подключения разрешены по умолчанию.

{% hint style="info" %}
Обязательно настройте firewall в самой MikoPBX как можно раньше после создания виртуальной машины. Подробнее про то как это сделать, Вы можете прочитать [здесь](/mikopbx/manual/connectivity/firewall.md).
{% endhint %}

Нажмите "**Create Security Group**".

<figure><img src="/files/WOQ3OEO1IjFWmGmwWhZ5" alt=""><figcaption><p>Параметры группы правил</p></figcaption></figure>

## Создание виртуальной машины

1. Перейдите в раздел "**Instances & Images**" -> "**Instances**":

<figure><img src="/files/MGCB6oUtI0YbEy4aYqnY" alt=""><figcaption><p>Раздел "Instances"</p></figcaption></figure>

2. Нажмите "**Create Instance**" для создания новой виртуальной машины.

<figure><img src="/files/0EWfyOdIH27VibdrFnx0" alt=""><figcaption><p>Элемент "Create Instance"</p></figcaption></figure>

3. Выберите параметры для вашей виртуальной машины:

* "**Billing Method**" - выберите вариант оплаты ВМ.
* "**Region**", "**Network and Zone**" - выберите параметры региона и зоны, подходящие Вам.
* "**Instance**" - выберите конфигурацию Вашей виртуальной машины.

<figure><img src="/files/2xJHFnjhLadXLRvSQkyK" alt=""><figcaption><p>Параметры виртуальной машины №1</p></figcaption></figure>

4. Выберите параметры для вашей виртуальной машины:

* "**Image**" - выберите "**Custom Images**" -> Загруженный ранее образ
* "**Storage**" - выберите тип и размер "**System Disk**". 20 Гб - минимально возможный в Alibaba Cloud.
* Добавьте второй диск, нажав "**Add Data Disk**". Укажите его тип и размер.

{% hint style="info" %}
Рекомендуемый размер диска для хранения записей разговора - не менее 50ГБ. В данной инструкции, в качестве примера, используется диск размером 30ГБ.
{% endhint %}

<figure><img src="/files/HoEUMmUEHEzgUirKLEHy" alt=""><figcaption><p>Параметры виртуальной машины №2</p></figcaption></figure>

5. Выберите параметры сети для Вашей ВМ. Группа правил будет назначена автоматически (ранее созданная):

<figure><img src="/files/Vj1Jvjged4r1WFy0M99i" alt=""><figcaption><p>Параметры сети</p></figcaption></figure>

6. Нажмите "**Create Order**".

<figure><img src="/files/MyYEoxgJ1wrjtCsVg5sO" alt=""><figcaption><p>Элемент "Create Order"</p></figcaption></figure>

## Подключение к консоли MikoPBX

В разделе "**Instances**" перейдите к созданной виртуальной машине, нажав на ее название.

<figure><img src="/files/TvwdJ6KqrP5FgoIMazLF" alt=""><figcaption><p>Переход к созданной виртуальной машине</p></figcaption></figure>

### Подключение из встроенной в облако консоли

1. Нажмите "**Connect**".

<figure><img src="/files/3iuk9HpAiSGEu4n38ld9" alt=""><figcaption><p>Элемент "Connect"</p></figcaption></figure>

2. Выберите "**VNC**". Произойдет подключение в новой вкладке Вашего браузера.

<figure><img src="/files/cfFJrnIGZn73FWAX9CW0" alt=""><figcaption><p>VNC консоль</p></figcaption></figure>

### Подключение по SSH

{% hint style="info" %}
Подробнее про SSH-подключения Вы можете узнать [в этом блоке статей](/mikopbx/faq/troubleshooting/connecting-to-a-pbx-using-ssh.md). В данной документации, в качестве примера будет продемонстрировано подключение по SSH через PowerShell.
{% endhint %}

Введите следующую команду для SSH-подключения:

```powershell
ssh -i C:\Users\username\.ssh\id_ed25519 root@ip-adress
```

Замените `C:\Users\username\.ssh\id_ed25519` на путь к ssh-ключам; `root`- на Ваше имя для ssh-авторизации (если оно было изменено при создании ВМ); `ip-adress` - на Внешний адрес MikoPBX.

<figure><img src="/files/25bVD2mObcrr77KivTos" alt=""><figcaption><p>Команда для ssh-подключения</p></figcaption></figure>

Произойдет подключение по SSH:

<figure><img src="/files/j5Yn9g64BK4VWlab4FsS" alt=""><figcaption><p>SSH-подключение</p></figcaption></figure>

## Первая авторизация в WEB-интерфейсе

На главной странице виртуальной машины находятся несколько важных параметров для авторизации в WEB-интерфейсе.

<figure><img src="/files/Htw7pWWVB4I88SL92rXN" alt=""><figcaption><p>Важные параметры для авторизации в web-интерфейс</p></figcaption></figure>

Вставьте IP-адрес в адресную строку браузера - Вы попадете на страницу авторизации в web-интерфейс MikoPBX.

{% hint style="info" %}
Данные для входа:

* **Username** - admin
* **Password** - ID Вашей виртуальной машины
  {% endhint %}

<figure><img src="/files/rbSCLdtS5LceG1PDaRgq" alt=""><figcaption><p>WEB-интерфейс MikoPBX</p></figcaption></figure>


---

# 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 https://docs.mikopbx.com/mikopbx/setup/cloud/alibaba-cloud.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.
