VK Cloud logo

display.yaml файлыBeta

display.yaml конфигурациялық файлы тарифтік жоспардың сіздің қосымшаңыздың тарифтік жоспарлар матрицасында қалай көрсетілетінін сипаттайды.

Файлдың негізгі секциялары:

Аты

Сипаттамасы

Форматы

Міндетті

pages

Тарифтік жоспарды баптау шеберінің бірінші және соңғы беттерден басқа барлық беттерін сипаттайды.

Параметр көрсетілмесе, баптау шебері тек автоматты түрде қалыптастырылатын беттерден тұрады

Массив

display.yaml файлы

entities

Тарифтеленетін VK Cloud инфрақұрылым элементтерін сипаттайды:

  • ВМ;

жүктеме балансировщиктері;

  • сыртқы IP-мекенжайлар.

Тарифтік жоспарды баптау шеберінде осы элементтердің құны көрсетіледі. Ол VK Cloud тарифтеріне сәйкес автоматты түрде есептеледі

Массив

Массив pages

Массив тарифтік жоспар үшін конфигурациялау шеберінің беттерін сипаттайды. Әр бетте тарифтік опциялардың бір немесе бірнеше тобы көрсетіледі. Беттердің максималды саны — 5.

pages массивінің параметрлері:

Атауы

Сипаттамасы

Форматы

Міндетті

name

Конфигурациялау шебері бетінің атауы, 32 таңбадан аспайды

string

display.yaml файлы

groups

Конфигурациялау шеберінің нақты бетінде көрсетілетін тарифтік опциялар топтары

Массив

display.yaml файлы

groups.name

Тарифтік опциялар тобының атауы, 255 таңбадан аспайды

string

display.yaml файлы

groups.parameters

Топқа кіретін тарифтік опциялардың атауларының тізімі.

Тізім, тізім элементі — string

display.yaml файлы

groups.parameters.name

Осы опцияның YAML-файлының атауымен сәйкес келетін тарифтік опцияның атауы: <ОПЦИЯ_АТЫ>.

string

display.yaml файлы

Әдепкі бойынша тарифтік жоспарды конфигурациялау шеберінде pages массивінде көрсетілген тарифтік опциялар топтарының (groups) барлығы көрсетіледі. Шарттарға байланысты топтарды көрсету немесе жасыру үшін when құрылымы пайдаланылады.

Төменде осы мысалдан алынған тарифтік жоспарды баптау шеберінің қалай көрсетілетіні берілген.

pic1

Массив entities

Массив тарифтік жоспар шеңберінде тарифтелетін VK Cloud инфрақұрылымының элементтерін сипаттайды.

Әдепкі бойынша тарифтік жоспарды конфигурациялау шеберінде entities массивінде сипатталған инфрақұрылымның барлық элементтерінің құны көрсетіледі. Шарттарға байланысты инфрақұрылым құнын көрсету немесе жасыру үшін when құрылымы пайдаланылады.

entities массивінің жалпы параметрлері:

Атауы

Сипаттамасы

Форматы

Міндетті

entity

Инфрақұрылым элементінің түрі:

  • vm — ВМ.
  • load_balancing — жүктеме балансирлеуші.
  • floating_ip — сыртқы IP-мекенжай.

string

display.yaml файлы

description

Инфрақұрылым элементінің сипаттамасы

string

display.yaml файлы

Сервисті баптау бетін тарифтік жоспарды конфигурациялау шеберінде сипаттау мысалы:

pages:- name: Сервисті баптау # Бет атауы  groups:  - name: Сервер # Тарифтік опциялар тобының атауы    parameters:    - name: network # Тарифтік опция атауы    - name: vm    - name: az  - name: Жүйелік диск    parameters:    - name: volume_size    - name: volume_type

ВМ

ВМ үшін entities массивінің параметрлері:

Атауы

Сипаттамасы

Форматы

Міндетті

count

ВМ саны, const немесе param параметрімен беріледі

Секция

display.yaml файлы

count.const

ВМ саны

integer

—

count.param

