shipyard研發系列（1）-shipyard安裝指南

這是一個建立於 的文章，其中的資訊可能已經有所發展或是發生改變。

Docker之shipyard安裝指南

一、前言：最近在研究shipyard的docker容器管理平台，在研究過程發現自己對docker基礎理解還存在一定的欠缺，為了更好的理解docker，將我對shipyard項目的理解共用給docker愛好者，也系統的形成一份研發日誌。dockerclub的shipyard研發系列詳細請訪問

二、shipyard項目介紹：shipyard是一個整合管理docker容器、鏡像、Registries的系統，他最大亮點應該是支援多節點的整合管理，可以動態載入節點，可託管node下的容器。這裡暫時不對shipyard的細節講解，後續章節會講他的架構。

三、shipyard安裝使用介紹，shipyard項目的安裝可以參考官網逐步操作，這裡補充一些坑的解決過程。

3.1 首次部署指令碼

curl -sSL https://shipyard-project.com/deploy | bash -s

• ACTION: 可以使用的指令 (deploy, upgrade, node, remove)

  1. DISCOVERY: 叢集系統採用Swarm進行採集和管理(在節點管理中可以使用‘node’)

  2. IMAGE: 鏡像，預設使用shipyard的鏡像

  3. PREFIX: 容器名字的首碼

  4. SHIPYARD_ARGS: 容器的常用參數

  5. TLS_CERT_PATH: TLS憑證路徑

  6. PORT: 主程式監聽連接埠 (預設連接埠: 8080)

  7. PROXY_PORT: 代理連接埠 (預設: 2375)

3.2 指令碼可選項

• 如果你要自訂部署，請參考以下規範

  1. 部署action：指令有效變數

  2. deploy: 部署新的shipyard執行個體

  3. upgrade: 更新已存在的執行個體（注意：你要保持相同的系統內容、變數來部署同樣的配置）

  4. node: 使用Swarm增加一個新的node

  5. remove: 刪除已存在的shipyard執行個體（容器）

3.3 鏡像使用

• 你可以採取規範的鏡像來部署執行個體，比如以下的測試版本，你也已這樣做

 curl -sSL https://shipyard-project.com/deploy | IMAGE=shipyard/shipyard:test bash -s

3.4 首碼使用

• 你可以定義你想要的首碼，比如

 curl -sSL https://shipyard-project.com/deploy | PREFIX=shipyard-test bash -s

3.5 參數使用

• 這裡增加一些shipyard運行參數，你可以像這樣進行調整：

     curl -sSL https://shipyard-project.com/deploy | SHIPYARD_ARGS="--ldap-server=ldap.example.com --ldap-autocreate-users" bash -s

3.6TLS認證使用

• 啟用TLS對組建進行部署，包括代理（proxy）、swarm叢集系統、shipyard管理平台的配置，這是一個配置規範。認證必須採用以下命名規範：

  1. ca.pem: 安全認證認證

  2. server.pem: 伺服器憑證

  3. server-key.pem: 伺服器私人認證

  4. cert.pem: 用戶端認證

  5. key.pem: 用戶端認證的key

• 注意：認證將被放置在一個docker容器中，並在各個組成部分之間共用。如果需要調試，可以將此容器串連到調試容器。資料容器名稱為首碼的認證。

 docker run --rm \    -v $(pwd)/certs:/certs \    ehazlett/certm \    -d /certs \    bundle \    generate \    -o shipyard \    --host proxy \    --host 127.0.0.1

• 你也可以按如下指令來部署系統

   curl -sSL https://shipyard-project.com/deploy | TLS_CERT_PATH=$(pwd)/certs bash -s

3.7增加一個部署節點

• shipyard節點部署指令碼將自動的安裝key/value儲存系統（etcd系統）。增加一個節點到swarm叢集，你可以使用以下的節點部署指令碼

curl -sSL https://shipyard-project.com/deploy | ACTION=node  DISCOVERY=etcd://10.0.1.10:4001 bash -s

• 注意：10.0.1.10這個ip地址你需要修改為你的首次初始化shipyard系統的主機地址

3.8刪除shipyard系統

 curl -sSL https://shipyard-project.com/deploy | ACTION=remove bash -s

3.9 附件：

• 下面是筆者部署後的效果，如果你遇到問題，可以在dockerclub.net問答社區上給我留言。

  1. 啟動介面
     

  2. 容器詳細情況
     

  3. 鏡像
     

  4. 節點