문서가격블로그
문의하기
로그인무료로 가입하기
Back to Tech Articles

기본값 너머 Rust 애플리케이션을 위한 유연한 구성

7월 23, 2025
# Misc

Min-jun Kim

Dev Intern · Leapcell

이 게시물은 English, 日本語 및 Deutsch에서도 볼 수 있습니다.
Cover of "기본값 너머 Rust 애플리케이션을 위한 유연한 구성"

소개

소프트웨어 개발의 세계에서 애플리케이션은 거의 진공 상태에서 작동하지 않습니다. 데이터베이스, 외부 API 및 다양한 서비스와 상호 작용해야 하며, 종종 개발, 테스트 및 프로덕션 환경에 대해 다른 설정이 필요합니다. 이러한 구성을 하드코딩하는 것은 깨지기 쉬운 코드와 어려운 배포로 이어지는 재앙의 지름길입니다. 외부 구성 관리가 필수적인 이유가 바로 이것입니다. Rust 개발자에게 적응 가능하고 환경을 인식하는 애플리케이션을 만드는 것은 강력한 구성 라이브러리를 채택하는 것을 의미합니다. 이 글에서는 figment와 config-rs가 단순한 정적 기본값을 넘어선 진정한 동적이고 적응 가능한 시스템을 위해 Rust 애플리케이션을 위한 유연하고 다중 형식 구성 솔루션을 구축하는 도구를 어떻게 제공하는지 살펴봅니다.

Rust에서의 구성 관리 이해

figment와 config-rs의 구체적인 내용을 살펴보기 전에 Rust에서의 구성 관리와 관련된 몇 가지 핵심 개념을 명확히 해 보겠습니다.

  • 구성 소스: 구성 데이터가 로드되는 위치입니다. 여기에는 환경 변수, 명령줄 인수, 파일 (TOML, YAML, JSON, INI) 또는 심지어 원격 서비스가 포함될 수 있습니다.
  • 계층화 (또는 재정의): 여러 구성 소스를 지정하고 우선 순위를 정의하는 기능입니다. 예를 들어, 환경 변수는 구성 파일의 값을 재정의할 수 있으며, 이는 코드에 정의된 기본값을 재정의할 수 있습니다.
  • 역직렬화: 구성 데이터 (일반적으로 문자열 기반)를 구조화된 Rust 유형 (예: 구조체)으로 변환하는 프로세스입니다. 이는 종종 serde를 활용합니다.
  • 유형 안전: 런타임 오류를 방지하기 위해 구성 값이 올바르게 형식화되고 검증되었는지 확인합니다.
  • 동적 vs. 정적 구성: 정적 구성은 시작 시 한 번 로드됩니다. 동적 구성은 애플리케이션을 다시 시작하지 않고도 런타임에 다시 로드할 수 있습니다. figment와 config-rs는 주로 정적 구성 로드에 중점을두지만, 유연성을 통해 동적 시스템의 기반을 마련할 수 있습니다.

figment와 config-rs 모두 이러한 측면을 단순화하여 현대 Rust 애플리케이션 개발을 위한 인체 공학적 API와 강력한 기능을 제공하는 것을 목표로 합니다.

config-rs로 애플리케이션 강화

config-rs는 계층적 구성을 위한 인기 있는 성숙한 라이브러리입니다. 구조화된 접근 방식을 사용하여 애플리케이션 설정을 정의하고 여러 구성 소스를 계층화할 수 있습니다.

핵심 원칙 및 사용법

config-rs는 Config 빌더 개념을 중심으로 설계되었으며, 우선 순서대로 소스를 추가합니다. 나중에 오는 소스가 먼저 오는 소스를 재정의합니다. 다양한 파일 형식, 환경 변수 및 사용자 지정 소스를 지원합니다.

간단한 웹 서버 애플리케이션에 대한 예제를 살펴보겠습니다.

먼저 Cargo.toml에 config-rs 및 serde를 추가합니다.

[dependencies]
config = "0.13"
serde = { version = "1.0", features = ["derive"] }

