Lua Academy · leksjon

Bygge en konfigurasjons-DSL

Opprett et deklarativt konfigurasjonsspråk som lastes inn med dofile() i en sandkasse.

Leksjon 3 av 413 trinn

Bygge en konfigurasjons-DSL er en gratis leksjon i Lua Academy på CoddyKit. Dette er leksjon 3 av 4. Du kan lese valgfritt 3 leksjoner fra denne læringsstien gratis i sin helhet – deretter låser CoddyKit PRO opp alle leksjoner, samt praktisk øving med en innebygd kodeeditor og en AI-veileder som er tilgjengelig døgnet rundt. Den er en del av læringsløpet i Lua Academy, og fremdriften din synkroniseres mellom nettet og CoddyKit-appen. Kurset i Lua Academy inneholder totalt 4 leksjoner.

Mål: Deklarativ konfigurasjon

En konfigurasjons-DSL lar brukere uttrykke konfigurasjon på en lesbar, deklarativ måte, samtidig som Lua sin fulle kraft (betingelser, løkker og funksjoner) brukes i bakgrunnen.

Mønster for konfigurasjonsfunksjon

Eksponer en config(tbl)-funksjon som validerer og lagrer konfigurasjon. Kall den med en tabell-literal for en ryddig syntaks.

local function config(tbl)
  -- validate and store
  return tbl
end
-- config.lua:
return config {
  host = "localhost",
  port = 8080,
  debug = os.getenv("DEBUG") == "1",
}

Nestet konfigurasjon med seksjoner

Støtt nestede seksjoner for organisert konfigurasjon.

return config {
  database = { host="db.local", port=5432 },
  cache    = { host="cache.local", ttl=300 },
  logging  = { level="INFO", file="/var/log/app.log" },
}

Hjelpefunksjoner i konfigurasjonen

Tillat kall til hjelpefunksjoner i konfigurasjonen for beregnede verdier.

local function env(name, default)
  return os.getenv(name) or default
end
return config {
  host  = env("DB_HOST", "localhost"),
  port  = tonumber(env("DB_PORT", "5432")),
}

Lasting av konfigurasjon i en sandkasse

Av sikkerhetshensyn skal konfigurasjonen lastes inn i et begrenset miljø som bare tillater sikre hjelpefunksjoner.

local function loadConfig(path)
  local safeEnv = {
    config = config,
    env    = env,
    math   = math,
    table  = table,
  }
  local fn, err = loadfile(path, "t", safeEnv)
  if not fn then error(err) end
  return fn()
end

Skjemavalidering

Valider obligatoriske felt og typer etter lasting.

local function validate(cfg)
  assert(type(cfg.host) == "string", "host must be string")
  assert(type(cfg.port) == "number", "port must be number")
  assert(cfg.port > 0 and cfg.port < 65536, "port out of range")
end
validate(loadConfig("config.lua"))

Standardverdier

Slå sammen den innlastede konfigurasjonen med standardverdier for å sikre at alle obligatoriske nøkler har verdier.

local defaults = {host="localhost", port=8080, debug=false}
local function loadWithDefaults(path)
  local cfg = loadConfig(path)
  for k, v in pairs(defaults) do
    if cfg[k] == nil then cfg[k] = v end
  end
  return cfg
end

Overstyring med miljøvariabler

Tillat miljøvariabler å overstyre verdier i konfigurasjonsfilen — noe som er avgjørende for 12-faktor-appdesign.

Arv for konfigurasjon

Last inn en grunnkonfigurasjon, og legg deretter konfigurasjon som er spesifikk for miljøet, oppå den (utvikling, staging, produksjon).

Uforanderlig konfigurasjon

Etter lasting kan De fryse konfigurasjonstabellen med en __newindex som utløser en feil, slik at utilsiktede endringer under kjøring hindres.

Dokumentasjon i konfigurasjonen

Bruk kommentarer og strukturerte nøkkelnavn som selvforklarende dokumentasjon. En godt utformet konfigurasjons-DSL er selvforklarende for DevOps-team.

Spørsmål om konfigurasjons-DSL

Hvorfor skal en konfigurasjonsfil lastes inn med en sandkasseisolert _ENV?

Besvar den i den interaktive leksjonen

Oppsummering: Bygge en konfigurasjons-DSL

Eksponer en config(tbl)-funksjon. Støtt nestede seksjoner og hjelpefunksjoner. Last inn konfigurasjonen i et sandkasseisolert miljø. Valider obligatoriske felt og typer. Tilby standardverdier, og tillat overstyring med miljøvariabler for å oppfylle kravene i 12-faktor-prinsippene.

Gratis å komme i gang

Lær deg Lua med en AI-veileder – gratis

Skriv og kjør ekte kode i nettleseren, få umiddelbar hjelp fra en AI-veileder som er tilgjengelig døgnet rundt, og fortsett der du slapp – på nettet eller i appen.

Kurs: 40
Leksjoner: 159

Start læringen gratis Se hele kurset

Ofte stilte spørsmål

Er leksjonen «Bygge en konfigurasjons-DSL» gratis?

Ja – du kan lese valgfritt 3 av leksjonene i læringsstien Lua Academy, inkludert «Bygge en konfigurasjons-DSL», gratis i sin helhet her på nettet. Deretter låser CoddyKit PRO opp alle leksjoner, samt interaktiv øving med en innebygd kodeeditor og en AI-veileder som er tilgjengelig døgnet rundt. Kurset i Lua Academy inneholder totalt 4 leksjoner.

Hva lærer jeg i «Bygge en konfigurasjons-DSL»?

Opprett et deklarativt konfigurasjonsspråk som lastes inn med dofile() i en sandkasse. Du øver på Lua Academy med praktisk kode som du kjører direkte i nettleseren, mens en AI-veileder som er tilgjengelig døgnet rundt, svarer på spørsmålene dine mens du jobber deg gjennom leksjonen.

Trenger jeg erfaring for å begynne med Lua Academy?

Ingen tidligere erfaring er nødvendig. Lua Academy på CoddyKit er lagt opp for både nybegynnere og viderekomne, så De kan begynne her eller helt fra start og lære i Deres eget tempo. Dette er leksjon 3 av 4.

Hvor lang tid tar leksjonen «Bygge en konfigurasjons-DSL»?

De fleste CoddyKit-leksjoner tar omtrent 5–10 minutter. Hver leksjon er kort og interaktiv, slik at De gjør jevne fremskritt og kan fortsette akkurat der De slapp – både på nettet og i appen.

Kan jeg skrive og kjøre kode i denne Lua Academy-leksjonen?

Ja. Alle Lua Academy-leksjoner har en innebygd kodeeditor, slik at De kan skrive og kjøre ekte kode direkte i nettleseren og få umiddelbar tilbakemelding fra AI – uten lokal konfigurering.

Alle leksjonene i dette kurset

Prinsipper for DSL-utforming i Lua
Operatoroverbelastning for flytende DSL-er
Bygge en konfigurasjons-DSL
Enkel uttrykksparser

← Tilbake til Lua Academy