chore: удалить generated/test/docs/ из git
This commit is contained in:
Naeel
@@ -1,25 +0,0 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
|
||||
<!-- Creator: CorelDRAW -->
|
||||
<svg xmlns="http://www.w3.org/2000/svg" xml:space="preserve" width="82.3711mm" height="18.2443mm" version="1.1" style="shape-rendering:geometricPrecision; text-rendering:geometricPrecision; image-rendering:optimizeQuality; fill-rule:evenodd; clip-rule:evenodd"
|
||||
viewBox="0 0 8221.93 1821.07"
|
||||
xmlns:xlink="http://www.w3.org/1999/xlink"
|
||||
xmlns:xodm="http://www.corel.com/coreldraw/odm/2003">
|
||||
<defs>
|
||||
<style type="text/css">
|
||||
<![CDATA[
|
||||
.fil0 {fill:#001C34}
|
||||
]]>
|
||||
</style>
|
||||
</defs>
|
||||
<g id="Слой_x0020_1">
|
||||
<metadata id="CorelCorpID_0Corel-Layer"/>
|
||||
<g id="_2283355517888">
|
||||
<path class="fil0" d="M477.49 479.69l-413.51 0 -63.98 276.48 178.44 0 1.17 1028.71 0 26.75 0.03 0 276.39 0 0 -871.72c0,-101.28 82.43,-183.69 183.75,-183.69l589.25 3.44c101.34,0 183.76,82.46 183.76,183.74l0 871.72 276.44 0 0 -871.72c0,-253.77 -206.46,-460.15 -460.05,-460.15l-589.52 -3.53 -162.17 0.45 0 -0.48z"/>
|
||||
<path class="fil0" d="M6664.65 1813.37l1181.04 0c212.14,0 376.24,-175.01 376.24,-387.08 0,-212.13 -172.55,-384.68 -384.69,-384.68l-653.66 0c-60.22,0 -109.16,-48.94 -109.16,-109.18l0 -66.18c0,-60.19 48.94,-109.14 109.16,-109.14l695.76 0 63.74 -275.49 -759.5 0c-212.13,0 -384.66,172.53 -384.66,384.63l0 66.18c0,212.13 172.53,384.67 384.66,384.67l653.66 0c60.2,0 109.2,49 109.2,109.19 0,60.13 -49,116.1 -109.2,116.1l-1118.9 0 -53.68 270.98z"/>
|
||||
<path class="fil0" d="M6200.79 483.5l-723.21 0c-215.88,0 -391.47,175.6 -391.47,391.51l0 485.5c0,248.38 202.05,450.4 450.4,450.4l989.38 0 62.13 -268.51 -1051.51 0c-96.41,0 -174.95,-85.37 -174.95,-181.88l-1.5 -39.46 923.62 0 308.51 -1.84 0 -237.95 0 -206.26c0,-215.91 -175.59,-391.51 -391.41,-391.51zm115.96 560.28l-955.19 0 0 -168.77c0,-63.96 52.07,-116.05 116.02,-116.05l723.21 0c63.91,0 115.96,52.08 115.96,116.05l0 168.77z"/>
|
||||
<path class="fil0" d="M4683.49 1194.24l0 168.28c0,100.92 -81.7,178.37 -182.67,178.37l-589.87 1.23c-93.18,0 -170.28,-69.96 -181.63,-160.09l0 -458.13c11.36,-90.1 88.46,-160.07 181.63,-160.07l589.44 3.5c100.97,0 183.1,82.18 183.1,183.1l0 30.42 0 213.4zm-1230.2 -345.53l-0.89 -795.03 276.91 -53.68 0 526.07c55.74,-24.16 117.03,-37.74 181.5,-37.74l589.71 3.5c252.69,0 458.42,205.72 458.42,458.59l0 30.42 0 213.4 0 168.28c0,252.86 -205.73,458.54 -458.42,458.54l-589.71 -3.5c-252.7,0 -458.41,-205.67 -458.41,-458.56l0 -171.61 0 -240.48 0.89 -98.2z"/>
|
||||
<path class="fil0" d="M3041.25 1150.84l0 204.28c0,100.93 -82.15,183.05 -183.11,183.05l-582.11 -3.46c-100.96,0 -183.11,-82.16 -183.11,-183.08l0 -67.42 1.48 0.24 0 -862.65 -276.91 53.68 0.12 103.41 -0.12 0.04 0 772.69c0,252.87 205.72,458.54 458.39,458.54l582.4 3.5c252.67,0 458.4,-205.68 458.4,-458.55l0 -70.79 0.71 0.12 0 -862.65 -276.91 53.68 0.76 675.35z"/>
|
||||
</g>
|
||||
</g>
|
||||
</svg>
|
||||
|
Before Width: | Height: | Size: 2.8 KiB |
@@ -1,55 +0,0 @@
|
||||
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
|
||||
<svg
|
||||
width="57"
|
||||
height="57"
|
||||
xml:space="preserve"
|
||||
overflow="hidden"
|
||||
version="1.1"
|
||||
id="svg8"
|
||||
sodipodi:docname="U_v3.svg"
|
||||
inkscape:version="1.3.2 (091e20e, 2023-11-25, custom)"
|
||||
xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
|
||||
xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
|
||||
xmlns="http://www.w3.org/2000/svg"
|
||||
xmlns:svg="http://www.w3.org/2000/svg"><sodipodi:namedview
|
||||
id="namedview8"
|
||||
pagecolor="#ffffff"
|
||||
bordercolor="#000000"
|
||||
borderopacity="0.25"
|
||||
inkscape:showpageshadow="2"
|
||||
inkscape:pageopacity="0.0"
|
||||
inkscape:pagecheckerboard="0"
|
||||
inkscape:deskcolor="#d1d1d1"
|
||||
inkscape:zoom="16.226667"
|
||||
inkscape:cx="27.146672"
|
||||
inkscape:cy="28.317584"
|
||||
inkscape:window-width="2560"
|
||||
inkscape:window-height="1494"
|
||||
inkscape:window-x="-11"
|
||||
inkscape:window-y="-11"
|
||||
inkscape:window-maximized="1"
|
||||
inkscape:current-layer="svg8" /><defs
|
||||
id="defs2"><clipPath
|
||||
id="clip0"><rect
|
||||
x="652"
|
||||
y="420"
|
||||
width="64"
|
||||
height="75"
|
||||
id="rect1" /></clipPath><clipPath
|
||||
id="clip1"><rect
|
||||
x="652"
|
||||
y="420"
|
||||
width="64"
|
||||
height="70"
|
||||
id="rect2" /></clipPath></defs><g
|
||||
clip-path="url(#clip0)"
|
||||
transform="matrix(1.0135748,0,0,1.0135748,-664.97034,-440.30567)"
|
||||
id="g8"><g
|
||||
clip-path="url(#clip1)"
|
||||
id="g7"><g
|
||||
id="g6"><path
|
||||
d="m 114.028,43.1492 v 7.6592 c 0,3.7843 -3.08,6.8632 -6.866,6.8632 L 85.3367,57.5419 c -3.7853,0 -6.8655,-3.0805 -6.8655,-6.8643 v -2.5279 l 0.0555,0.009 V 15.8148 l -10.3823,2.0127 0.0045,3.8772 -0.0045,0.0015 v 28.971 c 0,9.481 7.7132,17.1923 17.1867,17.1923 l 21.8359,0.1313 c 9.474,0 17.187,-7.7117 17.187,-17.1928 v -2.6541 l 0.027,0.0045 V 15.8145 l -10.382,2.0126 0.028,25.3214 z"
|
||||
fill="#001c34"
|
||||
fill-rule="evenodd"
|
||||
transform="matrix(1,0,0,1.01337,587.92,420.059)"
|
||||
id="path6" /></g></g></g></svg>
|
||||
|
Before Width: | Height: | Size: 2.0 KiB |
@@ -1,291 +0,0 @@
|
||||
# Начало работы с Nubes Terraform (TEST)
|
||||
|
||||
Это руководство поможет вам установить Terraform и развернуть первую инфраструктуру в облаке Nubes (тестовый стенд).
|
||||
|
||||
## 0. Установка Terraform
|
||||
|
||||
Версия 1.0 или выше.
|
||||
|
||||
1. **Скачать**: [hashicorp.com/terraform/install](https://developer.hashicorp.com/terraform/install) или [Yandex Cloud Mirror](https://hashicorp-releases.yandexcloud.net/terraform/) (без VPN)
|
||||
2. **Установить**: распаковать, положить `terraform` в `PATH`
|
||||
3. **Проверить**: `terraform -version`
|
||||
|
||||
---
|
||||
|
||||
## 1. Конфигурация провайдера
|
||||
|
||||
Создайте `main.tf`:
|
||||
|
||||
```hcl
|
||||
terraform {
|
||||
required_providers {
|
||||
nubes = {
|
||||
source = "registry.kube5s.ru/nubes-test/nubes"
|
||||
version = "5.1.2"
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
provider "nubes" {
|
||||
api_endpoint = "https://lk-api-gateway-test.ngcloud.ru/api/v1/svc"
|
||||
api_token = var.api_token
|
||||
}
|
||||
|
||||
variable "api_token" {
|
||||
type = string
|
||||
sensitive = true
|
||||
}
|
||||
```
|
||||
|
||||
!!! info "TEST стенд"
|
||||
- Личный кабинет: [https://deck-test.ngcloud.ru/dashboard/](https://deck-test.ngcloud.ru/dashboard/)
|
||||
- API: `https://lk-api-gateway-test.ngcloud.ru/api/v1/svc`
|
||||
|
||||
!!! tip "Безопасность"
|
||||
Не храните токен в `main.tf`. Используйте `terraform.tfvars` или переменные окружения.
|
||||
|
||||
---
|
||||
|
||||
## 2. Получение API токена
|
||||
|
||||
1. Зайдите в Личный кабинет → Профиль → Токены
|
||||
2. Нажмите «Выпустить тех-токен»
|
||||
3. **Сохраните токен** — он показывается только один раз
|
||||
|
||||
Создайте `terraform.tfvars`:
|
||||
|
||||
```hcl
|
||||
api_token = "eyJhbGciOi..." # Ваш токен
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. Команды Terraform
|
||||
|
||||
### `terraform init`
|
||||
Загружает провайдер. Выполняется **один раз** при старте проекта. При смене версии — `terraform init -upgrade`.
|
||||
|
||||
```bash
|
||||
terraform init
|
||||
```
|
||||
|
||||
### `terraform plan`
|
||||
Показывает что будет создано/изменено/удалено. Безопасно, ничего не меняет.
|
||||
|
||||
```bash
|
||||
terraform plan
|
||||
```
|
||||
|
||||
### `terraform apply`
|
||||
Применяет изменения. Создаёт/меняет/удаляет ресурсы в облаке.
|
||||
|
||||
```bash
|
||||
terraform apply
|
||||
# или сразу без подтверждения:
|
||||
terraform apply -auto-approve
|
||||
```
|
||||
|
||||
### `terraform destroy`
|
||||
Удаляет ВСЕ ресурсы из манифеста.
|
||||
|
||||
```bash
|
||||
terraform destroy
|
||||
```
|
||||
|
||||
!!! warning "Suspend vs Destroy"
|
||||
По умолчанию `terraform destroy` **не удаляет** инстанс — переводит в `Suspend`. См. раздел 5.
|
||||
|
||||
### `terraform state list` / `terraform state show`
|
||||
Просмотр ресурсов под управлением Terraform.
|
||||
|
||||
```bash
|
||||
terraform state list
|
||||
terraform state show nubes_postgres.baza
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. Примеры ресурсов
|
||||
|
||||
### PostgreSQL
|
||||
|
||||
Скопируйте из [примера PostgreSQL](postgres_example.md) — заполните `TODO` своими значениями.
|
||||
|
||||
```hcl
|
||||
resource "nubes_postgres" "baza" {
|
||||
resource_name = "pg-tst01"
|
||||
|
||||
cluster_configuration {
|
||||
cpu = 500
|
||||
memory = 512
|
||||
replicas = 1
|
||||
disk = 10
|
||||
}
|
||||
|
||||
startup_configuration {
|
||||
resource_realm = "k8s-3-sandbox-nubes-ru"
|
||||
}
|
||||
|
||||
access_configuration {
|
||||
master_access_list = jsonencode(["10.0.0.0/8"])
|
||||
master_ip_space = "no-needed"
|
||||
slave_access_list = jsonencode([])
|
||||
slave_ip_space = "no-needed"
|
||||
}
|
||||
|
||||
postgres_configuration {
|
||||
version = "17"
|
||||
ssl_required = true
|
||||
pooler_master = false
|
||||
pooler_slave = false
|
||||
}
|
||||
|
||||
backup_configuration {
|
||||
s3_uid = "UUID-вашего-S3" # Обязательно
|
||||
retain = 7
|
||||
schedule = "0 0 * * *"
|
||||
}
|
||||
|
||||
autoscale_configuration {
|
||||
enabled = false
|
||||
schedule = 0
|
||||
percent = 10
|
||||
quota = 100
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### S3 Bucket
|
||||
|
||||
```hcl
|
||||
resource "nubes_s3bucket" "my_files" {
|
||||
resource_name = "bucket_0"
|
||||
bucket_name = "my-unique-bucket-name"
|
||||
s3_user_uid = "UUID-вашего-S3"
|
||||
}
|
||||
```
|
||||
|
||||
Подробные примеры — в разделе **Ресурсы** (левое меню), вкладка **Example** у каждого ресурса.
|
||||
|
||||
---
|
||||
|
||||
## 5. Suspend, Adopt и жизненный цикл
|
||||
|
||||
Провайдер **не удаляет** инстансы при `terraform destroy` по умолчанию. Вместо этого переводит в `Suspend`.
|
||||
|
||||
### `suspend_on_destroy` (по умолчанию `true`)
|
||||
|
||||
| Значение | `terraform destroy` | Удаление из манифеста |
|
||||
|----------|--------------------|-----------------------|
|
||||
| `true` | Инстанс → `Suspend` | Инстанс → `Suspend` |
|
||||
| `false` | Только удаление из state | Только удаление из state |
|
||||
|
||||
### `adopt_existing_on_create` (по умолчанию `false`)
|
||||
|
||||
| Значение | Поведение при `apply` |
|
||||
|----------|-----------------------|
|
||||
| `false` | Если инстанс уже есть → ошибка |
|
||||
| `true` | `running` → adopt под управление; `suspended` + совпадение параметров → resume + adopt |
|
||||
|
||||
### `operation_timeout`
|
||||
|
||||
Таймаут ожидания операции. По умолчанию `"10m"`. Для долгих операций можно увеличить:
|
||||
|
||||
```hcl
|
||||
operation_timeout = "15m"
|
||||
```
|
||||
|
||||
!!! warning "Один инстанс — один state"
|
||||
Не подключайте один инстанс к двум манифестам — получите конфликт управления.
|
||||
|
||||
---
|
||||
|
||||
## 6. Связка сервисов (Lucee + PostgreSQL)
|
||||
|
||||
```hcl
|
||||
resource "nubes_postgres" "db2" {
|
||||
resource_name = "pg-tst0"
|
||||
|
||||
startup_configuration {
|
||||
resource_realm = "k8s-3-sandbox-nubes-ru"
|
||||
}
|
||||
|
||||
cluster_configuration {
|
||||
cpu = 500
|
||||
memory = 512
|
||||
replicas = 1
|
||||
disk = 10
|
||||
}
|
||||
|
||||
access_configuration {
|
||||
master_access_list = jsonencode(["10.0.0.0/8"])
|
||||
master_ip_space = "no-needed"
|
||||
slave_access_list = jsonencode([])
|
||||
slave_ip_space = "no-needed"
|
||||
}
|
||||
|
||||
postgres_configuration {
|
||||
version = "17"
|
||||
ssl_required = true
|
||||
pooler_master = false
|
||||
pooler_slave = false
|
||||
}
|
||||
|
||||
backup_configuration {
|
||||
s3_uid = "UUID-вашего-S3"
|
||||
retain = 7
|
||||
schedule = "0 0 * * *"
|
||||
}
|
||||
|
||||
autoscale_configuration {
|
||||
enabled = false
|
||||
schedule = 0
|
||||
percent = 10
|
||||
quota = 100
|
||||
}
|
||||
}
|
||||
|
||||
resource "nubes_lucee" "app1" {
|
||||
resource_name = "lucy1"
|
||||
resource_realm = nubes_postgres.db2.startup_configuration.resource_realm
|
||||
domain = "web03"
|
||||
git_path = "https://github.com/user/repo.git"
|
||||
|
||||
json_env = jsonencode({
|
||||
testds_class = "org.postgresql.Driver"
|
||||
testds_bundleName = "org.postgresql.jdbc"
|
||||
testds_bundleVersion = "42.6.0"
|
||||
testds_connectionString = "jdbc:postgresql://$${nubes_postgres.db2.state_out_flat[\"internalConnect.master\"]}:5432/postgres"
|
||||
testds_username = nubes_postgres.db2.vault_secrets["adminUser"]
|
||||
testds_password = nubes_postgres.db2.vault_secrets["adminPass"]
|
||||
})
|
||||
|
||||
app_version = "5.4"
|
||||
|
||||
depends_on = [nubes_postgres.db2]
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 7. Типичный рабочий процесс
|
||||
|
||||
```bash
|
||||
# 1. Клонируем/создаём проект
|
||||
mkdir my-infra && cd my-infra
|
||||
|
||||
# 2. Создаём main.tf (скопировать из примера выше)
|
||||
# 3. Создаём terraform.tfvars с токеном
|
||||
|
||||
# 4. Инициализация
|
||||
terraform init
|
||||
|
||||
# 5. Проверка плана
|
||||
terraform plan
|
||||
|
||||
# 6. Применение
|
||||
terraform apply
|
||||
|
||||
# 7. При необходимости — удаление
|
||||
terraform destroy
|
||||
```
|
||||
Reference in New Issue
Block a user