VK Cloud logo

ivkcs_agent_exec ресурсы

ivkcs_agent_exec ресурсының аргументтері 1 кестесінде берілген.

1 кестесі — ivkcs_agent_exec ресурсының аргументтері

Атауы

Сипаттамасы

Форматы

Міндетті

uuid

Сервис жаймасының идентификаторы

string

ivkcs_agent_exec ресурсы

name

step аргументінде сипатталған скрипттерге арналған ортақ атау

string

ivkcs_agent_exec ресурсы

hosts

Скрипт орындалатын хост атауларының тізімі

list, тізім элементтері — string

ivkcs_agent_exec ресурсы

step

Хосттардағы агенттер іске қосатын скрипттерді сипаттайды. Скрипттердің орындалу ретін анықтайды

list, бір элементтің құрылымы төмендегі кестеде келтірілген

ivkcs_agent_exec ресурсы

step элементінің бір аргументі 2 кестесінде берілген.

2 кестесі — step бір элементінің аргументтері

Атауы

Сипаттамасы

Форматы

Міндетті

Мәні өзгерген кезде ресурсты қайта жасау

index

Скрипт индексі, орындалу ретін анықтайды

integer

ivkcs_agent_exec ресурсы

ivkcs_agent_exec ресурсы

type

Скрипт тілі. Мүмкін мәндер:

  • bash
  • python

string

ivkcs_agent_exec ресурсы

ivkcs_agent_exec ресурсы

options

Скриптті орындау параметрлері

set, тізім аргументтері — 3 кестесінде

ivkcs_agent_exec ресурсы

ivkcs_agent_exec ресурсы

content

Скрипт денесі

string

ivkcs_agent_exec ресурсы

ivkcs_agent_exec ресурсы

Скрипт опцияларын сипаттауға арналған options аргументтері 3 кестесінде берілген.

3 кестесі — Скрипт опциялары

Атауы

Сипаттамасы

Форматы

Әдепкі мәні

environment_variables

Жүйенің орта айнымалыларына қосымша орта айнымалыларының тізімі

list, тізім элементтері — <ENVIRONMENT_VARIABLE_NAME>=<VALUE> форматындағы string

exit_codes

Скрипттің күтілетін шығу кодтары.

Егер скрипттің сәтті орындалуын білдіретін шығу коды алынса, скриптке success мәртебесі беріледі.

Егер скрипттің қателікпен аяқталғанын білдіретін шығу коды алынса, скрипт қайта іске қосылады. Егер барлық қайта іске қосу әрекеттерінің нәтижесінде скрипт қателікпен аяқталса, скрипт мәртебесі — failed

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

  • attempts
  • attempt_pause

list, тізім элементтері — integer

0, -1.

0 коды — скрипт сәтті аяқталды.

-1 коды — қателікпен

halt_codes

Скрипт қайта іске қосылмайтын шығу кодтары

list, тізім элементтері — integer

125

stop_signal

Егер скрипттің орындалу тайм-ауты асса, скриптке жіберілетін сигнал — SIGTERM.

Тайм-аут timeout опциясында беріледі

integer

15

stop_timeout

SIGTERM сигналы алынған сәттен бастап есептелетін тайм-аут. Тайм-аут аяқталғаннан кейін процесс мәжбүрлі түрде SIGKILL арқылы аяқталады.

Мәндер мысалы:

  • 1m.
  • 15s.
  • 1h

string

5s

cwd

Скриптті орындауға арналған директория

string

/tmp

user

Скрипт оның атынан іске қосылатын пайдаланушы.

string

root

group

Скрипт оның атынан іске қосылатын пайдаланушылар тобы.

string

root

timeout

Скриптті орындау тайм-ауты. Егер скрипт тайм-аут ішінде аяқталмаса, оған SIGTERM сигналы жіберіледі (stop_signal опциясында берілген).

Мән stop_timeout опциясымен бірдей форматта беріледі

string

60s

attempts

Егер скрипттің қателікпен аяқталғаны туралы шығу кодтары алынса (exit_codes опциясында берілген), скриптті қайта іске қосу әрекеттерінің саны.

integer

3

attempt_pause

Скриптті қайта іске қосулар арасындағы үзіліс ұзақтығы.

Мән stop_timeout опциясымен бірдей форматта беріледі

string

5s

pause_before

Скрипт іске қосылғанға дейінгі үзіліс ұзақтығы.

Мән stop_timeout опциясымен бірдей форматта беріледі

string

0

pause_after

Скрипт аяқталғаннан кейінгі үзіліс ұзақтығы.

Мән stop_timeout опциясымен бірдей форматта беріледі

string

0

store_result

Скрипттің орындалу нәтижесін хост дискісіне сақтау не сақтамау

boolean

true

structured_result_file

Скрипттің пішімделген нәтижесі бар файлға жол

string

once

Скрипт тек бір рет орындала ма, әлде сервис әрбір қайта жайылған сайын орындала ма, соны анықтайды.

Егер true мәні берілсе, скрипт тек сервисті бастапқы жайған кезде ғана орындалады

boolean

false

step ішінде сипатталған әрбір скрипт үшін ivkcs_agent_exec ресурсы конфигурацияларды басқару сервисіне беру үшін скрипт хешін қамтитын hash атрибутын (string форматы) қайтарады. Алынған мәндер бойынша конфигурацияларды басқару сервисі хосттардың ағымдағы және мақсатты (Terraform манифесінде сипатталған) күйін салыстырады.