# Alibaba cloud

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

{% embed url="<https://rutube.ru/video/45d138f38207a275838d7aecb685ba6f/>" %}

В данной инструкции мы пошагово произведем установку 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="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FHJCsD6szTymwkeW37DxG%2FOSSConsole.jpg?alt=media&#x26;token=fa31ebb8-1204-4994-a5c8-d315efbba2b0" alt=""><figcaption><p>OSS Консоль</p></figcaption></figure>

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

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FYga2qnzdXcjq9chPuvnM%2FbucketsSection.jpg?alt=media&#x26;token=d528dfa8-0ac4-4503-8b06-6c7c27277de4" alt=""><figcaption><p>Раздел "Buckets"</p></figcaption></figure>

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

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FqOapp4LmEg9eLbmez18o%2FcreateBucketButton.jpg?alt=media&#x26;token=319a5a2d-173c-4b7c-949c-9adbab7d3dde" alt=""><figcaption><p>Элемент "Create bucket"</p></figcaption></figure>

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

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

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

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

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FCmYS5luWVfByquOnFjXd%2FbucketParameters.jpg?alt=media&#x26;token=33039b13-be91-4202-9bab-2773f9cee8bf" alt=""><figcaption><p>Параметры Bucket'а</p></figcaption></figure>

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

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FV3SkzNp90X9Bqo1CEVlF%2FbucketName.jpg?alt=media&#x26;token=d44bbf06-20b5-4b05-a4ed-a04154bf6355" alt=""><figcaption><p>Созданный bucket</p></figcaption></figure>

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

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FNGUegD0zxGjZxp7u6qeJ%2FuploadObject.jpg?alt=media&#x26;token=c48c4a68-5b03-490c-8ed5-7c81f836cbbc" alt=""><figcaption><p>Элемент "Upload object"</p></figcaption></figure>

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

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FHKChwJqhlUICRgH16KeF%2FURL.jpg?alt=media&#x26;token=ef88ecd0-ca74-470d-bbc1-0e0046cb2a26" alt=""><figcaption><p>Ссылка на файл образа диска</p></figcaption></figure>

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

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

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FMkicqYamOiVxUeySr5FG%2FimagesSection.jpg?alt=media&#x26;token=43febbdf-88f3-439e-8a9e-279d76f2326e" alt=""><figcaption><p>Раздел "Images"</p></figcaption></figure>

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

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FPFS5zkdpNiDwHEDX5HVI%2FimportImageButton.jpg?alt=media&#x26;token=54c2f890-7e42-4e5c-8dd6-05bbdb085f5e" 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="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FQM52dq59iGVK0O2ssH3e%2FimageParametersMikoPBX.jpg?alt=media&#x26;token=f0669396-16b7-4315-b4ba-c41cc51c7c9a" alt=""><figcaption><p>Параметры импорта образа</p></figcaption></figure>

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

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

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

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FAoFu578LYuwWWMuJFF0b%2FkeyPairsSection.jpg?alt=media&#x26;token=4d99435b-1e37-4199-9cd2-2b8c22e87564" alt=""><figcaption><p>Раздел "Key Pairs"</p></figcaption></figure>

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

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FSoo4uumHHJ12JiX4Pga5%2FcreateSSHKeyPair.jpg?alt=media&#x26;token=a737dda7-db6e-42bb-ba12-e7c5d4f9f703" alt=""><figcaption><p>Элемент "Create SSH Key Pair"</p></figcaption></figure>

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

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

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

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FXsWyv7tm9tAVpve663Ud%2FsshKeyPairParameters.jpg?alt=media&#x26;token=280c8a5a-a741-4546-adb2-f7cf8f863a65" alt=""><figcaption><p>Параметры создаваемой связки ключей</p></figcaption></figure>

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

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

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

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2Fg5ccjelhtcV6btKngJCo%2FsecurityGroupsSection.jpg?alt=media&#x26;token=2b7668f8-a825-458e-9a8a-69485728f963" alt=""><figcaption><p>Раздел "Security Groups"</p></figcaption></figure>

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

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2F4vo4uUCeNQb72ARehqVN%2FcreateSecurityGroup.jpg?alt=media&#x26;token=ab700b38-8493-4ab9-8a03-3b04469c49ef" alt=""><figcaption><p>Элемент для создания новой группы правил</p></figcaption></figure>

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

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

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

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

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FuU4IdRKX37HuelaaUqwu%2FParametersOfTheSecurity.jpg?alt=media&#x26;token=dfa5d4c9-4a78-43bd-866a-d9ac77e71e43" alt=""><figcaption><p>Параметры группы правил</p></figcaption></figure>

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

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

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2Fd1jP0dwsXOvuoS9OdyzV%2FinstancesSection.jpg?alt=media&#x26;token=9faca8b2-5037-4fb1-9e1e-f4bff4cf5782" alt=""><figcaption><p>Раздел "Instances"</p></figcaption></figure>

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

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FGkTRmQwBEQLU1B4uDhrp%2FcreateInstanceButton.jpg?alt=media&#x26;token=091beeec-4b3d-41a2-8095-5c5f9a3131f2" alt=""><figcaption><p>Элемент "Create Instance"</p></figcaption></figure>

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

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

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FTrMRwmNigLciduWLgcwN%2FVMParameters1.jpg?alt=media&#x26;token=64a487f6-92e3-4b03-8779-5ae0c1774a31" 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="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2F8I7U2usSBa5vgTMVMUCB%2FVMParameters2.jpg?alt=media&#x26;token=741c7468-4190-4282-9b0c-55257cab2487" alt=""><figcaption><p>Параметры виртуальной машины №2</p></figcaption></figure>

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

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FrvETmEdwqKA2PS5BltJZ%2FbandwidthsSecurityGroupsSection.jpg?alt=media&#x26;token=3ff4cc0d-e6af-4554-9e45-9d866745f9e0" alt=""><figcaption><p>Параметры сети</p></figcaption></figure>

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

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FnYwodrRRY9v2CxPFa4dN%2FcreateOrder.jpg?alt=media&#x26;token=320930f7-ced7-48dc-8ce7-a985135e3914" alt=""><figcaption><p>Элемент "Create Order"</p></figcaption></figure>

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

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

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FeE4pzeAqLNKR2QBl1UQo%2FgoToVM.jpg?alt=media&#x26;token=312659f2-845a-423c-b745-c7f70e9de092" alt=""><figcaption><p>Переход к созданной виртуальной машине</p></figcaption></figure>

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

