from docker hub to bluemix catalog

© 2016 IBM Corporation

從 DockerHub 擴展Bluemix Catalog中的服務

Joseph Chang

Cloud Tech Sales

IBM Cloud, TW

Document number

(From DockerHub to Bluemix Catalog)


From DockerHub to Bluemix Catalog

從 Bluemix Catalog 佈署Runtimes/Services非常快速容易, 但有時我要的服務不在 Catalog

……上 .



Docker Hub 上有數千個由軟體商或社群提供的 image, 可以讓您自由擴充Bluemix 的私人目錄



從 Docker Hub 下載 image 可快速擴充 Bluemix Catalog



Docker Hub Bluemix

How it works? 只要一行指令

bluemix ic cpi <image on docker> registry.ng.bluemix.net/<myreg>/<image on bluemix>:<ver>

(2) 執行 bluemix ic cpi 指令 , image 就會出現在 Bluemix 目錄

(1) 安裝 bluemix command line, 並執

行初始化設定( one time job)



Docker Hub Bluemix

環境需求

(1) 需要https://hub.docker.com 帳號密碼

(2) 需要https://www.bluemix.net 帳號密碼

(3) 需要安裝docker command line 工具

(4) 需要安裝 bluemix command line 及 ibm container plug-in 工具

如果需要安裝說明，請參考附錄



執行步驟

1. 連線到 https://hub.docker.com/explore 搜尋所需的 image

在此我們以 Nginx 為例作說明

https://hub.docker.com/explore



執行步驟

由 docker pull command 可查到正確的 imange 名稱

2. 點選所要的 image, 檢視 Docker Pull Command



執行步驟

bluemix ic cpi nginx registry.ng.bluemix.net/<Namespace >/nginx:<ver>

如果忘了自已設的Namespace 名稱，可用 cf ic info 查詢

cf ic cpi nginx registry.ng.bluemix.net/<Namespace>/nginx:<ver>

or

如果用的是舊版工具CF Command line

只要學會 cpi 指令,就一切搞定

註 : cpi 是 copy image 的意思

3. 開啟 bluemix 命令列 , 做變更語言設定及登入

export LANG=en_USbluemix login

4. 最後執行下列命令 ,就可將 image 載入到 Bluemix Catalog



範例 1 – Nginx (完整操作 )

cf ic cpi 指令執行參考結果

Taiwan 的使用者請將語言設定為 en_US 或

zh_Hant否則 cf ic 會出現錯誤

執行 cf ic ……. 亦可用 bluemix ic …..



Nginx –list images

執行成功後至 Catalog Container 查看 nginx 圖示

是否已建立(您必須登入 bluemix UI)

bluemix ic images 指令可以顯示你所擁有的 image

接下來請點選 nginx 圖示以建立 container



Nginx- create container1. 點選 Scalable

Group 以方便未來做 Scale

out

2. 指定 group name, host name 會同時被

指定

3. 指定 instance 數量

4. 指定 Http port => 80

Scalabile Group 不佔用固定的 private IP

5. 按 CREATE



Nginx- container is running 點選 Routes 以檢視網站



Nginx- check website

Nginx 執行中



Nginx- 用 bluemix ic comand Line 檢視

bluemix ic ps注意 : 這裡可以取得

container id

bluemix ic exec <container id> whoami

注意 : 你的身份是container root



Nginx- bluemix ic comand Line

bluemix ic exec <container id> ls -al



範例 2-- Jboss

bluemix ic cpi jboss/wildfly registry.ng.bluemix.net/<myreg>/jboss-wildfly:new



附錄



(1) 註冊 Docker 帳號

如果你還沒有 docker 帳號 , 請在 https://hub.docker.com 註冊，才能有下載權限

https://hub.docker.com/



(2) 註冊 Bluemix 帳號

如果你還沒有 bluemix 帳號 , 請在 https://www.bluemix.net 註冊



(3) Install Docker CLI

如尚未安裝 Docker 或需要更新，請下載及安裝 1.10.0. .– OS X https

://github.com/docker/toolbox/releases/download/v1.10.0/DockerToolbox-1.10.0.pkg– Windows

https://github.com/docker/toolbox/releases/download/v1.10.0/DockerToolbox-1.10.0.exe

– Linux Refer to the Docker installation documentation to find instructions on how to install Docker version 1.10.0 on the Linux distribution you use.

可支援的版本包括 Docker version 1.6, 1.7, 1.8, 1.8.1, 1.9.0, 1.9.1, or 1.10.0

https://github.com/docker/toolbox/releases/download/v1.10.0/DockerToolbox-1.10.0.pkg

https://github.com/docker/toolbox/releases/download/v1.10.0/DockerToolbox-1.10.0.pkg



(4) Install Bluemix CLI

請參考文件說明 : http://clis.ng.bluemix.net/ui/home.html



(5) Install ibm-containers plug-in

請參考文件說明 : http://plugins.ng.bluemix.net/ui/repository.html



(6) bluemix login

Bluemix 不認得 zh_TW 設定 , 請將 LANG 變數設成 en_US 或 zh_Hant

• 初次登入 bluemix command line, 您需要設定 api end point

未做語言設定會看到此錯誤訊息



(6) bluemix login

請依指示輸入 e-mail, password, organization, space 等資訊



(7) bluemix ic 可讓您查看可用命令

27



8) bluemix ic init

如何你是第一次使用 bluemix ic 命令，請先執行

bluemix ic init



(9) bluemix ic info

JosephdeMacBook-Pro:~ joseph$ bluemix ic info

日期 /時間 : 2016-05-05 11:29:52.883075718 +0800 CST

除錯模式 : false

CCS 主機 /url : https://containers-api.ng.bluemix.net

登錄主機 : https://registry.ng.bluemix.net

Bluemix api 主機 /url : https://api.ng.bluemix.net

Bluemix 組織 : [email protected](1f6d3957-c6c6-4804-a8c2-5c7b5d382387)

Bluemix 空間 : 1-sandbox(3fb3e792-dfb1-4fc2-83ab-62435218d59a)

CCS CLI 版本 : 0.9.1

CCS API 版本 : 3.0 2159 2016-05-04T14:28:53

名稱空間 : jjregistry

環境名稱 : prod-dal09-1

儲存器限制 : 無限制

儲存器使用狀況 : 1

儲存器在執行中 : 1

CPU 限制（核心） : 無限制

CPU 使用率（核心） : 1

記憶體限制 (MB) : 2048

記憶體用量 (MB) : 64

浮動 IP 限制 : 2

配置的浮動 IP : 1

連結的公用 IP : 1

******************

* 系統訊息 *

******************

The size of an image reported by IBM Containers may be the virtual size of zero, this is a known issue, it does not affect the running of containers based on the image. || 建立時間： 2016-03-30 18:48:16

bluemix ic info 指令可檢查您的 docker 設定是否成功



Thank you



31

Take me to BluemixClick Here

To learn more about Bluemix Docker Container :

https://console.ng.bluemix.net/docs/containers/container_creating_ov.html#container_gettingstarted_container

Thank you

from docker hub to bluemix catalog

Technology