다음으로 구성 구조를 정의합니다.

use serde::Deserialize;
use std::collections::HashMap;

#[derive(Debug, Deserialize, Clone)]
pub struct ServerConfig {
    pub host: String,
    pub port: u16,
    pub database_url: String,
    pub log_level: String,
    pub workers: Option<usize>,
    pub features: HashMap<String, bool>,
}

#[derive(Debug, Deserialize, Clone)]
pub struct ApplicationConfig {
    pub server: ServerConfig,
    pub app_name: String,
}

이제 기본 구성 파일 (config/default.toml), 환경별 재정의 (config/production.toml) 및 환경 변수와 같은 여러 소스에서 이 구성을 로드해 보겠습니다.

config/default.toml을 만듭니다.

[server]
host = "127.0.0.1"
port = 8080
database_url = "postgres://user:pass@localhost:5432/mydb"
log_level = "info"
workers = 4

app_name = "MyAwesomeApp"

[server.features]
user_registration = true
email_notifications = false

config/production.toml을 만듭니다.

[server]
host = "0.0.0.0"
port = 443
log_level = "warn"
workers = 8 # 기본값 재정의

main.rs에서:

use config::{Config, ConfigError, File, Environment};
use std::env;

fn get_app_config() -> Result<ApplicationConfig, ConfigError> {
    let run_mode = env::var("RUN_MODE").unwrap_or_else(|_| "development".into());

    let settings = Config::builder()
        // 기본 구성 파일로 시작
        .add_source(File::with_name("config/default").required(true))
        // 환경별 재정의가 있으면 추가
        .add_source(File::with_name(&format!("config/{}", run_mode)).required(false))
        // 환경 변수 추가.
        // 예: `APP_SERVER_PORT=9000`은 `server.port`를 재정의합니다.
        // `APP_SERVER_DATABASE_URL=...`은 `server.database_url`을 재정의합니다.
        .add_source(Environment::with_prefix("APP").separator("_"))
        .build()?;

    // 구조체로 역직렬화
    settings.try_deserialize()
}

fn main() {
    match get_app_config() {
        Ok(config) => {
            println!("Application Config Loaded:");
            println!("{:#?}", config);
            // 이제 `config.server.host`, `config.server.port` 등을 사용할 수 있습니다.
            assert_eq!(config.app_name, "MyAwesomeApp");

            // 재정의 테스트
            if env::var("RUN_MODE").is_ok() && env::var("RUN_MODE").unwrap() == "production" {
                assert_eq!(config.server.host, "0.0.0.0");
                assert_eq!(config.server.workers, Some(8));
            } else {
                assert_eq!(config.server.host, "127.0.0.1");
                assert_eq!(config.server.workers, Some(4));
            }
        }
        Err(e) => {
            eprintln!("Error loading configuration: {}", e);
            std::process::exit(1);
        }
    }

    // 환경 변수를 통한 재정의 예제:
    // 실행 방법: `APP_SERVER_PORT=5000 cargo run`
    // 출력에서 포트 5000을 볼 수 있습니다.
}

이 예제는 config-rs가 기본값, 환경별 재정의 및 환경 변수를 형식 안전한 ApplicationConfig 구조체로 역직렬화하는 방법을 우아하게 처리하는 방법을 보여줍니다.

figment로 구성 발전시키기

figment는 강력한 타입 안전성과 개발자 경험을 염두에 두고 설계된 더 새롭고, 더 의견이 뚜렷하며, 매우 구성 가능한 구성 라이브러리입니다. 중첩된 구성, 프로필 및 사용자 지정 제공자를 포함한 복잡한 시나리오를 처리하는 데 탁월합니다.

핵심 원칙 및 사용법

figment는 구성을 "제공자" 스택으로 간주하며, 각 제공자가 최종 구성에 기여합니다. serde를 역직렬화에 적극적으로 활용하고 구성 구조를 정의하는 깔끔한 API를 제공합니다.

