Traefik 플러그인 실험적 설정

Traefik 플러그인 실험적 설정 (Traefik Plugins Experimental Configuration)

출처: Traefik Plugins Experimental Configuration

본문

Traefik 플러그인 실험적 설정

개요 (Overview)

이 가이드는 Traefik의 새 실험적 plugins 설치 설정 옵션을 구성하고 사용하는 방법을 설명해요. plugins 옵션은 커스텀 미들웨어와 프로바이더로 Traefik의 기능을 확장할 수 있는 시스템을 도입해요.

실험적 (Experimental)

plugins 옵션은 현재 실험적이며 향후 릴리스에서 변경될 수 있어요. 운영 환경에서는 주의해서 사용하세요.

플러그인 활성화 (Enabling Plugins)

plugins 옵션은 설치 설정 파라미터예요. 플러그인을 활성화하려면 Traefik 설치 설정에 정의해야 해요.

파일 (YAML)

experimental:
  plugins:
    plugin-name: # The name of the plugin in the routing configuration
      moduleName: "github.com/github-organization/github-repository" # The plugin module name
      version: "vX.XX.X" # The version to use

파일 (TOML)

[experimental.plugins.plugin-name]
  moduleName = "github.com/github-organization/github-repository" # The plugin module name
  version = "vX.XX.X" # The version to use

CLI

# The plugin module name
# With plugin-name the name of the plugin in the routing configuration
--experimental.plugins.plugin-name.modulename=github.com/github-organization/github-repository
--experimental.plugins.plugin-name.version=vX.XX.X # The version to use

Traefik 인스턴스에 새 플러그인을 추가하는 방법에 대한 자세한 내용은 개발자 문서를 참고하세요.

플러그인 옵션 (Plugin Options)

| 필드 (Field) | 설명 (Description) | 타입 (Type) | 필수 (Required) | | moduleName | 플러그인의 모듈 이름입니다. | string | 예 (Yes) | | version | 플러그인의 버전입니다. | string | 예 (Yes) | | hash | 검증할 플러그인의 해시입니다. | string | 아니오 (No) | | settings | 플러그인의 설정입니다 (wasm 플러그인에서만 동작합니다). | object | 아니오 (No) | | settings.envs | wasm 게스트로 전달할 환경 변수입니다. | []string | 아니오 (No) | | settings.mounts | wasm 게스트에 마운트할 디렉토리입니다. | []string | 아니오 (No) | | settings.useUnsafe | 플러그인이 unsafe 및 syscall 패키지를 사용하도록 허용합니다. | bool | 아니오 (No) |

로컬 플러그인 (Local Plugins)

로컬 플러그인(Local plugins)을 사용하면 Traefik 플러그인 카탈로그에 게시하지 않고 로컬 디렉토리의 플러그인을 사용할 수 있어요.

파일 (YAML)

experimental:
  localPlugins:
    plugin-name: # The name of the plugin in the routing configuration
      moduleName: "github.com/github-organization/github-repository" # The plugin module name

파일 (TOML)

[experimental.localPlugins.plugin-name]
  moduleName = "github.com/github-organization/github-repository" # The plugin module name

CLI

# The plugin module name
# With plugin-name the name of the plugin in the routing configuration
--experimental.localplugins.plugin-name.modulename=github.com/github-organization/github-repository

로컬 플러그인 옵션 (Local Plugin Options)

| 필드 (Field) | 설명 (Description) | 타입 (Type) | 필수 (Required) | | moduleName | 플러그인의 모듈 이름입니다. | string | 예 (Yes) | | settings | 플러그인의 설정입니다 (wasm 플러그인에서만 동작합니다). | object | 아니오 (No) | | settings.envs | wasm 게스트로 전달할 환경 변수입니다. | []string | 아니오 (No) | | settings.mounts | wasm 게스트에 마운트할 디렉토리입니다. | []string | 아니오 (No) | | settings.useUnsafe | 플러그인이 unsafe 및 syscall 패키지를 사용하도록 허용합니다. | bool | 아니오 (No) |

더 알아보기 (Learn more)

• Traefik 공식 문서