Compare commits
8 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
 daglebov
|
837daefdf1 | ||
|
Речкина Елена Валерьевна
|
be581a8757 | ||
|
Речкина Елена Валерьевна
|
285babb9c9 | ||
|
Речкина Елена Валерьевна
|
fa95157ab7 | ||
|
Дмитрий Захаров
|
e208f23363 | ||
|
Elena Rechkina
|
deab4d3df0 | ||
|
Речкина Елена Валерьевна
|
3fffc8d2df | ||
|
Речкина Елена Валерьевна
|
ff41fe80c4 |
Generated
+2
-2
@@ -1,12 +1,12 @@
|
||||
{
|
||||
"name": "docs",
|
||||
"version": "0.5.0",
|
||||
"version": "0.6.1",
|
||||
"lockfileVersion": 3,
|
||||
"requires": true,
|
||||
"packages": {
|
||||
"": {
|
||||
"name": "docs",
|
||||
"version": "0.5.0",
|
||||
"version": "0.6.1",
|
||||
"license": "MIT",
|
||||
"dependencies": {
|
||||
"@beeline/design-tokens": "^1.31.0",
|
||||
|
||||
+91
-55
@@ -90,8 +90,8 @@ export default defineConfig({
|
||||
}
|
||||
},
|
||||
// https://vitepress.dev/reference/default-theme-config
|
||||
// nav: [
|
||||
// ],
|
||||
// nav: [
|
||||
// ],
|
||||
|
||||
// socialLinks: [
|
||||
// { icon: { svg: gitlab }, link: 'https://git.vimpelcom.ru/common/vega/docs' }
|
||||
@@ -118,88 +118,124 @@ export default defineConfig({
|
||||
label: 'Содержание'
|
||||
},
|
||||
sidebar: {
|
||||
'/platform/': [
|
||||
{
|
||||
text: 'Платформа Beeline Cloud', link: '/platform/index.md',
|
||||
collapsed: true,
|
||||
'/platform/': [
|
||||
{
|
||||
text: 'Платформа Beeline Cloud', link: '/platform/index.md',
|
||||
collapsed: true,
|
||||
items: [
|
||||
{text: 'Сервисы', link: '/platform/services/services.md'},
|
||||
{text: 'Техническая поддержка', link: '/platform/support/support-overview.md'},
|
||||
{ text: 'Сервисы', link: '/platform/services/services.md' },
|
||||
{ text: 'Техническая поддержка', link: '/platform/support/support-overview.md' },
|
||||
],
|
||||
},
|
||||
],
|
||||
'/start/': [
|
||||
{
|
||||
text: 'Начало работы в Beeline Cloud', link: '/start/index.md',
|
||||
collapsed: true,
|
||||
'/start/': [
|
||||
{
|
||||
text: 'Начало работы в Beeline Cloud', link: '/start/index.md',
|
||||
collapsed: true,
|
||||
items: [
|
||||
{text: 'Начать работу', link: '/start/getting-started.md'},
|
||||
{text: 'Бесплатный период', link: '/start/trial.md'},
|
||||
{text: 'Платное использование', link: '/start/organization.md'},
|
||||
{ text: 'Начать работу', link: '/start/getting-started.md' },
|
||||
{ text: 'Бесплатный период', link: '/start/trial.md' },
|
||||
{ text: 'Платное использование', link: '/start/organization.md' },
|
||||
],
|
||||
},
|
||||
],
|
||||
// '/billing/': [
|
||||
|
||||
// ],
|
||||
// '/billing/': [
|
||||
|
||||
// ],
|
||||
'/vdc/': [
|
||||
{
|
||||
text: 'Виртуальные дата-центры на VMware', link: '/vdc/index.md',
|
||||
collapsed: true,
|
||||
text: 'Виртуальные дата-центры на VMware', link: '/vdc/index.md',
|
||||
collapsed: true,
|
||||
items: [
|
||||
{text: 'Обзор сервиса', link: '/vdc/vdc-overview.md'},
|
||||
{text: 'Быстрый старт', link: '/vdc/vdc-getting-started.md'},
|
||||
{text: 'Виртуальные дата-центры', link: '/vdc/vdc-how-to/vdc-index.md',
|
||||
collapsed: true,
|
||||
items: [
|
||||
{ text: 'Создание дата-центра', link: '/vdc/vdc-how-to/vdc-create.md' },
|
||||
{ text: 'Вход в дата-центр', link: '/vdc/vdc-how-to/vdc-enter.md' },
|
||||
{ text: 'Управление дата-центром', link: '/vdc/vdc-how-to/vdc-manage.md' },
|
||||
{ text: 'Двухфакторная аутентификация', link: '/vdc/vdc-how-to/vdc-2fa.md',
|
||||
{ text: 'Обзор сервиса', link: '/vdc/vdc-overview.md' },
|
||||
{ text: 'Быстрый старт', link: '/vdc/vdc-getting-started.md' },
|
||||
{
|
||||
text: 'Виртуальные дата-центры', link: '/vdc/vdc-how-to/vdc-index.md',
|
||||
collapsed: true,
|
||||
items: [
|
||||
{text: 'Подключение 2FA', link: '/vdc/vdc-how-to/vdc-2fa-start.md'},
|
||||
{text: 'Управление 2FA', link: '/vdc/vdc-how-to/vdc-2fa-manage.md'},
|
||||
],
|
||||
{ text: 'Создание дата-центра', link: '/vdc/vdc-how-to/vdc-create.md' },
|
||||
{ text: 'Вход в дата-центр', link: '/vdc/vdc-how-to/vdc-enter.md' },
|
||||
{ text: 'Управление дата-центром', link: '/vdc/vdc-how-to/vdc-manage.md' },
|
||||
{
|
||||
text: 'Двухфакторная аутентификация', link: '/vdc/vdc-how-to/vdc-2fa.md',
|
||||
collapsed: true,
|
||||
items: [
|
||||
{ text: 'Подключение 2FA', link: '/vdc/vdc-how-to/vdc-2fa-start.md' },
|
||||
{ text: 'Управление 2FA', link: '/vdc/vdc-how-to/vdc-2fa-manage.md' },
|
||||
],
|
||||
},
|
||||
],
|
||||
},
|
||||
],
|
||||
},
|
||||
// { text: 'Тарификация', link: '/vdc/vdc-tarif.md' },
|
||||
// { text: 'Тарификация', link: '/vdc/vdc-tarif.md' },
|
||||
],
|
||||
},
|
||||
],
|
||||
],
|
||||
'/compute/': [
|
||||
{
|
||||
text: 'Виртуальные машины', link: '/compute/index.md',
|
||||
collapsed: true,
|
||||
text: 'Виртуальные машины', link: '/compute/index.md',
|
||||
collapsed: true,
|
||||
items: [
|
||||
{text: 'Обзор сервиса', link: '/compute/compute-overview.md'},
|
||||
// {text: 'Быстрый старт', link: '/compute/compute-getting-started.md'},
|
||||
{text: 'Виртуальные машины', link: '/compute/compute-how-to/compute-index.md',
|
||||
collapsed: true,
|
||||
items: [
|
||||
{ text: 'Обзор сервиса', link: '/compute/compute-overview.md' },
|
||||
// {text: 'Быстрый старт', link: '/compute/compute-getting-started.md'},
|
||||
{
|
||||
text: 'Виртуальные машины', link: '/compute/compute-how-to/compute-index.md',
|
||||
collapsed: true,
|
||||
items: [
|
||||
{ text: 'Создание ВМ', link: '/compute/compute-how-to/compute-servers-create.md' },
|
||||
{ text: 'Подключение к ВМ', link: '/compute/compute-how-to/compute-connect.md' },
|
||||
{ text: 'Управление ВМ', link: '/compute/compute-how-to/compute-servers-manage.md' },
|
||||
],
|
||||
},
|
||||
],
|
||||
},
|
||||
{ text: 'Диски', link: '/compute/compute-how-to/compute-disks.md' },
|
||||
{ text: 'IP-адреса', link: '/compute/compute-how-to/compute-ip.md' },
|
||||
{ text: 'Группы размещения', link: '/compute/compute-how-to/compute-affinity.md' },
|
||||
{ text: 'Группы размещения', link: '/compute/compute-how-to/compute-affinity.md' },
|
||||
{
|
||||
text: 'Практические руководства', link: '/compute/compute-guide/compute-guide-index.md',
|
||||
collapsed: true,
|
||||
items: [
|
||||
{ text: 'Подключение по SSH к ВМ закрытого контура', link: '/compute/compute-guide/compute-guide-ssh-inside.md' },
|
||||
],
|
||||
},
|
||||
],
|
||||
},
|
||||
|
||||
],
|
||||
|
||||
],
|
||||
'/admin/': [
|
||||
{
|
||||
text: 'Аккаунт Beeline Cloud', link: '/admin/acc-index.md',
|
||||
collapsed: true,
|
||||
{
|
||||
text: 'Аккаунт Beeline Cloud', link: '/admin/index.md',
|
||||
collapsed: true,
|
||||
items: [
|
||||
{text: 'Управление ключевыми парами', link: '/admin/ssh.md'},
|
||||
{ text: 'Управление ключевыми парами', link: '/admin/ssh.md' },
|
||||
],
|
||||
},
|
||||
],
|
||||
},
|
||||
],
|
||||
'/yellowbe/': [
|
||||
{
|
||||
text: 'Дизайн-платформа Yellowbe', link: '/yellowbe/index.md',
|
||||
collapsed: false,
|
||||
items: [
|
||||
{
|
||||
text: 'Начать работу',
|
||||
link: '/yellowbe/get-started/index.md',
|
||||
collapsed: true,
|
||||
items: [
|
||||
{
|
||||
text: 'Разработчику',
|
||||
link: '/yellowbe/get-started/dev.md',
|
||||
}, {
|
||||
text: 'Дизайнеру',
|
||||
link: '/yellowbe/get-started/design.md',
|
||||
},
|
||||
]
|
||||
},
|
||||
{
|
||||
text: 'Состав дизайн-платформы',
|
||||
link: '/yellowbe/about.md',
|
||||
}
|
||||
],
|
||||
},
|
||||
],
|
||||
},
|
||||
}
|
||||
},
|
||||
}
|
||||
)
|
||||
|
||||
@@ -1,3 +1,6 @@
|
||||
@use "@beeline/design-tokens/scss/tokens/globals/colors";
|
||||
@use "@beeline/design-tokens/scss/tokens/themes";
|
||||
|
||||
@mixin font_style($fontSize, $fontWeight, $lineHeight, $letterSpacing) {
|
||||
font-size: $fontSize;
|
||||
font-weight: $fontWeight;
|
||||
@@ -66,7 +69,7 @@
|
||||
}
|
||||
|
||||
li + li {
|
||||
margin-top: 50px;
|
||||
margin-top: 34px;
|
||||
}
|
||||
|
||||
ul li {
|
||||
@@ -75,16 +78,6 @@
|
||||
margin-top: 8px;
|
||||
}
|
||||
|
||||
ol li:nth-last-of-type(n+2)::after {
|
||||
content: '';
|
||||
border-left: 1px solid rgb(201, 197, 197);
|
||||
position: absolute;
|
||||
line-height: 100%;
|
||||
left: -30px;
|
||||
top: 43px;
|
||||
bottom: -30px;
|
||||
}
|
||||
|
||||
ol li::before {
|
||||
content: counter(list);
|
||||
counter-increment: list;
|
||||
@@ -94,8 +87,8 @@
|
||||
left: -48px;
|
||||
width: 35px;
|
||||
height: 35px;
|
||||
background-color: #7e00ed;
|
||||
color: #fff;
|
||||
background-color: colors.$color-background-brand;
|
||||
color: themes.$color-text-active;
|
||||
text-align: center;
|
||||
line-height: 25px;
|
||||
font-size: 16px;
|
||||
@@ -115,6 +108,10 @@
|
||||
padding: 0;
|
||||
}
|
||||
|
||||
ol li:last-child, ul li:last-child {
|
||||
margin-bottom: 40px;
|
||||
}
|
||||
|
||||
ol li p {
|
||||
margin-top: 0;
|
||||
}
|
||||
|
||||
@@ -1,10 +0,0 @@
|
||||
---
|
||||
section_links:
|
||||
- title: Управление ключевыми парами
|
||||
link: /admin/ssh.md
|
||||
description: Добавление SSH-ключей для подключения к виртуальным машинам
|
||||
---
|
||||
|
||||
# Аккаунт Beeline Cloud
|
||||
|
||||
Аккаунт Beeline Cloud создается при [регистрации пользователя](../start/getting-started.md#1-регистрация-в-beeline-cloud) в Beeline Cloud. С помощью аккаунта можно управлять профилем пользователя.
|
||||
@@ -0,0 +1,10 @@
|
||||
---
|
||||
section_links:
|
||||
- title: Управление ключевыми парами
|
||||
link: /admin/ssh.md
|
||||
description: Добавление SSH-ключей для подключения к виртуальным машинам
|
||||
---
|
||||
|
||||
# Аккаунт Beeline Cloud
|
||||
|
||||
Аккаунт Beeline Cloud создается при [регистрации пользователя](../start/getting-started.md#1-регистрация-в-beeline-cloud) в Beeline Cloud. С помощью аккаунта можно управлять профилем пользователя.
|
||||
|
||||
@@ -0,0 +1,11 @@
|
||||
---
|
||||
section_links:
|
||||
- title: Подключение по SSH к виртуальной машине закрытого контура
|
||||
link: /compute/compute-guide/compute-guide-ssh-inside.md
|
||||
description: Получение доступа из интернета к виртуальной машине закрытого контура
|
||||
---
|
||||
|
||||
# Практические руководства
|
||||
|
||||
Рассмотрены сценарии использования сервиса **Виртуальные машины**.
|
||||
|
||||
@@ -0,0 +1,100 @@
|
||||
# Подключение по SSH к виртуальным машинам закрытого контура
|
||||
|
||||
Виртуальные машины, созданные в [закрытом контуре (зоне доступности `Inside`)](../compute-overview.md#зоны-доступности), недоступны из интернета. Чтобы подключиться по SSH к ВМ закрытого контура, используйте промежуточную виртуальную машину (джамп-хост) с публичным IP-адресом в интернете.
|
||||
|
||||
## Перед началом работы
|
||||
|
||||
- Публичный IP-адрес [доступен для назначения](../compute-how-to/compute-ip.md#назначить-вм-публичный-ip-адрес).
|
||||
- Подготовлена ключевая пара для подключения к ВМ по SSH:
|
||||
- приватный ключ сохранен на компьютере, с которого выполняется подключение;
|
||||
- публичный ключ [добавлен](../../admin/ssh.md#добавить-ssh-ключ) в профиль пользователя в личном кабинете Beeline Cloud.
|
||||
|
||||
Если вы используете разные SSH-ключи для подключения к ВМ закрытого контура и к ВМ с публичным IP-адресом, то добавьте оба публичных ключа в профиль пользователя в личном кабинете Beeline Cloud.
|
||||
|
||||
## Посмотреть публичный IP-адрес
|
||||
|
||||
1. Войдите в [личный кабинет](https://lk.cloud.beeline.ru/).
|
||||
2. Выберите нужный проект в верхнем меню **Проекты**.
|
||||
3. В верхнем меню нажмите на пункт **Сервисы** и выберите сервис **Виртуальные машины**.
|
||||
4. В левом меню откройте раздел **IP-адреса**.
|
||||
5. Отобразится список всех IP-адресов проекта.
|
||||
6. Если для публичного IP-адреса отображается статус `Зарезервирован`, то публичный IP-адрес [доступен для назначения](../compute-how-to/compute-ip.md#назначить-вм-публичный-ip-адрес).
|
||||
|
||||
## Создать джамп-хост
|
||||
|
||||
Джамп-хост — это виртуальная машина с публичным IP-адресом, созданная в зоне доступности `DMZ`.
|
||||
|
||||
1. Войдите в [личный кабинет](https://lk.cloud.beeline.ru/).
|
||||
2. Выберите нужный проект в верхнем меню **Проекты**.
|
||||
3. В верхнем меню нажмите на пункт **Сервисы** и выберите сервис **Виртуальные машины**.
|
||||
4. В левом меню откройте раздел **Виртуальные машины**.
|
||||
5. Нажмите **Создать виртуальную машину**.
|
||||
6. В блоке **Имя и расположение** укажите имя и расположение ВМ:
|
||||
- **Имя машины**: введите название ВМ.
|
||||
- **Зона доступности**: выберите зону доступности, содержащую в названии `DMZ`.
|
||||
:::warning Важно
|
||||
Джамп-хост и публичный IP-адрес должны находиться в одной [зоне доступности](./../compute-overview.md#зоны-доступности).
|
||||
:::
|
||||
7. В блоке **Выбор образа** выберите [тип и версию операционной системы](./../compute-overview.md#операционная-система).
|
||||
8. В блоке **Конфигурация** выберите количество vCPU и RAM.
|
||||
9. В блоке **Диски** настройте загрузочный диск:
|
||||
- **Загрузочный диск**: выберите [тип диска](../compute-overview.md#диски) и укажите размер загрузочного диска.
|
||||
10. Выберите публичный ключ для подключения к ВМ по SSH.
|
||||
11. В блоке **Настройки сети** выберите:
|
||||
- **IPv4-адрес**: выберите из списка публичный IP-адрес.
|
||||
12. Нажмите **Создать виртуальную машину**.
|
||||
|
||||
## Создать ВМ в закрытом контуре
|
||||
|
||||
Если ВМ в закрытом контуре уже создана, то пропустите этот шаг.
|
||||
|
||||
1. Войдите в [личный кабинет](https://lk.cloud.beeline.ru/).
|
||||
2. Выберите нужный проект в верхнем меню **Проекты**.
|
||||
3. В верхнем меню нажмите на пункт **Сервисы** и выберите сервис **Виртуальные машины**.
|
||||
4. В левом меню откройте раздел **Виртуальные машины**.
|
||||
5. Нажмите **Создать виртуальную машину**.
|
||||
6. В блоке **Имя и расположение** укажите имя и расположение ВМ:
|
||||
- **Имя машины**: введите название ВМ.
|
||||
- **Зона доступности**: выберите зону доступности, содержащую в названии `Inside`.
|
||||
7. В блоке **Выбор образа** выберите [тип и версию операционной системы](./../compute-overview.md#операционная-система).
|
||||
8. В блоке **Конфигурация** выберите количество vCPU и RAM.
|
||||
9. В блоке **Диски** настройте загрузочный диск:
|
||||
- **Загрузочный диск**: выберите [тип диска](../compute-overview.md#диски) и укажите размер загрузочного диска.
|
||||
10. Выберите публичный ключ для подключения к ВМ по SSH.
|
||||
11. В блоке **Настройки сети** выберите:
|
||||
- **IPv4-адрес**: выберите `Автоматически`, ВМ будет назначен внутренний IP-адрес.
|
||||
12. Нажмите **Создать виртуальную машину**.
|
||||
|
||||
## Конфигурация SSH
|
||||
|
||||
1. Откройте конфигурационный файл SSH `~/.ssh/config` для ОС Linux или `C:\users\имя_пользователя\.ssh\config` для ОС Windows.
|
||||
2. Добавьте в конфигурационный файл сведения о виртуальных машинах:
|
||||
|
||||
```
|
||||
host jumphost
|
||||
hostname <foo-host>
|
||||
user <foo-login>
|
||||
IdentityFile <foo-secret-file-path>
|
||||
|
||||
host myhost
|
||||
hostname <bar-another-host>
|
||||
user <bar-login>
|
||||
IdentityFile <bar-secret-file-path>
|
||||
ProxyJump jumphost
|
||||
```
|
||||
где:
|
||||
- `foo-host`: публичный IP-адрес джамп-хоста;
|
||||
- `foo-login`: [имя пользователя ОС по умолчанию](./../compute-overview.md#операционная-система) на джамп-хосте;
|
||||
- `foo-secret-file-path`: путь к приватному ключу джамп-хоста;
|
||||
- `bar-another-host`: внутренний IP-адрес ВМ, к которой требуется подключиться;
|
||||
- `bar-login`: [имя пользователя ОС по умолчанию](./../compute-overview.md#операционная-система) на ВМ. к которой требуется подключиться;
|
||||
- `bar-secret-file-path`: путь к приватному ключу ВМ, к которой требуется подключиться;
|
||||
|
||||
## Подключиться к ВМ закрытого контура
|
||||
|
||||
1. Откройте терминал.
|
||||
2. Выполните команду:
|
||||
|
||||
```
|
||||
ssh myhost
|
||||
```
|
||||
@@ -1,36 +1,55 @@
|
||||
# Подключение к ВМ
|
||||
# Подключение к виртуальной машине
|
||||
|
||||
Подключение к ВМ выполняется по протоколу SSH с [помощью ключевой пары](../../admin/ssh.md).
|
||||
|
||||
:::tip Информация
|
||||
Чтобы подключаться к виртуальной машине по SSH, [добавьте](../../admin/ssh.md#добавить-ssh-ключ) публичный ключ в профиль пользователя перед созданием виртуальной машины. Для существующих виртуальных машин добавление SSH-ключа невозможно.
|
||||
:::
|
||||
|
||||
## Перед началом работы
|
||||
|
||||
- Статус ВМ `Включен`.
|
||||
Перед подключением проверьте выполнение условий и наличие данных:
|
||||
|
||||
- Статус виртуальной машины — `Включена`.
|
||||
- Виртуальной машине [назначен](../compute-how-to/compute-ip.md#назначить-вм-публичный-ip-адрес) публичный IP-адрес.
|
||||
- Узнайте [имя пользователя ОС по умолчанию](../compute-overview.md#операционная-система).
|
||||
- Приватный ключ сохранен на компьютере, с которого выполняется подключение.
|
||||
|
||||
:::tip Информация
|
||||
|
||||
Чтобы [подключиться](../compute-guide/compute-guide-ssh-inside.md) к виртуальной машине закрытого контура, используйте как джамп-хост виртуальную машину с публичным IP-адресом.
|
||||
|
||||
:::
|
||||
|
||||
## Подключиться к ВМ
|
||||
|
||||
1. Откройте терминал.
|
||||
2. Выполните команду в терминале:
|
||||
|
||||
- **подключиться из интернета к ВМ, созданной в зоне `DMZ`**:
|
||||
|
||||
```
|
||||
ssh -l <имя пользователя> <публичный IP-адрес ВМ>
|
||||
```
|
||||
```
|
||||
ssh -l <логин>@<публичный_IP>
|
||||
```
|
||||
где:
|
||||
|
||||
- `имя пользователя`: имя пользователя ВМ соответствует [названию операционной системы ВМ](./../compute-overview.md#операционная-система), но с маленькой буквы и без указания версии ОС;
|
||||
- `публичный IP-адрес ВМ`: публичный IP-адрес ВМ можно узнать на странице сервиса **Виртуальные машины** в разделе **Виртуальные машины**, нажмите на имя ВМ и скопируйте IP-адрес.
|
||||
|
||||
- **подключиться из интернета к ВМ, созданной в зоне `Inside`**:
|
||||
- `логин`: [имя пользователя ОС по умолчанию](./../compute-overview.md#операционная-система);
|
||||
- `публичный_IP`: публичный IP-адрес виртуальной машины можно узнать на странице сервиса **Виртуальные машины** в разделе **Виртуальные машины**.
|
||||
|
||||
```
|
||||
ssh -o ProxyJump=<имя пользователя1>@<публичный IP-адрес ВМ> <имя пользователя2>@<приватный IP-адрес ВМ>
|
||||
```
|
||||
где:
|
||||
- `имя пользователя1`: имя пользователя ВМ, через которую будет выполнено подключение к ВМ `Inside`-зоны, соответствует [названию операционной системы ВМ](./../compute-overview.md#операционная-система), но с маленькой буквы и без указания версии ОС;
|
||||
- `имя пользователя2`: имя пользователя ВМ `Inside`-зоны, соответствует [названию операционной системы ВМ](./../compute-overview.md#операционная-система), но с маленькой буквы и без указания версии ОС;
|
||||
- `публичный IP-адрес ВМ`: публичный IP-адрес ВМ, через которую будет выполнено подключение к ВМ `Inside`-зоны;
|
||||
- `приватный IP-адрес ВМ`: приватный IP-адрес ВМ `Inside`-зоны, к которой нужно подключиться из интернета;
|
||||
- IP-адреса ВМ можно узнать на странице сервиса **Виртуальные машины** в разделе **Виртуальные машины**, нажмите на имя ВМ и скопируйте IP-адрес.
|
||||
- Если на вашем устройстве есть несколько приватных ключей или вы переместили приватный ключ из каталога по умолчанию, то дополнительно укажите путь к приватному ключу:
|
||||
|
||||
```
|
||||
ssh -o IdentityFile=<путь_к_приватному_ключу> <логин>@<публичный_IP>
|
||||
```
|
||||
|
||||
3. Подтвердите подключение.
|
||||
|
||||
## Пример команды для подключения к ВМ
|
||||
|
||||
::::tabs
|
||||
= Linux/macOS
|
||||
```
|
||||
ssh -o IdentityFile=~/.ssh/id_ed25519 debian@<публичный_IP>
|
||||
```
|
||||
= Windows 10/11
|
||||
```
|
||||
ssh -o IdentityFile=%USERPROFILE%\.ssh\id_ed25519 debian@<публичный_IP>
|
||||
```
|
||||
::::
|
||||
|
||||
@@ -1,29 +1,36 @@
|
||||
# IP-адрес
|
||||
|
||||
IP-адрес — это вычислительный ресурс облака. В облачных сервисах используются внутренние IPv4-адреса.
|
||||
IP-адрес — это вычислительный ресурс облака. В сервисе **Виртуальные машины** поддерживаются только IPv4-адреса
|
||||
|
||||
Внутренние IP-адреса назначаются автоматически или выбираются из списка зарезервированных адресов при создании ВМ.
|
||||
Адреса могут быть внутренними или публичными.
|
||||
|
||||
Список зарезервированных адресов формируется из:
|
||||
- IP-адресов, [созданных вручную](#создать-ip-адрес);
|
||||
- IP-адресов, [сохраненных в проекте](#сохранить-ip-адрес-в-проекте).
|
||||
Внутренние IP-адреса формируются из диапазона IP-адресов:
|
||||
|
||||
- автоматически при [создании ВМ](./compute-servers-create.md#создать-виртуальную-машину);
|
||||
- [создаются вручную](#создать-ip-адрес).
|
||||
|
||||
Публичный IP-адрес выдается организации при регистрации аккаунта Beeline Cloud.
|
||||
|
||||
::: warning Важно
|
||||
Привязка и отвязка IP-адресов возможна внутри одной [зоны доступности](../compute-overview.md#зоны-доступности).
|
||||
Одной организации предоставляется один публичный IP-адрес.
|
||||
:::
|
||||
|
||||
## Типы IP-адресов
|
||||
## Внутренние IP-адреса
|
||||
|
||||
`Публичный` — IP-адрес, по которому ВМ доступна из интернета.
|
||||
Внутренний IP-адрес назначается виртуальной машине автоматически или выбираются из списка зарезервированных адресов при ее создании.
|
||||
|
||||
`Приватный` — IP-адрес, по которому ВМ доступна в [зоне `Inside`](../compute-overview.md#зоны-доступности).
|
||||
Внутренний IP-адрес используется для взаимодействия между ВМ внутри одной сети. Внутренний IP-адрес не виден из интернета.
|
||||
|
||||
::: warning Важно
|
||||
Один публичный IP-адрес предоставляется одной организации. Не удаляйте публичный IP-адрес из списка IP-адресов. В случае удаления IP-адреса пропадет возможность создания ВМ с доступом в интернет.
|
||||
|
||||
Публичный IP-адрес можно отвязать от ВМ и назначить другой ВМ.
|
||||
:::tip Информация
|
||||
Виртуальная машина доступна из интернета только через публичный IP-адрес. Для доступа из интернета к виртуальной машине по внутреннему IP-адресу используйте виртуальную машину с публичным IP-адресом как джамп-хост.
|
||||
:::
|
||||
|
||||
## Публичные IP-адреса
|
||||
|
||||
Публичный IP-адрес — это внешний IP-адрес, который используется для выхода в интернет. В сервисе **Виртуальные машины** публичный IP-адрес является плавающим адресом (floating IP), который можно [переназначать](#назначить-вм-публичный-ip-адрес) между виртуальными машинами.
|
||||
|
||||
Публичный IP-адрес [назначается](#назначить-вм-публичный-ip-адрес) виртуальной машине при ее создании. Существующей ВМ назначить публичный IP-адрес нельзя.
|
||||
|
||||
## Статусы IP-адресов
|
||||
|
||||
`Используется` — IP-адрес зарезервирован и назначен ВМ.
|
||||
@@ -53,11 +60,26 @@ IP-адрес — это вычислительный ресурс облака.
|
||||
- добавьте тег адресу при необходимости.
|
||||
7. Нажмите **Создать**.
|
||||
|
||||
На странице **Облачные вычисления → IP-адреса** появится новый IP-адрес со статусом `Зарезервирован`.
|
||||
На странице **Виртуальные машины → IP-адреса** появится новый IP-адрес со статусом `Зарезервирован`.
|
||||
|
||||
## Назначить ВМ публичный IP-адрес
|
||||
|
||||
Публичный IP-адрес можно привязать ВМ при условиях:
|
||||
|
||||
- IP-адрес находится в статусе `Зарезервирован`;
|
||||
- виртуальная машина и публичный IP-адрес находятся в одной [зоне доступности](./../compute-overview.md#зоны-доступности);
|
||||
- публичный IP-адрес можно назначить только новой ВМ, существующей ВМ привязать публичный IP-адрес не получится.
|
||||
|
||||
Чтобы привязать публичный IP-адрес новой ВМ, то при создании ВМ в поле **IPv4-адрес** выберите публичный IP-адрес.
|
||||
|
||||
Если вам требуется отвязать публичный IP-адрес от существующей ВМ:
|
||||
|
||||
- убедитесь, что для IP-адреса не указан признак `Автоудаление`, при необходимости [снимите признак `Автоудаление`](#сохранить-ip-адрес-в-проекте) у IP-адреса;
|
||||
- [удалите ВМ](./compute-servers-manage.md#удалить-вм).
|
||||
|
||||
## Сохранить IP-адрес в проекте
|
||||
|
||||
При удалении ВМ его IP-адрес освобождается и не может быть повторно использован в проекте. Если вам требуется сохранить IP-адрес ВМ и привязать этот адрес новой ВМ, то отключите автоудаление адреса. IP-адрес сохранится в вашем проекте и может быть назначен новой ВМ.
|
||||
При удалении ВМ её IP-адрес удаляется и не может быть повторно использован в проекте. Если вам требуется сохранить IP-адрес и использовать его для другой ВМ, то отключите автоудаление адреса. IP-адрес сохранится в вашем проекте и может быть назначен новой ВМ.
|
||||
|
||||
1. Войдите в [личный кабинет](https://lk.cloud.beeline.ru/).
|
||||
2. Выберите нужный проект в верхнем меню **Проекты**.
|
||||
@@ -70,7 +92,7 @@ IP-адрес — это вычислительный ресурс облака.
|
||||
|
||||
## Присвоить имя IP-адресу
|
||||
|
||||
Имя IP-адреса отображается только на странице **Облачные вычисления → IP-адреса**. На странице ВМ отображается значение IP-адреса.
|
||||
Имя IP-адреса отображается только на странице **Виртуальные машины → IP-адреса**. На параметрах виртуальной машины отображается значение IP-адреса.
|
||||
|
||||
1. Войдите в [личный кабинет](https://lk.cloud.beeline.ru/).
|
||||
2. Выберите нужный проект в верхнем меню **Проекты**.
|
||||
@@ -83,6 +105,10 @@ IP-адрес — это вычислительный ресурс облака.
|
||||
|
||||
## Удалить IP-адрес
|
||||
|
||||
:::warning Важно
|
||||
Не удаляйте публичный IP-адрес из списка IP-адресов. В случае удаления IP-адреса пропадет возможность создания ВМ с доступом в интернет.
|
||||
:::
|
||||
|
||||
Если для IP-адреса установлено автоудаление, то адрес удалится во время удаления ВМ.
|
||||
|
||||
Если для IP-адреса не установлено автоудаление, то адрес удаляется вручную:
|
||||
|
||||
@@ -9,37 +9,33 @@
|
||||
5. Нажмите **Создать виртуальную машину**.
|
||||
6. В блоке **Имя и расположение** укажите имя и расположение ВМ:
|
||||
- **Имя машины**: введите название ВМ:
|
||||
- допустимая длина 63 символа с учетом зоны DNS проекта;
|
||||
- длина от 3 до 63 символов;
|
||||
- используйте только строчные латинские буквы, цифры и дефис;
|
||||
- не используйте дефис в начале или в конце имени.
|
||||
- **Зона доступности**: выберите подходящую [зону доступности](../compute-overview.md#зоны-доступности).
|
||||
- Укажите количество создаваемых ВМ.
|
||||
7. В блоке **Выбор образа** выберите [тип и версию операционной системы](./../compute-overview.md#операционная-система).
|
||||
8. В блоке **Конфигурация** выберите количество ОЗУ и ЦПУ. Наборы ресурсов заранее скомпонованы по оптимальным параметрам.
|
||||
8. В блоке **Конфигурация** выберите количество vCPU и RAM. Наборы ресурсов заранее скомпонованы по оптимальным параметрам.
|
||||
::: tip Информация
|
||||
При выборе ресурсов рекомендуется в первую очередь ориентироваться на требуемое количество ОЗУ.
|
||||
При выборе ресурсов рекомендуется в первую очередь ориентироваться на требуемое количество RAM.
|
||||
:::
|
||||
9. В блоке **Диски** настройте загрузочный диск и, при необходимости, добавьте дополнительные диски:
|
||||
- **Загрузочный диск**: выберите тип хранения и укажите размер загрузочного диска.
|
||||
- **Загрузочный диск**: выберите [тип диска](../compute-overview.md#диски) и укажите размер загрузочного диска.
|
||||
- Рекомендуется создать дополнительный диск для размещения ваших данных: нажмите **Добавьте диск** и настройте дополнительный диск. [Дополнительный диск можно создать](#добавить-диск) позже.
|
||||
::: warning Важно
|
||||
К ВМ можно подключить не более 28 дисков, включая загрузочный.
|
||||
:::
|
||||
10. Выберите SSH-ключи, с помощью которых вы можете подключаться к ВМ по SSH. Если подходящий SSH-ключ отсутствует, то нажмите [**Создать ключ**](../../admin/ssh.md#создать-ssh-ключ).
|
||||
11. В блоке **Настройки сети** выберите:
|
||||
- **IPv4-адрес**: выберите способ получения внутреннего IP-адреса для ВМ:
|
||||
- выберите **Автоматически**, чтобы получить IP-адрес автоматически;
|
||||
- выберите адрес из списка. В списке адресов отображаются [созданные вручную IP-адреса](compute-ip.md#создать-ip-адрес) и [сохраненные IP-адреса](compute-ip.md#сохранить-ip-адрес-в-проекте), которые доступны для переиспользования.
|
||||
::: warning Важно
|
||||
Вашей организации предоставлен один [публичный IP-адрес](compute-ip.md#типы-адресов). Назначьте публичный IP-адрес ВМ, создаваемой в DMZ-зоне, и получите доступ из интернета к виртуальным машинам.
|
||||
:::
|
||||
12. В блоке **Размещения** выберите:
|
||||
10. Выберите SSH-ключи, с помощью которых вы можете подключаться к ВМ по SSH. Если подходящий SSH-ключ отсутствует, то нажмите [**Создать ключ**](../../admin/ssh.md#создать-ssh-ключ).
|
||||
11. В блоке **Настройки сети** выберите:
|
||||
- **IPv4-адрес**: выберите способ получения IP-адреса для ВМ:
|
||||
- выберите **Автоматически**, чтобы получить IP-адрес автоматически, автоматически назначаются [внутренние IP-адреса](compute-ip.md#внутренние-ip-адреса);
|
||||
- выберите адрес из списка. В списке адресов отображается [зарезервированные IP-адреса](compute-ip.md#статусы-ip-адресов).
|
||||
12. В блоке **Размещения** выберите:
|
||||
- **Группа размещения**: выберите правило размещения ВМ на физическом хосте. [Группу размещения](compute-affinity.md) создайте заранее.
|
||||
13. Установите флажок **Расширенные параметры**, чтобы использовать [cloud-init](https://cloudinit.readthedocs.io/en/latest/) для настройки ВМ.
|
||||
14. Нажмите **Создать виртуальную машину**.
|
||||
13. Отметьте **Расширенные параметры**, чтобы использовать [cloud-init](https://cloudinit.readthedocs.io/en/latest/) для настройки ВМ.
|
||||
14. Нажмите **Создать виртуальную машину**.
|
||||
|
||||
ВМ появится на странице сервиса **Виртуальные машины** в разделе **Виртуальные машины** в статусе `Cоздается`. Выполняется сборка виртуального ВМ, назначается [IP-адрес](compute-ip.md) и полное доменное имя (FQDN). После окончания сборки ВМ перейдет в статус `Включена`.
|
||||
|
||||
Виртуальная машина будет создана с `root`-правами.
|
||||
|
||||
## Добавить диск
|
||||
|
||||
Добавление дополнительного диска к ВМ состоит из двух шагов:
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# Обзор сервиса
|
||||
|
||||
Виртуальные машины — сервис для создания и управления виртуальными машинами.
|
||||
Виртуальные машины — сервис для создания и управления виртуальными машинами.
|
||||
|
||||
## Виртуальная машина
|
||||
|
||||
@@ -12,22 +12,7 @@
|
||||
- тип и размер диска;
|
||||
- регион доступности.
|
||||
|
||||
## Зоны доступности
|
||||
|
||||
Виртуальную машину можно создать в одной из зон доступности:
|
||||
|
||||
- `Inside` — внутренняя зона не подразумевает доступ из интернета к виртуальным машинам.
|
||||
- `DMZ` — демилитаризованная зона подразумевает доступ из интернета к виртуальным машинам.
|
||||
|
||||
К виртуальной машине, созданной в зоне `DMZ`, можно подключиться из интернета по SSH.
|
||||
|
||||
Доступ из интернета к виртуальным машинам, созданным в зоне `Inside` осуществляется:
|
||||
|
||||
- создайте ВМ в зоне `DMZ`;
|
||||
- назначьте ВM публичный IP-адрес;
|
||||
- [подключитесь к ВМ](./compute-how-to/compute-connect.md#подключиться-к-вм) `Inside`-зоны через виртуальную машину `DMZ`-зоны.
|
||||
|
||||
## Размещение виртуальных машин
|
||||
## Группы виртуальных машин
|
||||
|
||||
Группу виртуальных машин внутри одной зоны доступности можно объединить в соответствии с определенной политикой размещения. Доступны политики:
|
||||
|
||||
@@ -39,55 +24,37 @@
|
||||
|
||||
- Правило `Soft-Anti-Affinity` размещает ВМ по возможности на разных физических хостах.
|
||||
|
||||
## CPU и RAM
|
||||
## Зоны доступности
|
||||
|
||||
### Тарифы
|
||||
Виртуальную машину можно создать в одной из зон доступности:
|
||||
|
||||
При создании виртуальной машины доступны готовые конфигурации CPU и RAM.
|
||||
- `Inside` — закрытый контур, не подразумевает доступ из интернета к виртуальным машинам.
|
||||
- `DMZ` — демилитаризованная зона, подразумевает доступ из интернета к виртуальным машинам.
|
||||
|
||||
| Группа | slug | ЦПУ | ОЗУ Гбайт |
|
||||
|:------------|:------------|:----|:----------|
|
||||
| маленькие | cpu2ram2 | 2 | 2 |
|
||||
| маленькие | cpu2ram4 | 2 | 4 |
|
||||
| маленькие | cpu2ram8 | 2 | 8 |
|
||||
| маленькие | cpu2ram16 | 2 | 16 |
|
||||
| маленькие | cpu4ram4 | 4 | 4 |
|
||||
| маленькие | cpu4ram8 | 4 | 8 |
|
||||
| маленькие | cpu4ram16 | 4 | 16 |
|
||||
| маленькие | cpu4ram32 | 4 | 32 |
|
||||
| средние | cpu8ram16 | 8 | 16 |
|
||||
| средние | cpu8ram32 | 8 | 32 |
|
||||
| средние | cpu8ram64 | 8 | 64 |
|
||||
| средние | cpu8ram128 | 8 | 128 |
|
||||
| средние | cpu16ram4 | 16 | 4 |
|
||||
| средние | cpu16ram8 | 16 | 8 |
|
||||
| средние | cpu16ram16 | 16 | 16 |
|
||||
| средние | cpu16ram32 | 16 | 32 |
|
||||
| средние | cpu16ram64 | 16 | 64 |
|
||||
| средние | cpu16ram128 | 16 | 128 |
|
||||
| большие | cpu24ram48 | 24 | 48 |
|
||||
| большие | cpu24ram96 | 24 | 96 |
|
||||
## Шаблоны конфигурации ВМ
|
||||
|
||||
При создании виртуальной машины доступны готовые конфигурации CPU и RAM. Произвольные конфигурации недоступны.
|
||||
|
||||
## Диски
|
||||
|
||||
Хранение данных организовано с использованием сетевых дисков. Диск создается в определенной зоне доступности. Каждый диск автоматически реплицируется внутри своей зоны доступности, что обеспечивает надежное хранение данных.
|
||||
|
||||
Доступны типы дисков:
|
||||
- NBD.
|
||||
Система хранения построена на платформе Ceph. Используются блочные устройства хранения данных — `NBD (network block device)`. Доступен тип диска — `SSD`.
|
||||
|
||||
## Операционная система
|
||||
|
||||
Для виртуальных машин подготовлены образы операционных систем.
|
||||
Для виртуальных машин подготовлены образы операционных систем UNIX.
|
||||
|
||||
| Операционная система | Версия | Размер загрузочного диска | Имя пользователя |
|
||||
В операционных системах доступен `root`-пользователь. Для подключения к ВМ используется имя пользователя ОС по умолчанию.
|
||||
|
||||
| Операционная система | Версия | Размер загрузочного диска | Имя пользователя по умолчанию |
|
||||
|---|---|---|---|
|
||||
| AstraLinux | 1.8.2 | 3 Гб | astra|
|
||||
| CentOS | 9 | 10 Гб | centos|
|
||||
| CentOS | 10 | 10 Гб | centos|
|
||||
| Debian | 12 | 5 Гб | debian|
|
||||
| Rocky Linux | 9 | 10 Гб | rocky |
|
||||
| Ubuntu | 20.04 | 5 Гб | ubuntu |
|
||||
| Ubuntu | 22.04 | 5 Гб | ubuntu |
|
||||
| VyOS | 13 | 2 Гб | vyos |
|
||||
| VyOS | 14 | 2 Гб | vyos |
|
||||
|
||||
<!--| Rocky Linux | 9 | 10 Гб | rockylinux |-->
|
||||
@@ -4,7 +4,7 @@ section_links:
|
||||
link: /compute/compute-overview.md
|
||||
description: Обзор сервиса, решаемые задачи, характеристики оборудования
|
||||
- title: Виртуальные машины
|
||||
link: /compute/compute-how-to/compute-Index.md
|
||||
link: /compute/compute-how-to/compute-index.md
|
||||
description: Создание виртуальной машины и подключение к ней, управление виртуальной машиной
|
||||
- title: Диски
|
||||
link: /compute/compute-how-to/compute-disks.md
|
||||
|
||||
@@ -26,6 +26,9 @@ features:
|
||||
- title: Аккаунт Beeline Cloud
|
||||
details: Аккаунт пользователя Beeline Cloud.
|
||||
link: /admin/index
|
||||
- title: Дизайн-платформа Yellowbe
|
||||
details: Инструкця по работе с Yellowbe.
|
||||
link: /yellowbe/index
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -17,7 +17,7 @@ Beeline Cloud — облачная платформа, основанная на
|
||||
- быстрое развертывание сервисов;
|
||||
- безопасное хранение данных — наши системы хранения данных соответствуют строгим стандартам;
|
||||
- защита данных от утечек и несанкционированного доступа;
|
||||
- гибкое масштабирование — увеличение или уменьшение ресурсы по мере необходимости.
|
||||
- гибкое масштабирование — увеличение или уменьшение ресурсов по мере необходимости.
|
||||
- прогнозируемые расходы.
|
||||
|
||||
Облачная платформа полностью соответствует требованиям по защите ПДн для первого уровня защищенности (УЗ-1), что позволяет безопасно размещать и обрабатывать персональные данные.
|
||||
|
||||
@@ -10,7 +10,7 @@
|
||||
|
||||
| Способ связи | Описание | Время работы |
|
||||
|--------|----------|---------------------|
|
||||
|Портал технической поддержки| /скоро появится | круглосуточно |
|
||||
|Центр поддержки| [lk.cloud.beeline.ru/support-center](https://lk.cloud.beeline.ru/support-center) | круглосуточно |
|
||||
|Почта | [servicedesk@datafort.ru](mailto:servicedesk@datafort.ru) | круглосуточно|
|
||||
|
||||
## Сроки обработки запросов
|
||||
|
||||
+11
-5
@@ -23,19 +23,25 @@
|
||||
- создание других пользователей в проекте недоступно;
|
||||
- установлены [квоты](#квоты-сервисов) на ресурсы сервисов.
|
||||
|
||||
### Квоты сервисов
|
||||
## Квоты сервисов
|
||||
|
||||
::: details Виртуальные дата-центры на VMware
|
||||
### Виртуальные дата-центры на VMware
|
||||
|
||||
| Вид ограничения | Значение |
|
||||
|---|---|
|
||||
| Количество виртуальных дата-центров в проекте | 1 |
|
||||
| Количество vCPU в одном дата-центре | 4 |
|
||||
| Объем RAM в одном дата-центре | 8 Гб |
|
||||
| Объем дискового пространства в одном дата-центре | 80 Гб |
|
||||
| Объем RAM в одном дата-центре | 8 ГБ |
|
||||
| Объем дискового пространства в одном дата-центре | 80 ГБ |
|
||||
|Количество публичных IP-адресов в одном дата-центре| 1 |
|
||||
|
||||
:::
|
||||
### Виртуальные машины
|
||||
|
||||
| Вид ограничения | Значение |
|
||||
|---|---|
|
||||
|Количество публичных IP-адресов | 1 |
|
||||
|Шаблоны конфигурации vCPU и RAM виртуальных машин| 2 vCPU 2 ГБ RAM<br> 2 vCPU 4 ГБ RAM<br> |
|
||||
|Суммарный объем SSD-дисков, включая образы загрузочных дисков | 100 ГБ |
|
||||
|
||||
## Переход на платное использование
|
||||
|
||||
|
||||
@@ -0,0 +1,22 @@
|
||||
# Из чего состоит дизайн-платформа
|
||||
|
||||
## Ресурсы
|
||||
|
||||
### Frontend
|
||||
|
||||
- Компоненты на React. Реализованные в коде компоненты дизайн-платформы для фреймворка React
|
||||
- Токены компонентов. Готовые переменные всех свойств и стилей, которые при изменении дизайна автоматически обновляются в коде.
|
||||
- Мигратор. Инструмент для миграции устаревших токенов.
|
||||
|
||||
### Дизайн
|
||||
|
||||
- Web компоненты. Набор готовых и актуальных компонентов, которые значительно ускоряют процесс проектирования для веб-продуктов.
|
||||
- Набор базовых стилей. Обширная библиотека базовых стилей с готовыми палитрами, шрифтовой архитектурой и системой отступов.
|
||||
- Плагин icon finder. Плагин для поиска нужной иконки в иконочном шрифте Yellowbe.
|
||||
|
||||
### Основы
|
||||
|
||||
- Базовые токены. Набор базовых переменных (цвет, типографика, форма или свойство объекта) представленный в виде данных.
|
||||
- Иконки. Иконки Дизайн-платформы объединены в иконочный шрифт, который легко подключается к любому продукту. Шрифт имеет актуальную версию и автоматически дополняется новыми иконками.
|
||||
- Перестилизация элементов. Файлы, упрощающие глобальные настройки (подключение шрифтов, перестилизация скроллбара и т.д).
|
||||
- Гайды. Руководства по использованию инструментов дизайн-платформы.
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 21 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 185 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 130 KiB |
@@ -0,0 +1,54 @@
|
||||
|
||||
# Установка
|
||||
|
||||
### Подготовительные действия
|
||||
- Скачайте файлы с библиотекой [Yellowbe_Trial.pix](https://yellowbe.beeline.ru/consumer/assets/files/Yellowbe_Trial.pix)
|
||||
- Импортируйте скачанный файл библиотеки в черновики (Drafts) 
|
||||
|
||||
### Подключение библиотеки Pixso
|
||||
- Если у вас бесплатный аккаунт в Figma, то вы можете работать в файле. Создавайте новые страницы и проектируйте в них, используя локальные компоненты «Yellowbe».
|
||||
- Платный (Enterprise) аккаунт даёт вам возможность опубликовать файл как библиотеку и подключать её к другим файлам. Переместите файл в команду и опубликуйте его.
|
||||
- Теперь вы можете подключить опубликованную библиотеку к файлам проекта: Component > Library > Enterprise libraries > Switch ON
|
||||
|
||||
|
||||
|
||||
|
||||
# Работа с компонентами
|
||||
Компоненты — это часто повторяющиеся элементы интерфейса. Они помогают создавать и поддерживать консистентный дизайн в продуктах. Мы пытаемся покрывать все потребности дизайнеров и постоянно работаем над развитием системы.
|
||||
|
||||
### Принципы работы с компонентами
|
||||
При использовании библиотеки компонентов следуйте принципам:
|
||||
- Выбирать компоненты через вкладку Component
|
||||
- Не отвязывать компоненты, с целью их “доработать”
|
||||
- Не копировать мастер-компонент из библиотеки в Pixso
|
||||
|
||||
|
||||
### Типы компонентов
|
||||
|
||||
- Сквозной компонент. Это компонент, который переиспользуется во всех макетах. Его стоит обернуть в локальный компонент в вашем проекте, чтобы все изменения происходили автоматически.
|
||||
- Кастомизируемый компонент.Это компонент, который предполагает изменения под нужды продуктов. Например, добавить в Header дополнительные кнопки или иконки.
|
||||
- Сборный компонент. Это группа компонентов-деталей, из которых собирается компонент или целый элемент интерфейса. К таким составным компонентам относятся: Autocomplete, Cell, List, Side sheet.
|
||||
|
||||
#### Сквозной компонент
|
||||
Настраивается под продукт, и затем дублируется во всем проекте. Например, Navigation drawer или Header.
|
||||
|
||||
Следует обернуть копию компонента из библиотеки в свой локальный компонент и дать название в соответствии со значением.
|
||||
При редактирование локального компонента, изменения наследуются на остальные инстансы, а связь с Дизайн-платформой сохраняется.
|
||||
Детачить компонент из библиотеки нельзя.
|
||||
|
||||
#### Кастомизируемый компонент
|
||||
Кастомизируется под запрос продукта, но полностью соответствуют правилам дизайн-платформы и следует единому дизайну.
|
||||
|
||||
Бывает что компонент не до конца соответствует запросу продукта, и в этом случае можно доработать компонент под частный случай.
|
||||
|
||||
Все элементы добавляются в единый фрейм/группу, объединяющую базовый компонент Yellowbe и другие элементы. При создании такого компонента необходимо соблюдать правила дизайн-платформы и здравого смысла.
|
||||
|
||||
Скрывать ненужные элементы можно через панель управления вариантами. Детачить компонент из библиотеки нельзя.
|
||||
|
||||
#### Сборный компонент из компонентов Yellowbe
|
||||
Состоит из нескольких компонентов, или групп, которые помогают формировать свой уникальный элемент интерфейса.
|
||||
Может собираться из компонентов: list item, cell, notification, sideshit, autocomplete и др.
|
||||
|
||||
Из маленьких элементов следует собирать более крупные и формирующие группы, блоки или страницы. Сборный компонент легко изменить в любом месте и любом объёме, убрав или заменив нужный элемент.
|
||||
|
||||
Сборка компонента похожа на конструктор, и даёт больше гибкости в реализации.
|
||||
@@ -0,0 +1,122 @@
|
||||
# 📦 Установка
|
||||
|
||||
### Установка из локального архива
|
||||
Для установки библиотеки из скачанного архива выполните:
|
||||
- Скачайте архив <code>yellowbe-ui-vX.X.X.tgz</code> из <a href="https://github.com/beeline-design/yellowbe-ui/releases" target="_blank">релизов GitHub</a>
|
||||
- Переместите архив в папку вашего проекта
|
||||
- Выполните команду установки:
|
||||
|
||||
|
||||
```bash
|
||||
npm install ./yellowbe-ui-vX.X.X.tgz
|
||||
# или
|
||||
yarn add ./yellowbe-ui-vX.X.X.tgz
|
||||
```
|
||||
|
||||
### 🔨 Быстрый старт
|
||||
|
||||
```jsx
|
||||
import { ThemeProvider, Button, Input } from "@yellowbe/design-system-react";
|
||||
|
||||
function App() {
|
||||
return (
|
||||
<ThemeProvider isRoot theme='light'>
|
||||
<Input label="Email" type="email" />
|
||||
<Button variant="primary">Отправить</Button>
|
||||
</ThemeProvider>
|
||||
);
|
||||
}
|
||||
```
|
||||
|
||||
## 🎨 Настройка темизации
|
||||
|
||||
Оберните корневой компонент приложения:
|
||||
|
||||
```jsx
|
||||
import { ThemeProvider } from "@yellowbe/design-system-react";
|
||||
|
||||
function RootComponent() {
|
||||
return (
|
||||
<ThemeProvider isRoot theme='light'> {/* или 'dark' */}
|
||||
<App />
|
||||
</ThemeProvider>
|
||||
);
|
||||
}
|
||||
```
|
||||
|
||||
## 🔤 Подключение шрифтов и стилей
|
||||
|
||||
### Шрифт Roboto
|
||||
Библиотека использует шрифт **Roboto** от Google, распространяемый под лицензией **Apache License 2.0**:
|
||||
|
||||
- [Лицензия Roboto](https://github.com/google/roboto/blob/main/LICENSE)
|
||||
- [Официальный сайт шрифта](https://fonts.google.com/specimen/Roboto)
|
||||
|
||||
**Условия использования:**
|
||||
✅ Разрешено:
|
||||
- Бесплатное использование в коммерческих и некоммерческих проектах
|
||||
- Модификация шрифта
|
||||
- Распространение в продуктах
|
||||
|
||||
### Для полной интеграции дизайн-платформы добавьте:
|
||||
|
||||
#### В глобальном CSS/SCSS
|
||||
```css
|
||||
@import '~@yellowbe/design-tokens/css/iconfont/iconfont.css';
|
||||
@import '~@yellowbe/design-tokens/css/font-face.css';
|
||||
@import '~@yellowbe/design-tokens/css/scrollbar.css';
|
||||
```
|
||||
#### Или через JS:
|
||||
|
||||
```js
|
||||
// В корневом JS/TS файле
|
||||
import '@yellowbe/design-tokens/css/iconfont/iconfont.css';
|
||||
import '@yellowbe/design-tokens/css/font-face.css';
|
||||
import '@yellowbe/design-tokens/css/scrollbar.css';
|
||||
```
|
||||
|
||||
#### После подключения:
|
||||
|
||||
- Доступен шрифт "Roboto" (автоматически используется в Typography)
|
||||
- Работает иконочный шрифт "Yellowbe Icons" (для компонента Icon)
|
||||
- Скроллбар с поддержкой темизации (Chromium/Firefox)
|
||||
|
||||
**Для работы компонента Icon необходимо подключить шрифт иконок**
|
||||
|
||||
## ⚠️ Внимание: При проблемах со сборкой:
|
||||
|
||||
- Проверьте настройки сборщика для обработки CSS и шрифтов
|
||||
- Убедитесь что пакет @yellowbe/design-tokens установлен
|
||||
- Обратитесь к документации
|
||||
|
||||
## 🧩 Использование компонентов
|
||||
Библиотека поддерживает оба формата импорта:
|
||||
|
||||
### ESM (рекомендуется)
|
||||
```jsx
|
||||
import { Button, Typography, Icon } from '@yellowbe/design-system-react';
|
||||
|
||||
function Component() {
|
||||
return (
|
||||
<>
|
||||
<Button variant="primary">Действие</Button>
|
||||
<Typography variant="h1">Заголовок</Typography>
|
||||
<Icon name="arrow-right" size={24} />
|
||||
</>
|
||||
);
|
||||
}
|
||||
```
|
||||
|
||||
### CommonJS
|
||||
```jsx
|
||||
const { Button, Typography } = require('@yellowbe/design-system-react');
|
||||
|
||||
function Component() {
|
||||
return (
|
||||
<>
|
||||
<Button>Кнопка</Button>
|
||||
<Typography>Текст</Typography>
|
||||
</>
|
||||
);
|
||||
}
|
||||
```
|
||||
@@ -0,0 +1,13 @@
|
||||
---
|
||||
section_links:
|
||||
- title: Для разработчика
|
||||
link: /yellowbe/get-started/dev.md
|
||||
description: Как начать работу с библиотеками Yellowbe
|
||||
- title: Для дизайнера
|
||||
link: /yellowbe/get-started/design.md
|
||||
description: Как начать работу с библиотеками Yellowbe
|
||||
---
|
||||
|
||||
# Начать работу
|
||||
|
||||
Как бастро начать использовать дизайн-платформу
|
||||
@@ -0,0 +1,45 @@
|
||||
---
|
||||
section_links:
|
||||
- title: Начать работу
|
||||
link: /yellowbe/get-started/index.md
|
||||
description: Как начать работу с библиотеками Yellowbe
|
||||
- title: Из чего состоит дизайн-платформа
|
||||
link: /yellowbe/about.md
|
||||
description: Список компонентов Yellowbe
|
||||
---
|
||||
|
||||
# Дизайн-платформа Yellowbe
|
||||
|
||||
Готовые UI компоненты для разработчиков и дизайнеров, без санкций и ограничений с поддержкой темизации.
|
||||
|
||||
Дизайн-платформа Yellowbe входит в Реестр российского ПО, [Реестровая запись №27198 от 19.03.2025](https://reestr.digital.gov.ru/reestr/3166609/)
|
||||
|
||||
|
||||
## Ссылки на ресурсы
|
||||
|
||||
<div class="cards-container" style="display: grid; grid-template-columns: repeat(auto-fill, minmax(300px, 1fr)); gap: 20px; margin: 30px 0;">
|
||||
|
||||
<div class="card" style="border: 1px solid #e1e4e8; border-radius: 10px; padding: 20px; box-shadow: 0 3px 10px rgba(0,0,0,0.08);display:flex; flex-direction:column">
|
||||
<h3 style="margin-top: 0;">📚 Официальная документация</h3>
|
||||
<p style="margin:auto">Полное руководство по использованию компонентов, API и примеры кода</p>
|
||||
<a href="https://yellowbe.beeline.ru/consumer/main" style="display: inline-block; background: #f0f4f8; color: #0366d6; padding: 8px 15px; border-radius: 6px; text-decoration: none; font-weight: 500; margin-top: 10px;">
|
||||
Перейти к документации →
|
||||
</a>
|
||||
</div>
|
||||
|
||||
<div class="card" style="border: 1px solid #e1e4e8; border-radius: 10px; padding: 20px; box-shadow: 0 3px 10px rgba(0,0,0,0.08); display:flex; flex-direction:column">
|
||||
<h3 style="margin-top: 0;">🎨 Pixso</h3>
|
||||
<p style="margin:auto">Файлы библиотеки компонентов для Pixso</p>
|
||||
<a href="https://yellowbe.beeline.ru/consumer/get-started/design/pixso-components" style="display: inline-block; background: #f0f4f8; color: #0366d6; padding: 8px 15px; border-radius: 6px; text-decoration: none; font-weight: 500; margin-top: 10px;">
|
||||
Перейти к установке →
|
||||
</a>
|
||||
</div>
|
||||
|
||||
<div class="card" style="border: 1px solid #e1e4e8; border-radius: 10px; padding: 20px; box-shadow: 0 3px 10px rgba(0,0,0,0.08);display:flex; flex-direction:column">
|
||||
<h3 style="margin-top: 0;">💬 Вопросы</h3>
|
||||
<p style="margin:auto">По вопросам можно обращаться на почту</p>
|
||||
<a href="mailto:designsystem@beeline.ru&subject=Обращение из GitHub" style="display: inline-block; background: #f0f4f8; color: #0366d6; padding: 8px 15px; border-radius: 6px; text-decoration: none; font-weight: 500; margin-top: 10px;">
|
||||
Написать нам →
|
||||
</a>
|
||||
</div>
|
||||
</div>
|
||||
Reference in New Issue
Block a user