1. Нажмите "**Connect**".&#x20;

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FsY1qqfNjc4PW1UBplGqS%2FconnectToTheConsole.jpg?alt=media&#x26;token=5f1d33f4-a091-421e-89ca-33c321c2c4e7" alt=""><figcaption><p>Элемент "Connect"</p></figcaption></figure>

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

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2Fsbylo0jdrBBnZ7qQKfnB%2FVNCConsole.jpg?alt=media&#x26;token=c56c7153-41f7-4dd4-946d-dd8e74be165b" alt=""><figcaption><p>VNC консоль</p></figcaption></figure>

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

{% hint style="info" %}
Подробнее про SSH-подключения Вы можете узнать [в этом блоке статей](https://docs.mikopbx.com/mikopbx/faq/troubleshooting/connecting-to-a-pbx-using-ssh). В данной документации, в качестве примера будет продемонстрировано подключение по 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="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2F7mla3K6nLzgeUc9nuTg1%2FsshCommandPowerShell.jpg?alt=media&#x26;token=ed3bb1bc-6c75-432c-aa8f-3ade1471f20f" alt=""><figcaption><p>Команда для ssh-подключения</p></figcaption></figure>

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

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FjofISPkg0PWmQ1PrmR5T%2FSSHConnection.jpg?alt=media&#x26;token=0b9f2848-45e5-415b-9034-e46b403c5c64" alt=""><figcaption><p>SSH-подключение</p></figcaption></figure>

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

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

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FtmdUtGP0w4hg4tFrD4zn%2FauthorizationParametersRU.jpg?alt=media&#x26;token=875c835b-16bb-4ada-b365-1ff8c5ad2cc8" alt=""><figcaption><p>Важные параметры для авторизации в web-интерфейс</p></figcaption></figure>

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

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

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

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2Fpm0ARF7WJXJylcPl43aL%2FmikopbxWEB.jpg?alt=media&#x26;token=a30037c6-6b2e-4855-badf-0569694d19f0" alt=""><figcaption><p>WEB-интерфейс MikoPBX</p></figcaption></figure>
