+
+
+
diff --git a/src/.vitepress/theme/components/CustomSidebar.vue b/src/.vitepress/theme/components/CustomSidebar.vue
new file mode 100644
index 0000000..d5deecd
--- /dev/null
+++ b/src/.vitepress/theme/components/CustomSidebar.vue
@@ -0,0 +1,137 @@
+
+
+
+
+
+
+
diff --git a/src/.vitepress/theme/index.ts b/src/.vitepress/theme/index.ts
new file mode 100644
index 0000000..5af5c92
--- /dev/null
+++ b/src/.vitepress/theme/index.ts
@@ -0,0 +1,30 @@
+// https://vitepress.dev/guide/custom-theme
+import { h } from 'vue'
+import type { Theme, EnhanceAppContext } from 'vitepress'
+import DefaultTheme from 'vitepress/theme-without-fonts'
+import { enhanceAppWithTabs } from 'vitepress-plugin-tabs/client'
+import './scss/style.scss'
+import matomo from '../matomo';
+
+const matomoHost = import.meta.env.VITE_MATOMO_HOST;
+const matomoSiteId = import.meta.env.VITE_MATOMO_SITE_ID;
+console.log({matomo: typeof matomoHost !== 'undefined' && matomoHost})
+
+export default {
+ extends: DefaultTheme,
+ Layout: () => {
+ return h(DefaultTheme.Layout, null, {
+ // https://vitepress.dev/guide/extending-default-theme#layout-slots
+ })
+ },
+ enhanceApp({ app, router }: EnhanceAppContext) {
+ enhanceAppWithTabs(app)
+ if (typeof matomoHost !== 'undefined' && matomoHost) {
+ matomo({
+ router: router,
+ siteID: matomoSiteId,
+ trackerUrl: matomoHost
+ })
+ }
+ }
+} satisfies Theme
diff --git a/src/.vitepress/theme/scss/components/_index.scss b/src/.vitepress/theme/scss/components/_index.scss
new file mode 100644
index 0000000..4ec4734
--- /dev/null
+++ b/src/.vitepress/theme/scss/components/_index.scss
@@ -0,0 +1,4 @@
+@use "vp-doc.scss";
+@use "vp-custom-block.scss";
+@use "vp-doc-aside.scss";
+@use "vp-sidebar.scss";
\ No newline at end of file
diff --git a/src/.vitepress/theme/scss/components/vp-custom-block.scss b/src/.vitepress/theme/scss/components/vp-custom-block.scss
new file mode 100644
index 0000000..230ad52
--- /dev/null
+++ b/src/.vitepress/theme/scss/components/vp-custom-block.scss
@@ -0,0 +1,11 @@
+.custom-block {
+ padding: 24px;
+
+ &-title {
+ font-size: 18px;
+ line-height: 22px;
+ font-weight: 500;
+ letter-spacing: .2px;
+ margin-bottom: 12px;
+ }
+}
\ No newline at end of file
diff --git a/src/.vitepress/theme/scss/components/vp-doc-aside.scss b/src/.vitepress/theme/scss/components/vp-doc-aside.scss
new file mode 100644
index 0000000..ed267ae
--- /dev/null
+++ b/src/.vitepress/theme/scss/components/vp-doc-aside.scss
@@ -0,0 +1,10 @@
+.VPDocAside {
+ .outline-link {
+ font-size: 16px;
+ }
+
+ .outline-title {
+ font-size: 17px;
+ font-weight: 500;
+ }
+}
\ No newline at end of file
diff --git a/src/.vitepress/theme/scss/components/vp-doc.scss b/src/.vitepress/theme/scss/components/vp-doc.scss
new file mode 100644
index 0000000..bb7a243
--- /dev/null
+++ b/src/.vitepress/theme/scss/components/vp-doc.scss
@@ -0,0 +1,138 @@
+@mixin font_style($fontSize, $fontWeight, $lineHeight, $letterSpacing) {
+ font-size: $fontSize;
+ font-weight: $fontWeight;
+ line-height: $lineHeight;
+ letter-spacing: $letterSpacing;
+}
+
+@mixin generate-numbered-list-styles($start, $end) {
+ @for $counter from $start through $end {
+ $counter-name: list + ' ' + ($counter - 1);
+ ol[start*="#{$counter}"] {
+ list-style-type: none;
+ counter-reset: $counter-name;
+ }
+ }
+}
+
+.vp-doc {
+ font-size: 17px;
+
+ // Titles
+ h1 {
+ @include font_style(44px, 500, 46px, 0.3px);
+ margin-bottom: 24px;
+ }
+
+ h2 {
+ @include font_style(34px, 400, 36px, 0.3px);
+ margin-bottom: 12px;
+ }
+
+ h3 {
+ @include font_style(26px, 500, 32px, 0.2px);
+ margin-bottom: 12px;
+ }
+
+ h4 {
+ @include font_style(20px, 700, 28px, 0.2px);
+ margin-bottom: 12px;
+ }
+
+ h5 {
+ @include font_style(17px, 500, 22px, 0.2px);
+ margin-bottom: 12px;
+ }
+
+ // Text
+ ol {
+ list-style-type: none;
+ counter-reset: list;
+ margin: 0 0 0 50px;
+ padding: 0 0 5px 0;
+ font-size: 16px;
+
+ & > * + * {
+ margin-top: 50px;
+ }
+ }
+
+ @include generate-numbered-list-styles(2, 50);
+
+ ol li {
+ position: relative;
+ padding: 5px 0 0 0;
+ line-height: 1.4;
+ }
+
+ li + li {
+ margin-top: 50px;
+ }
+
+ ul li {
+ padding-bottom: 0;
+ padding-top: 0;
+ 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;
+ display: inline-flex;
+ position: absolute;
+ top: 0;
+ left: -48px;
+ width: 35px;
+ height: 35px;
+ background-color: #7e00ed;
+ color: #fff;
+ text-align: center;
+ line-height: 25px;
+ font-size: 16px;
+ border-radius: 50%;
+ justify-content: center;
+ align-items: center;
+ }
+
+ ul li:nth-last-of-type(n):after {
+ content: none;
+ }
+
+ ol ul li::before {
+ counter-increment: list;
+ content: none;
+ margin: 0;
+ padding: 0;
+ }
+
+ ol li p {
+ margin-top: 0;
+ }
+
+ p {
+ line-height: 22px;
+ }
+
+ // Links
+ a {
+ color: #1a73e8;
+
+ &:hover, &:focus-visible, &:focus, &:active {
+ color: #1a73e8;
+ }
+
+ &:visited {
+ color: #7e00ed;
+ }
+ }
+}
\ No newline at end of file
diff --git a/src/.vitepress/theme/scss/components/vp-sidebar.scss b/src/.vitepress/theme/scss/components/vp-sidebar.scss
new file mode 100644
index 0000000..03a6cfa
--- /dev/null
+++ b/src/.vitepress/theme/scss/components/vp-sidebar.scss
@@ -0,0 +1,7 @@
+.VPSidebar {
+ &Item {
+ .text {
+ font-size: 15px;
+ }
+ }
+}
\ No newline at end of file
diff --git a/src/.vitepress/theme/scss/design-system.scss b/src/.vitepress/theme/scss/design-system.scss
new file mode 100644
index 0000000..61d96f4
--- /dev/null
+++ b/src/.vitepress/theme/scss/design-system.scss
@@ -0,0 +1,15 @@
+:root {
+ --color-text-active: rgba(9, 11, 22, 0.94);
+ --color-text-inactive: rgba(25, 28, 52, 0.7);
+ --color-gradient-magma: linear-gradient(-46deg, #1a73e8 0%, #bc00b8 49.44%, #f55555 100%);
+
+ // Button
+ --color-button-contained-background-color: #fdd835;
+ --color-button-contained-hover-background-color: #fdc435;
+ --color-button-contained-text-color: rgba(9, 11, 22, 0.94);
+}
+
+.dark {
+ --color-text-active: rgba(255, 255, 255, 0.87);
+ --color-text-inactive: rgba(255, 255, 255, 0.6);
+}
\ No newline at end of file
diff --git a/src/.vitepress/theme/scss/fonts.scss b/src/.vitepress/theme/scss/fonts.scss
new file mode 100644
index 0000000..24681b8
--- /dev/null
+++ b/src/.vitepress/theme/scss/fonts.scss
@@ -0,0 +1,52 @@
+$font-path-beeline-sans: '/fonts/beeline-sans' !default;
+
+@mixin beeline-sans-font($type, $weight, $style: normal) {
+ @font-face {
+ font-family: "Beeline Sans";
+ src:url('#{$font-path-beeline-sans}/BeelineSans-#{$type}.woff2') format('woff2'),
+ url('#{$font-path-beeline-sans}/BeelineSans-#{$type}.woff') format('woff'),
+ url('#{$font-path-beeline-sans}/BeelineSans-#{$type}.ttf') format('truetype');
+ font-weight: $weight;
+ font-style: $style;
+ }
+}
+
+@mixin beeline-sans-font-pair($type, $weight) {
+ @include beeline-sans-font($type, $weight);
+
+}
+
+@include beeline-sans-font-pair(Regular, 400);
+
+@include beeline-sans-font-pair(Medium, 500);
+
+@include beeline-sans-font-pair(Bold, 700);
+
+@include beeline-sans-font-pair(Black, 900);
+
+$font-path-roboto-mono: '/fonts/roboto-mono' !default;
+
+@mixin roboto-mono-font($type, $weight, $style: normal) {
+ @font-face {
+ font-family: "Roboto Mono";
+ src:url('#{$font-path-roboto-mono}/RobotoMono-#{$type}.woff2') format('woff2'),
+ url('#{$font-path-roboto-mono}/RobotoMono-#{$type}.woff') format('woff'),
+ url('#{$font-path-roboto-mono}/RobotoMono-#{$type}.ttf') format('truetype');
+ font-weight: $weight;
+ font-style: $style;
+ }
+}
+
+@mixin roboto-mono-font-pair($type, $weight) {
+ @include roboto-mono-font($type, $weight);
+
+}
+
+@include roboto-mono-font-pair(Light, 300);
+
+@include roboto-mono-font-pair(Regular, 400);
+
+@include roboto-mono-font-pair(Medium, 500);
+
+@include roboto-mono-font-pair(Bold, 700);
+
diff --git a/src/.vitepress/theme/scss/style.scss b/src/.vitepress/theme/scss/style.scss
new file mode 100644
index 0000000..50006f3
--- /dev/null
+++ b/src/.vitepress/theme/scss/style.scss
@@ -0,0 +1,4 @@
+@use "fonts.scss";
+@use "design-system.scss";
+@use "vars.scss";
+@use "components";
\ No newline at end of file
diff --git a/src/.vitepress/theme/scss/vars.scss b/src/.vitepress/theme/scss/vars.scss
new file mode 100644
index 0000000..39cead5
--- /dev/null
+++ b/src/.vitepress/theme/scss/vars.scss
@@ -0,0 +1,205 @@
+/**
+ * Customize default theme styling by overriding CSS variables:
+ * https://github.com/vuejs/vitepress/blob/main/src/client/theme-default/styles/vars.css
+ */
+
+/**
+ * Colors
+ *
+ * Each colors have exact same color scale system with 3 levels of solid
+ * colors with different brightness, and 1 soft color.
+ *
+ * - `XXX-1`: The most solid color used mainly for colored text. It must
+ * satisfy the contrast ratio against when used on top of `XXX-soft`.
+ *
+ * - `XXX-2`: The color used mainly for hover state of the button.
+ *
+ * - `XXX-3`: The color for solid background, such as bg color of the button.
+ * It must satisfy the contrast ratio with pure white (#ffffff) text on
+ * top of it.
+ *
+ * - `XXX-soft`: The color used for subtle background such as custom container
+ * or badges. It must satisfy the contrast ratio when putting `XXX-1` colors
+ * on top of it.
+ *
+ * The soft color must be semi transparent alpha channel. This is crucial
+ * because it allows adding multiple "soft" colors on top of each other
+ * to create a accent, such as when having inline code block inside
+ * custom containers.
+ *
+ * - `default`: The color used purely for subtle indication without any
+ * special meanings attched to it such as bg color for menu hover state.
+ *
+ * - `brand`: Used for primary brand colors, such as link text, button with
+ * brand theme, etc.
+ *
+ * - `tip`: Used to indicate useful information. The default theme uses the
+ * brand color for this by default.
+ *
+ * - `warning`: Used to indicate warning to the users. Used in custom
+ * container, badges, etc.
+ *
+ * - `danger`: Used to show error, or dangerous message to the users. Used
+ * in custom container, badges, etc.
+ * -------------------------------------------------------------------------- */
+
+ :root {
+ --vp-c-default-1: var(--vp-c-gray-1);
+ --vp-c-default-2: var(--vp-c-gray-2);
+ --vp-c-default-3: var(--vp-c-gray-3);
+ --vp-c-default-soft: var(--vp-c-gray-soft);
+
+ --vp-c-brand-1: #fdc435; // var(--vp-c-indigo-1);
+ --vp-c-brand-2: #fdc435; // var(--vp-c-indigo-2);
+ --vp-c-brand-3: #fdd835; // var(--vp-c-indigo-3);
+ --vp-c-brand-soft: #fff7d7; // var(--vp-c-indigo-soft);
+
+ --vp-c-tip-1: var(--vp-c-brand-1);
+ --vp-c-tip-2: var(--vp-c-brand-2);
+ --vp-c-tip-3: var(--vp-c-brand-3);
+ --vp-c-tip-soft: var(--vp-c-brand-soft);
+
+ --vp-c-warning-1: #ff9419; // var(--vp-c-yellow-1);
+ --vp-c-warning-2: var(--vp-c-yellow-2);
+ --vp-c-warning-3: var(--vp-c-yellow-3);
+ --vp-c-warning-soft: var(--vp-c-yellow-soft);
+
+ --vp-c-danger-1: var(--vp-c-red-1);
+ --vp-c-danger-2: var(--vp-c-red-2);
+ --vp-c-danger-3: var(--vp-c-red-3);
+ --vp-c-danger-soft: var(--vp-c-red-soft);
+ --vp-c-divider: rgba(25, 28, 52, 0.12);
+ // --vp-sidebar-width: 272;
+}
+
+.dark {
+ --vp-c-divider: rgba(255, 255, 255, 0.2);
+}
+
+/**
+ * Colors: Background
+ *
+ * - `bg`: The bg color used for main screen.
+ *
+ * - `bg-alt`: The alternative bg color used in places such as "sidebar",
+ * or "code block".
+ *
+ * - `bg-elv`: The elevated bg color. This is used at parts where it "floats",
+ * such as "dialog".
+ *
+ * - `bg-soft`: The bg color to slightly distinguish some components from
+ * the page. Used for things like "carbon ads" or "table".
+ * -------------------------------------------------------------------------- */
+
+:root {
+ --vp-c-bg: #ffffff;
+ --vp-c-bg-alt: #f9f9f9;
+ --vp-c-bg-elv: #ffffff;
+ --vp-c-bg-soft: #f9f9f9;
+}
+
+.dark {
+ --vp-c-bg: #141414;
+ --vp-c-bg-alt: #212121;
+ --vp-c-bg-elv: #2e2f33;
+ --vp-c-bg-soft: #36383c;
+}
+
+/**
+ * Typography
+ * -------------------------------------------------------------------------- */
+
+:root {
+ --vp-font-family-base: 'Beeline Sans', 'Helvetica Neue', Helvetica, Arial, sans-serif;
+ --vp-font-family-mono: 'Roboto Mono', monospace;
+
+ // Code
+ // --vp-code-font-size: ;
+ --vp-code-color: rgba(9, 11, 22, 0.94);
+ --vp-code-link-color: rgba(9, 11, 22, 0.94);
+ --vp-code-link-hover-color: rgba(9, 11, 22, 0.94);
+}
+
+.dark {
+ --vp-code-color: rgba(255, 255, 255, 0.87);
+ --vp-code-link-color: rgba(255, 255, 255, 0.87);
+ --vp-code-link-hover-color: rgba(255, 255, 255, 0.87);
+}
+
+/**
+ * Component: Button
+ * -------------------------------------------------------------------------- */
+
+:root {
+ --vp-button-brand-border: transparent;
+ --vp-button-brand-text: var(--vp-c-white);
+ --vp-button-brand-bg: var(--vp-c-brand-3);
+ --vp-button-brand-hover-border: transparent;
+ --vp-button-brand-hover-text: var(--vp-c-white);
+ --vp-button-brand-hover-bg: var(--vp-c-brand-2);
+ --vp-button-brand-active-border: transparent;
+ --vp-button-brand-active-text: var(--vp-c-white);
+ --vp-button-brand-active-bg: var(--vp-c-brand-1);
+}
+
+/**
+ * Component: Home
+ * -------------------------------------------------------------------------- */
+
+:root {
+ --vp-home-hero-name-color: transparent;
+ --vp-home-hero-name-background: -webkit-linear-gradient(
+ 120deg,
+ #bd34fe 30%,
+ #41d1ff
+ );
+
+ --vp-home-hero-image-background-image: linear-gradient(
+ -45deg,
+ #bd34fe 50%,
+ #47caff 50%
+ );
+ --vp-home-hero-image-filter: blur(44px);
+}
+
+@media (min-width: 640px) {
+ :root {
+ --vp-home-hero-image-filter: blur(56px);
+ }
+}
+
+@media (min-width: 960px) {
+ :root {
+ --vp-home-hero-image-filter: blur(68px);
+ }
+}
+
+/**
+ * Component: Custom Block
+ * -------------------------------------------------------------------------- */
+
+:root {
+ --vp-custom-block-font-size: 17px;
+ --vp-custom-block-code-font-size: 17px;
+ --vp-custom-block-tip-border: transparent;
+ --vp-custom-block-tip-text: var(--vp-c-text-1);
+ --vp-custom-block-tip-bg: #f1f1f3;
+ --vp-custom-block-tip-code-bg: var(--vp-c-brand-soft);
+ --vp-custom-block-warning-bg: #fff4e1;
+ --vp-custom-block-danger-bg: #ffecef;
+}
+
+.dark {
+ --vp-custom-block-warning-bg: #3d392a;
+ --vp-custom-block-tip-bg: #36383c;
+ --vp-custom-block-danger-bg: #371313;
+}
+
+/**
+ * Component: Algolia
+ * -------------------------------------------------------------------------- */
+
+.DocSearch {
+ --docsearch-primary-color: var(--vp-c-brand-1) !important;
+}
+
diff --git a/src/guide/admin/availability-matrix.md b/src/guide/admin/availability-matrix.md
new file mode 100644
index 0000000..dcb943d
--- /dev/null
+++ b/src/guide/admin/availability-matrix.md
@@ -0,0 +1,13 @@
+# Матрица региональной доступности
+
+Регион доступности — это один или несколько центров обработки данных (ЦОД), в которых могут быть размещены компоненты облачной инфраструктуры.
+
+| Регион | Статус | Гипервизор | Процессор | HDD| SSD | NVME|
+|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
+ | **ДатаФорт 1** | Доступен | OpenStack | Intel® Xeon® Gold 6248R | ✘ | ✘ | ✅ |
+
+Условные обозначения:
+
+✅ — есть возможность выдачи ресурсов.
+
+✘ — нет возможности выдачи ресурсов.
\ No newline at end of file
diff --git a/src/guide/admin/limits.md b/src/guide/admin/limits.md
new file mode 100644
index 0000000..3030f5d
--- /dev/null
+++ b/src/guide/admin/limits.md
@@ -0,0 +1,40 @@
+# Квоты и лимиты
+
+Ограничения включают в себя лимиты и квоты на потребление ресурсов в проекте.
+
+Квоты ограничивают потребление ресурсов в проекте. В проекте на каждый ресурс выделяется квота, не превышающая лимит.
+
+После создания проекту становятся доступны базовые квоты. Для них установлены значения по умолчанию.
+
+**Базовые квоты**
+
+| Название квоты | Количество |
+|---------------------|------------|
+| Количество виртуальных серверов | 3 штуки|
+| ЦПУ | 200 |
+| ОЗУ | 200 Гбайт |
+| Хранилище NVME | 5000 Гбайт |
+| Объектное хранилище | 100 Гбайт |
+
+## Просмотр квот проекта
+
+1. Перейдите в консоль управления.
+2. В шапке выберите **Проекты**.
+3. Откроется список проектов, в которых вы являетесь участником.
+4. Нажмите на имя нужного проекта.
+5. Откройте раздел **Обзор**.
+
+## Редактирование квот проекта
+
+::: tip Информация
+Изменить квоты проекта может пользователь с ролью **Владелец проекта**.
+:::
+
+1. Перейдите в консоль управления.
+2. В шапке выберите **Проекты**.
+3. Откроется список проектов, в которых вы являетесь участником.
+4. Нажмите на имя нужного проекта.
+5. Откройте раздел **Обзор**.
+6. В правом верхнем углу нажмите **Изменить квоты**.
+7. Увеличите или уменьшите квоты для ресурсов.
+8. Нажмите **Сохранить**.
\ No newline at end of file
diff --git a/src/guide/admin/projects.md b/src/guide/admin/projects.md
new file mode 100644
index 0000000..a8b1659
--- /dev/null
+++ b/src/guide/admin/projects.md
@@ -0,0 +1,49 @@
+# Управление проектами
+
+Проект — это структурная единица публичного облака, в которой содержатся ресурсы: виртуальные машины, хранилища, IP-адреса и др.
+
+Ресурсы могут быть вычислительными и аппаратными.
+
+Вычислительные ресурсы:
+- оперативная память (ОЗУ);
+- ядра процессора (ЦПУ);
+- локальные диски;
+- сетевые диски;
+- IP-адреса.
+
+Аппаратные ресурсы (серверы, сети, диски) размещены в центрах обработки данных (ЦОД). Каждый дата-центр разделен на модули. Модули оснащены независимыми системами электропитания и охлаждения.
+
+При получении доступа в публичное облако текущий пользователь становится менеджера проектов. Менеджер проектов может создавать новые проекты, в которых он получает роль владельца проекта. Владелец проекта может добавлять пользователей в проект, назначая им роли.
+
+Доступ к проекту осуществляется из консоли управления.
+
+## Создать проект
+
+1. Перейдите в консоль управления.
+2. Нажмите кнопку **Создать → Проект** в правом верхнем углу.
+3. Заполните информацию о проекте:
+ - **Название**: введите наименование проекта.
+ - **Идентификатор**: введите идентификатор проекта:
+ - допустимы строчные и прописные буквы латинского алфавита, цифры и дефис;
+ - длина не более 64 символов;
+ - не должно начинаться или заканчиваться дефисом.
+ - **Описание**: введите краткое описание проекта.
+4. Нажмите **Создать**.
+
+## Изменить имя проекта
+
+::: tip Информация
+Изменить имя и описание проекта может только пользователь с ролью **Владелец проекта**.
+:::
+
+1. Перейдите в консоль управления.
+2. В шапке выберите **Проекты**.
+3. Откроется список проектов, в которых вы являетесь участником.
+4. Нажмите на имя нужного проекта.
+5. Откройте раздел **Настройки → Основное**.
+6. Измените имя, описание проекта.
+7. Нажмите **Сохранить**.
+
+## Удаление проекта
+
+Функциональность не предусмотрена в публичном облаке.
\ No newline at end of file
diff --git a/src/guide/admin/roles.md b/src/guide/admin/roles.md
new file mode 100644
index 0000000..6bcd338
--- /dev/null
+++ b/src/guide/admin/roles.md
@@ -0,0 +1,49 @@
+# Ролевая модель
+
+Управление проектом основано на ролевой модели.
+
+**Базовые роли**
+
+В проекте предусмотрен базовый набор ролей:
+
+- **Владелец продукта** — управление пользователями проекта, просмотр ресурсов.
+- **DevOps-инженер** — управление инфраструктурой, стандартное администрирование ОС UNIX по протоколу ssh и права управления виртуальными серверами и дисками в консоли управления.
+
+## Матрица ролей
+
+| Действие | Владелец проекта | DevOps-инженер |
+|---|---|---|
+| Обзор проекта (квоты и количество использованных ресурсов)| ✅ | ✅ |
+| Серверы: обзор | ✅ | ✅ |
+| Серверы: мониторинг | ✅ | ✅ |
+| Серверы: создать сервер |✘ | ✅ |
+| Серверы: подключить диск | ✘ | ✅ |
+| Серверы: отключить диск | ✘ | ✅ |
+| Серверы: добавить диск | ✘ | ✅ |
+| Серверы: теги | ✘ |✅ |
+| Серверы: масштабирование сервера | ✘ | ✅ |
+| Серверы: выключить сервер | ✘ | ✅ |
+| Серверы: включить сервер | ✘ | ✅ |
+| Серверы: перезагрузить сервер | ✘ | ✅ |
+| Серверы: принудительно перезагрузить сервер | ✘ | ✅ |
+| Серверы: удалить сервер | ✘ | ✅ |
+| Серверы: группы размещения | ✘ | ✅ |
+| Серверы: IP-адреса | ✘ | ✅ |
+| Диски: просмотр дисков | ✅ | ✅ |
+| Диски: добавление дискового пространства | ✘ | ✅ |
+| Диски: удалить диск| ✘ | ✅ |
+| Объектное хранилище: просмотр| ✅ | ✅ |
+| Объектное хранилище: добавить хранилище | ✘ | ✅ |
+| Объектное хранилище: удалить хранилище | ✘ | ✅|
+| DNS: добавить зону | ✘ | ✅ |
+| DNS: редактировать зону | ✘ | ✅ |
+| DNS: удалить зону |✘ | ✅ |
+| Настройки проекта: просмотр| ✅ | ✅ |
+| Настройки проекта: изменить описание проекта |✅ | ✘ |
+| Участники: просмотр | ✅ | ✅ |
+| Участники: добавить участника | ✅ | ✘ |
+| Участники: удалить участника | ✅ | ✘ |
+| Участники: назначить роль | ✅| ✘ |
+| Квоты: просмотр | ✅ | ✅ |
+| Веб-обработчики | ✘ | ✅ |
+| Наблюдаемость | ✅ | ✅ |
\ No newline at end of file
diff --git a/src/guide/admin/ssh.md b/src/guide/admin/ssh.md
new file mode 100644
index 0000000..d1ce528
--- /dev/null
+++ b/src/guide/admin/ssh.md
@@ -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. Нажмите на … и выберите **Редактировать**.
+5. Измените имя ключа.
+6. Нажмите **Сохранить**.
+
+## Удалить ключ
+
+1. Перейдите в профиль пользователя.
+2. Перейдите в раздел **SSH-ключи**.
+3. Выберите нужный ключ.
+4. Нажмите на … и выберите **Удалить**.
+5. Нажмите **Удалить**, чтобы подтвердить удаление ключа.
\ No newline at end of file
diff --git a/src/guide/admin/users.md b/src/guide/admin/users.md
new file mode 100644
index 0000000..6654e39
--- /dev/null
+++ b/src/guide/admin/users.md
@@ -0,0 +1,47 @@
+# Управление пользователями в проекте
+
+В консоли управления можно добавлять пользователей, управлять ролями пользователей в проекте. Один пользователей может участвовать в нескольких проектах и иметь в них разные роли.
+
+::: tip Информация
+Добавлять и удалять пользователей, изменять права пользователей в проекте может только владелец проекта.
+:::
+
+## Добавить пользователя
+
+1. Перейдите в консоль управления.
+2. Откройте **Настройки → Участники**.
+3. Нажмите **Добавить пользователя**.
+4. Найдите пользователя по ФИО или email.
+5. Назначьте [роль](../admin/roles.md) пользователю.
+6. Нажмите **Добавить**.
+
+## Назначить права пользователю
+
+Каждому пользователю проекта должна быть выдана хотя бы одна роль. У пользователя может быть несколько ролей в одном проекте.
+
+1. Перейдите в консоль управления.
+2. Откройте **Настройки → Участники**.
+3. Найдите пользователя.
+4. Нажмите ⠇ в строке с именем пользователя и выберите **Редактировать**.
+5. Назначьте [роль](../admin/roles.md) пользователю: установите флажок напротив роли.
+6. Нажмите **Сохранить**.
+
+Права на существующие ОС применятся в течение 10 минут.
+
+## Отозвать права у пользователя
+
+1. Перейдите в консоль управления.
+2. Откройте **Настройки → Участники**.
+3. Найдите пользователя.
+4. Нажмите ⠇ в строке с именем пользователя и выберите **Редактировать**.
+5. Отзовите роль у пользователя: уберите флажок напротив роли. Оставьте пользователю хотя бы одну роль в проекте.
+6. Нажмите кнопку **Сохранить**.
+
+## Удалить пользователя
+
+1. Перейдите в консоль управления.
+2. Откройте **Настройки → Участники**.
+3. Найдите пользователя.
+4. Нажмите ⠇ в строке с именем пользователя и выберите **Удалить**.
+
+Пользователь будет удален из списка участников проекта. Ресурсы проекта станут недоступны пользователю.
\ No newline at end of file
diff --git a/src/guide/compute/compute-getting-started.md b/src/guide/compute/compute-getting-started.md
new file mode 100644
index 0000000..66853f0
--- /dev/null
+++ b/src/guide/compute/compute-getting-started.md
@@ -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 <путь до приватного ключа>
+```
+- по полному доменному имени сервера (FQDN):
+
+```
+ssh -l <логин пользователя> -i <путь до приватного ключа>
+```
+
+Пример команды подключения к серверу по 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#удалить-сервер).
\ No newline at end of file
diff --git a/src/guide/compute/compute-instructions/compute-affinity.md b/src/guide/compute/compute-instructions/compute-affinity.md
new file mode 100644
index 0000000..c19cbd6
--- /dev/null
+++ b/src/guide/compute/compute-instructions/compute-affinity.md
@@ -0,0 +1,52 @@
+# Группы размещения
+
+Группы размещения — это правила размещения виртуальных серверов на физических хостах. Правила размещения позволяют создавать виртуальные серверы на разных или на одном хосте. Политика размещения серверов действует в рамках одной зоны доступности.
+
+- Правило `Affinity` размещает серверы обязательно на одном физическом хосте.
+
+- Правило `Soft-Affinity` размещает серверы по возможности на одном физическом хосте.
+
+- Правило `Anti-Affinity` размещает серверы обязательно на разных физических хостах. Такое размещение повышает производительность и предотвращает недоступность сервера при отказе хоста сервера.
+
+- Правило `Soft-Anti-Affinity` размещает серверы по возможности на разных физических хостах.
+
+::: warning Важно
+Виртуальный сервер создается в группе размещения. Существующий сервер не может быть добавлен в группу размещения.
+
+Виртуальный сервер может быть создан в группе размещения, если для выполнения правила есть ресурсы в зоне доступности. Если ресурсов нет, то виртуальный сервер не будет создан.
+:::
+
+## Создать группу размещения
+
+1. Перейдите в консоль управления.
+2. Откройте **Облачные вычисления → Группы размещения**.
+3. Нажмите **Создать группу**.
+4. Введите параметры группы размещения:
+ - **Имя группы размещения**: введите имя группы размещения.
+ - выберите правило размещения.
+ - **Зона доступности**: выберите зону доступности, в которой будут создаваться виртуальные серверы по правилу размещения.
+ - добавьте тег группе размещения при необходимости.
+7. Нажмите **Создать группу**.
+
+## Редактировать группу размещения
+
+В группе размещения можно изменить название группы и редактировать теги.
+
+1. Перейдите в консоль управления.
+2. Откройте **Облачные вычисления → Группы размещения**.
+3. Переименовать группу размещения:
+ - Нажмите на название группы в списке групп.
+ - Нажмите на … и выберите **Переименовать**.
+ - Введите новое имя группы размещения.
+ - Нажмите ✓.
+4. Редактировать теги группы размещения:
+ - Нажмите на название группы в списке групп.
+ - Нажмите **Редактировать теги**.
+ - Добавьте или удалите теги.
+ - Нажмите **Сохранить**.
+
+## Удалить группу размещения
+
+1. Перейдите в консоль управления.
+2. Откройте **Облачные вычисления → Группы размещения**.
+3. Справа от названия группы размещения нажмите кнопку .
\ No newline at end of file
diff --git a/src/guide/compute/compute-instructions/compute-disks.md b/src/guide/compute/compute-instructions/compute-disks.md
new file mode 100644
index 0000000..a4eb922
--- /dev/null
+++ b/src/guide/compute/compute-instructions/compute-disks.md
@@ -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. Нажмите на … и выберите **Отключить от сервера**.
+7. В открывшемся окне подтвердите операцию:
+ - Введите имя виртуального сервера, от которого отключаете диск.
+ - Нажмите **Отключить диск**.
+
+## Удалить диск
+
+Перед удалением отключите диск от виртуального сервера.
+
+::: danger Предупреждение
+Удаление диска необратимо. Все данные будут удалены без возможности восстановления.
+:::
+
+1. Перейдите в консоль управления.
+2. Откройте **Облачные вычисления → Диски**.
+3. Нажмите на … и выберите **Удалить**.
+6. В открывшемся окне подтвердите операцию:
+ - Введите имя удаляемого диска.
+ - Нажмите **Удалить**.
\ No newline at end of file
diff --git a/src/guide/compute/compute-instructions/compute-ip.md b/src/guide/compute/compute-instructions/compute-ip.md
new file mode 100644
index 0000000..febe618
--- /dev/null
+++ b/src/guide/compute/compute-instructions/compute-ip.md
@@ -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. Нажмите на … и выберите **Переименовать**.
+5. Введите новое имя IP-адреса.
+6. Нажмите ✓.
+
+## Удалить IP-адрес
+
+Если для IP-адреса установлено автоудаление, то адрес удалится во время удаления виртуального сервера.
+
+Если для IP-адреса не установлено автоудаление, то адрес удаляется вручную:
+
+1. Перейдите в консоль управления.
+2. Откройте **Облачные вычисления → IP-адреса**.
+3. Удалите адрес одним из способов:
+ - В разделе **IP-адреса**:
+ - В списке адресов найдите IP-адрес, который необходимо удалить.
+ - Cправа от имени IP-адреса нажмите кнопку .
+ - Подтвердите действие.
+ - На странице IP-адреса:
+ - Нажмите на имя адреса в списке IP-адресов., который необходимо удалить.
+ - Нажмите на … в правом углу страницы и выберите **Удалить**.
+ - Подтвердите действие.
\ No newline at end of file
diff --git a/src/guide/compute/compute-instructions/compute-servers-create.md b/src/guide/compute/compute-instructions/compute-servers-create.md
new file mode 100644
index 0000000..606bb74
--- /dev/null
+++ b/src/guide/compute/compute-instructions/compute-servers-create.md
@@ -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 <путь до приватного ключа>
+```
+- по полному доменному имени сервера (FQDN):
+
+```
+ssh -l <логин пользователя> -i <путь до приватного ключа>
+```
+
+Пример команды подключения к серверу по IP-адресу:
+
+```
+$ ssh -l ivanov -i /home/user/.ssh/id_rsa 10.0.0.1
+```
\ No newline at end of file
diff --git a/src/guide/compute/compute-instructions/compute-servers-manage.md b/src/guide/compute/compute-instructions/compute-servers-manage.md
new file mode 100644
index 0000000..273af0c
--- /dev/null
+++ b/src/guide/compute/compute-instructions/compute-servers-manage.md
@@ -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. Измените состояние виртуального сервера одним из способов:
+ - На странице **Серверы**:
+ - В списке виртуальных серверов найдите сервер, состояние которого необходимо изменить.
+ - Нажмите на … и выберите **Выключить**.
+ - Подтвердите действие, нажав **Выключить**.
+ - На странице виртуального сервера:
+ - В списке виртуальных серверов найдите сервер, состояние которого необходимо изменить.
+ - Нажмите на имя сервера.
+ - Нажмите **Выключить**.
+ - Подтвердите действие, нажав **Выключить сервер**.
+
+Выключение виртуального сервера занимает некоторое время, отключается питание сервера. После выключения сервер переходит в статус `Выключен пользователем`.
+
+## Включить сервер
+
+1. Перейдите в консоль управления.
+2. Откройте **Облачные вычисления → Серверы**.
+3. Измените состояние виртуального сервера одним из способов:
+ - На странице **Серверы**:
+ - В списке виртуальных серверов найдите сервер, состояние которого необходимо изменить.
+ - Нажмите на … и выберите **Включить**.
+ - На странице виртуального сервера:
+ - В списке виртуальных серверов найдите сервер, состояние которого необходимо изменить.
+ - Нажмите на имя сервера.
+ - Нажмите **Включить**.
+
+Включение виртуального сервера занимает некоторое время. После включения сервер переходит в статус `Включен`.
+
+## Перезагрузить сервер
+
+Перезагрузка виртуального сервера предполагает корректное завершение работы операционный системы без отключения питания.
+
+1. Перейдите в консоль управления.
+2. Откройте **Облачные вычисления → Серверы**.
+3. Измените состояние виртуального сервера одним из способов:
+ - На странице **Серверы**:
+ - В списке виртуальных серверов найдите сервер, состояние которого необходимо изменить.
+ - Нажмите на … и выберите **Перезагрузить**.
+ - Подтвердите действие, нажав **Перезагрузить**.
+ - На странице виртуального сервера:
+ - В списке виртуальных серверов найдите сервер, состояние которого необходимо изменить.
+ - Нажмите на имя сервера.
+ - Нажмите **Перезагрузить**.
+ - Подтвердите действие, нажав **Перезагрузить**.
+
+Во время выполнения перезагрузки сервер находится в статусе `Перезагружается`. После завершения перезагрузки сервер перейдет в статус `Включен`.
+
+## Принудительная перезагрузка сервера
+
+Принудительная перезагрузка виртуального сервера предполагает аппаратное выключение и включение. Несохраненные данные могут быть потеряны.
+
+1. Перейдите в консоль управления.
+2. Откройте **Облачные вычисления → Серверы**.
+3. Измените состояние виртуального сервера одним из способов:
+ - На странице **Серверы**:
+ - В списке виртуальных серверов найдите сервер, состояние которого необходимо изменить.
+ - Нажмите на … и выберите **Принудительная перезагрузка**.
+ - Подтвердите действие, нажав **Перезагрузить**.
+ - На странице виртуального сервера:
+ - В списке виртуальных серверов найдите сервер, состояние которого необходимо изменить.
+ - Нажмите на имя сервера.
+ - Нажмите на … в правом углу страницы и выберите **Принудительная перезагрузка**.
+ - Подтвердите действие, нажав **Перезагрузить**.
+
+Во время выполнения перезагрузки сервер находится в статусе `Холодная перезагрузка`. После завершения перезагрузки сервер перейдет в статус `Включен`.
+
+## Назначить виртуальному серверу внутренний 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. Удалите виртуальный сервер одним из способов:
+ - На странице **Серверы**:
+ - В списке виртуальных серверов найдите сервер, которого необходимо удалить.
+ - Нажмите на … и выберите **Удалить**.
+ - Введите имя удаляемого сервера и нажмите **Удалить сервер**.
+ - На странице виртуального сервера:
+ - В списке виртуальных серверов найдите сервер, которого необходимо удалить.
+ - Нажмите на имя сервера.
+ - Нажмите на … в правом углу страницы и выберите **Удалить**.
+ - Введите имя удаляемого сервера и нажмите **Удалить сервер**.
\ No newline at end of file
diff --git a/src/guide/compute/compute-instructions/image/copy.png b/src/guide/compute/compute-instructions/image/copy.png
new file mode 100644
index 0000000..fb4b0bf
Binary files /dev/null and b/src/guide/compute/compute-instructions/image/copy.png differ
diff --git a/src/guide/compute/compute-instructions/image/delete.png b/src/guide/compute/compute-instructions/image/delete.png
new file mode 100644
index 0000000..086a868
Binary files /dev/null and b/src/guide/compute/compute-instructions/image/delete.png differ
diff --git a/src/guide/compute/compute-instructions/image/fqdn.png b/src/guide/compute/compute-instructions/image/fqdn.png
new file mode 100644
index 0000000..4887a8c
Binary files /dev/null and b/src/guide/compute/compute-instructions/image/fqdn.png differ
diff --git a/src/guide/compute/compute-instructions/image/off_disk.png b/src/guide/compute/compute-instructions/image/off_disk.png
new file mode 100644
index 0000000..ee42523
Binary files /dev/null and b/src/guide/compute/compute-instructions/image/off_disk.png differ
diff --git a/src/guide/compute/compute-instructions/image/scale_disk.png b/src/guide/compute/compute-instructions/image/scale_disk.png
new file mode 100644
index 0000000..670e000
Binary files /dev/null and b/src/guide/compute/compute-instructions/image/scale_disk.png differ
diff --git a/src/guide/compute/compute-instructions/image/up_disk.png b/src/guide/compute/compute-instructions/image/up_disk.png
new file mode 100644
index 0000000..0c57610
Binary files /dev/null and b/src/guide/compute/compute-instructions/image/up_disk.png differ
diff --git a/src/guide/compute/compute-limits.md b/src/guide/compute/compute-limits.md
new file mode 100644
index 0000000..a58c781
--- /dev/null
+++ b/src/guide/compute/compute-limits.md
@@ -0,0 +1,5 @@
+# Квоты и лимиты
+
+Для [проекта действуют квоты](../admin/limits.md), по умолчанию определяемые при инициализации проекта.
+
+[Изменить квоты](../admin/limits.md#редактирование-квот-проекта) можно на странице **Обзор**.
\ No newline at end of file
diff --git a/src/guide/compute/compute-ola.md b/src/guide/compute/compute-ola.md
new file mode 100644
index 0000000..98f2c69
--- /dev/null
+++ b/src/guide/compute/compute-ola.md
@@ -0,0 +1,37 @@
+# Уровень обслуживания
+
+Настоящий документ определяет уровень обслуживания (SLA) сервиса «Облачные вычисления».
+
+## Описание предоставляемых услуг
+
+В таблице рассмотрены услуги, предоставляемые в рамках OLA сервиса «Облачные вычисления».
+
+| Наименование услуги | Краткое описание | Ценность для потребителя | Целевая аудитория | Подразделение-исполнитель|
+|---|---|---|---|---|
+| Заказ и управление параметрами виртуальных серверов с ОС | Заказ и управление виртуальной машиной с серверной ОС | Реализация проектной и операционной деятельности продуктовых команд в части ИТ-Инфраструктуры | Руководители проектов DevOps Администраторы| Отдел виртуальных платформ Отдел программно-определяемых сред|
+
+
+## Доступность услуги
+
+Заказ и управление параметрами виртуальных серверов с ОС: 99,5 %.
+
+
+## Характеристики доступности услуги
+
+Заказ и управление параметрами виртуальных серверов с ОС:
+| Метрика | Допустимое значение | Измерение |
+|---|---|---|
+| HDD IOPS | Эталонные значения: 250 IOPS/500GB тип диска «hdd», не более 1000 iops на диск; 1000 IOPS/500GB тип диска «ssd/nvme» не более 15000 iops на диск | - Стандартное измерение платформа наблюдаемости «Grafana» - Утилита fio при записи в 32-64 потока c флагом sync в зависимости от размера блока (обычно - 4k/8k) 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 |
\ No newline at end of file
diff --git a/src/guide/compute/compute-overview.md b/src/guide/compute/compute-overview.md
new file mode 100644
index 0000000..a246bf7
--- /dev/null
+++ b/src/guide/compute/compute-overview.md
@@ -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.
\ No newline at end of file
diff --git a/src/guide/dns/dns-instructions/dns-create.md b/src/guide/dns/dns-instructions/dns-create.md
new file mode 100644
index 0000000..de57b34
--- /dev/null
+++ b/src/guide/dns/dns-instructions/dns-create.md
@@ -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
+ - **Зона**: выберите из списка *.cloud.dfcloud.ru*.
+ - **Параметр**: введите доменное имя записи. Максимальная длина имени — 63 символа и полного доменного имени (FQDN) — 255 символов.
+ - **Значение**: введите IP-адрес виртуального сервера. IP-адрес можно посмотреть на странице **Облачные вычисления → Серверы**.
+ - **TTL**: введите время жизни записи в секундах.
+ :::
+
+ ::: details CNAME
+ - **Зона**: выберите из списка *.cloud.dfcloud.ru*.
+ - **Параметр**: введите доменное имя записи.
+ - **Значение**: введите FQDN сервера, точка не ставится в конце значения.
+ - **TTL**: введите время жизни записи в секундах.
+ :::
+
+ ::: details PTR
+
+ Запись в обратной зоне добавляется автоматически при создании виртуального сервера. Для одного IP-адреса предназначена одна PTR-запись. Если для нужного IP-адреса не создана PTR-запись, то создайте ее вручную.
+
+ - **Зона**: выберите из списка *.cloud.dfcloud.ru*.
+ - **Параметр**: введите IP-адрес виртуального сервера. IP-адрес можно посмотреть на странице **Облачные вычисления → Серверы**.
+ - **Значение**: введите FQDN сервера.
+ - **TTL**: введите время жизни записи в секундах.
+ :::
+
+2. Нажмите **Добавить**.
+
+## Редактировать запись
+
+1. Перейдите в консоль управления.
+2. Откройте **DNS**.
+3. Откройте записи прямой или обратной зоны.
+4. В таблице записей напротив нужной записи нажмите **Редактировать**.
+5. Измените `Параметр`, `Значение` или `TTL` записи.
+6. Нажмите **Сохранить**.
+
+## Удалить запись
+
+1. Перейдите в консоль управления.
+2. Откройте **DNS**.
+3. Откройте записи прямой или обратной зоны.
+4. В таблице записей напротив нужной записи нажмите **Удалить**.
+5. В открывшемся окне подтвердите операцию:
+ - Скопируйте предложенный текст.
+ - Нажмите **Удалить**.
\ No newline at end of file
diff --git a/src/guide/dns/dns-limits.md b/src/guide/dns/dns-limits.md
new file mode 100644
index 0000000..35591b2
--- /dev/null
+++ b/src/guide/dns/dns-limits.md
@@ -0,0 +1,3 @@
+# Квоты и лимиты
+
+Ограничений на количество создаваемых записей в зоне нет.
\ No newline at end of file
diff --git a/src/guide/dns/dns-overview.md b/src/guide/dns/dns-overview.md
new file mode 100644
index 0000000..5d0cf2e
--- /dev/null
+++ b/src/guide/dns/dns-overview.md
@@ -0,0 +1,11 @@
+# Обзор сервиса
+
+Сервис DNS предназначен для управления доменными именами ресурсов в проекте.
+
+Сервис DNS предоставляет одну зону в `cloud.dfcloud.ru`.
+
+Для каждого проекта автоматически создается зона: `.cloud.dfcloud.ru`. В этой зоне можно [управлять записями](../dns/dns-instructions/dns-create.md): создавать, редактировать, удалять.
+
+При создании виртуального сервера автоматически добавляются:
+- FQDN сервера в прямой зоне;
+- PTR-запись в обратной зоне.
\ No newline at end of file
diff --git a/src/guide/index.md b/src/guide/index.md
new file mode 100644
index 0000000..699694f
--- /dev/null
+++ b/src/guide/index.md
@@ -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)** или инфраструктура как код — это подход для управления и описания инфраструктуры посредством конфигурационных файлов без непосредственного взаимодействия с интерфейсами управления.
\ No newline at end of file
diff --git a/src/guide/storage/storage-instructions/s3-connect/s3cmd.md b/src/guide/storage/storage-instructions/s3-connect/s3cmd.md
new file mode 100644
index 0000000..d20bcd0
--- /dev/null
+++ b/src/guide/storage/storage-instructions/s3-connect/s3cmd.md
@@ -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).
\ No newline at end of file
diff --git a/src/guide/storage/storage-instructions/s3-connect/winscp.md b/src/guide/storage/storage-instructions/s3-connect/winscp.md
new file mode 100644
index 0000000..4c1fec5
--- /dev/null
+++ b/src/guide/storage/storage-instructions/s3-connect/winscp.md
@@ -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://`;
+ - начнется скачивание файла.
\ No newline at end of file
diff --git a/src/guide/storage/storage-instructions/storage-s3.md b/src/guide/storage/storage-instructions/storage-s3.md
new file mode 100644
index 0000000..c598feb
--- /dev/null
+++ b/src/guide/storage/storage-instructions/storage-s3.md
@@ -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. Нажмите ⠇ и выберите **Удалить**.
+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 =
+ aws_secret_access_key =
+ ```
+4. Создайте директорию, в которой будет отображаться содержимое бакета. Например, `/mnt/s3`.
+5. Для монтирования бакета выполните команду:
+
+ ```sh
+ /bin/geesefs --endpoint <имя бакета> /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 <путь_к_директории>
+```
\ No newline at end of file
diff --git a/src/guide/storage/storage-limits.md b/src/guide/storage/storage-limits.md
new file mode 100644
index 0000000..cbacc4c
--- /dev/null
+++ b/src/guide/storage/storage-limits.md
@@ -0,0 +1,3 @@
+# Квоты и лимиты
+
+Для сервиса действует квота по умолчанию, определяемая при инициализация проекта, в размере 100 Гбайт.
\ No newline at end of file
diff --git a/src/guide/storage/storage-ola.md b/src/guide/storage/storage-ola.md
new file mode 100644
index 0000000..c3fe22b
--- /dev/null
+++ b/src/guide/storage/storage-ola.md
@@ -0,0 +1,17 @@
+# Уровень обслуживания
+
+Настоящий документ определяет уровень обслуживания (SLA) сервиса «Объектное хранилище».
+
+
+## Описание предоставляемых услуг
+
+В таблице рассмотрены услуги, предоставляемые в рамках SLA сервиса «Объектное хранилище».
+
+| Наименование услуги | Краткое описание | Ценность для потребителя | Целевая аудитория |
+|---|---|---|---|
+| Доступ к S3 хранилищу | Web-доступ к эластичному хранилищу данных | Возможность очень быстрого подключения дискового пространства в приложение, сервер, ВРС и т. п. | DevOps Администраторы |
+
+
+## Доступность услуги
+
+Доступ к S3 хранилищу 99,5 %.
diff --git a/src/guide/storage/storage-overview.md b/src/guide/storage/storage-overview.md
new file mode 100644
index 0000000..aa33600
--- /dev/null
+++ b/src/guide/storage/storage-overview.md
@@ -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-го и последующих уровней это правило не распространяется;
+ - может содержать строчные буквы латинского алфавита, цифры, дефис и подчеркивания;
+ - подчеркивание недопустимо для имени бакета в корневом каталоге.
+
+Правила именования файлов в бакете:
+- может содержать строчные буквы латинского алфавита, цифры, дефис и подчеркивания.
\ No newline at end of file
diff --git a/src/guide/using-vue.md b/src/guide/using-vue.md
new file mode 100644
index 0000000..71ac45b
--- /dev/null
+++ b/src/guide/using-vue.md
@@ -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 `` component:
+
+##
diff --git a/src/index.md b/src/index.md
new file mode 100644
index 0000000..5569cb0
--- /dev/null
+++ b/src/index.md
@@ -0,0 +1,22 @@
+---
+# https://vitepress.dev/reference/default-theme-home-page
+layout: home
+
+hero:
+ name: "BeeCloud Docs"
+ text: "Документация публичного облака"
+ # tagline: My great project tagline
+
+features:
+ - title: Облачные вычисления
+ details: Масштабируемые вычислительные мощности для создания и управления виртуальными серверами.
+ link: /guide/compute/compute-overview
+ - title: Объектное хранилище
+ details: Amazon совместимое S3 хранилище.
+ link: /guide/storage/storage-overview
+ - title: DNS
+ details: Управление ресурсными записями DNS.
+ link: /guide/dns/dns-overview
+
+---
+
diff --git a/src/public/favicon.svg b/src/public/favicon.svg
new file mode 100644
index 0000000..947bf28
--- /dev/null
+++ b/src/public/favicon.svg
@@ -0,0 +1,13 @@
+
diff --git a/src/public/fonts/beeline-sans/BeelineSans-Black.ttf b/src/public/fonts/beeline-sans/BeelineSans-Black.ttf
new file mode 100644
index 0000000..a8e3862
Binary files /dev/null and b/src/public/fonts/beeline-sans/BeelineSans-Black.ttf differ
diff --git a/src/public/fonts/beeline-sans/BeelineSans-Black.woff b/src/public/fonts/beeline-sans/BeelineSans-Black.woff
new file mode 100644
index 0000000..7288f60
Binary files /dev/null and b/src/public/fonts/beeline-sans/BeelineSans-Black.woff differ
diff --git a/src/public/fonts/beeline-sans/BeelineSans-Black.woff2 b/src/public/fonts/beeline-sans/BeelineSans-Black.woff2
new file mode 100644
index 0000000..7ac678c
Binary files /dev/null and b/src/public/fonts/beeline-sans/BeelineSans-Black.woff2 differ
diff --git a/src/public/fonts/beeline-sans/BeelineSans-Bold.ttf b/src/public/fonts/beeline-sans/BeelineSans-Bold.ttf
new file mode 100644
index 0000000..5c07a55
Binary files /dev/null and b/src/public/fonts/beeline-sans/BeelineSans-Bold.ttf differ
diff --git a/src/public/fonts/beeline-sans/BeelineSans-Bold.woff b/src/public/fonts/beeline-sans/BeelineSans-Bold.woff
new file mode 100644
index 0000000..6eeb00b
Binary files /dev/null and b/src/public/fonts/beeline-sans/BeelineSans-Bold.woff differ
diff --git a/src/public/fonts/beeline-sans/BeelineSans-Bold.woff2 b/src/public/fonts/beeline-sans/BeelineSans-Bold.woff2
new file mode 100644
index 0000000..9e420ce
Binary files /dev/null and b/src/public/fonts/beeline-sans/BeelineSans-Bold.woff2 differ
diff --git a/src/public/fonts/beeline-sans/BeelineSans-Medium.ttf b/src/public/fonts/beeline-sans/BeelineSans-Medium.ttf
new file mode 100644
index 0000000..25f2634
Binary files /dev/null and b/src/public/fonts/beeline-sans/BeelineSans-Medium.ttf differ
diff --git a/src/public/fonts/beeline-sans/BeelineSans-Medium.woff b/src/public/fonts/beeline-sans/BeelineSans-Medium.woff
new file mode 100644
index 0000000..6599fdd
Binary files /dev/null and b/src/public/fonts/beeline-sans/BeelineSans-Medium.woff differ
diff --git a/src/public/fonts/beeline-sans/BeelineSans-Medium.woff2 b/src/public/fonts/beeline-sans/BeelineSans-Medium.woff2
new file mode 100644
index 0000000..ee19a0a
Binary files /dev/null and b/src/public/fonts/beeline-sans/BeelineSans-Medium.woff2 differ
diff --git a/src/public/fonts/beeline-sans/BeelineSans-Regular.ttf b/src/public/fonts/beeline-sans/BeelineSans-Regular.ttf
new file mode 100644
index 0000000..a4340f1
Binary files /dev/null and b/src/public/fonts/beeline-sans/BeelineSans-Regular.ttf differ
diff --git a/src/public/fonts/beeline-sans/BeelineSans-Regular.woff b/src/public/fonts/beeline-sans/BeelineSans-Regular.woff
new file mode 100644
index 0000000..747ad27
Binary files /dev/null and b/src/public/fonts/beeline-sans/BeelineSans-Regular.woff differ
diff --git a/src/public/fonts/beeline-sans/BeelineSans-Regular.woff2 b/src/public/fonts/beeline-sans/BeelineSans-Regular.woff2
new file mode 100644
index 0000000..db4d6c6
Binary files /dev/null and b/src/public/fonts/beeline-sans/BeelineSans-Regular.woff2 differ
diff --git a/src/public/fonts/iconfont/BeelineIcons.ttf b/src/public/fonts/iconfont/BeelineIcons.ttf
new file mode 100644
index 0000000..ec2c241
Binary files /dev/null and b/src/public/fonts/iconfont/BeelineIcons.ttf differ
diff --git a/src/public/fonts/iconfont/BeelineIcons.woff b/src/public/fonts/iconfont/BeelineIcons.woff
new file mode 100644
index 0000000..8fabcf7
Binary files /dev/null and b/src/public/fonts/iconfont/BeelineIcons.woff differ
diff --git a/src/public/fonts/iconfont/BeelineIcons.woff2 b/src/public/fonts/iconfont/BeelineIcons.woff2
new file mode 100644
index 0000000..7df4f7f
Binary files /dev/null and b/src/public/fonts/iconfont/BeelineIcons.woff2 differ
diff --git a/src/public/fonts/roboto-mono/RobotoMono-Bold.ttf b/src/public/fonts/roboto-mono/RobotoMono-Bold.ttf
new file mode 100644
index 0000000..900fce6
Binary files /dev/null and b/src/public/fonts/roboto-mono/RobotoMono-Bold.ttf differ
diff --git a/src/public/fonts/roboto-mono/RobotoMono-Bold.woff b/src/public/fonts/roboto-mono/RobotoMono-Bold.woff
new file mode 100644
index 0000000..653fd12
Binary files /dev/null and b/src/public/fonts/roboto-mono/RobotoMono-Bold.woff differ
diff --git a/src/public/fonts/roboto-mono/RobotoMono-Bold.woff2 b/src/public/fonts/roboto-mono/RobotoMono-Bold.woff2
new file mode 100644
index 0000000..6de7588
Binary files /dev/null and b/src/public/fonts/roboto-mono/RobotoMono-Bold.woff2 differ
diff --git a/src/public/fonts/roboto-mono/RobotoMono-Light.ttf b/src/public/fonts/roboto-mono/RobotoMono-Light.ttf
new file mode 100644
index 0000000..276af4c
Binary files /dev/null and b/src/public/fonts/roboto-mono/RobotoMono-Light.ttf differ
diff --git a/src/public/fonts/roboto-mono/RobotoMono-Light.woff b/src/public/fonts/roboto-mono/RobotoMono-Light.woff
new file mode 100644
index 0000000..4872bff
Binary files /dev/null and b/src/public/fonts/roboto-mono/RobotoMono-Light.woff differ
diff --git a/src/public/fonts/roboto-mono/RobotoMono-Light.woff2 b/src/public/fonts/roboto-mono/RobotoMono-Light.woff2
new file mode 100644
index 0000000..3b9fc53
Binary files /dev/null and b/src/public/fonts/roboto-mono/RobotoMono-Light.woff2 differ
diff --git a/src/public/fonts/roboto-mono/RobotoMono-Medium.ttf b/src/public/fonts/roboto-mono/RobotoMono-Medium.ttf
new file mode 100644
index 0000000..8461be7
Binary files /dev/null and b/src/public/fonts/roboto-mono/RobotoMono-Medium.ttf differ
diff --git a/src/public/fonts/roboto-mono/RobotoMono-Medium.woff b/src/public/fonts/roboto-mono/RobotoMono-Medium.woff
new file mode 100644
index 0000000..fb4a342
Binary files /dev/null and b/src/public/fonts/roboto-mono/RobotoMono-Medium.woff differ
diff --git a/src/public/fonts/roboto-mono/RobotoMono-Medium.woff2 b/src/public/fonts/roboto-mono/RobotoMono-Medium.woff2
new file mode 100644
index 0000000..ebc6552
Binary files /dev/null and b/src/public/fonts/roboto-mono/RobotoMono-Medium.woff2 differ
diff --git a/src/public/fonts/roboto-mono/RobotoMono-Regular.ttf b/src/public/fonts/roboto-mono/RobotoMono-Regular.ttf
new file mode 100644
index 0000000..7c4ce36
Binary files /dev/null and b/src/public/fonts/roboto-mono/RobotoMono-Regular.ttf differ
diff --git a/src/public/fonts/roboto-mono/RobotoMono-Regular.woff b/src/public/fonts/roboto-mono/RobotoMono-Regular.woff
new file mode 100644
index 0000000..4ce4448
Binary files /dev/null and b/src/public/fonts/roboto-mono/RobotoMono-Regular.woff differ
diff --git a/src/public/fonts/roboto-mono/RobotoMono-Regular.woff2 b/src/public/fonts/roboto-mono/RobotoMono-Regular.woff2
new file mode 100644
index 0000000..e033cfa
Binary files /dev/null and b/src/public/fonts/roboto-mono/RobotoMono-Regular.woff2 differ
diff --git a/src/public/gitlab.svg b/src/public/gitlab.svg
new file mode 100644
index 0000000..d4fcca3
--- /dev/null
+++ b/src/public/gitlab.svg
@@ -0,0 +1,33 @@
+
+
diff --git a/src/public/img/a.svg b/src/public/img/a.svg
new file mode 100644
index 0000000..f57f228
--- /dev/null
+++ b/src/public/img/a.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/src/public/img/schema-publication-dmz.png b/src/public/img/schema-publication-dmz.png
new file mode 100644
index 0000000..e061c4d
Binary files /dev/null and b/src/public/img/schema-publication-dmz.png differ
diff --git a/src/public/vega-logo.svg b/src/public/vega-logo.svg
new file mode 100644
index 0000000..9e9e8ce
--- /dev/null
+++ b/src/public/vega-logo.svg
@@ -0,0 +1,6 @@
+
\ No newline at end of file
diff --git a/src/terraform/faq.md b/src/terraform/faq.md
new file mode 100644
index 0000000..b48d448
--- /dev/null
+++ b/src/terraform/faq.md
@@ -0,0 +1,84 @@
+# Вопросы и ответы
+
+## Не могу найти ресурс, созданный через Terraform?
+
+Во время выполнения команды `terraform [apply | plan]` получаем ошибку `404` __Сервер по вашему запросу не найден__:
+
+```
+lanning failed. Terraform encountered an error while generating this plan.
+╷
+│ Error: url=[https://console.cloud.dfcloud.ru/api/v1/projects/vega-dev-demo/vps/servers/cac9da7e-d3b1-488c-9bb0-277fd20140d1,body=]
+{"code":404,"error":"server-not-found","description":"Сервер по вашему запросу не найден"} // [!code focus]
+│
+│ with beecloud_server.router[1], // [!code focus]
+│ on main.tf line 23, in resource "beecloud_server" "router":
+│ 23: resource "beecloud_server" "router" {
+│
+```
+Решение:
+
+1. Удалите поломанный ресурс из файла состояния:
+ ```sh
+ terraform state rm "beecloud_server.router[1]"
+ ```
+ Вывод:
+
+ ```
+ Removed beecloud_server.router[1]
+ Successfully removed 1 resource instance(s).
+ ```
+2. Повторно примените конфигурацию Terraform:
+
+ ```sh
+ terraform apply
+ ```
+
+ Terraform создаст недостающий ресурс.
+
+## Что делать, если при создании ресурса Terraform выдает ошибку: "context deadline exceeded"?
+
+Во время выполнения команды `terraform apply` получаем ошибку: __context deadline exceeded__
+
+```
+beecloud_server.my-server: Creating...
+...
+beecloud_server.my-server: Still creating... [10m elapsed]
+╷
+│ Error: Error waiting for server ae8c5364-16e4-4b9b-84e1-092a04647838 to come ready, error: context deadline exceeded // [!code focus]
+│
+│ with beecloud_server.my-server, // [!code focus]
+│ on main.tf line 31, in resource "beecloud_server" "my-server":
+│ 31: resource "beecloud_server" "my-server" {
+╵
+```
+
+Решение:
+
+Увеличьте тайм-аут ожидания ресурса при создании:
+
+```hcl
+resource "beecloud_server" "my-server" {
+ ...
+
+ timeouts {
+ create = "30m"
+ }
+}
+```
+
+Тайм-ауты по умолчанию для операций:
+
+| CRUD Function | Default Timeout |
+|----------------------|-----------------|
+| Create | 20 minutes |
+| CreateContext | 20 minutes |
+| CreateWithoutTimeout | N/A |
+| Delete | 20 minutes |
+| DeleteContext | 20 minutes |
+| DeleteWithoutTimeout | N/A |
+| Read | 20 minutes |
+| ReadContext | 20 minutes |
+| ReadWithoutTimeout | N/A |
+| Update | 20 minutes |
+| UpdateContext | 20 minutes |
+| UpdateWithoutTimeout | N/A |
\ No newline at end of file
diff --git a/src/terraform/index.md b/src/terraform/index.md
new file mode 100644
index 0000000..afec2e4
--- /dev/null
+++ b/src/terraform/index.md
@@ -0,0 +1,31 @@
+# Terraform
+
+[Terraform](https://www.terraform.io/) позволяет быстро создать облачную инфраструктуру в Облаке Vega и управлять ей с помощью файлов конфигураций. В файлах конфигураций хранится описание инфраструктуры на языке HCL (HashiCorp Configuration Language). Terraform и его провайдеры распространяются под лицензией [Business Source License](https://github.com/hashicorp/terraform/blob/main/LICENSE).
+
+При изменении файлов конфигураций Terraform автоматически определяет, какая часть вашей конфигурации уже развернута, что следует добавить или удалить.
+
+## Установите Terraform
+
+::: tabs
+== UNIX
+Выполните команду в терминале:
+
+Ubuntu/Debian
+```sh
+wget -O- https://apt.releases.hashicorp.com/gpg | sudo gpg --dearmor -o /usr/share/keyrings/hashicorp-archive-keyring.gpg
+echo "deb [signed-by=/usr/share/keyrings/hashicorp-archive-keyring.gpg] https://apt.releases.hashicorp.com $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/hashicorp.list
+sudo apt update && sudo apt install terraform
+```
+
+== MacOS
+Выполните команду в терминале:
+
+```sh
+brew tap hashicorp/tap
+brew install hashicorp/tap/terraform
+```
+
+== Windows
+Установить по ссылке [386 v1.9.6](https://releases.hashicorp.com/terraform/1.9.6/terraform_1.9.6_windows_386.zip) [AMD64 v1.9.6](https://releases.hashicorp.com/terraform/1.9.6/terraform_1.9.6_windows_amd64.zip)
+
+:::
diff --git a/src/terraform/providers/beecloud/compute/data-sources/beecloud_affinity_groups.md b/src/terraform/providers/beecloud/compute/data-sources/beecloud_affinity_groups.md
new file mode 100644
index 0000000..1964e43
--- /dev/null
+++ b/src/terraform/providers/beecloud/compute/data-sources/beecloud_affinity_groups.md
@@ -0,0 +1,45 @@
+---
+page_title: "beecloud: beecloud_affinity_groups"
+description: "Get information about multiple beecloud affinity groups"
+---
+
+# Источник данных: beecloud_affinity_groups
+
+Получение информации обо всех аффинити-группах проекта.
+
+## Пример конфигурации
+
+Получение всех аффинити-групп проекта
+
+```hcl
+data "beecloud_affinity_groups" "all" {}
+
+output "beecloud_affinity_groups_all" {
+ value = data.beecloud_affinity_groups.all
+}
+```
+
+Дополнительная фильтрация по ID региона
+
+```hcl
+data "beecloud_affinity_groups" "by_region" {
+ region = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
+}
+
+output "beecloud_affinity_groups_by_region" {
+ value = data.beecloud_affinity_groups.by_region
+}
+```
+
+## Возвращаемые поля
+- `id` - Проект в beecloud, к которому относятся сервера (ID/Slug).
+- `affinity_groups` - Список аффинити-групп.
+ - `affinity_group_id` - ID в системе TF. Соответствует ID группы.
+ - `project_id` - ID проекта.
+ - `name` - Наименование сервера.
+ - `policy` - Политика группы (affinity/soft-affinity/anti-affinity/soft-anti-affinity).
+ - `region` - Данные о регионе.
+ - `id` - ID региона
+ - `slug` - Слаг региона.
+ - `name` - Наименование региона.
+ - `condition` - Состояние группы (статус) (готовность к использованию).
\ No newline at end of file
diff --git a/src/terraform/providers/beecloud/compute/data-sources/beecloud_flavors.md b/src/terraform/providers/beecloud/compute/data-sources/beecloud_flavors.md
new file mode 100644
index 0000000..de23378
--- /dev/null
+++ b/src/terraform/providers/beecloud/compute/data-sources/beecloud_flavors.md
@@ -0,0 +1,97 @@
+---
+page_title: "beecloud: beecloud_flavors"
+description: "Get information about multiple beecloud Flavors of project"
+---
+
+# Источник данных: beecloud_flavors
+
+Получение информации обо всех тарифах, доступных проекту.
+
+## Пример конфигурации
+
+```hcl
+data "beecloud_flavors" "all" {}
+
+output "beecloud_flavors_all" {
+ value = data.beecloud_flavors.all
+}
+```
+
+## Список доступных тарифов
+
+```hcl
+data "beecloud_flavors" "all_slug" {}
+
+output "flavors_slug" {
+ value = data.beecloud_flavors.all_slug.flavors[*].slug
+}
+```
+
+## Варианты фильтрации
+
+Поиск по CPU и RAM
+
+> RAM указывается в Мегабайтах пример (2048 Мб = 2 Гб)
+
+```hcl
+data "beecloud_flavors" "cpu2" {
+ filters {
+ vcpu = 2
+ }
+}
+
+output "flavors_cpu2" {
+ value = data.beecloud_flavors.cpu2
+}
+
+data "beecloud_flavors" "cpu2ram2" {
+ filters {
+ vcpu = 2
+ ram = 2 * 1024
+ }
+}
+
+output "flavors_cpu2ram2" {
+ value = data.beecloud_flavors.cpu2ram2
+}
+
+```
+
+## Возвращаемые поля
+
+- `id` - TF ID. Соответствует ID/Slug проекта.
+- `filters` - параметры фильтра
+ - `ram` - значение заданного фильтра для ОЗУ
+ - `vcpu` - значение заданного фильтра для ЦПУ
+- `flavors` - Список доступных тарифов.
+ - `flavor_id` - ID тарифа.
+ - `group` - Тарифная группа.
+ - `name` - Наименование тарифа.
+ - `ram` - Параметр ram тарифа.
+ - `regions` - Доступен для регионов. Список.
+ - `slug` - Slug тарифа.
+ - `vcpu` - Параметр vcpu тарифа.
+
+# beecloud_flavor
+
+Получение информации о тарифе
+
+```hcl
+data "beecloud_flavor" "cpu2_ram2" {
+ slug = "cpu2ram2"
+}
+
+output "flavor_id" {
+ value = data.beecloud_flavor.cpu2_ram2.flavor_id
+}
+```
+
+## Возвращаемые поля
+
+- `flavor_id` - ID тарифа.
+- `slug` - Slug тарифа.
+- `name` - Наименование тарифа.
+- `vcpu` - Параметр vcpu тарифа.
+- `ram` - Параметр ram тарифа.
+- `group` - Тарифная группа.
+- `regions` - Доступен для регионов. Список.
\ No newline at end of file
diff --git a/src/terraform/providers/beecloud/compute/data-sources/beecloud_images.md b/src/terraform/providers/beecloud/compute/data-sources/beecloud_images.md
new file mode 100644
index 0000000..29a3c0f
--- /dev/null
+++ b/src/terraform/providers/beecloud/compute/data-sources/beecloud_images.md
@@ -0,0 +1,30 @@
+---
+page_title: "beecloud: beecloud_images"
+description: "Get information about multiple beecloud Images of project"
+---
+
+# Источник данных: beecloud_images
+
+Получение информации обо всех образах, доступных проекту.
+
+## Пример конфигурации
+
+```hcl
+data "beecloud_images" "all" {}
+
+output "beecloud_images_all" {
+ value = data.beecloud_images.all
+}
+```
+
+## Возвращаемые поля
+
+- `id` - TF ID. Соответствует ID/Slug проекта.
+- `images` - Список доступных образов.
+ - `image_id` - ID образа.
+ - `slug` - Slug образа.
+ - `name` - Наименование образа.
+ - `distribution` - Дистрибутив образа.
+ - `version` - Версия образа.
+ - `min_disk` - Минимальный размер диска.
+ - `regions` - Доступен для регионов. Список.
\ No newline at end of file
diff --git a/src/terraform/providers/beecloud/compute/data-sources/beecloud_regions.md b/src/terraform/providers/beecloud/compute/data-sources/beecloud_regions.md
new file mode 100644
index 0000000..6f90a83
--- /dev/null
+++ b/src/terraform/providers/beecloud/compute/data-sources/beecloud_regions.md
@@ -0,0 +1,37 @@
+---
+page_title: "beecloud: beecloud_regions"
+description: "Get information about multiple beecloud Regions of project"
+---
+
+# Источник данных: beecloud_regions
+
+Получение информации обо всех регионах, доступных проекту.
+
+## Пример конфигурации
+
+```hcl
+data "beecloud_regions" "all" {}
+
+output "beecloud_regions_all" {
+ value = data.beecloud_regions.all
+}
+```
+
+## Возвращаемые поля
+
+- `id` - TF ID. Соответствует ID/Slug проекта.
+- `regions` - Список доступных регионов.
+ - `region_id` - ID региона.
+ - `slug` - Slug региона.
+ - `name` - Наименование региона.
+ - `hypervisor` - Гипервизор.
+ - `location` - Местонахождение.
+ - `priority` - Приоритет.
+ - `zone` - Зона региона.
+ - `volumes_type` - Доступные типы дисков. Список.
+ - `features` - Сетевой периметр (?)
+ - `limits` - Лимиты региона.
+ - `instance` - Количество инстансов.
+ - `ram` - Ограничение по RAM.
+ - `vcpu` - Ограничение по VCPU.
+ - `volumes_size` - Объект типа "key:value". Размеры для каждого типа диска (hhd/ssd/nvme/..)
\ No newline at end of file
diff --git a/src/terraform/providers/beecloud/compute/data-sources/beecloud_server.md b/src/terraform/providers/beecloud/compute/data-sources/beecloud_server.md
new file mode 100644
index 0000000..c8a4713
--- /dev/null
+++ b/src/terraform/providers/beecloud/compute/data-sources/beecloud_server.md
@@ -0,0 +1,55 @@
+---
+page_title: "beecloud: beecloud_server"
+description: "Get information about beecloud Instance"
+---
+
+# Источник данных: beecloud_server
+
+Получение информации о сервере.
+
+## Пример конфигурации
+
+```hcl
+data "beecloud_server" "server_by_id" {
+ server_id = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
+}
+
+output "server_beecloud" {
+ value = data.beecloud_server.server_by_id
+}
+```
+
+## Аргументы
+
+- `server_id` - ID сервера.
+
+## Возвращаемые поля
+
+- `id` - ID TF. Соответствует ID сервера.
+- `name` - Наименование сервера.
+- `image` - Параметры образа сервера.
+ - `id` - ID образа сервера.
+ - `slug` - Slug образа.
+ - `name` - Наименование образа.
+- `region` - Регион, где создан сервер.
+ - `id` - ID региона.
+ - `slug` - Slug региона.
+ - `name` - Наименование региона.
+- `flavor` - Тариф.
+ - `id` - ID тарифа.
+ - `slug` - Slug тарифа.
+ - `name` - Наименование тарифа.
+- `volumes` - Список дисков.
+ - `id` - ID диска.
+ - `size` - Размер диска.
+ - `type` - Тип диска (hhd/ssd/nvme).
+ - `is_boot` - Загрузочный/дополнительный (`true`, `false`).
+ - `name` - Наименование диска.
+- `addresses` - Список адресов.
+ - `type` - Тип адреса.
+ - `address` - IP адрес.
+ - `version` - Версия IP адреса (4/6).
+- `status` - Статус сервера (Создан/Создается/...)
+- `fqdn` - Полный домен.
+- `tags` - Список тэгов.
+- `wait_completed` - Ключ ожидания состояния сервера (Создан/Создается...).
\ No newline at end of file
diff --git a/src/terraform/providers/beecloud/compute/data-sources/beecloud_servers.md b/src/terraform/providers/beecloud/compute/data-sources/beecloud_servers.md
new file mode 100644
index 0000000..22d8c9c
--- /dev/null
+++ b/src/terraform/providers/beecloud/compute/data-sources/beecloud_servers.md
@@ -0,0 +1,55 @@
+---
+page_title: "beecloud: beecloud_servers"
+description: "Get information about multiple beecloud Instances of project"
+---
+
+# Источник данных: beecloud_servers
+
+Получение информации обо всех серверах проекта.
+
+## Пример конфигурации
+
+```hcl
+data "beecloud_servers" "all" {}
+
+output "beecloud_servers_all" {
+ value = data.beecloud_servers.all
+}
+```
+
+## Возвращаемые поля
+
+- `id` - Проект в beecloud, к которому относятся серверыы (ID/Slug).
+- `servers` - Список серверов.
+ - `server_id` - ID сервера.
+ - `name` - Наименование сервера.
+ - `image` - Параметры образа сервера.
+ - `id` - ID образа сервера.
+ - `slug` - Slug образа.
+ - `name` - Наименование образа.
+ - `region` - Регион, где создан сервер.
+ - `id` - ID региона.
+ - `slug` - Slug региона.
+ - `name` - Наименование региона.
+ - `flavor` - Тариф.
+ - `id` - ID тарифа.
+ - `slug` - Slug тарифа.
+ - `name` - Наименование тарифа.
+ - `volumes` - Список дисков.
+ - `id` - ID диска.
+ - `size` - Размер диска.
+ - `type` - Тип диска (hhd/ssd/nvme).
+ - `is_boot` - Загрузочный/дополнительный (`true`, `false`).
+ - `name` - Наименование диска.
+ - `addresses` - Список адресов.
+ - `type` - Тип адреса.
+ - `address` - IP адрес.
+ - `version` - Версия IP адреса (4/6).
+ - `status` - Статус сервера (Создан/Создается/...)
+ - `fqdn` - Полный домен.
+ - `tags` - Список тэгов.
+ - `wait_completed` - Ключ ожидания состояния сервера (Создан/Создается...).
+
+
+
+
diff --git a/src/terraform/providers/beecloud/compute/data-sources/beecloud_volume.md b/src/terraform/providers/beecloud/compute/data-sources/beecloud_volume.md
new file mode 100644
index 0000000..96beb46
--- /dev/null
+++ b/src/terraform/providers/beecloud/compute/data-sources/beecloud_volume.md
@@ -0,0 +1,34 @@
+---
+page_title: "beecloud: beecloud_volume"
+description: "Get information about beecloud Volume"
+---
+
+# Источник данных: beecloud_volume
+Получение информации о диске.
+
+## Пример конфигурации
+
+```hcl
+data "beecloud_volume" "vlm_by_id" {
+ volume_id = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
+}
+
+output "beecloud_volume_by_id" {
+ value = data.beecloud_volume.vlm_by_id
+}
+```
+
+## Аргументы
+- `volume_id` - ID диска.
+
+## Возвращаемые поля
+
+- `id` - ID TF. Соответствует ID диска.
+- `project_id` - ID проекта.
+- `region_id` - ID региона.
+- `name` - Наименование диска.
+- `size` - Размер диска.
+- `type` - Тип диска.
+- `is_boot` - Загрузочный/дополнительный (`true`, `false`).
+- `attached_to` - ID сервера, к которому примонтирован.
+- `last_updated` - Время последнего обновления ресурса.
diff --git a/src/terraform/providers/beecloud/compute/data-sources/beecloud_volumes.md b/src/terraform/providers/beecloud/compute/data-sources/beecloud_volumes.md
new file mode 100644
index 0000000..9ed1276
--- /dev/null
+++ b/src/terraform/providers/beecloud/compute/data-sources/beecloud_volumes.md
@@ -0,0 +1,31 @@
+---
+page_title: "beecloud: beecloud_volumes"
+description: "Get information about multiple beecloud Volumes of project"
+---
+
+# Источник данных: beecloud_volumes
+Получение информации обо всех дисках проекта.
+
+## Пример конфигурации
+
+```hcl
+data "beecloud_volumes" "all" {}
+
+output "beecloud_volumes_all" {
+ value = data.beecloud_volumes.all
+}
+```
+
+## Возвращаемые поля
+
+- `id` - ID TF. Соответствует ID/Slug проекта.
+- `volumes` - Список дисков.
+ - `volume_id` - ID диска.
+ - `project_id` - ID проекта.
+ - `region_id` - ID региона.
+ - `name` - Наименование диска.
+ - `size` - Размер диска.
+ - `type` - Тип диска.
+ - `is_boot` - Загрузочный/дополнительный (`true`, `false`).
+ - `attached_to` - ID сервера, к которому примонтирован.
+ - `last_updated` - Время последнего обновления ресурса.
\ No newline at end of file
diff --git a/src/terraform/providers/beecloud/compute/resources/beecloud_address_ip.md b/src/terraform/providers/beecloud/compute/resources/beecloud_address_ip.md
new file mode 100644
index 0000000..aa80e4c
--- /dev/null
+++ b/src/terraform/providers/beecloud/compute/resources/beecloud_address_ip.md
@@ -0,0 +1,35 @@
+---
+page_title: "beecloud: beecloud_address_ip"
+description: "Manages beecloud Address IPs"
+---
+
+# Ресурс: beecloud_address_ip
+Получение информации об адресах.
+
+Создание и управление адресами проекта в beecloud. Больше информации в [swagger](https://beecloud.vimpelcom.ru/api/v1/vps/swagger/index.html#/).
+
+Ресурс может быть создан/прочитан/удален.
+
+```hcl
+resource "beecloud_address_ip" "server_ip" {
+
+ region_id = "xxxx-xxxx-xxxx-xxxx"
+}
+```
+
+## Аргументы
+
+- `region` - (Обязательно) Данные о регионе.
+ - `id` - (Обязательно) ID региона.
+
+## В дополнение к приведенным выше аргументам, возвращаются следующие параметры:
+
+- `id` - ID в системе TF. Соответствует ID адреса.
+- `project_id` - ID проекта.
+- `name` - наименование адреса.
+- `address` - значение IP адреса.
+- `version` - версия адреса (UNKNOWN/4/6).
+- `status` - статус адреса (UNKNOWN/FREE/USED/RESERVED).
+- `purpose` - назначение адреса.
+- `type` - тип адреса (UNKNOWN/EXTERNAL/INTERNAL).
+- `metadata` - дополнительные управляющие параметры.
diff --git a/src/terraform/providers/beecloud/compute/resources/beecloud_affinity_group.md b/src/terraform/providers/beecloud/compute/resources/beecloud_affinity_group.md
new file mode 100644
index 0000000..3e3357c
--- /dev/null
+++ b/src/terraform/providers/beecloud/compute/resources/beecloud_affinity_group.md
@@ -0,0 +1,45 @@
+---
+page_title: "beecloud: beecloud_affinity_group"
+description: "Manages Affinity Groups of servers"
+---
+
+# Ресурс: beecloud_affinity_group
+Управление Аффинити-группами (группами размещения) серверов.
+Поддерживается создание/удаление/чтение/обновление (согласно API beecloud обновление поддерживается только для именования группы, остальные изменения повлекут пересоздание группы)
+
+Политики (согласно API beecloud): **affinity/soft-affinity/anti-affinity/soft-anti-affinity**
+
+## Примеры конфигураций
+### Основное
+
+```hcl
+resource "beecloud_affinity_group" "affinity_policy" {
+ region {
+ id = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
+ }
+ name = "tf-affinity-group"
+ policy = "affinity"
+}
+
+output "beecloud_affinity_group_policy" {
+ value = beecloud_affinity_group.affinity_policy
+}
+```
+
+## Аргументы
+
+- `name` - (Обязательно) Наименование сервера.
+- `policy` - (Обязательно) Политика группы (affinity/soft-affinity/anti-affinity/soft-anti-affinity).
+- `region` - (Обязательно) Данные о регионе.
+ - `id` - (Обязательно) ID региона.
+
+
+## В дополнение к приведенным выше аргументам, возвращаются следующие параметры:
+- `id` - ID в системе TF. Соответствует ID группы.
+- `affinity_group_id` - ID в системе TF. Соответствует ID группы.
+- `project_id` - ID проекта.
+- `region` - Данные о регионе.
+ - `id` - ID региона
+ - `slug` - Слаг региона.
+ - `name` - Наименование региона
+- `condition` - Состояние группы (статус) (готовность к использованию)
\ No newline at end of file
diff --git a/src/terraform/providers/beecloud/compute/resources/beecloud_server.md b/src/terraform/providers/beecloud/compute/resources/beecloud_server.md
new file mode 100644
index 0000000..a3c135d
--- /dev/null
+++ b/src/terraform/providers/beecloud/compute/resources/beecloud_server.md
@@ -0,0 +1,245 @@
+---
+page_title: "beecloud: beecloud_server"
+description: "Manages beecloud Instances"
+---
+
+# Ресурс: beecloud_server
+
+Создание и управление серверами проекта в beecloud. Больше информации в [swagger](https://beecloud.vimpelcom.ru/api/v1/vps/swagger/index.html).
+
+Ресурс может быть создан/прочитан/обновлен/удален.
+Обновляется только при монтировании/демонтировании доп.дисков или изменении тэгов, в остальных случаях - пересоздание.
+Для защиты от случайного пересоздания можно использовать `lifecycle`:
+
+```hcl
+resource "beecloud_server" "test" {
+
+ ...
+
+ lifecycle {
+ prevent_destroy = true
+ }
+}
+```
+
+Посмотреть текущее состояние ресурса:
+
+```bash
+$ terraform state show beecloud_server.test
+```
+
+## Примеры конфигураций
+
+```hcl
+resource "beecloud_server" "test" {
+ flavor {
+ id = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
+ }
+ image {
+ id = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
+ }
+ region {
+ id = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
+ }
+ name = "tf-create-server-test"
+
+ root_volume {
+ size = 40
+ type = "hdd"
+ }
+}
+
+output "beecloud_server_test" {
+ value = beecloud_server.test
+}
+```
+
+### С дополнительными дисками
+
+```hcl
+resource "beecloud_server" "test" {
+ flavor {
+ id = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
+ }
+ image {
+ id = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
+ }
+ region {
+ id = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
+ }
+ name = "tf-create-server-test"
+
+ root_volumes {
+ size = 40
+ type = "hdd"
+ }
+
+ additional_volume_ids = ["XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX", "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"]
+}
+```
+> Note: Поле с дисками может изменить состояние после использования ресурса `beecloud_volume`. Необходимо будет синхронизировать состояние.
+
+### С тэгами
+
+```hcl
+resource "beecloud_server" "test" {
+ flavor {
+ id = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
+ }
+ image {
+ id = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
+ }
+ region {
+ id = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
+ }
+ name = "tf-create-server-test"
+
+ root_volumes {
+ size = 40
+ type = "hdd"
+ }
+
+ additional_volume_ids = ["XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX", "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"]
+
+ tags = ["dev", "test"]
+}
+```
+
+### С управлением адресом
+Передается UUID адреса. Он может быть заранее создан ресурсом "beecloud_address_ip".
+
+```hcl
+resource "beecloud_server" "test" {
+ flavor {
+ id = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
+ }
+ image {
+ id = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
+ }
+ region {
+ id = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
+ }
+ name = "tf-create-server-test"
+
+ root_volumes {
+ size = 40
+ type = "hdd"
+ }
+
+ address = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
+}
+```
+
+### С аффинити-группой
+Передается UUID группы. Он может быть заранее создан ресурсом "beecloud_affinity_group".
+
+```hcl
+resource "beecloud_server" "test" {
+ flavor {
+ id = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
+ }
+ image {
+ id = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
+ }
+ region {
+ id = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
+ }
+ name = "tf-create-server-test"
+
+ root_volumes {
+ size = 40
+ type = "hdd"
+ }
+
+ affinity {
+ id = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
+ }
+}
+
+```
+
+>
+>~> **На заметку**: Для примонтирования/демонтирования есть два способа:
+>1. Использовать поле `additional_volume_ids`
+>2. Использовать ресурс `beecloud_volume_bind`
+>
+>Не использовать вместе!
+>
+
+
+## Аргументы
+
+- `name` - (Обязательно) Наименование сервера (должно быть уникальным).
+- `image` - (Обязательно) Данные об образе.
+ - `id` - (Обязательно) ID образа.
+- `region` - (Обязательно) Данные о регионе.
+ - `id` - (Обязательно) ID региона.
+- `flavor` - (Обязательно) Данные о тарифе.
+ - `id` - (Обязательно) ID тарифа.
+- `root_volume` - (Обязательно) Диски. Минимум один экземпляр для загрузочного диска.
+ - `size` - (Обязательно) Размер диска.
+ - `type` - (Обязательно) Тип диска.
+- `additional_volume_ids` - (Опционально) Список дополнительных (примонтированных) дисков.
+- `address` - (Опционально) Данные об адресе (Если нужно управлять адресом - лучше его отдельно выделить как ресурс и прописать его ID в сервере)
+ - `id` - ID адреса, с которым будет создан сервер
+- `tags` - (Опционально) Список тэгов.
+- `wait_completed` - (Опционально) По умолчанию: `true`. Этот ключ отвечает за ожидание полного создания сервера. Если переключить его в `false`, то ресурс не будет дожидаться полного создания сервера, сервер будет в статусе "Создается".
+- `affinity` - (Опционально) Данные об аффинити-группе
+ - `id` - ID аффинити-группы, с учетом правила которой будет создан сервер. Изменение ID повлечет пересоздание сервера.
+
+## В дополнение к приведенным выше аргументам, возвращаются следующие параметры:
+
+- `id` - ID в системе TF. Соответствует ID сервера.
+- `server_id` - ID созданного сервера.
+- `image` - Данные об образе.
+ - `slug` - Слаг образа.
+ - `name` - Имя образа.
+- `region` - Данные о регионе.
+ - `slug` - Слаг региона.
+ - `name` - Имя региона.
+- `flavor` - Данные о тарифе.
+ - `slug`- Слаг тарифа.
+ - `name` - Имя тарифа.
+- `root_volume` - (Обязательно) Диски. Минимум один экземпляр для загрузочного диска.
+ - `id` - ID загрузочного сервера.
+ - `is_boot` - Определение типа: загрузочный диск (`true`) или дополнительный (`false`). Загрузочный может быть только один.
+ - `name` - Имя диска (для загрузочных - наименование диска будет **`server_name`**`-boot`).
+- `addresses` - Адрес сервера.
+ - `id` - ID в системе TF. Соответствует ID адреса.
+ - `project_id` - ID проекта.
+ - `name` - наименование адреса.
+ - `address` - значение IP адреса.
+ - `version` - версия адреса (UNKNOWN/4/6).
+ - `status` - статус адреса (UNKNOWN/USED/RESERVED).
+
+
+ - `metadata` - дополнительные управляющие параметры.
+- `status` - Статус сервера (ACTIVE/BUILD/ERROR..).
+- `fqdn` - Имя домена.
+- `tags` - Список тэгов.
+- `affinity` - Данные об аффинити-группе
+ - `id` - ID аффинити-группы.
+ - `name` - Наименование группы
+ - `project_id` - ID проекта
+ - `policy` - политика группы (affinity/soft-affinity/anti-affinity/soft-anti-affinity)
+ - `condition` - Текущее состояние группы(статус)
+
+
+## Импорт
+
+Задаем конфигурацию, которая будет управлять импортом
+```
+resource "beecloud_server" "import_server" {}
+
+```
+Передаем ID существующего сервера, состояние которого хотим импортировать "75429417-2a18-435c-92fa-dae26dac4e3e":
+
+```bash
+$ terraform import beecloud_server.import_server 75429417-2a18-435c-92fa-dae26dac4e3e
+```
+
+Затем все параметры состояния записываем в конфигурацию и синхронизируем.
+
+
+
+
diff --git a/src/terraform/providers/beecloud/compute/resources/beecloud_volume.md b/src/terraform/providers/beecloud/compute/resources/beecloud_volume.md
new file mode 100644
index 0000000..0de6fa3
--- /dev/null
+++ b/src/terraform/providers/beecloud/compute/resources/beecloud_volume.md
@@ -0,0 +1,56 @@
+---
+page_title: "beecloud: beecloud_volume"
+description: "Manages beecloud Volumes"
+---
+
+# Ресурс: beecloud_volume
+
+Создание и управление дисками проекта в beecloud. Больше информации в [swagger](https://beecloud.vimpelcom.ru/api/v1/core/swagger/index.html).
+
+Ресурс может быть создан/прочитан/обновлен/удален.
+
+## Примеры конфигураций
+
+```hcl
+resource "beecloud_volume" "vlm" {
+ name = "vlm-added"
+ region_id = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
+ size = 34
+ type = "hdd"
+}
+
+output "beecloud_vlm" {
+ value = beecloud_volume.vlm
+}
+```
+
+## Параметры
+
+- `region_id` - (Обязательно) Данные о регионе.
+- `name` - Наименование диска.
+- `size` - Размер диска.
+- `type` - Тип диска.
+
+## В дополнение к приведенным выше параметрам, возвращаются следующие поля:
+
+- `id` - ID TF. Соответствует ID диска.
+- `volume_id` - ID диска.
+- `project_id` - ID проекта.
+- `is_boot` - Загрузочный/дополнительный (`true`, `false`).
+- `attached_to` - ID сервера, к которому примонтирован.
+- `last_updated` - Время последнего обновления ресурса.
+
+
+## Импорт
+
+Задаем конфигурацию, которая будет управлять импортом
+
+```
+resource "beecloud_volume" "import_volume" {}
+```
+
+Передаем ID существующего сервера, состояние которого хотим импортировать "75429417-2a18-435c-92fa-dae26dac4e3e":
+
+```bash
+$ terraform import beecloud_volume.import_volume 75429417-2a18-435c-92fa-dae26dac4e3e
+```
\ No newline at end of file
diff --git a/src/terraform/providers/beecloud/compute/resources/beecloud_volume_bind.md b/src/terraform/providers/beecloud/compute/resources/beecloud_volume_bind.md
new file mode 100644
index 0000000..e14c4ec
--- /dev/null
+++ b/src/terraform/providers/beecloud/compute/resources/beecloud_volume_bind.md
@@ -0,0 +1,53 @@
+---
+page_title: "beecloud: beecloud_volume_bind"
+description: "Manages beecloud Volumes (Attach/Detach to server)"
+---
+
+# Ресурс: beecloud_volume_bind
+
+Управление дисками проекта в beecloud. Больше информации в [swagger](https://beecloud.vimpelcom.ru/api/v1/core/swagger/index.html).
+
+Примонтировать/отмонтировать диск к/от сервера.
+
+Примонтировать диск к серверу:
+
+```bash
+$ terraform apply
+```
+
+Отмонтировать диск:
+
+```bash
+$ terraform destroy
+```
+
+## Примеры конфигураций
+
+```hcl
+resource "beecloud_volume_bind" "attach" {
+ volume_id = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
+ server_id = "YYYYYYYY-YYYY-YYYY-YYYY-YYYYYYYYYYYY"
+}
+
+output "attach_beecloud_volume" {
+ value = beecloud_volume_bind.attach
+}
+```
+
+## Параметры
+
+- `volume_id` - ID диска.
+- `server_id` - ID сервера.
+
+## В дополнение к приведенным выше параметрам, возвращаются следующие поля:
+
+- `id` - ID TF. Соответствует ID диска.
+- `region_id` - ID региона.
+- `project_id` - ID проекта.
+- `name` - Наименование диска.
+- `size` - Размер диска.
+- `type` - Тип диска.
+- `is_boot` - Загрузочный/дополнительный (`true`, `false`).
+- `attached_to` - ID сервера, к которому примонтирован.
+- `last_updated` - Время последнего обновления ресурса.
+
diff --git a/src/terraform/providers/beecloud/dns/data-sources/beecloud_dns_records.md b/src/terraform/providers/beecloud/dns/data-sources/beecloud_dns_records.md
new file mode 100644
index 0000000..9a16307
--- /dev/null
+++ b/src/terraform/providers/beecloud/dns/data-sources/beecloud_dns_records.md
@@ -0,0 +1 @@
+# Источник данных: vega_dns_records
\ No newline at end of file
diff --git a/src/terraform/providers/beecloud/dns/data-sources/beecloud_dns_zones.md b/src/terraform/providers/beecloud/dns/data-sources/beecloud_dns_zones.md
new file mode 100644
index 0000000..0aad191
--- /dev/null
+++ b/src/terraform/providers/beecloud/dns/data-sources/beecloud_dns_zones.md
@@ -0,0 +1,30 @@
+
+# Источник данных: vega_dns_zones
+Получение информации обо всех доступных зонах проекта
+
+## Пример конфигурации
+
+Получение всех зон
+
+```hcl
+data "vega_dns_zones" "all" {}
+
+output "vega_affinity_groups_all" {
+ value = data.vega_dns_zones.all
+}
+```
+
+
\ No newline at end of file
diff --git a/src/terraform/providers/beecloud/dns/resources/beecloud_dns_record.md b/src/terraform/providers/beecloud/dns/resources/beecloud_dns_record.md
new file mode 100644
index 0000000..1752a4f
--- /dev/null
+++ b/src/terraform/providers/beecloud/dns/resources/beecloud_dns_record.md
@@ -0,0 +1,47 @@
+---
+page_title: "beecloud: beecloud_dns_record"
+description: "Manages beecloud DNS records"
+---
+
+# Ресурс: beecloud_dns_record
+Управление dns записями.
+
+Создание и управление DNS записями проекта в beecloud. Больше информации в [swagger](https://beecloud.vimpelcom.ru/api/v1/dns/swagger/index.html#/).
+
+Ресурс может быть создан/прочитан/обновлен/удален.
+
+```hcl
+// Получение списка доступных зон
+data "beecloud_dns_zones" "local" {}
+
+locals {
+ // uuid первой зоны из списка
+ dns_zone_id = data.beecloud_dns_zones.local.dns_zones.0.zone_id
+}
+
+resource "beecloud_dns_record" "my-name" {
+ name = "service1"
+ ttl = 600
+ type = "CNAME"
+ zone_id = local.dns_zone_id
+ data = ["10.0.0.2"]
+ tags = ["tag1", "tag2"]
+}
+```
+
+## Аргументы
+
+- `zone_id` - (Обязательно) ID DNS зоны.
+- `name` - (Обязательно) Наименование.
+- `type` - (Обязательно) Тип записи `A`, `AAAA`, `CNAME`,`PTR`.
+- `data` - (Обязательно)
+- `ttl` - (Опционально) По умолчанию: 600.
+- `tags` - (Опционально) Набор тегов.
+
+## В дополнение к приведенным выше аргументам, возвращаются следующие параметры:
+
+- `id` - ID в системе TF. Соответствует ID адреса.
+- `project_id` - ID проекта.
+- `server_id` - ID сервера, к которому относится запись.
+
+
\ No newline at end of file
diff --git a/src/terraform/providers/beecloud/index.md b/src/terraform/providers/beecloud/index.md
new file mode 100644
index 0000000..19bedd1
--- /dev/null
+++ b/src/terraform/providers/beecloud/index.md
@@ -0,0 +1,80 @@
+---
+page_title: "Provider: BeeCloud"
+description: |-
+ The BeeCloud provider is used to manage BeeCloud resources. The provider needs to be configured with the proper credentials before it can be used.
+---
+
+# BeeCloud Provider
+
+BeeCloud провайдер используется для управления ресурсами облака.
+Перед использованием провайдер должен быть настроен.
+
+## Terraform v.1.3.7 and later
+```
+terraform {
+ required_providers {
+ beecloud = {
+ source = "console.cloud.dfcloud.ru/beeline/beecloud"
+ }
+ }
+}
+```
+
+## Пример конфигурации
+
+```
+terraform {
+ required_providers {
+ beecloud = {
+ source = "console.cloud.dfcloud.ru/beeline/beecloud"
+ }
+ }
+}
+
+provider "beecloud" {
+ project = "my-project"
+ token = "eafJKHnldkfbs.....sLbldfblhb"
+}
+```
+
+## Аутентификация и Конфигурация
+
+Конфигурация провайдера BeeCloud может быть получена из нескольких источников, которые применяются в следующем порядке:
+
+* Параметры из конфигурации провайдера
+* Из переменных среды
+* Файлы общей конфигурации
+
+### Конфигурация провайдера
+
+Используя сервисный токен проекта:
+
+> Получить JWT токен(роль DevOps-инженер) https://console.cloud.dfcloud.ru/projects/{PROJECT}/service-token
+
+```hcl
+provider "beecloud" {
+ token = "eafJKHnldkfbs.....sLbldfblhb"
+ project = "my-project"
+}
+```
+
+### Переменные окружения
+
+```hcl
+provider "beecloud" {}
+```
+
+Используя сервисный токен проекта:
+```sh
+$ export BEECLOUD_TOKEN="eafJKHnldkfbs.....sLbldfblhb"
+$ export BEECLOUD_PROJECT="my-project"
+```
+
+
+## Параметры конфигурации
+
+| Настройка | В провайдере | Переменная окружения |
+|------------------------------------------------------------------------|--------------|----------------------|
+| Идентификатор проекта | project | BEECLOUD_PROJECT |
+| Сервисный токен проекта | token | BEECLOUD_TOKEN |
+| URL платформы значение по умолчанию "https://console.cloud.dfcloud.ru" | url | BEECLOUD_API |
diff --git a/src/terraform/providers/null/data-sources/null_data_source.md b/src/terraform/providers/null/data-sources/null_data_source.md
new file mode 100644
index 0000000..e69de29
diff --git a/src/terraform/providers/null/index.md b/src/terraform/providers/null/index.md
new file mode 100644
index 0000000..b0ca7ab
--- /dev/null
+++ b/src/terraform/providers/null/index.md
@@ -0,0 +1,25 @@
+# Null Provider
+
+Null provider - довольно необычный поставщик, у которого есть конструкции, которые намеренно ничего не делают. Это может показаться странным, и действительно, в большинстве случаев эти конструкции не обязательно использовать, но они могут быть полезны в различных ситуациях, чтобы помочь организовать сложное поведение или обойти ограничения.
+
+Документация по каждой функции этого поставщика, доступная через навигацию, содержит примеры ситуаций, в которых эти конструкции могут оказаться полезными.
+
+Использование нулевого поставщика может усложнить понимание конфигурации Terraform. Хотя в некоторых случаях это может быть полезно, применять его следует с осторожностью, а при наличии других решений отдавать предпочтение.
+
+Полная копия провайдера [hashicorp/null](https://github.com/hashicorp/terraform-provider-null)
+
+## Пример конфигурации
+
+```
+terraform {
+ required_providers {
+ null = {
+ source = "console.cloud.dfcloud.ru/beeline/null"
+ }
+ }
+}
+
+provider "null" {
+ # Параметры конфигурации
+}
+```
diff --git a/src/terraform/providers/null/resources/null_resource.md b/src/terraform/providers/null/resources/null_resource.md
new file mode 100644
index 0000000..e69de29
diff --git a/src/terraform/quick-start.md b/src/terraform/quick-start.md
new file mode 100644
index 0000000..ac889ec
--- /dev/null
+++ b/src/terraform/quick-start.md
@@ -0,0 +1,236 @@
+# Terraform
+
+[SDK](https://git.vimpelcom.ru/common/vega)
+
+[Пример разворачивания веб-приложения в Docker с помощью Terraform](https://bwiki.beeline.ru/x/j9bNFQ)
+
+[FAQ](faq.md)
+
+
\ No newline at end of file