Практычныя нататкі: Kubernetes MCP-сервер з 453 зялёнымі тэстамі — і што было далей

У гэтым карыце парадкульны спосаб разбудовы лініі ад сыр'ёў да рабочай сістэмы: Я створыў сервер Kubernetes MCP, які праходзіць 453 тэсты. Потым я наставіў яго на рэальны кластэр. Акцэнт ставіцца на практычныя крокі, чысткія перакананні і код, які можна проста дадаць у рэпазітарый без неабяснення меты. У стадыі агляду неабходна практычна візначыць інпуты, адпаведальную особу за крок і крытэрыя завершэння прычыну змены коду. Аперацыйныя працавікі должны магчымае перадзваначыць крок з вядомай точкі контролю, не падозруючы пра схованы стан. Конфігурацыю трэба залічыць парадзельной ад коду прыкладнення. Файлы сераўіса, хранільнікі секрэтных дадзеных і флагі функцый належыць у аднам месца, якое працавікі можу пераглядаць, не чытаяўшы весь граф.

Тое, што па адзінцы магло быць ясным пасля аналізу

Калі працуеце над праектам, які трэба запускаць, спачатку запісайце угоду: неабяжлівыя даны, сігнал успеху і тое, што выходзіць у разе частковага неякшання. Такій чэк-ліст дапамагае заставаць змяны коду чыстымі. Документавайце як шлях успеху, так і шлях вярнення. Перапрыбуткі, людзкіе контралі і обработка некорэктных паведамленняў ёсць часткай продукту, а не пасляднім дапрацоўкам. Зявляйце логі з назвай інструмента, хэшам аргументаў, часам затрымкі і рэзультатам кожнага вызову. Без такога следу дэбагаванне агента губіць гадзіны.

"content": "b'/docker-entrypoint.sh: /docker-entrypoint.d/ is not empty...\\n...'"

Той самы фармат, разныя полья, на адні дзень пазней

Калі працуеце з аднам кшэтам у разных этапах выканання, спачатку запісайце умовы кантракту: неабяжлівыя даны, сігнал успеху і тое, што выходзіць у разе частковага нявыпання. Такі спіс контроля дапамагае заліцварыць пазнейшыя змены ў кодзе. Валіце маленькія, тэставаныя елементы замест большых скрыптов. Калі якісь крок не выйшоў, прычына нявыпання павінна вказываць на адную адпаведальнасць, а не на заплутаны ланцужок задач. Запісвайце назву інструмента, хэш аргументаў, час адклікання і рэзультат кожнага вызову. Без такога следу дэбагаванне агента губіць гадзіны.

Тое, якое даслівна мае значэння

Калі працуеце над тым, што насправды ствараеце, спачатку запісайце контракт: неабяжлівыя даныя, сігнал успеху і тое, што выходзіць пад частыя неудачы. Такі спіс пераканае ў тым, што пазнейшыя змены коду будуць чыстымі. Спрэтавайцеся да гэтага этапу як да контракту межу данымі і перакананымі выходамі. Дайце назву артыфактам, задаць правіла пераканання успеху і не падзеўляйцеся частым, неконтрольаваным завершэнням. Запісвайце назву інструмента, хэш аргументаў, час адклікання і рэзультат кожнага вызову. Без такога лёгкага следу дэбагаванне губіць гадзіны. Калі працуеце над тым, што насправды ствараеце, спачатку запісайце контракт: неабяжлівыя даныя, сігнал успеху і тое, што выходзіць пад частыя неудачы. Такі спіс пераканае ў тым, што пазнейшыя змены коду будуць чыстымі. Зберагаюце настройкі праза код аплікацыі. Файлы сераўнавання, храненні секрэтных даных і флагі функцый должны знаходзіцца ў аднам месцы, куда аператары можуць аўдытаваць іх, не чытаючы весь граф.

Error executing tool get_pod_events: Invalid value for `event_time`, must not be `None`

Той мінімальны адзін, пра які вы продовжваеце думаць

Той мінімальны адзін, пра які вы продовжваеце думаць, найлепей работае, калі яго рассматрываць як вімерную плошчу. Запісайце адзін ідэальны прыклад, адзін прыклад неудачы і прыметку па поверненню да пачатковага стану пры розшырэнні масштаба. Дакументавайце як шлях успеху, так і шлях вярнення ў нормальны стан. Перапрыбуткі, людзкія контралі і обработка некорэктных паведамленняў ёсць часткай продукту, а не наступным этапам доработкі. Адкройце інструменты з вузкімі схемамі і чысткімі пазначэннямі побачных эфектаў. Хостам неабходна ведаць, якія вызовы мутуюць стан, перш чым яны автаматычна схваляюць ўпраўленні.