Мәні ВМ санын анықтайтын тарифтік опцияның атауы (<ОПЦИЯ_АТЫ>)

string

—

flavor

ВМ түрі, const немесе param параметрімен беріледі

Секция

display.yaml файлы

flavor.const

ВМ конфигурациясы үлгісінің ID

string

—

flavor.param

ВМ түрін сипаттайтын тарифтік опцияның атауы (<ОПЦИЯ_АТЫ>): datasource.type = flavor

string

—

disks

ВМ дисктері. Әр диск type және size секцияларымен сипатталады

Массив

display.yaml файлы, егер pages массивінде datasource.type = volume_type түріндегі опция көрсетілсе

disks.type

Диск түрі, const немесе param параметрімен беріледі

Секция

—

disks.type.const

Диск түрі.

Мүмкін мәндер:

  • ceph-ssd — SSD түріндегі диск.
  • ceph-hdd — HDD түріндегі диск.
  • high-iops — High-IOPS SSD түріндегі диск (жоғары өнімді SSD).

string

—

disks.type.param

Диск түрін сипаттайтын тарифтік опцияның атауы (<ОПЦИЯ_АТЫ>): datasource.type = volume_type

string

—

disks.size

Диск өлшемі, const немесе param параметрімен беріледі

Секция

—

disks.size.const

Диск өлшемі

integer

—

disks.size.param

Мәні диск өлшемін анықтайтын тарифтік опцияның атауы (<ОПЦИЯ_АТЫ>)

string

—

Тарифтік жоспарды конфигурациялау шебері үшін ВМ сипаттамасының мысалы:

entities:  - entity: vm    description: Виртуалды машина    count:      const: 1    flavor:      param: ds-flavor # Тарифтік опция атауы    disks:      - type:          param: root_type        size:          param: root_size      - type:          param: data_type        size:          param: data_size

Төменде осы мысалдан алынған инфрақұрылым құны туралы ақпараттың тарифтік жоспарды баптау шеберінде қалай көрсетілетіні берілген.

pic1

Жүктеме балансировщигі

Жүктеме балансирлеуші үшін entities массивінің параметрлері:

Атауы

Сипаттамасы

Форматы

Міндетті

count

Жүктеме балансирлеушілерінің саны, const немесе param параметрімен беріледі

Секция

display.yaml файлы

count.const

Балансирлеушілер саны

integer

—

count.param

Мәні балансирлеушілер санын анықтайтын тарифтік опцияның атауы (<ОПЦИЯ_АТЫ>)

string

—

Тарифтік жоспарды конфигурациялау шебері үшін жүктеме балансирлеушінің сипаттамасының мысалы:

entities:  - entity: load_balancing    count:      param: number_balancing # Тарифтік опция атауы

Сыртқы IP-мекенжай

Сыртқы IP-мекенжай үшін entities массивінің параметрлері:

Атауы

Сипаттамасы

Форматы

Міндетті

count

Сыртқы IP-мекенжайлардың саны, const немесе param параметрімен беріледі

Секция

display.yaml файлы

count.const

Сыртқы IP-мекенжайлар саны

integer

—

count.param

Мәні сыртқы IP-мекенжайлар санын анықтайтын тарифтік опцияның атауы (<ОПЦИЯ_АТЫ>)

string

—

Тарифтік жоспарды конфигурациялау шебері үшін сыртқы IP-мекенжайдың сипаттамасының мысалы:

entities:  - entity: floating_ip    count:      const: 1

when құрылымы

when құрылымы тарифтік жоспар шеберін көрсету кезіндегі шартты тармақталуды басқарады. Ол мыналарды қамтиды:

  • Шарт түрі:

    • when.in — key және values параметрлерінде берілген мәндердің теңдігін тексеру. key мәні values мәндерінің кем дегенде біреуіне тең болса, шарт орындалады.
    • when.not_in — key және values параметрлерінде берілген мәндердің тең еместігін тексеру. key мәні values мәндерінің ешқайсысына тең болмаса, шарт орындалады.
  • Өлшемшарттар. key және values параметрлерінің бірімен беріледі:

    • param параметрі арқылы — нақты тарифтік опцияның мәнін пайдалану үшін.
    • const параметрі арқылы — тіркелген мәнді пайдалану үшін.

    key ішінде бір мән, values ішінде бір немесе бірнеше мән көрсетуге болады.

