Docker私有Registry在CentOS6.X下安裝指南

(WJW)Docker私有Registry在CentOS6.X下安裝指南

說明:html

docker.yy.com 這是docker registry服務器的域名也就是你的公司docker私有服務器的主機地址,假定ip是192.168.2.114;由於https的SSL證書不能用IP地址,我就隨便起了個名字。前端

registry 服務器做爲上游服務器處理docker鏡像的最終上傳和下載,用的是官方的鏡像。node

nginx 1.4.x 是一個用nginx做爲反向代理服務器nginx


[X] Docker Server端配置

安裝依賴

yum -y install gcc make file && \
yum -y install tar pcre-devel pcre-staticopenssl openssl-devel httpd-tools

配置SSL

(1) 編輯/etc/hosts,把docker.yy.com的ip地址添加進來,例如:

192.168.2.114 docker.yy.com

(2) 生成根密鑰

先把git

/etc/pki/CA/cacert.pem
/etc/pki/CA/index.txt
/etc/pki/CA/index.txt.attr
/etc/pki/CA/index.txt.old
/etc/pki/CA/serial
/etc/pki/CA/serial.oldgithub

刪除掉!web

cd /etc/pki/CA/
openssl genrsa -out private/cakey.pem 2048

(3) 生成根證書

openssl req -new -x509 -key private/cakey.pem -out cacert.pem

輸出:docker