Доказванне таго, што модэль безпекі дзейсна працуе, а не проста стварэнне такога уявлення

Этап апроўачання модэлі безпекі працюе наякшым чынам, калі яго розглядаць як вімерную плошчу. Зафіксавайце адны ідэальны прыклад, адзін кейс неудачы і запіс пра вярнэнне да пачатковага стану перш чым расшырваць масштабы. Валіце маленькія, тэставаныя елементы замест большых скрыптов. Калі якісьць крок не выйшла, прычына неудачы павінна вказываць на адную адпаведальнасць, а не на заплутаны ланцужок дзеянняў. Задаць ліміт токенав на кожны рунг і на кожную сесыю. Інструменты-агенты агрэсіўна расшырваюць кантэкст; строгі ліміты не дазволяюць дэмам ператварыцца на неспакоўлівыя рахункі.

Частка, якая ўжо зовсім не мела нічынага спраўа з кодам

Тая частка, якая працюе на даным этапе, найкрашчая, калі яе расследжваць як вімерную паверхню. Зафіксуйце адны ідэальны прыклад, адну справу з бягамі і прыметку па вярнэнне да пачатковага стану пры расшырэнні масштаба. Расследжвайце гэты этап як кантракт межа вхіднымі данымі і паверынутымі выходнымі рэзультатамі. Дайце назвы артыфактам, задаць крытэрыя успеху і не падзеўляйцеся частым, непূরным выкананнем задач. Адкройце інструменты з вузкімі схемамі і чыткімі пазначэннямі побачных эфектаў. Адпаведальныя за эксплуатацыю должны ведаць, якія вызовы мутуюць стан, перш чым автаматычна схваліць іх. Тая частка, якая працюе на даным этапе, найкрашчая, калі яе расследжваць як вімерную паверхню. Зафіксуйце адны ідэальны прыклад, адну справу з бягамі і прыметку па вярнэнне да пачатковага стану пры расшырэнні масштаба. Зберагайце настройкі праза код аплікацыі. Файлы сяродавішняе сераўісу, хранілішчы секрэтных даных і флагі функцый должны знаходзіцца ў аднам месцы, якое аператары можаць пераглядаць без неабяжнага чытання всіх элементаў.

Што вы на самай працоўнай адзе з гэтага запамяталі

Для тагу «What you actually took stage» неабяжна прадзефінаваць вхідныя даны, адміністратара крока і крытэрыя завершэння пры зміне коду. Аперацыйныя спецыялісты должны магчымаць перзапуск крока з вядомай точкі контролю, не падозрываючы схованы стан. Неабяжна задокументаваць як «шчаслівы» шлях, так і шлях вярнення. Перапрыбуткі, людзкіе перакрыцця і апрацоўка некорэктных паведамленняў ёсць часткай продукту, а не пасляднім дапрацоўкам. Автэнтыфікуйцеся на воратах і прадзефінаваць правыя на выкарыстоўванне дадзеных занова. Сам токэн-носіцель не ёсць межай арэндаванага рэсурсу.

Чэк-ліст для аперацый

Этап чэк-ліста для аперацый працюе найэфектывней, калі яго спрыягаюць як мерыемую плошчу. Запісайце адна «золатая» транскрыпцыю, адын прыклад неудачы і прыметку па вярненню да пачатковага стану пры расшырэнні масштаба. Запісвайце часы выканання і косты токэнаў або запытак разам з функцыйнымі рэзультатамі. Відразлівасць костаў з самага пачатку запобегае неспадзяваным рахункам, калі шлях пераходзіць з дэмаверсіі ў спяльныя сераўы.

Адаптавайце інструменты з вузкімі схемамі і чытальнымі пазначэннямі побачных эфектаў. Хостам неабходна знаты, якія запыткі мутуюць стан, прычым яны можаць автаматычна санкціонаваць іх.

Калі дозволяе бюджэт, дадзіце тэст на працясць крытычнага маршруту ў сістэме CI з вікорыстанням фіксатываў, а не рэальных платных API.

Зберагаюце настройкі праза код аплікацыі. Файлы сяродавішча, хранільнікі секрэтных дадзеных і пазначкі функцыйяў должны знаходзіцца ў аднам месцы, куды аператары можаць адбавляць контроль без неабяжнага чытання всіх элементаў.

