Fork me on GitHub

Docker 配置私有仓库-配置 Registry

字数统计: 1.4k字   |   阅读时长≈ 6分

参考文章：[Docker 技术入门与实战 第3板]

配置 Registry

Docker Registry 提供了一些样例配置，用户可以直接使用它们进行开发或生产部署。

示例配置

这里以下面的示例配置(config-dev.yaml)为例，介绍如何使用配置文件来管理私有仓库。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
version: 0.1
log:
  level: debug
  fields:
    service: registry
    environment: development
  hooks:
    - type: mail
      disabled: true
      levels:
        - panic
      options:
        smtp:
          addr: mail.example.com:25
          username: mailuser
          password: password
          insecure: true
        from: sender@example.com
        to:
          - errors@example.com
storage:
    delete:
      enabled: true
    cache:
        blobdescriptor: redis
    filesystem:
        rootdirectory: /var/lib/registry
    maintenance:
        uploadpurging:
            enabled: false
http:
    addr: :5000
    debug:
        addr: :5001
        prometheus:
            enabled: true
            path: /metrics
    headers:
        X-Content-Type-Options: [nosniff]
redis:
  addr: localhost:6379
  pool:
    maxidle: 16
    maxactive: 64
    idletimeout: 300s
  dialtimeout: 10ms
  readtimeout: 10ms
  writetimeout: 10ms
notifications:
    events:
        includereferences: true
    endpoints:
        - name: local-5003
          url: http://localhost:5003/callback
          headers:
             Authorization: [Bearer <an example token>]
          timeout: 1s
          threshold: 10
          backoff: 1s
          disabled: true
        - name: local-8083
          url: http://localhost:8083/callback
          timeout: 1s
          threshold: 10
          backoff: 1s
          disabled: true 
health:
  storagedriver:
    enabled: true
    interval: 10s
    threshold: 3

配置选项

这些选项以 yaml 文件格式提供，用户可以直接进行修改，也可以添加自定义的模板段。
默认情况下变量可以从环境变量中读取，例如 log.level:debug 可以配置为：

1
export LOG_LEVEL=debug

比较重要的选项包括版本信息，log 选项，hooks 选项，存储选项，认证选项，HTTP 选项，通知选项，Redis 选项，健康监控选项，代理选项和验证选项等。下面分别介绍。

version 版本信息

1
version: 0.1

log 日志选项

日志相关，代码如下：

1
2
3
4
5
6
log:
    level: debug
    formatter: text
    fields:
        service: registry
        environment: staging

代码解释：

  • level: 字符串类型，标注输出调试信息的级别，包括 debug，info，warn，error；
  • formatter: 字符串类型，日志输出的格式，包括 text，json，logstash 等；
  • fields: 增加到日志输出消息中的键值对，可以用于过滤日志。

hooks 选项

配置当仓库发生异变时，通过邮件发送日志时的参数，代码如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
hooks:
    - type: mail
      levels:
          - panic
      options:
          smtp:
              addr: smtp.senderhost.com:25
              username: sender name
              password: password
              insecure: true
          from: name@senderhost.com
          to:
              - name@receivehost.com

storage 存储选项

storage 选项将配置存储引擎，默认支持包括本地文件系统，Google 云存储，AWS S3云存储和 OpenStack Swift 分布式存储等，代码如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
storage:
    filesystem:
        rootdirectory: /var/lib/registry
    azure:
        accountname: account name
        accountkey: base64 encoded accountkey
        container: container name
    gcs:
        bucket: bucket name
        keyfile: /path/to/keyfile
        rootdirectory: /gcs/object/name/prefix
    s3:
        accesskey: aws access key
        secretkey: aws secret key
        region: us-west-1
        regionendpoint: http://myobjects.local
        bucket: bucket name
        encrypt: true
        keyid: mykey id
        secure: true
        v4auth: true
        chunksize: 5242880
        multipartcopychunksize: 33554432
        multipartcopymaxconcurrency: 100
        multipartcopythresholdsize: 33554432
        rootdirectory: /s3/object/name/prefix
    swift:
        username: username
        password: password
        authurl: https://storage.myprovider.com/auth/v1.0 or https://storage.myprovider.com/v2.0 or https://storage.myprovider.com/v3/auth
        tenant: tenantname
        tenantid: tenantid
        domain: domain name for OpenStack Identity v3 API
        domianid: domain id for OpenStack Identity v3 API
        insecureskipverify: true
        region: fr
        container: containername
        rootdirectory: /swift/object/name/prefix
    oss:
        accesskeyid: access key id
        accesskeysecret: access key secret
        region: OSS region name
        endpoint: optional endpoint
        internal: optional internal endpoint
        bucket: OSS bucket
        encrypy: optional data encryption setting
        secure: optional ssl setting
        chunksize: optional size value
        rootdirectory: optional root directory
    inmemory:
    delete:
        enabled: false
    cache:
        blobdescriptor: inmemory
    maintenance:
        uploadpurging:
            enabled: true
            age: 168h
            interval: 24h
            dryrun: false

