display.yaml файлыBeta
display.yaml конфигурациялық файлы тарифтік жоспардың сіздің қосымшаңыздың тарифтік жоспарлар матрицасында қалай көрсетілетінін сипаттайды.
Файлдың негізгі секциялары:
Аты | Сипаттамасы | Форматы | Міндетті |
|---|---|---|---|
| Тарифтік жоспарды баптау шеберінің бірінші және соңғы беттерден басқа барлық беттерін сипаттайды. Параметр көрсетілмесе, баптау шебері тек автоматты түрде қалыптастырылатын беттерден тұрады | Массив | |
| Тарифтеленетін VK Cloud инфрақұрылым элементтерін сипаттайды:
| жүктеме балансировщиктері;
Тарифтік жоспарды баптау шеберінде осы элементтердің құны көрсетіледі. Ол VK Cloud тарифтеріне сәйкес автоматты түрде есептеледі | Массив |
Массив тарифтік жоспар үшін конфигурациялау шеберінің беттерін сипаттайды. Әр бетте тарифтік опциялардың бір немесе бірнеше тобы көрсетіледі. Беттердің максималды саны — 5.
pages массивінің параметрлері:
Атауы | Сипаттамасы | Форматы | Міндетті |
|---|---|---|---|
| Конфигурациялау шебері бетінің атауы, 32 таңбадан аспайды |
| |
| Конфигурациялау шеберінің нақты бетінде көрсетілетін тарифтік опциялар топтары | Массив | |
| Тарифтік опциялар тобының атауы, 255 таңбадан аспайды |
| |
| Топқа кіретін тарифтік опциялардың атауларының тізімі. | Тізім, тізім элементі — | |
| Осы опцияның YAML-файлының атауымен сәйкес келетін тарифтік опцияның атауы: |
|
Әдепкі бойынша тарифтік жоспарды конфигурациялау шеберінде pages массивінде көрсетілген тарифтік опциялар топтарының (groups) барлығы көрсетіледі. Шарттарға байланысты топтарды көрсету немесе жасыру үшін when құрылымы пайдаланылады.
Төменде осы мысалдан алынған тарифтік жоспарды баптау шеберінің қалай көрсетілетіні берілген.
Массив тарифтік жоспар шеңберінде тарифтелетін VK Cloud инфрақұрылымының элементтерін сипаттайды.
Әдепкі бойынша тарифтік жоспарды конфигурациялау шеберінде entities массивінде сипатталған инфрақұрылымның барлық элементтерінің құны көрсетіледі. Шарттарға байланысты инфрақұрылым құнын көрсету немесе жасыру үшін when құрылымы пайдаланылады.
entities массивінің жалпы параметрлері:
Атауы | Сипаттамасы | Форматы | Міндетті |
|---|---|---|---|
| Инфрақұрылым элементінің түрі:
|
| |
| Инфрақұрылым элементінің сипаттамасы |
|
Сервисті баптау бетін тарифтік жоспарды конфигурациялау шеберінде сипаттау мысалы:
pages:- name: Сервисті баптау # Бет атауыgroups:- name: Сервер # Тарифтік опциялар тобының атауыparameters:- name: network # Тарифтік опция атауы- name: vm- name: az- name: Жүйелік дискparameters:- name: volume_size- name: volume_type
ВМ үшін entities массивінің параметрлері:
Атауы | Сипаттамасы | Форматы | Міндетті |
|---|---|---|---|
| ВМ саны, | Секция | |
| ВМ саны |
| — |
| Мәні ВМ санын анықтайтын тарифтік опцияның атауы ( |
| — |
| ВМ түрі, | Секция | |
|
| — | |
| ВМ түрін сипаттайтын тарифтік опцияның атауы ( |
| — |
| ВМ дисктері. Әр диск | Массив |
|
| Диск түрі, | Секция | — |
| Диск түрі. Мүмкін мәндер:
|
| — |
| Диск түрін сипаттайтын тарифтік опцияның атауы ( |
| — |
| Диск өлшемі, | Секция | — |
| Диск өлшемі |
| — |
| Мәні диск өлшемін анықтайтын тарифтік опцияның атауы ( |
| — |
Тарифтік жоспарды конфигурациялау шебері үшін ВМ сипаттамасының мысалы:
entities:- entity: vmdescription: Виртуалды машинаcount:const: 1flavor:param: ds-flavor # Тарифтік опция атауыdisks:- type:param: root_typesize:param: root_size- type:param: data_typesize:param: data_size
Төменде осы мысалдан алынған инфрақұрылым құны туралы ақпараттың тарифтік жоспарды баптау шеберінде қалай көрсетілетіні берілген.
Жүктеме балансирлеуші үшін entities массивінің параметрлері:
Атауы | Сипаттамасы | Форматы | Міндетті |
|---|---|---|---|
| Жүктеме балансирлеушілерінің саны, | Секция | |
| Балансирлеушілер саны |
| — |
| Мәні балансирлеушілер санын анықтайтын тарифтік опцияның атауы ( |
| — |
Тарифтік жоспарды конфигурациялау шебері үшін жүктеме балансирлеушінің сипаттамасының мысалы:
entities:- entity: load_balancingcount:param: number_balancing # Тарифтік опция атауы
Сыртқы IP-мекенжай үшін entities массивінің параметрлері:
Атауы | Сипаттамасы | Форматы | Міндетті |
|---|---|---|---|
| Сыртқы IP-мекенжайлардың саны, | Секция | |
| Сыртқы IP-мекенжайлар саны |
| — |
| Мәні сыртқы IP-мекенжайлар санын анықтайтын тарифтік опцияның атауы ( |
| — |
Тарифтік жоспарды конфигурациялау шебері үшін сыртқы IP-мекенжайдың сипаттамасының мысалы:
entities:- entity: floating_ipcount:const: 1
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_inkey:param: <ОПЦИЯ_АТЫ> # немесе const: <МӘН>values:- const: <МӘН>- param: <ОПЦИЯ_АТЫ>...
Мұндағы:
<ОПЦИЯ_АТЫ>— осы опцияның YAML-файлының атауымен сәйкес келетін тарифтік опцияның атауы.<МӘН>— тіркелген мән.
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ішінде — себебі бір тарифтік опция тек бір топта ғана көрсетілуі мүмкін.
entities массивінде when құрылымы entities массивінде сипатталған инфрақұрылым элементінің құнын тарифтік жоспарды конфигурациялау шеберінде көрсету қажет пе екенін анықтайтын шартты беру үшін пайдаланылады.
entities массивінде when құрылымын пайдалану мысалы:
entities:- entity: vmdescription: alkair_softwarewhen:in:key:param: need_install_alkair_software # Тарифтік опция атауыvalues:- const: trueflavor:const: 6a7a0690-943a-4921-936e-2849970ccfba # ВМ түрі (CPU, RAM). Бұл мысалда 2 CPU және 3 ГБ RAM бар ВМcount:const: 1disks:- type:const: high-iops # Диск түріsize:const: 500 # Диск өлшемі
Бұл мысалда Алькаир БҚ үшін ВМ құнын көрсету баптамасы берілген. Егер пайдаланушы need_install_alkair_software тарифтік опциясы үшін true мәнін таңдаса, тарифтік жоспарды конфигурациялау шеберінде entities.entity элементінде сипатталған ВМ құны көрсетіледі.