YAML форматындағы when құрылымы:

when:  in: # немесе not_in    key:      param: <ОПЦИЯ_АТЫ> # немесе const: <МӘН>    values:      - const: <МӘН>      - param: <ОПЦИЯ_АТЫ>      ...

Мұндағы:

  • <ОПЦИЯ_АТЫ> — осы опцияның YAML-файлының атауымен сәйкес келетін тарифтік опцияның атауы.
  • <МӘН> — тіркелген мән.

when құрылымы pages массивінде

pages массивінде when құрылымы тарифтік жоспарды конфигурациялау шеберінде тарифтік опциялар тобын көрсету қажет пе екенін анықтайтын шартты беру үшін пайдаланылады.

Бір тарифтік опция әртүрлі топтардағы when құрылымдарында пайдаланылуы мүмкін. Тарифтік опцияның мәніне байланысты конфигурациялау шеберінде сол немесе басқа топтар көрсетіледі.

when құрылымы пайдаланылғанда, мына шарттар бір мезгілде орындалса, тарифтік опциялар топтары бар бет жасырылады:

  • Бір бет шеңберінде барлық топтарда when құрылымы бар.
  • Тарифтік жоспарды конфигурациялау шеберінде осы беттегі барлық топтардың шарттары орындалмайтындай тарифтік опция мәндері берілген.

pages массивінде when құрылымын пайдалану мысалы:

pages:- name: Бекап баптаулары # Бет атауы  groups:  - name: High-frequency бекап # Тарифтік опциялар тобының атауы    parameters:    - name: frequency_per_day # Тарифтік опция атауы    when:      in:        key:          param: backup_method # Тарифтік опция атауы        values:          - const: high-frequency

Бұл мысалда пайдаланушы конфигурациялау шеберінде backup_method тарифтік опциясы үшін high-frequency мәнін таңдаса, frequency_per_day тарифтік опциясы бар High-frequency бекап тобы көрсетіледі. Содан кейін пайдаланушы бекап жасау жиілігін таңдай алады.

backup_method тарифтік опциясы:

  • басқа топтардағы when құрылымында пайдаланылуы мүмкін;
  • басқа топтың parameters массивінде көрсетілуі тиіс.

frequency_per_day тарифтік опциясы басқа топтарда пайдаланылмауы мүмкін:

  • when құрылымында — себебі шарттар иерархиясының тек бір деңгейіне қолдау көрсетіледі;
  • parameters ішінде — себебі бір тарифтік опция тек бір топта ғана көрсетілуі мүмкін.

when құрылымы entities массивінде

entities массивінде when құрылымы entities массивінде сипатталған инфрақұрылым элементінің құнын тарифтік жоспарды конфигурациялау шеберінде көрсету қажет пе екенін анықтайтын шартты беру үшін пайдаланылады.

entities массивінде when құрылымын пайдалану мысалы:

entities:  - entity: vm    description: alkair_software    when:      in:        key:          param: need_install_alkair_software # Тарифтік опция атауы        values:          - const: true    flavor:      const: 6a7a0690-943a-4921-936e-2849970ccfba # ВМ түрі (CPU, RAM). Бұл мысалда 2 CPU және 3 ГБ RAM бар ВМ    count:      const: 1    disks:      - type:          const: high-iops # Диск түрі        size:          const: 500 # Диск өлшемі

Бұл мысалда Алькаир БҚ үшін ВМ құнын көрсету баптамасы берілген. Егер пайдаланушы need_install_alkair_software тарифтік опциясы үшін true мәнін таңдаса, тарифтік жоспарды конфигурациялау шеберінде entities.entity элементінде сипатталған ВМ құны көрсетіледі.

pic1
Мақала пайдалы болды ма?