You are about to be asked to enter information that will be incorporated
into your certificate request.
What you are about to enter is what is called a Distinguished Name or a DN.
There are quite a few fields but you can leave some blank
For some fields there will be a default value,
If you enter '.', the field will be left blank.
-----
Country Name (2 letter code) [XX]:CN
State or Province Name (full name) []:beijing
Locality Name (eg, city) [Default City]:beijing
Organization Name (eg, company) [Default Company Ltd]:youyuan
Organizational Unit Name (eg, section) []:
Common Name (eg, your name or your server's hostname) []:docker.yy.com
Email Address []:

會提示輸入一些內容,由於是私有的,因此能夠隨便輸入,最好記住能與後面保持一致,特別是"Common Name"。上面的自簽證書cacert.pem應該生成在/etc/pki/CA下。centos

(4) 爲咱們的nginx web服務器生成ssl密鑰

mkdir -p /etc/nginx/ssl
cd /etc/nginx/ssl
openssl genrsa -out nginx.key 2048

咱們的CA中心與要申請證書的服務器是同一個,不然應該是在另外一臺須要用到證書的服務器上生成。瀏覽器

(5) 爲nginx生成證書籤署請求

openssl req -new -key nginx.key -out nginx.csr

輸出:

You are about to be asked to enter information that will be incorporated
into your certificate request.
What you are about to enter is what is called a Distinguished Name or a DN.
There are quite a few fields but you can leave some blank
For some fields there will be a default value,
If you enter '.', the field will be left blank.
-----
Country Name (2 letter code) [XX]:CN
State or Province Name (full name) []:beijing
Locality Name (eg, city) [Default City]:beijing
Organization Name (eg, company) [Default Company Ltd]:youyuan
Organizational Unit Name (eg, section) []:
Common Name (eg, your name or your server's hostname) []:docker.yy.com
Email Address []:

Please enter the following 'extra' attributes
to be sent with your certificate request
A challenge password []:
An optional company name []:

一樣會提示輸入一些內容,Commone Name必定要是你要授予證書的服務器域名或主機名,challenge password不填。

(6) 私有CA根據請求來簽發證書

touch /etc/pki/CA/index.txt
touch /etc/pki/CA/serial
echo 00 > /etc/pki/CA/serial
openssl ca -in nginx.csr -out nginx.crt

輸出:

Using configuration from /etc/pki/tls/openssl.cnf
Check that the request matches the signature
Signature ok
Certificate Details:
        Serial Number: 0 (0x0)
        Validity
            Not Before: Dec  9 09:59:20 2014 GMT
            Not After : Dec  9 09:59:20 2015 GMT
        Subject:
            countryName               = CN
            stateOrProvinceName       = beijing
            organizationName          = youyuan
            commonName                = docker.yy.com
        X509v3 extensions:
            X509v3 Basic Constraints:
                CA:FALSE
            Netscape Comment:
                OpenSSL Generated Certificate
            X509v3 Subject Key Identifier:
                5D:6B:02:FF:9E:F8:EA:1B:73:19:47:39:4F:88:93:9F:E7:AC:A5:66
            X509v3 Authority Key Identifier:
                keyid:46:DC:F1:A5:6F:39:EC:6E:77:03:3B:C4:34:03:7E:B8:0A:ED:99:41

Certificate is to be certified until Dec  9 09:59:20 2015 GMT (365 days)
Sign the certificate? [y/n]:y


1 out of 1 certificate requests certified, commit? [y/n]y
Write out database with 1 new entries
Data Base Updated

一樣會提示輸入一些內容,選擇y就能夠了!


安裝,配置,運行nginx

(1) 添加組和用戶:

groupadd www -g 58
useradd -u 58 -g www www

(2) 下載nginx源文件:

cd /tmp
wget http://nginx.org/download/nginx-1.4.6.tar.gz
cp ./nginx-1.4.6.tar.gz /tmp/

(3) 編譯,安裝nginx:

tar zxvf ./nginx-1.4.6.tar.gz
cd ./nginx-1.4.6 && \
  ./configure --user=www --group=www --prefix=/opt/nginx \
  --with-pcre \
  --with-http_stub_status_module \
  --with-http_ssl_module \
  --with-http_addition_module  \
  --with-http_realip_module \
  --with-http_flv_module && \
  make && \
  make install
cd /tmp
rm -rf /tmp/nginx-1.4.6/
rm /tmp/nginx-1.4.6.tar.gz

(4) 生成htpasswd

htpasswd -cb /opt/nginx/conf/.htpasswd ${USER} ${PASSWORD}

(5) 編輯/opt/nginx/conf/nginx.conf文件

#daemon off;

# 使用的用戶和組
user  www www;
# 指定工做進程數(通常等於CPU總核數)
worker_processes  auto;

# 指定錯誤日誌的存放路徑,錯誤日誌記錄級別選項爲:[debug | info | notic | warn | error | crit]
error_log  /var/log/nginx_error.log  error;

#指定pid存放的路徑
#pid        logs/nginx.pid;

# 指定文件描述符數量
worker_rlimit_nofile 51200;

events {
    # 使用的網絡I/O模型,Linux推薦epoll;FreeBSD推薦kqueue
    use epoll;
    # 容許的最大鏈接數
    worker_connections  51200;
    multi_accept on;
}

http {
  include       mime.types;

  log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
                    '$status $body_bytes_sent "$http_referer" '
                    '"$http_user_agent" "$upstream_addr"';

  access_log  /var/log/nginx_access.log  main;

  # 服務器名稱哈希表的桶大小,該默認值取決於CPU緩存
  server_names_hash_bucket_size 128;
  # 客戶端請求的Header頭緩衝區大小
  client_header_buffer_size 32k;
  large_client_header_buffers 4 32k;

  # 啓用sendfile()函數
  sendfile        on;
  tcp_nopush      on;
  tcp_nodelay     on;

  keepalive_timeout  65;

  upstream registry {
    server 127.0.0.1:5000;
  }

  server {
    listen       443;
    server_name  192.168.2.114;

    ssl                  on;
    ssl_certificate /etc/nginx/ssl/nginx.crt;
    ssl_certificate_key /etc/nginx/ssl/nginx.key;

    client_max_body_size 0; # disable any limits to avoid HTTP 413 for large image uploads

    # required to avoid HTTP 411: see Issue #1486 (https://github.com/docker/docker/issues/1486)
    chunked_transfer_encoding on;

    location / {
      auth_basic "registry";
      auth_basic_user_file /opt/nginx/conf/.htpasswd;

      root   html;
      index  index.html index.htm;

      proxy_pass                  http://registry;
      proxy_set_header  Host           $http_host;
      proxy_set_header  X-Real-IP      $remote_addr;
      proxy_set_header  Authorization  "";

      client_body_buffer_size     128k;
      proxy_connect_timeout       90;
      proxy_send_timeout          90;
      proxy_read_timeout          90;
      proxy_buffer_size           8k;
      proxy_buffers               4 32k;
      proxy_busy_buffers_size     64k;  #若是系統很忙的時候能夠申請更大的proxy_buffers 官方推薦*2
      proxy_temp_file_write_size  64k;  #proxy緩存臨時文件的大小
    }
    location /_ping {
      auth_basic off;
      proxy_pass http://registry;
    }
    location /v1/_ping {
      auth_basic off;
      proxy_pass http://registry;
    }
  }
}

(6) 驗證配置

/opt/nginx/sbin/nginx -t

輸出:

nginx: the configuration file /opt/nginx/conf/nginx.conf syntax is ok
nginx: configuration file /opt/nginx/conf/nginx.conf test is successful

(7) 啓動nginx:

/opt/nginx/sbin/nginx

(8) 驗證nginx是否啓動:

ps -ef | grep -i 'nginx'

以下輸出就代表nginx一切正常!

root     27133     1  0 18:58 ?        00:00:00 nginx: master process /opt/nginx/sbin/nginx
www      27134 27133  0 18:58 ?        00:00:00 nginx: worker process
www      27135 27133  0 18:58 ?        00:00:00 nginx: worker process
www      27136 27133  0 18:58 ?        00:00:00 nginx: worker process
www      27137 27133  0 18:58 ?        00:00:00 nginx: worker process
www      27138 27133  0 18:58 ?        00:00:00 nginx: worker process
www      27139 27133  0 18:58 ?        00:00:00 nginx: worker process
www      27140 27133  0 18:58 ?        00:00:00 nginx: worker process
www      27141 27133  0 18:58 ?        00:00:00 nginx: worker process
www      27142 27133  0 18:58 ?        00:00:00 nginx: worker process
www      27143 27133  0 18:58 ?        00:00:00 nginx: worker process
www      27144 27133  0 18:58 ?        00:00:00 nginx: worker process
www      27145 27133  0 18:58 ?        00:00:00 nginx: worker process
www      27146 27133  0 18:58 ?        00:00:00 nginx: worker process
www      27147 27133  0 18:58 ?        00:00:00 nginx: worker process
www      27148 27133  0 18:58 ?        00:00:00 nginx: worker process
www      27149 27133  0 18:58 ?        00:00:00 nginx: worker process
www      27150 27133  0 18:58 ?        00:00:00 nginx: worker process
www      27151 27133  0 18:58 ?        00:00:00 nginx: worker process
www      27152 27133  0 18:58 ?        00:00:00 nginx: worker process
www      27153 27133  0 18:58 ?        00:00:00 nginx: worker process
www      27154 27133  0 18:58 ?        00:00:00 nginx: worker process
www      27155 27133  0 18:58 ?        00:00:00 nginx: worker process
www      27156 27133  0 18:58 ?        00:00:00 nginx: worker process
www      27157 27133  0 18:58 ?        00:00:00 nginx: worker process
root     27160 42863  0 18:58 pts/0    00:00:00 grep -i nginx

配置,運行Docker

(1) 中止docker

service docker stop

(2)編輯/etc/sysconfig/docker文件,加上以下一行

DOCKER_OPTS="--insecure-registry docker.yy.com --tlsverify --tlscacert /etc/pki/CA/cacert.pem"

(3) 把根證書複製到/etc/docker/certs.d/docker.yy.com/目錄下

mkdir -p /etc/docker/certs.d/docker.yy.com/
cp /etc/pki/CA/cacert.pem /etc/docker/certs.d/docker.yy.com/ca-certificates.crt

(4) 啓動docker

service docker start

下載,配置,運行registryimage

(1) 獲取Image

docker pull registry

(2) 運行Image

mkdir -p /opt/registry
docker run -d -e STORAGE_PATH=/registry -v /opt/registry:/registry -p 127.0.0.1:5000:5000 --name registry registry

命令稍加解釋一下: -p 127.0.0.1:5000:5000 registry 做爲上游服務器,這個 5000 端口能夠不用映射出來,由於全部的外部訪問都是經過前端的nginx來提供,nginx 能夠在私有網絡訪問 registry 。

(3) 驗證registry:

用瀏覽器輸入: https://docker.yy.com 或者:curl -i -k https://abc:123@docker.yy.com

服務端的配置就到此完成!


[X] Docker客戶端配置

(1) 編輯/etc/hosts,把docker.yy.com的ip地址添加進來,例如:

192.168.2.114 docker.yy.com

(2) 把docker registry服務器端的根證書追加到ca-certificates.crt文件裏

先從docker registry服務器端把文件/etc/pki/CA/cacert.pem拷貝到本機,而後執行命令:

cat ./cacert.pem >> /etc/pki/tls/certs/ca-certificates.crt

(3) 驗證docker.yy.com下的registry:

用瀏覽器輸入: https://docker.yy.com 或者:curl -i -k https://abc:123@docker.yy.com

(4) 使用私有registry步驟:

  • 登陸: docker login -u abc -p 123 -e "test@gmail.com" https://docker.yy.com
  • 給container起另一個名字: docker tag centos:centos6 docker.yy.com/centos:centos6
  • 發佈: docker push docker.yy.com/centos:centos6

[X] Server端,操做私有倉庫的步驟:

1. 從官方pull下來image!

docker push centos:centos6

2. 查看image的id

執行docker images
輸出:

root@pts/0 # docker images
REPOSITORY                                   TAG                 IMAGE ID            CREATED             VIRTUAL SIZE
centos                                       centos6             25c5298b1a36        8 days ago          215.8 MB

3. 給image賦予一個私有倉庫的tag

docker tag 25c5298b1a36 docker.yy.com/centos:centos6

4. push到私有倉庫

docker push docker.yy.com/centos:centos6

5. 查看image

docker images
輸出:

root@pts/0 # docker images
REPOSITORY                                   TAG                 IMAGE ID            CREATED             VIRTUAL SIZE
centos                                       centos6             25c5298b1a36        8 days ago          215.8 MB
docker.yy.com/centos                         centos6             25c5298b1a36        8 days ago          215.8 MB

[X] Client端,操做私有倉庫的步驟:

1. 從私有倉庫pull下來image!

docker pull docker.yy.com/centos:centos6

2. 查看image

docker images
輸出:

root@pts/0 # docker images
REPOSITORY                                   TAG                 IMAGE ID            CREATED             VIRTUAL SIZE
docker.yy.com/centos                         centos6             25c5298b1a36        8 days ago          215.8 MB

Docker的Web管理界面Shipyard

[0] 編輯/etc/sysconfig/docker文件

DOCKER_OPTS裏添加-H tcp://0.0.0.0:4243 -H unix:///var/run/docker.sock,例如:

DOCKER_OPTS="-H tcp://0.0.0.0:4243 -H unix:///var/run/docker.sock --insecure-registry docker.yy.com --tlsverify --tlscacert /etc/pki/CA/cacert.pem --registry-mirror=http://d194d5cb.m.daocloud.io"

[1] Start an data volume instance of RethinkDB:

docker run -it -d --name shipyard-rethinkdb-data --entrypoint /bin/bash shipyard/rethinkdb -l

[2] Start RethinkDB with using the data volume container:

docker run -it -P -d --name shipyard-rethinkdb --volumes-from shipyard-rethinkdb-data shipyard/rethinkdb

If your server is directly accessible on Internet,
please note your RethinkDB installation may publicly listen to
ports 49153 (local instance), 49154 (cluster) and 49155 (web interface) and so accessible to all.

[3] Start the Shipyard controller:

docker run -it -p 8080:8080 -d --name shipyard --link shipyard-rethinkdb:rethinkdb shipyard/shipyard

Shipyard will create a default user account with the usernameadmin and the passwordshipyard.
You should then be able to open a browser tohttp://<your-host-ip>:8080and see the Shipyard login.

附錄:

(1) 弊端:

server端能夠login到官方的Docker Hub,能夠pull,push官方和私有倉庫!
client端只能操做搭設好的私有倉庫!
私有倉庫不能search!

(2) 優勢:

全部的build,pull,push操做只能在私有倉庫的server端操做,下降企業風險!

(3) 當client端docker login到官方的https://index.docker.io/v1/網站,出現x509: certificate signed by unknown authority錯誤時

重命名根證書! mv /etc/pki/tls/certs/ca-certificates.crt /etc/pki/tls/certs/ca-certificates.crt.bak
重啓docker服務! service docker restart!

相關文章
相關標籤/搜索