먼저 Cargo.toml에 figment 및 serde를 추가합니다. 사용할 파일 형식에 대한 기능을 활성화해야 합니다.

[dependencies]
figment = { version = "0.10", features = ["derive", "toml", "env"] } # 필요에 따라 "yaml", "json" 추가
serde = { version = "1.0", features = ["derive"] }

config-rs 예제에서 사용한 ServerConfig 및 ApplicationConfig 구조체를 재사용해 보겠습니다. figment는 #[derive(Figment)]로 구조체에 주석을 달아 Default 구현이 있는 경우 기본값을 자동으로 제공하거나 특정 소스에서 구성을 적용할 수 있도록 합니다.

use serde::Deserialize;
use std::collections::HashMap;
use figment::{Figment, Provider, collectors::json, providers::{Format, Toml, Env, Serialized}};

#[derive(Debug, Deserialize, Clone, figment::Figment)] // Figment derive 추가
// 구조체에 직접 기본값을 지정하거나, Default impl을 통해 지정。
#[figment(
    map = "ServerConfig",
    // 예: 특정 필드에 `env` 제공자 사용, 또는 기본값 정의
    // 환경 변수의 경우 Figment는 자동으로 SERVER_HOST 등을 찾습니다.
    env_prefix = "SERVER", // 이 구조체의 모든 환경 변수는 SERVER_로 접두사가 붙습니다.
    default = {
        "host": "127.0.0.1",
        "port": 8080,
        "database_url": "postgres://user:pass@localhost:5432/mydb",
        "log_level": "info",
        "workers": 4,
    }
)]
pub struct ServerConfig {
    pub host: String,
    pub port: u16,
    pub database_url: String,
    pub log_level: String,
    pub workers: Option<usize>,
    pub features: HashMap<String, bool>,
}

#[derive(Debug, Deserialize, Clone, figment::Figment)]
#[figment(
    map = "ApplicationConfig",
    env_prefix = "APP", // 이 구조체의 모든 환경 변수는 APP_로 접두사가 붙습니다.
    default = {
        "app_name": "MyAwesomeApp",
        "server": {
            // 기본 `server` 값은 `ServerConfig`의 Figment derive에서 가져옵니다.
            // 또는 `Default` impl이 있는 경우 해당 impl에서 가져옵니다. 이것은 최상위 `ApplicationConfig` 기본값용입니다.
        }
    }
)]
pub struct ApplicationConfig {
    pub server: ServerConfig,
    pub app_name: String,
}

이제 figment로 애플리케이션을 구성해 보겠습니다. 이전과 동일한 config/default.toml 및 config/production.toml을 사용합니다.

main.rs에서:

use figment::{Figment, providers::{Env, Format, Toml, Serialized}};
use std::env;

fn get_app_config() -> Result<ApplicationConfig, figment::Error> {
    let run_mode = env::var("RUN_MODE").unwrap_or_else(|_| "development".into());

    let figment = Figment::new()
        // `ApplicationConfig` 및 `ServerConfig`의 `Figment` derive를 통해 기본값 제공
        .merge(Serialized::defaults(ApplicationConfig::default())) // `Default` impl 또는 `figment(default = { ... })` 필요
        // 환경별 TOML 파일 추가
        .merge(Toml::file("config/default.toml"))
        .merge(Toml::file(format!("config/{}.toml", run_mode)).nested()) // `nested()`는 `server.port`가 `server.port`를 재정의하도록 보장합니다.
        // 환경 변수가 모든 것을 재정의합니다.
        // `FIGMENT_APP_NAME` 또는 `APP_APP_NAME` (`ApplicationConfig`의 `env_prefix` 때문)
        // `FIGMENT_SERVER_PORT` 또는 `SERVER_PORT` (`ServerConfig`의 `env_prefix` 때문)
        // Figment는 `FIGMENT_...` 및 구조체의 `env_prefix`를 모두 확인합니다.
        .merge(Env::with_prefix("APP").global()) // 전역 `APP_` 접두사
        .merge(Env::with_prefix("SERVER").global()); // 전역 `SERVER_` 접두사

    // 구조체로 역직렬화
    figment.extract()
}

