16f4b6bacaf4 для систем вырабатчыка — контракты і пераконтрольваннія

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

// Some random controller file
const port = process.env.PORT || 3000;
mongoose.connect(process.env.MONGO_URI);

npm install zod

import dotenv from 'dotenv';
import { z } from 'zod';

// Load variables from .env file (if in development)
dotenv.config();

// 1. Define the schema
const envSchema = z.object({
  PORT: z.string().transform(Number).default('3000'),
  NODE_ENV: z.enum(['development', 'production', 'test']).default('development'),
  MONGO_URI: z.string(),
  JWT_SECRET: z.string(),
  JWT_EXPIRES_IN: z.string().default('1d'),
});

// 2. Parse the environment against the schema
const _env = envSchema.safeParse(process.env);

// 3. Fail fast if it's invalid
if (!_env.success) {
  console.error('Invalid environment variables:', _env.error.format());
  process.exit(1); // Crash the app immediately!
}

// 4. Export the typed, validated object
export const env = _env.data;

Чэк-ліст для эксплуатацыі

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

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

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

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

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

Спрыймайце гэты этап як кантракт межаў вхідных дадзенаў і перакананых выходных рэзултатаў. Назвіце всі элементы, задаце критэрыя успеху і адмовіцеся ад мовчанкавага частковага завершэння задачы.

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

Прыметка для 16f4b6bacaf4: не кладзіце ключы прадаўцаў у репазітарый, задаце верхнюю межу токенаў на сесію і зберагачыце транскрыпты празаўсюды з фіксатрамі eval, каб пазнейшыя замены модэляў заставаліся порównаннімы.

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

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

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

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