本篇作為書籤用途,紀錄網路上的 Docker 參考資料

  • docs.docker.com Search URL https://docs.docker.com/search/?q={q} 其中 {q} 可替換成要搜尋的文字

重點名詞

  • Layer: 層,一組唯讀的文件或命令,描述如何在容器下設置底層系統。層 (Layer) 構建在彼此之上,每個層代表對文件系統的更改
  • Image: 映像檔,一個不可變的層 (Layer),形成容器的基礎
  • Container: 容器,可以作為獨立執行應用程式的映像檔實例。容器具有可變層,該可變層位於映像檔的頂部並且與底層相分離
  • Registry: 註冊伺服器,用於散佈 Docker 映像檔的存儲系統
  • Repository: 倉庫,一組相關相同應用程式但不同版本的 Docker 映像檔儲存倉庫

啟動 Docker 容器內的命令列

一般來說我們可以使用 docker attach 來將 Docker 運行中的容器附加到終端機上,讓我們能夠在容器內操作指令,但如果這個容器是一個運行中的 Web 服務,這只應會讓你附加到 Web Server Process,你只會看到 Web Server Process 所透過 stdout 輸出的訊息,這時我們便無法做更多操作。

如果你想要在一個運行 Web 服務的伺服器進行操作,可以使用以下指令來啟動該容器內的伺服器 cmd 指令:

docker exec -it <YOUR_CONTAINER_ID_OR_NAME> cmd

如果你的容器是使用 Linux,可以將 cmd 改成 bash

REF: https://stackoverflow.com/questions/30172605/how-do-i-get-into-a-docker-container

基本指令

Docker CLI 官方文件:Use the Docker command line

開發 Docker 容器相關:

  • docker create [image]: Create a new container from a particular image.
  • docker login: 登錄 Docker Hub 或私有的 Docker 註冊伺服器
  • docker build: 建立一個新的映像檔 doc
  • docker pull [image]: 從倉庫取得所需要的映像檔
  • docker push [username/image]: 把自己建立的映像檔上傳到倉庫中來共享
  • docker search [term]: Search the Docker Hub repository for a particular term.
  • docker tag [source] [target]: 為目標映像檔新增標籤或匿名 (alias)

執行 Docker 容器相關:

  • docker start [container]: 啟動一個已經停止的容器
  • docker stop [container]: 停止一個執行中的容器
  • docker exec -it [container] [command]: Run a shell command inside a particular container.
  • docker run [image] 啟動容器 doc
  • docker run -it -image [image] [container] [command]: 建立並啟動容器,並在內部執行指令
  • docker run -it -rm -image [image] [container] [command]: 建立並啟動容器,並在內部執行指令,指令完成後自動移除此容器
  • docker pause [container]: Pause all processes running within a particular container.

使用 Docker 工具:

  • docker history [image]: Display the history of a particular image.
  • docker images: 顯示所有儲存在本機的映像檔 doc
  • docker inspect [object]: Display low-level information about a particular Docker object.
  • docker ps: 列出當前正在運行的所有容器 doc
  • docker version: 顯示系統上當前安裝的 Docker 版本

清理 Docker 環境:

  • docker kill [container]: Kill a particular container. doc
  • docker kill $(docker ps -q): Kill all containers that are currently running.
  • docker rm [container]: 移除本地端未執行的容器 doc
  • docker rm $(docker ps -a -q):移除本地端所有未執行的容器
  • docker rmi [image] 移除本地端的映像檔 doc

Docker Image 名稱必須是小寫,否則會無法編譯。

DockerFile

使用 Dockerfile 讓使用者可以建立自定義的映像檔。

Dockerfile 分為四部分:

  • 基底映像檔資訊、
  • 維護者資訊
  • 映像檔操作指令和
  • 容器啟動時執行指令

範例:

FROM microsoft/dotnet:2.1-aspnetcore-runtime
WORKDIR /app 
ADD /apppublish/ .
ENTRYPOINT ["dotnet", "MyClass.dll"]

ADD 和 COPY 的差別

先說結論,根據官方文件 Docker Doc - ADD or COPY 建議使用 COPY,因為使用上會比較直覺且指令的意思和一般使用上的預期結果一致。

COPY 指令相對單純,只會將來源參數的檔案,複製至目的地路徑。

ADD 指令做的事情比較多,如下:

  • 可以使用 URL 作為來源參數,通過 URL 下載文件並且複製到目的地路徑
  • 若來源參數是一個壓縮檔格式(tar, gzip, bzip2, etc),會自動解壓縮並存至目的地路徑

使用 ADD 的時候,你可能會遇到有時解壓縮,有時又不會的奇妙現象,因此建議使用單純一點的 COPY 指令,讓行為比較符合預期。如果你明確知道要用 ADD 來達成下載遠端檔案的行為,這時候 ADD 是你的好幫手。

常用的 Docker Image

Push Docker Image Push 到 Docker Hub

註冊 Docker Hub 帳號。

  1. docker images 查看本機的 Docker Images
  2. docker tag Image-Name Docker-Hub-Account/Image-Name 將本機的 Image-Name Docker Images 加上 tag
  • 須注意 Docker Tag 的格式,前面為 Docker Hub 帳號名稱
  1. docker login 登入 Docker Hub
  2. docker push Docker-Hub-Account/Image-Name 將指定的 Docker Image Push 到 Docker Hub 上
  3. 完成後,登入 Docker Hub 網站就可以看到上傳的 Docker Image

若要從 Docker Hub Pull 指定的 Docker Image,請執行 docker pull Docker-Hub-Account/Image-Name

推送映像檔至 Azure Container Registry

官方文件

  1. 登入 Azure Container Registry,下面指令擇一
  • az acr login --name myregistry
  • docker login myregistry.azurecr.io -u xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -p myPassword
  1. 取得映像檔
  • docker pull nginx
  1. 建立別名
  • docker tag nginx myregistry.azurecr.io/samples/nginx
  1. 將映像推送至您的登錄庫
  • docker push myregistry.azurecr.io/samples/nginx

遠端操作 Docker

有時候不想登入 Docker 的伺服器,想透過自己的電腦做遠端操作,可以使用 -H 並指定連線位置,然後下指令執行。

例如下面這個指令,是遠端操作 DOCKER_REMOTE_SERVER 這台伺服器,執行 docker logs --tail 100 WebApp 印出 WebApp 這個 Container 最後 100 行的 Log 資料。

docker -H=DOCKER_REMOTE_SERVER logs --tail 100 WebApp

如果經常需要這樣操作了話,可以透過 alias 來建立別名指令:

alias dockerx="docker -H=DOCKER_REMOTE_SERVER"

REF:

Docker Compose

使用指定的 docker-compose.yml 設定檔來啟動遠端的容器。注意,指定遠端主機的地方要加上 2375 的 Port 號。

docker-compose.exe -H REMOTE_DOCKER_IP:2375 -f docker/command/docker-compose.yml up

參考資料:


Poy Chang

Trial and Error