alex/fox
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Перенос ветки для демо1 из док-ии Vega

Browse Source
This commit is contained in:
Elena Rechkina
2025-03-27 13:43:31 +06:00
parent 5863c6af9d
commit dd15812268
128 changed files with 9520 additions and 89 deletions
Download Patch File Download Diff File Expand all files Collapse all files
src/guide/admin/availability-matrix.md
+13
View File
@@ -0,0 +1,13 @@
# Матрица региональной доступности
Регион доступности — это один или несколько центров обработки данных (ЦОД), в которых могут быть размещены компоненты облачной инфраструктуры.
| Регион | Статус | Гипервизор | Процессор | HDD| SSD | NVME|
|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
| **ДатаФорт 1** | Доступен | OpenStack | Intel® Xeon® Gold 6248R | ✘ | ✘ | ✅ |
Условные обозначения:
✅ — есть возможность выдачи ресурсов.
✘ — нет возможности выдачи ресурсов.
src/guide/admin/limits.md
+40
View File
@@ -0,0 +1,40 @@
# Квоты и лимиты
Ограничения включают в себя лимиты и квоты на потребление ресурсов в проекте.
Квоты ограничивают потребление ресурсов в проекте. В проекте на каждый ресурс выделяется квота, не превышающая лимит.
После создания проекту становятся доступны базовые квоты. Для них установлены значения по умолчанию.
**Базовые квоты**
| Название квоты | Количество |
|---------------------|------------|
| Количество виртуальных серверов | 3 штуки|
| ЦПУ | 200 |
| ОЗУ | 200 Гбайт |
| Хранилище NVME | 5000 Гбайт |
| Объектное хранилище | 100 Гбайт |
## Просмотр квот проекта
1. Перейдите в консоль управления.
2. В шапке выберите **Проекты**.
3. Откроется список проектов, в которых вы являетесь участником.
4. Нажмите на имя нужного проекта.
5. Откройте раздел **Обзор**.
## Редактирование квот проекта
::: tip Информация
Изменить квоты проекта может пользователь с ролью **Владелец проекта**.
:::
1. Перейдите в консоль управления.
2. В шапке выберите **Проекты**.
3. Откроется список проектов, в которых вы являетесь участником.
4. Нажмите на имя нужного проекта.
5. Откройте раздел **Обзор**.
6. В правом верхнем углу нажмите **Изменить квоты**.
7. Увеличите или уменьшите квоты для ресурсов.
8. Нажмите **Сохранить**.
src/guide/admin/projects.md
+49
View File
@@ -0,0 +1,49 @@
# Управление проектами
Проект — это структурная единица публичного облака, в которой содержатся ресурсы: виртуальные машины, хранилища, IP-адреса и др.
Ресурсы могут быть вычислительными и аппаратными.
Вычислительные ресурсы:
- оперативная память (ОЗУ);
- ядра процессора (ЦПУ);
- локальные диски;
- сетевые диски;
- IP-адреса.
Аппаратные ресурсы (серверы, сети, диски) размещены в центрах обработки данных (ЦОД). Каждый дата-центр разделен на модули. Модули оснащены независимыми системами электропитания и охлаждения.
При получении доступа в публичное облако текущий пользователь становится менеджера проектов. Менеджер проектов может создавать новые проекты, в которых он получает роль владельца проекта. Владелец проекта может добавлять пользователей в проект, назначая им роли.
Доступ к проекту осуществляется из консоли управления.
## Создать проект
1. Перейдите в консоль управления.
2. Нажмите кнопку **Создать → Проект** в правом верхнем углу.
3. Заполните информацию о проекте:
- **Название**: введите наименование проекта.
- **Идентификатор**: введите идентификатор проекта:
- допустимы строчные и прописные буквы латинского алфавита, цифры и дефис;
- длина не более 64 символов;
- не должно начинаться или заканчиваться дефисом.
- **Описание**: введите краткое описание проекта.
4. Нажмите **Создать**.
## Изменить имя проекта
::: tip Информация
Изменить имя и описание проекта может только пользователь с ролью **Владелец проекта**.
:::
1. Перейдите в консоль управления.
2. В шапке выберите **Проекты**.
3. Откроется список проектов, в которых вы являетесь участником.
4. Нажмите на имя нужного проекта.
5. Откройте раздел **Настройки → Основное**.
6. Измените имя, описание проекта.
7. Нажмите **Сохранить**.
## Удаление проекта
Функциональность не предусмотрена в публичном облаке.
src/guide/admin/roles.md
+49
View File
@@ -0,0 +1,49 @@
# Ролевая модель
Управление проектом основано на ролевой модели.
**Базовые роли**
В проекте предусмотрен базовый набор ролей:
- **Владелец продукта** — управление пользователями проекта, просмотр ресурсов.
- **DevOps-инженер** — управление инфраструктурой, стандартное администрирование ОС UNIX по протоколу ssh и права управления виртуальными серверами и дисками в консоли управления.
## Матрица ролей
| Действие | Владелец проекта | DevOps-инженер |
|---|---|---|
| Обзор проекта<br> (квоты и количество использованных ресурсов)| &#9989; | &#9989; |
| Серверы: обзор | &#9989; | &#9989; |
| Серверы: мониторинг | &#9989; | &#9989; |
| Серверы: создать сервер |&#10008; | &#9989; |
| Серверы: подключить диск | &#10008; | &#9989; |
| Серверы: отключить диск | &#10008; | &#9989; |
| Серверы: добавить диск | &#10008; | &#9989; |
| Серверы: теги | &#10008; |&#9989; |
| Серверы: масштабирование сервера | &#10008; | &#9989; |
| Серверы: выключить сервер | &#10008; | &#9989; |
| Серверы: включить сервер | &#10008; | &#9989; |
| Серверы: перезагрузить сервер | &#10008; | &#9989; |
| Серверы: принудительно перезагрузить сервер | &#10008; | &#9989; |
| Серверы: удалить сервер | &#10008; | &#9989; |
| Серверы: группы размещения | &#10008; | &#9989; |
| Серверы: IP-адреса | &#10008; | &#9989; |
| Диски: просмотр дисков | &#9989; | &#9989; |
| Диски: добавление дискового пространства | &#10008; | &#9989; |
| Диски: удалить диск| &#10008; | &#9989; |
| Объектное хранилище: просмотр| &#9989; | &#9989; |
| Объектное хранилище: добавить хранилище | &#10008; | &#9989; |
| Объектное хранилище: удалить хранилище | &#10008; | &#9989;|
| DNS: добавить зону | &#10008; | &#9989; |
| DNS: редактировать зону | &#10008; | &#9989; |
| DNS: удалить зону |&#10008; | &#9989; |
| Настройки проекта: просмотр| &#9989; | &#9989; |
| Настройки проекта: изменить описание проекта |&#9989; | &#10008; |
| Участники: просмотр | &#9989; | &#9989; |
| Участники: добавить участника | &#9989; | &#10008; |
| Участники: удалить участника | &#9989; | &#10008; |
| Участники: назначить роль | &#9989;| &#10008; |
| Квоты: просмотр | &#9989; | &#9989; |
| Веб-обработчики | &#10008; | &#9989; |
| Наблюдаемость | &#9989; | &#9989; |
src/guide/admin/ssh.md
+38
View File
@@ -0,0 +1,38 @@
# SSH-ключи
SSH-ключи используются для подключения к виртуальной машине по SSH. SSH-ключ состоит из публичного и приватного ключей: публичный ключ хранится в профиле пользователя в публичном облаке, приватный — хранится у пользователя.
## Создать SSH-ключ
1. Перейдите в профиль пользователя.
2. Перейдите в раздел **SSH-ключи**.
3. Нажмите **Добавить ключ**.
4. Укажите название ключа.
5. Откройте терминал и сгенерируйте ключевую пару. Можно использовать команду:
```sh
ssh-keygen -t ed25519 -C “login” -Z aes256-gcm@openssh.com
```
6. Добавьте публичную часть ключа в поле **SSH-ключ**. Пример публичной части ключа:
```
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5ABFLIFyapYheN7OZNhTaNqEHefjmU5mtzK********+gRPCz user@Desktop
```
## Изменить название ключа
1. Перейдите в профиль пользователя.
2. Перейдите в раздел **SSH-ключи**.
3. Выберите нужный ключ.
4. Нажмите на &hellip; и выберите **Редактировать**.
5. Измените имя ключа.
6. Нажмите **Сохранить**.
## Удалить ключ
1. Перейдите в профиль пользователя.
2. Перейдите в раздел **SSH-ключи**.
3. Выберите нужный ключ.
4. Нажмите на &hellip; и выберите **Удалить**.
5. Нажмите **Удалить**, чтобы подтвердить удаление ключа.
src/guide/admin/users.md
+47
View File
@@ -0,0 +1,47 @@
# Управление пользователями в проекте
В консоли управления можно добавлять пользователей, управлять ролями пользователей в проекте. Один пользователей может участвовать в нескольких проектах и иметь в них разные роли.
::: tip Информация
Добавлять и удалять пользователей, изменять права пользователей в проекте может только владелец проекта.
:::
## Добавить пользователя
1. Перейдите в консоль управления.
2. Откройте **Настройки → Участники**.
3. Нажмите **Добавить пользователя**.
4. Найдите пользователя по ФИО или email.
5. Назначьте [роль](../admin/roles.md) пользователю.
6. Нажмите **Добавить**.
## Назначить права пользователю
Каждому пользователю проекта должна быть выдана хотя бы одна роль. У пользователя может быть несколько ролей в одном проекте.
1. Перейдите в консоль управления.
2. Откройте **Настройки → Участники**.
3. Найдите пользователя.
4. Нажмите &#10247; в строке с именем пользователя и выберите **Редактировать**.
5. Назначьте [роль](../admin/roles.md) пользователю: установите флажок напротив роли.
6. Нажмите **Сохранить**.
Права на существующие ОС применятся в течение 10 минут.
## Отозвать права у пользователя
1. Перейдите в консоль управления.
2. Откройте **Настройки → Участники**.
3. Найдите пользователя.
4. Нажмите &#10247; в строке с именем пользователя и выберите **Редактировать**.
5. Отзовите роль у пользователя: уберите флажок напротив роли. Оставьте пользователю хотя бы одну роль в проекте.
6. Нажмите кнопку **Сохранить**.
## Удалить пользователя
1. Перейдите в консоль управления.
2. Откройте **Настройки → Участники**.
3. Найдите пользователя.
4. Нажмите &#10247; в строке с именем пользователя и выберите **Удалить**.
Пользователь будет удален из списка участников проекта. Ресурсы проекта станут недоступны пользователю.
src/guide/compute/compute-getting-started.md
+46
View File
@@ -0,0 +1,46 @@
# Быстрый старт
В этой инструкции рассмотрен процесс создания виртуального сервера UNIX и подключение к нему по протоколу SSH.
## Перед началом работы
- [Создан проект](../admin/projects.md#создать-проект).
- Назначена роль **DevOps-инженер**.
## Создать виртуальный сервер
1. Откройте [консоль управления](https://console.cloud.dfcloud.ru).
2. Выбрать проект.
3. На странице **Обзор** убедитесь в наличии свободных ресурсов.
4. Нажмите **Создать сервер**.
5. Выберите образ ОС UNIX.
6. [Заполните свойства cервера](../compute/compute-instructions/compute-servers-create.md#создать-сервер).
7. Нажмите **Cоздать сервер**.
Виртуальный сервер отобразится на странице **Облачные вычисления → Серверы**. Выполняется сборка виртуального сервера. После окончания сборки сервер перейдет в статус `Включен`.
## Подключиться к серверу по SSH
Для подключения к виртуальному серверу по SSH выполните команду в терминале:
- по IP-адресу сервера:
```
ssh -l <логин пользователя> -i <путь до приватного ключа> <IP-адрес сервера>
```
- по полному доменному имени сервера (FQDN):
```
ssh -l <логин пользователя> -i <путь до приватного ключа> <FQDN сервера>
```
Пример команды подключения к серверу по IP-адресу:
```
$ ssh -l ivanov -i /home/user/.ssh/id_rsa 10.0.0.1
```
## Далее
- [Подключение дополнительного диска к виртуальному серверу](../compute/compute-instructions/compute-disks.md#добавить-диск).
- [Удаление виртуального сервера](../compute/compute-instructions/compute-servers-manage.md#удалить-сервер).
src/guide/compute/compute-instructions/compute-affinity.md
+52
View File
@@ -0,0 +1,52 @@
# Группы размещения
Группы размещения — это правила размещения виртуальных серверов на физических хостах. Правила размещения позволяют создавать виртуальные серверы на разных или на одном хосте. Политика размещения серверов действует в рамках одной зоны доступности.
- Правило `Affinity` размещает серверы обязательно на одном физическом хосте.
- Правило `Soft-Affinity` размещает серверы по возможности на одном физическом хосте.
- Правило `Anti-Affinity` размещает серверы обязательно на разных физических хостах. Такое размещение повышает производительность и предотвращает недоступность сервера при отказе хоста сервера.
- Правило `Soft-Anti-Affinity` размещает серверы по возможности на разных физических хостах.
::: warning Важно
Виртуальный сервер создается в группе размещения. Существующий сервер не может быть добавлен в группу размещения.
Виртуальный сервер может быть создан в группе размещения, если для выполнения правила есть ресурсы в зоне доступности. Если ресурсов нет, то виртуальный сервер не будет создан.
:::
## Создать группу размещения
1. Перейдите в консоль управления.
2. Откройте **Облачные вычисления → Группы размещения**.
3. Нажмите **Создать группу**.
4. Введите параметры группы размещения:
- **Имя группы размещения**: введите имя группы размещения.
- выберите правило размещения.
- **Зона доступности**: выберите зону доступности, в которой будут создаваться виртуальные серверы по правилу размещения.
- добавьте тег группе размещения при необходимости.
7. Нажмите **Создать группу**.
## Редактировать группу размещения
В группе размещения можно изменить название группы и редактировать теги.
1. Перейдите в консоль управления.
2. Откройте **Облачные вычисления → Группы размещения**.
3. Переименовать группу размещения:
- Нажмите на название группы в списке групп.
- Нажмите на &hellip; и выберите **Переименовать**.
- Введите новое имя группы размещения.
- Нажмите &#10003;.
4. Редактировать теги группы размещения:
- Нажмите на название группы в списке групп.
- Нажмите **Редактировать теги**.
- Добавьте или удалите теги.
- Нажмите **Сохранить**.
## Удалить группу размещения
1. Перейдите в консоль управления.
2. Откройте **Облачные вычисления → Группы размещения**.
3. Справа от названия группы размещения нажмите кнопку ![del](../compute-instructions/image/delete.png).
src/guide/compute/compute-instructions/compute-disks.md
+107
View File
@@ -0,0 +1,107 @@
# Диски
Хранение данных организовано с использованием сетевых дисков. Диск создается в определенной зоне доступности. Каждый диск автоматически реплицируется внутри своей зоны доступности, что обеспечивает надежное хранение данных.
Загрузочный диск создается вместе с виртуальным сервером. Конфигурация загрузочного диска задается на этапе [создания виртуального сервера](compute-servers-create.md#создать-сервер). При [удалении виртуального сервера](compute-servers-manage.md#удалить-сервер) загрузочный диск удалится вместе с сервером.
[Дополнительные диски можно добавить](compute-servers-create.md#добавить-диск) на этапе создания виртуального сервера или [создать диск позже и подключить к нужному виртуальному серверу](#создать-диск). При [удалении виртуального сервера](compute-servers-manage.md#удалить-сервер) дополнительные диски (не загрузочные) останутся в проекте в списке дисков.
## Посмотреть список дисков
1. Перейдите в консоль управления.
2. Откройте **Облачные вычисления → Диски**.
## Посмотреть информацию о диске
1. Перейдите в консоль управления.
2. Откройте **Облачные вычисления → Диски**.
3. Нажмите на имя диска.
4. На странице показана информация о диске:
- **Идентификатор**: уникальный идентификатор диска.
- **Тип хранения**: тип диска.
- **Загрузочный**: является ли диск загрузочным.
- **Размер**: размер диска.
- **Подключен к**: виртуальный сервер, к которому подключен диск.
- **Имя устройства**: имя устройства в файловой системе.
## Создать диск
Создать диск дополнительный (не загрузочный):
1. Перейдите в консоль управления.
2. Откройте **Облачные вычисления → Диски**.
3. Нажмите **Создать диск**.
4. Введите параметры добавляемого диска:
- **Имя диска**: введите название диска
- **Зона доступности**: выберите из списка зону доступности, в которой будет создан диск.
- **Тип**: выберите из списка тип хранения.
- **Размер диска**: введите размер добавляемого диска в Гб.
5. Нажмите **Создать диск**.
На странице **Диски** будет добавлен новый диск, но не подключен к какому-либо серверу. Диск можно [подключить к серверу](#подключить-диск-к-виртуальному-серверу).
## Увеличить размер дискового пространства
::: warning Важно
Изменение размера дискового пространства возможно только в большую сторону.
:::
1. Перейдите в консоль управления.
2. Откройте диск, размер которого требуется изменить, одним из способов:
- На странице **Серверы**:
- Откройте **Облачные вычисления → Серверы**.
- Нажмите на имя сервера.
- Перейдите на вкладку **Диски**.
- Нажмите на имя диска и перейдите на шаг 3.
- На странице **Диски**:
- Откройте **Облачные вычисления → Диски**.
- Нажмите на имя диска и перейдите на шаг 3.
3. Нажмите **Изменить размер диска**.
3. Введите размер добавляемого дискового пространства в Гб.
4. Нажмите **Сохранить**.
Далее требуется увеличить размер диска в ОС.
## Подключить диск к виртуальному серверу
Подключить диск к виртуальному серверу можно внутри одной зоны доступности.
::: warning Важно
К виртуальному серверу можно подключить 28 дисков, включая системный.
:::
1. Перейдите в консоль управления.
2. Откройте **Облачные вычисления → Серверы**.
3. Нажмите на имя сервера.
4. Перейдите на вкладку **Диски**.
5. Нажмите **Подключить диск**.
6. В строке поиска введите имя диска. Для отображения списка дисков щелкните в строке поиска левой кнопкой мыши.
7. Нажмите **Подключить**.
## Отключить диск от виртуального сервера
Отключить от виртуального сервера можно только дополнительный диск. Отключение загрузочного диска невозможно.
1. Перейдите в консоль управления.
2. Откройте **Облачные вычисления → Серверы**.
3. Нажмите на имя сервера.
4. Перейдите на вкладку **Диски**.
5. Нажмите на &hellip; и выберите **Отключить от сервера**.
7. В открывшемся окне подтвердите операцию:
- Введите имя виртуального сервера, от которого отключаете диск.
- Нажмите **Отключить диск**.
## Удалить диск
Перед удалением отключите диск от виртуального сервера.
::: danger Предупреждение
Удаление диска необратимо. Все данные будут удалены без возможности восстановления.
:::
1. Перейдите в консоль управления.
2. Откройте **Облачные вычисления → Диски**.
3. Нажмите на &hellip; и выберите **Удалить**.
6. В открывшемся окне подтвердите операцию:
- Введите имя удаляемого диска.
- Нажмите **Удалить**.
src/guide/compute/compute-instructions/compute-ip.md
+80
View File
@@ -0,0 +1,80 @@
# IP-адрес
IP-адрес — это вычислительный ресурс публичного облака. В облачных сервисах используются внутренние IPv4-адреса.
Внутренние IP-адреса назначаются автоматически или выбираются из списка зарезервированных адресов при создании виртуального сервера.
Список зарезервированных адресов формируется из:
- IP-адресов, [созданных вручную](#создать-ip-адрес);
- IP-адресов, [сохраненных в проекте](#сохранить-ip-адрес-в-проекте).
::: warning Важно
Привязка и отвязка IP-адресов возможна в одной [зоне доступности](../../admin/availability-matrix.md).
:::
## Статусы IP-адресов
`Используется` — IP-адрес зарезервирован и назначен виртуальному серверу.
`Зарезервирован` — IP-адрес зарезервирован и не назначен виртуальному серверу, доступен для назначения.
## Посмотреть список IP-адресов
1. Перейдите в консоль управления.
2. Откройте **Облачные вычисления → IP-адреса**.
3. Отобразится список всех IP-адресов проекта.
## Создать IP-адрес
Вы можете зарезервировать IP-адрес из диапазона IP-адресов и назначить этот адрес новому виртуальному серверу.
1. Перейдите в консоль управления.
2. Откройте **Облачные вычисления → IP-адреса**.
3. Нажмите **Создать IP-адрес**.
4. Введите параметры адреса:
- **Имя**: введите имя IP-адреса.
- **Зона доступности**: выберите зону доступности, в которой будут доступен адрес.
- добавьте тег адресу при необходимости.
7. Нажмите **Создать**.
На странице **Облачные вычисления → IP-адреса** появится новый IP-адрес со статусом `Зарезервирован`.
## Сохранить IP-адрес в проекте
При удалении сервера его IP-адрес освобождается и не может быть повторно использован в проекте. Если вам требуется сохранить IP-адрес сервера и привязать этот адрес новому серверу, то отключите автоудаление адреса. IP-адрес сохранится в вашем проекте и может быть назначен новому серверу.
1. Перейдите в консоль управления.
2. Откройте **Облачные вычисления → IP-адреса**.
3. Нажмите на имя адреса в списке IP-адресов.
4. На странице адреса нажмите кнопку **Изменить**, расположенную ниже флажка **Автоудаление**.
5. Снимите флажок **Автоудаление**, если он установлен.
6. Нажмите **Сохранить**.
## Присвоить имя IP-адресу
Имя IP-адреса отображается только на странице **Облачные вычисления → IP-адреса**. На странице виртуального сервера отображается значение IP-адреса.
1. Перейдите в консоль управления.
2. Откройте **Облачные вычисления → IP-адреса**.
3. Нажмите на имя адреса в списке IP-адресов.
4. Нажмите на &hellip; и выберите **Переименовать**.
5. Введите новое имя IP-адреса.
6. Нажмите &#10003;.
## Удалить IP-адрес
Если для IP-адреса установлено автоудаление, то адрес удалится во время удаления виртуального сервера.
Если для IP-адреса не установлено автоудаление, то адрес удаляется вручную:
1. Перейдите в консоль управления.
2. Откройте **Облачные вычисления → IP-адреса**.
3. Удалите адрес одним из способов:
- В разделе **IP-адреса**:
- В списке адресов найдите IP-адрес, который необходимо удалить.
- Cправа от имени IP-адреса нажмите кнопку ![del](../compute-instructions/image/delete.png).
- Подтвердите действие.
- На странице IP-адреса:
- Нажмите на имя адреса в списке IP-адресов., который необходимо удалить.
- Нажмите на &hellip; в правом углу страницы и выберите **Удалить**.
- Подтвердите действие.
src/guide/compute/compute-instructions/compute-servers-create.md
+89
View File
@@ -0,0 +1,89 @@
# Виртуальные серверы
## Выбор образа операционной системы
Для проектов уже подготовлены образы на базе операционной системы UNIX.
| Образ | OC | slug | Версия | Минимальный размер системного диска |
|--------------|----------------|-------------------------|----------|-------------------------------------|
| Ubuntu | Ubuntu | ubuntu-22-04 | 22.04 | 40 Гб |
## Создать сервер
1. Перейдите в консоль управления.
2. Откройте раздел **Облачные вычисления**.
3. Нажмите **Создать сервер**.
4. В блоке **Имя и расположение** укажите имя и расположение виртуального сервера:
- **Имя сервера**: введите название виртуального сервера:
- допустимая длина 63 символа с учетом зоны DNS проекта;
- **Зона доступности**: выберите подходящий [регион ЦОД](../../admin/availability-matrix.md).
- Укажите количество создаваемых серверов.
5. В блоке **Выбор образа** выберите тип и версию операционной системы.
6. В блоке **Конфигурация** выберите количество ОЗУ и ЦПУ. Наборы ресурсов заранее скомпонованы по оптимальным параметрам.
::: tip Информация
При выборе ресурсов рекомендуется в первую очередь ориентироваться на требуемое количество ОЗУ.
:::
7. В блоке **Диски** настройте загрузочный диск и, при необходимости, добавьте дополнительные диске:
- **Загрузочный диск**: выберите тип хранения и укажите размер загрузочного диска.
- Рекомендуется создать дополнительный диск для размещения ваших данных: нажмите **Добавьте диск** и настройте дополнительный диск. [Дополнительный диск можно создать](#добавить-диск) позже.
::: warning Важно
К виртуальному серверу можно подключить не более 28 дисков, включая системный.
:::
8. Выберите SSH-ключи, с помощью которых вы можете подключаться к виртуальному серверу по SSH. Если подходящий SSH-ключ отсутствует, то нажмите [**Создать ключ**](../../admin/ssh.md#создать-ssh-ключ).
9. В блоке **Настройки сети** выберите:
- **IPv4-адрес**: выберите способ получения внутреннего IP-адреса для виртуального сервера:
- выберите **Автоматически**, чтобы получить IP-адрес автоматически;
- выберите адрес из списка. В списке адресов отображаются [созданные вручную IP-адреса](compute-ip.md#создать-ip-адрес) и [сохраненные IP-адреса](compute-ip.md#сохранить-ip-адрес-в-проекте), которые доступны для переиспользования.
10. В блоке **Размещения** выберите:
- **Группа размещения**: выберите правило размещения сервера на физическом хосте. [Группу размещения](compute-affinity.md) создайте заранее.
11. Установите флажок **Расширенные настройки**, чтобы использовать [cloud-init](https://cloudinit.readthedocs.io/en/latest/) для настройки виртуального сервера.
12. Нажмите **Создать сервер**.
Виртуальный сервер появится на странице **Облачные вычисления → Серверы** в статусе `Cоздается`. Выполняется сборка виртуального сервера, назначается [IP-адрес](compute-ip.md) и полное доменное имя (FQDN). После окончания сборки сервер перейдет в статус `Включен`.
## Добавить диск
Добавление дополнительного диска к виртуальному серверу состоит из двух шагов:
- 1 шаг. Добавить новое устройство.
- 2 шаг. Подключить диск внутри операционной системы.
Новое устройство добавляется в консоли управления:
1. Перейдите в консоль управления.
4. Откройте **Облачные вычисления → Серверы**.
5. Нажмите на имя сервера.
6. Перейдите на вкладку **Диски**.
7. Нажмите **Добавить диск**.
8. Введите параметры добавляемого диска:
- **Имя диска**: введите название диска.
- **Тип**: выберите из списка тип хранения.
- **Размер диска**: введите размер добавляемого диска в Гб.
9. Нажмите **Создать диск**.
Далее требуется подключить диск в операционной системе.
## Подключиться к виртуальному серверу
Подключиться к серверу по протоколу SSH может пользователь с ролью **DevOps-инженер**.
Для подключения к виртуальному серверу по SSH выполните команду в терминале:
- по IP-адресу сервера:
```
ssh -l <логин пользователя> -i <путь до приватного ключа> <IP-адрес сервера>
```
- по полному доменному имени сервера (FQDN):
```
ssh -l <логин пользователя> -i <путь до приватного ключа> <FQDN сервера>
```
Пример команды подключения к серверу по IP-адресу:
```
$ ssh -l ivanov -i /home/user/.ssh/id_rsa 10.0.0.1
```
src/guide/compute/compute-instructions/compute-servers-manage.md
+145
View File
@@ -0,0 +1,145 @@
# Управление виртуальными серверами
## Посмотреть список серверов
1. Перейдите в консоль управления.
2. Откройте **Облачные вычисления → Серверы**.
## Посмотреть свойства сервера
1. Перейдите в консоль управления.
2. Откройте **Облачные вычисления → Серверы**.
3. Нажмите на имя сервера.
4. На вкладке **Общая информация** показана информация о виртуальном сервере:
- **Идентификатор**: уникальный идентификатор сервера.
- **Внутренний FQDN**: полное доменное имя сервера.
- **IPv4 адрес**:внутренний IP-адрес, присвоенный серверу.
- **Образ**: операционная система, установленная на сервере.
- **Конфигурация**: конфигурация ЦПУ и ОЗУ.
- **Группа размещения**: группа размещения сервера.
- **Дата создания**: дата и время создания сервера.
- **Создатель**: имя пользователя, который создал сервер.
- **Теги**: теги, присвоенные серверу.
5. На вкладке **Диски** показан загрузочный диск и дополнительные диски, подключенных к серверу.
## Изменить конфигурацию сервера
У виртуального сервера можно изменить конфигурацию ЦПУ и ОЗУ: увеличить или уменьшить количество вычислительных ресурсов. Выбор конфигурации предоставляется из линейки доступных тарифов.
1. Перейдите в консоль управления.
2. На странице **Обзор** убедитесь в наличии свободных ресурсов.
3. Откройте **Облачные вычисления → Серверы**.
4. Нажмите на имя сервера.
5. На вкладке **Общая информация** нажмите **Изменить конфигурацию**.
6. Выберите из списка новый тариф: количество ЦПУ и ОЗУ.
7. Нажмите **Сохранить и перезагрузить**.
8. Подтвердите действие, нажав **Перезагрузить**.
Во время выполнения масштабирования сервер находится статусе `Расширение`. После применения изменений сервер будет автоматически перезагружен. Виртуальный сервер перейдет в статус `Включен`.
## Выключить сервер
Выключение виртуального сервера не предполагает освобождение вычислительных ресурсов, зарезервированных за этим сервером.
1. Перейдите в консоль управления.
2. Откройте **Облачные вычисления → Серверы**.
3. Измените состояние виртуального сервера одним из способов:
- На странице **Серверы**:
- В списке виртуальных серверов найдите сервер, состояние которого необходимо изменить.
- Нажмите на &hellip; и выберите **Выключить**.
- Подтвердите действие, нажав **Выключить**.
- На странице виртуального сервера:
- В списке виртуальных серверов найдите сервер, состояние которого необходимо изменить.
- Нажмите на имя сервера.
- Нажмите **Выключить**.
- Подтвердите действие, нажав **Выключить сервер**.
Выключение виртуального сервера занимает некоторое время, отключается питание сервера. После выключения сервер переходит в статус `Выключен пользователем`.
## Включить сервер
1. Перейдите в консоль управления.
2. Откройте **Облачные вычисления → Серверы**.
3. Измените состояние виртуального сервера одним из способов:
- На странице **Серверы**:
- В списке виртуальных серверов найдите сервер, состояние которого необходимо изменить.
- Нажмите на &hellip; и выберите **Включить**.
- На странице виртуального сервера:
- В списке виртуальных серверов найдите сервер, состояние которого необходимо изменить.
- Нажмите на имя сервера.
- Нажмите **Включить**.
Включение виртуального сервера занимает некоторое время. После включения сервер переходит в статус `Включен`.
## Перезагрузить сервер
Перезагрузка виртуального сервера предполагает корректное завершение работы операционный системы без отключения питания.
1. Перейдите в консоль управления.
2. Откройте **Облачные вычисления → Серверы**.
3. Измените состояние виртуального сервера одним из способов:
- На странице **Серверы**:
- В списке виртуальных серверов найдите сервер, состояние которого необходимо изменить.
- Нажмите на &hellip; и выберите **Перезагрузить**.
- Подтвердите действие, нажав **Перезагрузить**.
- На странице виртуального сервера:
- В списке виртуальных серверов найдите сервер, состояние которого необходимо изменить.
- Нажмите на имя сервера.
- Нажмите **Перезагрузить**.
- Подтвердите действие, нажав **Перезагрузить**.
Во время выполнения перезагрузки сервер находится в статусе `Перезагружается`. После завершения перезагрузки сервер перейдет в статус `Включен`.
## Принудительная перезагрузка сервера
Принудительная перезагрузка виртуального сервера предполагает аппаратное выключение и включение. Несохраненные данные могут быть потеряны.
1. Перейдите в консоль управления.
2. Откройте **Облачные вычисления → Серверы**.
3. Измените состояние виртуального сервера одним из способов:
- На странице **Серверы**:
- В списке виртуальных серверов найдите сервер, состояние которого необходимо изменить.
- Нажмите на &hellip; и выберите **Принудительная перезагрузка**.
- Подтвердите действие, нажав **Перезагрузить**.
- На странице виртуального сервера:
- В списке виртуальных серверов найдите сервер, состояние которого необходимо изменить.
- Нажмите на имя сервера.
- Нажмите на &hellip; в правом углу страницы и выберите **Принудительная перезагрузка**.
- Подтвердите действие, нажав **Перезагрузить**.
Во время выполнения перезагрузки сервер находится в статусе `Холодная перезагрузка`. После завершения перезагрузки сервер перейдет в статус `Включен`.
## Назначить виртуальному серверу внутренний IP-адрес
Если вам необходимо переиспользовать IP-адрес, то перед удалением сервера [сохраните IP-адрес](compute-ip.md#сохранить-ip-адрес-в-проекте). При создании виртуального сервера этот IP-адрес будет доступен для назначения.
::: warning Важно
Переиспользование IP-адресов возможно внутри одной зоны доступности.
IP-адрес можно назначить новому виртуальному серверу. Назначение IP-адреса существующему виртуальному серверу не предусмотрено.
:::
## Удалить сервер
После удаления виртуального сервера освобождаются вычислительные ресурсы.
Системный диск будет удален вместе с сервером. Если к виртуальному серверу подключены дополнительные диски, то при удалении сервера диски будут отключены. В дальнейшем эти диски можно подключить к другому виртуальному серверу.
IP-адрес будет удален вместе с сервером. Чтобы оставить IP-адрес, перед удалением сервера [сохраните IP-адрес в проекте](../compute-instructions/compute-ip.md#сохранить-ip-адрес-в-проекте). Сохраненный IP-адрес после удаления сервера остается в вашем проекте и будет доступен для назначения новому серверу.
::: danger Предупреждение
Удаление сервера необратимо. Все данные будут удалены без возможности восстановления.
:::
1. Перейдите в консоль управления.
2. Откройте **Облачные вычисления → Серверы**.
3. Удалите виртуальный сервер одним из способов:
- На странице **Серверы**:
- В списке виртуальных серверов найдите сервер, которого необходимо удалить.
- Нажмите на &hellip; и выберите **Удалить**.
- Введите имя удаляемого сервера и нажмите **Удалить сервер**.
- На странице виртуального сервера:
- В списке виртуальных серверов найдите сервер, которого необходимо удалить.
- Нажмите на имя сервера.
- Нажмите на &hellip; в правом углу страницы и выберите **Удалить**.
- Введите имя удаляемого сервера и нажмите **Удалить сервер**.
src/guide/compute/compute-instructions/image/copy.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 281 B

src/guide/compute/compute-instructions/image/delete.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 803 B

src/guide/compute/compute-instructions/image/fqdn.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 2.4 KiB

src/guide/compute/compute-instructions/image/off_disk.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 996 B

src/guide/compute/compute-instructions/image/scale_disk.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 1.1 KiB

src/guide/compute/compute-instructions/image/up_disk.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 937 B

src/guide/compute/compute-limits.md
+5
View File
@@ -0,0 +1,5 @@
# Квоты и лимиты
Для [проекта действуют квоты](../admin/limits.md), по умолчанию определяемые при инициализации проекта.
[Изменить квоты](../admin/limits.md#редактирование-квот-проекта) можно на странице **Обзор**.
src/guide/compute/compute-ola.md
+37
View File
@@ -0,0 +1,37 @@
# Уровень обслуживания
Настоящий документ определяет уровень обслуживания (SLA) сервиса «Облачные вычисления».
## Описание предоставляемых услуг
В таблице рассмотрены услуги, предоставляемые в рамках OLA сервиса «Облачные вычисления».
| Наименование услуги | Краткое описание | Ценность для потребителя | Целевая аудитория | Подразделение-исполнитель|
|---|---|---|---|---|
| Заказ и управление параметрами виртуальных серверов с ОС | Заказ и управление виртуальной машиной с серверной ОС | Реализация проектной и операционной деятельности продуктовых команд в части ИТ-Инфраструктуры | Руководители проектов<br> DevOps<br> Администраторы| Отдел виртуальных платформ<br> Отдел программно-определяемых сред|
## Доступность услуги
Заказ и управление параметрами виртуальных серверов с ОС: 99,5 %.
## Характеристики доступности услуги
Заказ и управление параметрами виртуальных серверов с ОС:
| Метрика | Допустимое значение | Измерение |
|---|---|---|
| HDD IOPS | Эталонные значения:<br>250 IOPS/500GB тип диска «hdd», не более 1000 iops на диск;<br>1000 IOPS/500GB тип диска «ssd/nvme» не более 15000 iops на диск | - Стандартное измерение платформа наблюдаемости «Grafana»<br>- Утилита fio при записи в 32-64 потока c флагом sync в зависимости от размера блока (обычно - 4k/8k)<br>fio -direct=1 -group_reporting -name=test -bs=4k -iodepth=1 -numjobs 1 -rw=randwrite -runtime=60 -filename=/vdb -size=90G |
| Количество MIPS на одно vCPU | Не менее 1900 | Стандартное измерение платформа наблюдаемости «Grafana» |
| RAM Swaped процент от сконфигурированной памяти VM | До 10% | Стандартное измерение платформа наблюдаемости «Grafana» |
| HDD IOPS уменьшение в процентах от оговоренного значения | До 10% | Стандартное измерение платформа наблюдаемости «Grafana» |
| Среднее время доступа к диску тип диска «стандартный» на виртуальной машине | До 25 мс на каждый диск (на не нагруженной ВМ) | Стандартное измерение платформа наблюдаемости «Grafana» |
| Среднее время доступа к диску тип диска «быстрый» на виртуальной машине | До 8 мс на каждый диск (на не нагруженной ВМ) | Стандартное измерение платформа наблюдаемости «Grafana» |
| Среднее время доступа к объекту в «холодном» S3 хранилище read (чтение) | До 30 мс при запросе размером не более 16 Kb | Стандартное измерение платформа наблюдаемости «Grafana» |
| Среднее время доступа к объекту в «холодном» S3 хранилище write (запись) | До 110 мс при запросе размером не более 16 Kb | Стандартное измерение платформа наблюдаемости «Grafana» |
Предоставление услуги сетевой связности внутри облачных ВМ в пределах ЦОД:
| Метрика | Допустимое значение | Измерение |
|---|---|---|
| Процент потерянных пакетов в пределах ЦОД | Не более 0,2 % | Стандартное измерение платформа наблюдаемости «Grafana» |
| Средняя сетевая задержка в пределах ЦОД | Не более 5 мс | Измеряется на эталонной виртуальной машине в проекте команды. Загрузка сетевого интерфейса не более 400 Mb/s |
src/guide/compute/compute-overview.md
+82
View File
@@ -0,0 +1,82 @@
# Обзор сервиса
Публичное облако предоставляет масштабируемые вычислительные мощности для создания и управления виртуальными серверами.
К виртуальным серверам можно подключать диски с образами ОС семейства Linux.
Для сервиса «Облачные вычисления» действует соглашение об [уровне обслуживания](compute-ola.md).
## Виртуальный сервер
Конфигурация виртуального сервера задается при его создании:
- операционная система;
- количество ЦПУ;
- объем ОЗУ;
- тип и размер диска;
- регион доступности.
## Размещение серверов
Группу серверов внутри кластера можно объединить в соответствии с определенной политикой размещения. Доступны политики:
- Правило `Affinity` размещает серверы обязательно на одном физическом хосте.
- Правило `Soft-Affinity` размещает серверы по возможности на одном физическом хосте.
- Правило `Anti-Affinity` размещает серверы обязательно на разных физических хостах. Такое размещение повышает производительность и предотвращает недоступность сервера при отказе хоста сервера.
- Правило `Soft-Anti-Affinity` размещает серверы по возможности на разных физических хостах.
## CPU и RAM
### Тарифы
При создании виртуального сервера доступны готовые конфигурации ЦПУ и ОЗУ.
| Группа | 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 |
| средние | cpu8ram256 | 8 | 256 |
| средние | cpu12ram256 | 12 | 256 |
| средние | cpu16ram4 | 16 | 4 |
| средние | cpu16ram8 | 16 | 8 |
| средние | cpu16ram16 | 16 | 16 |
| средние | cpu16ram32 | 16 | 32 |
| средние | cpu16ram64 | 16 | 64 |
| средние | cpu16ram128 | 16 | 128 |
| средние | cpu16ram160 | 16 | 160 |
| средние | cpu16ram512 | 16 | 512 |
| большие | cpu24ram48 | 24 | 48 |
| большие | cpu24ram96 | 24 | 96 |
| большие | cpu24ram256 | 24 | 256 |
| большие | cpu32ram64 | 32 | 64 |
| большие | cpu32ram128 | 32 | 128 |
| большие | cpu32ram256 | 32 | 256 |
| большие | cpu32ram512 | 32 | 512 |
| большие | cpu64ram128 | 64 | 128 |
| большие | cpu64ram256 | 64 | 256 |
| большие | cpu64ram512 | 64 | 512 |
## Диски
Хранение данных организовано с использованием сетевых дисков. Диск создается в определенной зоне доступности. Каждый диск автоматически реплицируется внутри своей зоны доступности, что обеспечивает надежное хранение данных.
Публичное облако поддерживает типы дисков:
- NVME.
## Операционная система
При создании виртуального сервера можно выбрать операционную систему семейства Unix.
src/guide/dns/dns-instructions/dns-create.md
+74
View File
@@ -0,0 +1,74 @@
# Ресурсные записи
Ресурсная запись — это запись о соответствии доменного имени и IP-адреса и другой информации в системе доменных имен. Ресурсные записи хранятся на DNS-серверах. DNS-серверы выполняют маршрутизацию запросов, поступающих на определенные доменные имена.
Сервис DNS поддерживает работу с типами записей:
`A` — сопоставление доменного имени и IPv4-адреса.
`CNAME` — синоним FQDN.
`PTR` — сопоставление IP-адреса и доменного имени.
У каждой ресурсной записи есть следующие параметры:
- зона DNS;
- тип записи;
- доменное имя;
- значение записи;
- время жизни записи (TTL).
**TTL (Time to live)** — время жизни записи. TTL определяет, сколько времени запись будет храниться в локальном кэше пользователя. Если вы изменили свойства записи в DNS, то пользователи не увидят этих изменений до тех пор, пока не истечет значение TTL.
## Создать запись
1. Перейдите в консоль управления.
2. Откройте **DNS**.
3. Нажмите **Добавить**.
4. Выберите тип записи: `A`, `CNAME`, `PTR`.
5. Заполните параметры записи:
::: details A
- **Зона**: выберите из списка *<slug-проекта>.cloud.dfcloud.ru*.
- **Параметр**: введите доменное имя записи. Максимальная длина имени — 63 символа и полного доменного имени (FQDN) — 255 символов.
- **Значение**: введите IP-адрес виртуального сервера. IP-адрес можно посмотреть на странице **Облачные вычисления → Серверы**.
- **TTL**: введите время жизни записи в секундах.
:::
::: details CNAME
- **Зона**: выберите из списка *<slug-проекта>.cloud.dfcloud.ru*.
- **Параметр**: введите доменное имя записи.
- **Значение**: введите FQDN сервера, точка не ставится в конце значения.
- **TTL**: введите время жизни записи в секундах.
:::
::: details PTR
Запись в обратной зоне добавляется автоматически при создании виртуального сервера. Для одного IP-адреса предназначена одна PTR-запись. Если для нужного IP-адреса не создана PTR-запись, то создайте ее вручную.
- **Зона**: выберите из списка *<slug-проекта>.cloud.dfcloud.ru*.
- **Параметр**: введите IP-адрес виртуального сервера. IP-адрес можно посмотреть на странице **Облачные вычисления → Серверы**.
- **Значение**: введите FQDN сервера.
- **TTL**: введите время жизни записи в секундах.
:::
2. Нажмите **Добавить**.
## Редактировать запись
1. Перейдите в консоль управления.
2. Откройте **DNS**.
3. Откройте записи прямой или обратной зоны.
4. В таблице записей напротив нужной записи нажмите **Редактировать**.
5. Измените `Параметр`, `Значение` или `TTL` записи.
6. Нажмите **Сохранить**.
## Удалить запись
1. Перейдите в консоль управления.
2. Откройте **DNS**.
3. Откройте записи прямой или обратной зоны.
4. В таблице записей напротив нужной записи нажмите **Удалить**.
5. В открывшемся окне подтвердите операцию:
- Скопируйте предложенный текст.
- Нажмите **Удалить**.
src/guide/dns/dns-limits.md
+3
View File
@@ -0,0 +1,3 @@
# Квоты и лимиты
Ограничений на количество создаваемых записей в зоне нет.
src/guide/dns/dns-overview.md
+11
View File
@@ -0,0 +1,11 @@
# Обзор сервиса
Сервис DNS предназначен для управления доменными именами ресурсов в проекте.
Сервис DNS предоставляет одну зону в `cloud.dfcloud.ru`.
Для каждого проекта автоматически создается зона: `<slug-проекта>.cloud.dfcloud.ru`. В этой зоне можно [управлять записями](../dns/dns-instructions/dns-create.md): создавать, редактировать, удалять.
При создании виртуального сервера автоматически добавляются:
- FQDN сервера в прямой зоне;
- PTR-запись в обратной зоне.
src/guide/index.md
+9
View File
@@ -0,0 +1,9 @@
# Обзор облачной платформы
**Публичное облако** — это облачная платформа, предоставляющая инфраструктурные сервисы IaaS, PaaS на базе платформ виртуализации OpenStack, VMware, Hyper-V в режиме самообслуживания или посредством программного интерфейса API.
**Infrastructure-as-a-Service (IaaS)** или инфраструктура как услуга — это модель предоставления облачных вычислений, при которой потребители получают доступ к управлению полным жизненным циклом, а также необходимый доступ к фундаментальным ИТ-ресурсам: серверы с заданной вычислительной мощностью и емкостью хранения, типовой преднастроенной операционной системой, подключенные к сети.
**Platform-as-a-Service (PaaS)** или платформа как услуга — это модель предоставления облачных вычислений, при которой потребители получают доступ к использованию ИТ-платформой: операционные системы, системы управления базами данных, сервисные шины, вызов удаленных процедур, брокеры сообщений и т.п. При этом управление низлежащим слоем потребителю недоступно.
**Infrastructure-as-Code (IaC)** или инфраструктура как код — это подход для управления и описания инфраструктуры посредством конфигурационных файлов без непосредственного взаимодействия с интерфейсами управления.
src/guide/storage/storage-instructions/s3-connect/s3cmd.md
+86
View File
@@ -0,0 +1,86 @@
# S3cmd
S3cmd — это консольный клиент (Linux, Mac) для работы с Amazon S3-совместимыми хранилищами.
Подробности о работе c s3cmd см. [в документации s3cmd](https://s3tools.org/s3cmd-howto).
## Подготовительные шаги
- [Создайте аккаунт S3 и ключ доступа](../storage-s3.md#создать-аккаунт). Сохраните ключ **secret**.
- Установите [S3cmd](https://s3tools.org/download).
## Настроить подключение
Перед настройкой подключения [создайте аккаунт и ключ доступа](../storage-s3.md#создать-аккаунт).
Настроить подключение к хранилищу можно одним из способов:
- **1 способ**: установить значения переменных и подключиться к хранилищу;
- **2 способ**: настроить подключение с помощью стандартной команды s3cmd `s3cmd --configure`.
::: tabs
== 1 способ
1. Установите значения переменных:
```sh
S3_ACCESS_KEY=...
S3_SECRET_KEY=...
S3_URL=...
```
где:
- `S3_ACCESS_KEY`: введите *Access key*, полученный при [создании хранилища в консоли управления](../storage-s3.md#создать-аккаунт).
- `S3_SECRET_KEY`: введите ключ *secret*, полученный при [создании хранилища в консоли управления](../storage-s3.md#создать-аккаунт).
- `S3_URL`: имя хоста для подключения соответствует [региону](../../storage-overview.md#регионы-и-зоны-доступности).
2. Подключите хранилище:
```sh
s3cmd --ssl --access_key="${S3_ACCESS_KEY}" --secret_key="${S3_SECRET_KEY}" --host="${S3_URL}" --region=US --no-progress --host-bucket="%(bucket)" --dump-config > ~/.s3cfg
```
== 2 способ
1. Выполните команду в терминале:
```sh
s3cmd --configure
```
2. Укажите значения для следующих параметров:
- `Access Key`: введите *Access key*, полученный при [создании хранилища в консоли управления](../storage-s3.md#создать-аккаунт).
- `Secret Key`: введите ключ *secret*, полученный при [создании хранилища в консоли управления](../storage-s3.md#создать-аккаунт)
- .
- `S3 Endpoint`: имя хоста для подключения соответствует [региону](../../storage-overview.md#регионы-и-зоны-доступности).
- `DNS-style bucket+hostname:port template for accessing a bucket`: введите `%(bucket)`.
- `Use HTTPS protocol`: введите `Y`.
3. Остальные настройки оставьте без изменений.
4. Устанавливается соединение. В случае успеха, отобразится `Success. Your access key and secret key worked fine :-)`.
5. Сохраните конфигурацию: `Save settings? [y/N]`: введите `Y`
:::
S3cmd сохранит настройки в файле `~/.s3cfg`, его можно изменить вручную.
::: warning Важно
Если при установке соединения с хранилищем возникла ошибка валидности SSL-сертификатов, то выполните команду в терминале для добавления корневого сертификата:
```sh
echo 'alias s3cmd="s3cmd --ca-certs /etc/ssl/certs/ca-certificates.crt"' >> ~/.profile
```
Выполните настройку подключения к хранилищу снова.
:::
## Проверить подключение к хранилищу
Выполните команду в терминале:
```sh
s3cmd ls
```
В выводе должен отобразиться список доступных бакетов. Список может быть пустым, если в хранилище не создано ни одного бакета.
## Примеры команд
- `s3cmd --help` - справка.
- `s3cmd mb s3://<имя_бакета>` - создание бакета.
- `s3cmd ls s3://<имя_бакета>` - получение списка бакетов.
Подробности о работе c s3cmd см. [в документации s3cmd](https://s3tools.org/usage).
src/guide/storage/storage-instructions/s3-connect/winscp.md
+44
View File
@@ -0,0 +1,44 @@
# WinSCP
WinSCP — это графический клиент, поддерживающий работу с различными типами хранилищ, в том числе с [Amazon S3](https://aws.amazon.com/ru/s3/) совместимыми хранилищами. Доступен для Windows.
## Настроить подключение
1. [Создайте аккаунт и ключ доступа](../storage-s3.md#создать-аккаунт).
2. Скачайте WinSCP с [официального сайта](https://winscp.net/eng/download.php).
3. Откройте WinSCP.
4. Cоздайте новое подключение:
- **Протокол передачи**: выберите из списка *Amazon S3*.
- **Имя хоста**: соответствует [региону](../../storage-overview.md#регионы-и-зоны-доступности).
- **Порт**: введите *443*.
- **Идентификатор ключа доступа**: введите *Access key*, полученный при создании аккаунта в консоли управления.
- **Секретный ключ доступа**: введите ключ *Secret*, полученный при создании аккаунта в консоли управления.
5. Нажмите **Еще**.
6. В окне **Расширенные настройки соединения** выберите **Среда → S3 → Стиль по умолчанию URL** значение *Путь*.
7. Нажмите **OK**.
8. Нажмите **Войти**, потребуется еще раз ввести секретный ключ доступа.
В результате успешного подключения на вкладке справа отобразятся бакеты. Список может быть пустым, если в хранилище не создано ни одного объекта.
Подробности о работе WinSCP с S3-совместимыми хранилищами см. [в документации WinSCP](https://winscp.net/eng/docs/guide_amazon_s3#buckets).
## Проверить доступность хранилища
Для проверки доступности хранилища создайте файл в хранилище и попробуйте его скачать.
1. Войдите в S3 хранилище.
2. В меню **Файлы** выберите **Новый → Каталог**;
- введите название каталога по [правилам](../../storage-overview.md#правила-именования);
3. Создайте файл в каталоге из п. 2:
- в меню **Файлы** выберите **Новый → Файл**;
- введите название файла по [правилам](../../storage-overview.md#правила-именования);
- сохраните файл.
4. Выдайте права на действия с файлом:
- правой кнопкой мыши нажмите на имя файла и выберите **Свойства**;
- в ACL установите права **R** для всех;
- нажмите **OK**.
5. Проверьте сетевую доступность файла, созданного на шаге 3:
- правой кнопкой мыши нажмите на имя файла и выберите **Файловые пользовательские команды → Сгенерировать URL для протокола HTTP**;
- в открывшемся окне нажмите **Копировать**;
- вставьте скопированную ссылку в браузер, заменив `http://` на `https://`;
- начнется скачивание файла.
src/guide/storage/storage-instructions/storage-s3.md
+136
View File
@@ -0,0 +1,136 @@
# Управление хранилищем
## Создать аккаунт
При добавлении хранилища выполняется создание аккаунта S3 и ключей доступа.
::: tip Информация
В момент создания нового хранилища сохраните ключи и секреты (токены) доступа. Данная информация не хранится на серверах Vega. В случае утери ключей доступа все данные хранилища будут недоступны.
:::
1. Перейдите в консоль управления.
2. Откройте **Объектное хранилище**.
3. Нажмите **Добавить хранилище**.
4. Заполните параметры хранилища:
- **Регион**: выбрать из списка.
- **Название аккаунта**: введите название аккаунта. <!--Есть правила нейминга?-->
- **Размер хранилища**: введите значение в Гбайтах, размер хранилища ограничен квотой.
5. Нажмите **Создать**.
6. В открывшемся окне скопируйте ключи и сохраните их в надежном месте.
7. Нажмите **Закрыть**.
Аккаунт S3 будет добавлен в разделе **Объектное хранилище**. Далее необходимо [подключиться к хранилищу c помощью утилиты S3cmd](../storage-instructions/s3-connect/s3cmd.md) или [WinSCP](../storage-instructions/s3-connect/winscp.md).
## Удалить аккаунт
::: warning Важно
Перед удалением аккаунта удалите бакеты вручную.
:::
1. Перейдите в консоль управления.
2. Откройте **Объектное хранилище**.
3. Найдите нужное хранилище.
5. Нажмите &#10247; и выберите **Удалить**.
6. В открывшемся окне подтвердите операцию:
- Скопируйте предложенный текст.
- Нажмите **Удалить**.
## Управление жизненным циклом объектов в бакете
Управление жизненным циклом объектов позволяет настроить автоматическое удаление отдельных объектов или групп объектов по заданным условиям и расписанию.
Для управления жизненными циклами с помощью S3cmd используется [конфигурация в формате XML](https://docs.aws.amazon.com/AmazonS3/latest/userguide/lifecycle-configuration-examples.html).
::: tabs
== Загрузить политику
```sh
s3cmd setlifecycle bucket-lifecycle.xml s3://bucket
```
== Получить политику
```sh
s3cmd getlifecycle s3://bucket
```
== Удалить политику
```sh
s3cmd dellifecycle s3://bucket
```
:::
## Управление доступом (ACL)
Access Control List (ACL) — список управления доступом, который определяет, список пользователей для доступа к файлам или бакету и список допустимых или запрещенных операции.
Для управления доступом в S3 хранилище можно использовать команды из [документации S3cmd](https://s3tools.org/s3cmd).
## Монтирование бакета
Монтирование бакета позволит управлять содержимым S3-хранилища через интерфейс файловой системы. Бакет объектного хранилища монтируется через [FUSE](https://ru.wikipedia.org/wiki/FUSE_(%D0%BC%D0%BE%D0%B4%D1%83%D0%BB%D1%8C_%D1%8F%D0%B4%D1%80%D0%B0)).
В инструкции рассмотрено разовое монтирование контейнера. В этом случае при каждой перезагрузке системы контейнер будет размонтирован. Потребуется выполнить монтирование контейнера вручную после перезагрузки системы.
::: tabs
== GeeseFS
1. Установите клиент GeeseFS.
2. Сделайте файл geesefs исполняемым и поместите его в директорию `/bin`:
```sh
chmod 700 geesefs-linux-amd64
mv geesefs-linux-amd64 /bin/geesefs
```
3. [Используйте ключ доступа, полученный при создании аккаунта](#создать-аккаунт), и поместите его в директорию `~/.aws/credentials`:
```
[default]
aws_access_key_id = <Access key>
aws_secret_access_key = <secret>
```
4. Создайте директорию, в которой будет отображаться содержимое бакета. Например, `/mnt/s3`.
5. Для монтирования бакета выполните команду:
```sh
/bin/geesefs --endpoint <endpoint s3> <имя бакета> /mnt/s3/
```
== S3fs
1. Установите клиент S3fs:
```sh
apt install s3fs
```
2. Cохраните [ключ доступа и секретный ключ, полученные при создании аккаунта](#создать-аккаунт) в файле `~/.passwd-s3fs`:
```sh
echo <идентификатор_ключа>:<секретный_ключ> > ~/.passwd-s3fs
```
3. Ограничьте доступ к файлу `~/.passwd-s3fs`:
```sh
chmod 600 ~/.passwd-s3fs
```
4. Для монтирования бакета выполните команду:
```sh
s3fs <имя_бакета> <путь_к_директории> -o passwd_file=~/.passwd-s3fs -o url=<адрес_endpoint> -o use_path_request_style
```
:::
Для проверки монтирования бакета выполните команду:
```sh
df-h
```
### Размонтировать бакет
Для размонтирования бакета выполните команду:
```sh
umount <путь_к_директории>
```
src/guide/storage/storage-limits.md
+3
View File
@@ -0,0 +1,3 @@
# Квоты и лимиты
Для сервиса действует квота по умолчанию, определяемая при инициализация проекта, в размере 100 Гбайт.
src/guide/storage/storage-ola.md
+17
View File
@@ -0,0 +1,17 @@
# Уровень обслуживания
Настоящий документ определяет уровень обслуживания (SLA) сервиса «Объектное хранилище».
## Описание предоставляемых услуг
В таблице рассмотрены услуги, предоставляемые в рамках SLA сервиса «Объектное хранилище».
| Наименование услуги | Краткое описание | Ценность для потребителя | Целевая аудитория |
|---|---|---|---|
| Доступ к S3 хранилищу | Web-доступ к эластичному хранилищу данных | Возможность очень быстрого подключения дискового пространства в приложение, сервер, ВРС и т. п. | DevOps<br> Администраторы |
## Доступность услуги
Доступ к S3 хранилищу 99,5 %.
src/guide/storage/storage-overview.md
+26
View File
@@ -0,0 +1,26 @@
# Обзор сервиса
Сервис «Объектное хранилище» предназначен для хранения и извлечения данных. Доступ к объектам осуществляется из любых периметров по протоколу https.
## Регионы и зоны доступности
| Регион | Хранилище | Адрес |
| -------------------------------- | --------- | ---------------------------------------- |
| s3-cloud-dfcloud-ru | Ceph | https://s3.cloud.dfcloud.ru |
## Модели адресации в S3
Сервис поддерживает модель адресации для доступа к объектному хранилищу S3:
- `Path-style` — модель, при которой название бакета указывается в части пути до объекта, например: https://s3.cloud.dfcloud.ru/bucket/file.txt
## Правила именования
Правила именования бакетов:
- имя бакета в корневом каталоге должно быть уникальным для всего хранилища S3, на каталоги 2-го и последующих уровней это правило не распространяется;
- может содержать строчные буквы латинского алфавита, цифры, дефис и подчеркивания;
- подчеркивание недопустимо для имени бакета в корневом каталоге.
Правила именования файлов в бакете:
- может содержать строчные буквы латинского алфавита, цифры, дефис и подчеркивания.
src/guide/using-vue.md
+9
View File
@@ -0,0 +1,9 @@
# Using Vue in Markdown
## Browser API Access Restrictions
Because VuePress applications are server-rendered in Node.js when generating static builds, any Vue usage must conform to the [universal code requirements](https://ssr.vuejs.org/en/universal.html). In short, make sure to only access Browser / DOM APIs in `beforeMount` or `mounted` hooks.
If you are using or demoing components that are not SSR friendly (for example containing custom directives), you can wrap them inside the built-in `<ClientOnly>` component:
##