Адаптавайце інструменты з вузкімі схемамі і чытальнымі пазначэннямі побачных эфектаў. Хостам неабходна знаты, якія запыткі мутуюць стан, прычым яны можаць автаматычна санкціонаваць іх.

Перад апраноўкай стака заморажавайце версіі, зафіксавайце ідэальны транскрыпт крытычнага маршруту і паказвайце крокі для адвярнення змян. У спадзеленых сяродавішчах неабходны ліміты частоты запыткаў, пераказы на адпаведнасць тэнантыям і чысткі власнік для замены секрэтных дадзеных. Валіце простую надзяйнасць працы над крэатывнымі, адзінразовымі дамах.

Запіска параграфу для e0b17bbc783b: не трэба кантрацеўваць ключы прадаўцаў у рэпазітарыі, задаць максімальную кантэйнернасць токена на сесію, а таксама зберагчы транскрыпціі праза фіксатуры адлічэння, каб пазнейшыя замены мадэляў заставалі пораўнанневымі.

Для запіскі параграфу апранкавання 0 стадзія, перш чым зменіць код, неабходна апісація вхідных дадзеных, адпаведальнага за крок і крэатарыяў выходу. Аператоры должны магчымае перзапускаць крок з вядомай точкі контролю, не спрабоўваючы здагадвацца пра схованы стан. Лепш выбіраць маленькія, тэставаныя елементы заместо вялікіх скрыптав. Калі крок не выйшоў, прычына неудачы должна вказваць на адну конкрэтную адпаведальнасць, а не на заплутаны працэс.

Дзеянне апранкавання 0/906: памеры часу выкарыстоўвання, класаі бядаў і кансуму токенаў для гэтай запіскі, пасля чаго трэба вырашыць, чы рашыцца застаўляць змяну на адной фіксованай сэтцы пытанняў, а не на асобістых спазырэннях.

Калі працуеце над першым этапам зміцнення, спачатку запісайце умовы кантракту: неабяцковыя даны, сігнал успеху і тое, што выходзіць пад частковыя неудачы. Такі спіс дапамагае заліцварваць будучыя змены коду. Празначайце час выканання задачы і вартасьць токена або запіту празмаўляючы пра функцыйнае рэзультат. Відразлівае праказаванне вартасцей запобегае неспакою, калі працэс пераходзіць з дэмаверсіі ў спяльныя асяроддзя.

Дзеянне зміцнення 1/906: вымерайце час выканання, класію памылак і вартасьць токена для гэтага пункту, а потым выберайце, чы робіць змену на аднойчынных крытэрыях, а не на асоціяцыях.

Этап зміцнення 2 працюе лепей, калі яго спрыягчваць як меравальную плошчу. Запісайце адну ідэальную транскрыпцыю, адзін прыклад неудачы і запіску пра вярнэнне да пачатковага стану, перш чым расшырваць масштабы. Дакументавайце як успішны, так і вярнэльны шляхы. Перапрыбуткі, людзкія контралі і обработка неканальных паведамленняў ёсць часткай продукту, а не чымсь, што дадаецца пазней.

Дзеянне паўжасткі 2/906: звярніце увагу на час выканання, клас памылак і колькасць токенаў, выкорыстаных для гэтай змяны, а пасля, на аднойчынку з фіксаваным наборам пытанняў, а не на асобістых спазырах, выявіце, чы хачаце застаўіць гэту змяну.

Для 3-й стадзіі паўжасткі неабходна перад змянай коду чытко апісаць вхідныя даны, адпаведальнага за выкананне крока і крытэрыяы завершэння. Аперацыйныя працавнікі павінны магчымае перадзвігнуць гэты крок з вядомай точкі контролю, не падозрываючы прыхованы стан. Штуюце гэту стадзію як кантракт межа вхіднымі данымі і перакананымі выходнымі рэзультатамі. Дайце назвы артыфактам, апісаць крытэрыяы успеху і не прабывайце прыймаць часткова завершаныя рэзультаты без падтверджэння.

Дзеянне паўжасткі 3/906: звярніце увагу на час выканання, клас памылак і колькасць токенаў, выкорыстаных для гэтай змяны, а пасля, на аднойчынку з фіксаваным наборам пытанняў, а не на асобістых спазырах, выявіце, чы хачаце застаўіць гэту змяну.