fn main() {
    match get_app_config() {
        Ok(config) => {
            println!("Application Config Loaded:");
            println!("{:#?}", config);
            assert_eq!(config.app_name, "MyAwesomeApp");

            // 재정의 테스트
            if env::var("RUN_MODE").is_ok() && env::var("RUN_MODE").unwrap() == "production" {
                assert_eq!(config.server.host, "0.0.0.0");
                assert_eq!(config.server.workers, Some(8));
            } else {
                assert_eq!(config.server.host, "127.0.0.1");
                assert_eq!(config.server.workers, Some(4));
            }
        }
        Err(e) => {
            eprintln!("Error loading configuration: {}", e);
            std::process::exit(1);
        }
    }

    // 환경 변수를 통한 재정의 예제:
    // 실행 방법: `SERVER_PORT=5000 cargo run` 또는 `APP_SERVER_PORT=5000 cargo run`
    // `ServerConfig`의 `env_prefix` 또는 최상위 `Env::with_prefix("APP").global()` 때문에 출력에서 포트 5000을 볼 수 있습니다.
}

특히 Figment의 derive 매크로는 구조체 정의 내에서 직접 기본값과 환경 변수 접두사를 지정하는 것을 매우 편리하게 만듭니다. 이는 명확성을 높이고 상용구 코드를 줄입니다. nested()는 파일을 병합할 때 더 깊은 필드가 올바르게 병합되고 덮어 써지도록 보장하는 데 중요합니다.

사용 사례 및 이점

figment와 config-rs 모두 훌륭한 선택이며, 약간의 차이가 있습니다.

  • config-rs:
    • 일반적인 경우의 단순성: 파일을 계층화하고 환경 변수를 사용하는 것이 매우 간단합니다.
    • 성숙하고 널리 사용됨: 대부분의 프로젝트에 안전한 선택입니다.
    • 유연한 소스 API: 사용자 지정 구성 소스를 쉽게 구현할 수 있습니다.
  • figment:
    • derive를 통한 강력한 유형 안전성: #[derive(Figment)] 매크로는 종종 구성 정의를 더 간결하고 오류가 적게 만듭니다.
    • 프로필 및 환경: 수동 파일 경로 구성 없이 다양한 환경 관리에 대한 훌륭한 지원을 제공합니다.
    • 구성 가능성: 제공자 기반 시스템은 사용자 지정 시나리오에 대해 매우 확장 가능하게 만듭니다.
    • 의견이 뚜렷한 구조: 복잡하고 중첩된 구성의 경우 상용구가 적을 수 있습니다.
    • 오류 보고: 역직렬화 중에 종종 더 자세한 오류 메시지를 제공합니다.

대부분의 애플리케이션의 경우 config-rs는 강력하고 이해하기 쉬운 솔루션을 제공합니다. 보다 정교한 환경 관리, 강력한 유형 기반 기본값 또는 복잡한 구성 집계가 필요한 프로젝트의 경우 figment는 강력한 derive 매크로와 제공자 아키텍처를 통해 빛을 발합니다.

결론

유연하고 다중 형식 구성을 제공하는 것은 강력하고 적응 가능한 Rust 애플리케이션을 구축하는 데 중요합니다. figment와 config-rs 모두 강력하고 인체 공학적인 솔루션을 제공하여 개발자가 코드를 깔끔하게 분리 할 수 ​​있도록 합니다. 해당 기능을 활용하면 애플리케이션을 다양한 환경 및 배포 시나리오에서 쉽게 구성 할 수 ​​있어 더 유지 관리하기 쉽고 탄력적인 소프트웨어를 만들 수 있습니다.

Share this article

HackerNews

More Posts from Leapcell

cover

Rust 웹 프레임워크에서 스트리밍 응답을 사용하여 대용량 파일 및 장기 연결 효율적으로 처리하기

cover

Rust 웹 서비스에서 강력한 백그라운드 작업 처리 구축

Popular Posts