比较重要的选项如下：

  • maintenance: 配置维护相关的功能，包括对孤立旧文件的清理，开启只读模式等；
  • delete: 是否允许删除镜像功能，默认关闭；
  • cache: 开启对镜像层元数据的缓存功能，默认开启。

auth 认证选项

对认证类型的配置，代码如下：

1
2
3
4
5
6
7
8
9
10
11
12
auth:
    silly:
        realm: silly-realm
        service: silly-service
    token:
        realm: token-realm
        service: token-server
        issuer: registry-token-issuer
        rootcertbundle: /root/certs/bundle
    htpasswd:
        realm: basic-realm
        path: /path/to/htpasswd

代码解释：

  • silly: 仅供测试使用，只要请求头带有认证域即可，不做内容检查；
  • token: 基于 Token 的用户认证，适用于生产环境，需要额外的 Token 服务来支持；
  • htpasswd: 基于 Apache htpasswd 密码文件的权限检查。

http 选项

与 HTTP 服务相关的配置，代码如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
http:
    addr: localhost:5000
    net: tcp
    prefix: /my/nested/registry/
    host: https://myregistryaddress.org:5000
    secret: a secret for local development
    relativeurls: false
    tls:
        certificate: /path/to/x509/public
        key: /path/to/x509/private
        clientcas:
            - /path/to/ca.pem
            - /path/to/anoyher/ca.pm
        letsencrypt:
            cachefile: /path to/cache-file
            email: emailuser@letsencrypt.com
    debug:
        addr: localhost:5001
    headers:
        X-Content-Type-Options: [nosniff]
    http2:
        disabled: false

代码解释：

  • addr: 必选，服务监听地址；
  • secret: 必选，与安全相关的随机字符串，用户可以自定义；
  • tls: 证书相关的文件路径信息；
  • http2: 是否开启 http2 支持，默认关闭。

notifications 通知选项

有事件发生时候的通知系统，代码如下：

1
2
3
4
5
6
7
8
9
notifications:
    endpoints:
        - name: a listener
          disable: false
          url: https://my.listener.com/event
          headers: <http.Header>
          timeout: 500
          threshold: 5
          backoff: 1000

redis 选项

Registry 可以使用 Redis 来缓存文件块，这里可以配置相关选项，代码如下：

1
2
3
4
5
6
7
8
9
10
11
redis:
    addr: localhost:6379
    password: a secret
    db: 0
    dialtimeout: 10ms
    readtimeout: 10ms
    writetimeout: 10ms
    pool:
        maxidle: 16
        maxactive: 64
        idletimeout: 300s

health 健康监控选项

与健康监控相关，主要是对配置服务进行检测判断系统状态，代码如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
health:
    storagedriver:
        enabled: true
        interval: 10s
        threshold: 3
    file:
        - file: /path/to/checked/file
          interval: 10s
    http:
        - uri: http://server.to.check/must/return/200
          heahers:
                Authorization: [Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==]
          statuscode: 200
          timeout: 3s
          interval: 10s
          threshold: 3
    tcp:
        - addr: redis-server.domain.com:6379
          timeout: 3s
          interval: 10s
          threshold: 3

默认并未启用

proxy 代理选项

配置 Registry 作为一个 pull 代理，从远端（目前仅支持官方仓库）下拉 Docker 镜像，代码如下：

1
2
3
4
proxy:
    remoteurl: https://registry-1.docker.io
    username: [username]
    password: [password]

之后，用户可以通过如下命令来配置 Docker 使用代理：

1
docker --registry-mirror=https://myrepo.com:5000 daemon

validation 验证选项

限定来自指定地址的客户端才可以执行 push 操作，代码如下：

1
2
3
4
5
6
7
8
validation:
    enabled: true
    manifests:
        urls:
            allow:
                - ^https?://([^/]+\.)*example\.com/
            deny:
                - ^https?://www\.example\.com/

tag:

    缺失模块。
    1、请确保node版本大于6.2
    2、在博客根目录（注意不是yilia-plus根目录）执行以下命令：
    npm i hexo-generator-json-content --save

    3、在根目录_config.yml里添加配置： 

      jsonContent:
    meta: false
    pages: false
    posts:
      title: true
      date: true
      path: true
      text: false
      raw: false
      content: false
      slug: false
      updated: false
      comments: false
      link: false
      permalink: false
      excerpt: false
      categories: false
      tags: true

主要涉及技术：
Linux 运维、自动化运维、
Kubernetes、Python、Jenkins、Docker

联系QQ:2350686113

很惭愧

只做了一点微小的工作
谢谢大家