rovecom/traefik-rancher

rancher-traefik 镜像说明

镜像概述

该镜像为Rancher平台上的Traefik提供动态配置功能，基于https://github.com/rawmind0/rancher-tools%E6%9E%84%E5%BB%BA%EF%BC%8C%E9%9C%80%E4%BD%9C%E4%B8%BAhttps://github.com/rawmind0/alpine-traefik%E7%9A%84sidekick%E5%AE%B9%E5%99%A8%E8%BF%90%E8%A1%8C%EF%BC%8C%E9%80%9A%E8%BF%87%E6%89%AB%E6%8F%8FRancher%E5%85%83%E6%95%B0%E6%8D%AE%E7%94%9F%E6%88%90Traefik%E7%9A%84%E8%B7%AF%E7%94%B1%E8%A7%84%E5%88%99%E3%80%82

核心功能

1. 自动扫描Rancher元数据中的服务和外部服务；
2. 识别带有Traefik标签的服务，生成对应的前端和后端配置；
3. 支持ACME证书功能，可覆盖默认证书；
4. 仅包含健康状态的服务到配置中，确保服务可用性。

使用场景

适用于Rancher环境中需要通过Traefik动态管理服务路由的场景，如微服务架构下的服务暴露、多域名路由配置等。

配置说明

需在Rancher服务或外部服务上添加以下Traefik标签：

• traefik.enable: 控制是否暴露服务（true/false），true时默认以service_name.traefik_domain暴露；
• traefik.service: 覆盖默认服务名称；
• traefik.domain: 路由域名，支持多个域名用逗号分隔；
• traefik.port: 暴露的服务端口；
• traefik.acme: 是否启用ACME证书功能（true/false）。

注意：仅健康状态的服务会被添加到配置中，因此服务必须配置健康检查。

部署示例

Docker Run（作为sidekick）

假设已运行rawmind/alpine-traefik容器（名称为alpine-traefik-container），启动该镜像作为sidekick：

bash
docker run -d \
  --name traefik-rancher-sidekick \
  --volumes-from alpine-traefik-container \
  --link alpine-traefik-container \
  --env RANCHER_METADATA_URL=http://rancher-metadata:8080 \
  rovecom/traefik-rancher

Docker Compose

yaml
version: '3'
services:
  traefik:
    image: rawmind/alpine-traefik
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - /opt/tools
  traefik-rancher:
    image: rovecom/traefik-rancher
    volumes_from:
      - traefik
    environment:
      - RANCHER_METADATA_URL=[***]
    depends_on:
      - traefik