# Docker (二) - Docker 的基本操作

上一篇介紹完了[容器與 Docker 的基本概念](https://tienyulin.github.io/docker-concept/)，這一篇我們要開始來介紹 Docker 的一些基本操作。

在開始操作前，我們需要先安裝 Docker，安裝的方式依照作業系統不同可以在[Docker 官網](https://docs.docker.com/engine/install/)找到相對應的安裝方式。

<!--more-->

## Docker開機自動啟動
安裝好 Docker 後，建議設定讓 Docker 開機自動啟動，才能在伺服器或電腦重啟時不用再手動啟動 Docker。

* Windows 系統設定方式:
在 Docker 的設定裡勾選 `Start Docker Desktop when you log in`

* Linux系統設定方式:
> systemctl : 負責控制 systemd 系統與服務管理器

sudo systemctl enable docker

## Docker Image 的管理
安裝好 Docker 之後，就可以開始建立自己的 Image 或是下載別人做好的 Image。

### 下載 Image
我們先利用 `docker pull <ImageName>` 指令從 DockerHub 下載 [portainer](https://hub.docker.com/r/portainer/portainer) 這個 Image，portainer 是一種 Docker UI 的管理工具。

# 從 remote repository (docker hub) 下載 image
docker pull portainer/portainer

### 列出 Image
下載好 portainer 後，可以透過以下兩種指令來列出所有的 Image。

docker images
docker image ls

### 搜尋 Image
如果想直接搜尋 DockerHub 上面的 Image 可以透過 `search` 指令來搜尋。

docker search ubuntu

### 刪除 Image
刪除 Image 可以使用 `rmi` 指令並且指定 ImageId 來刪除。

docker rmi <ImageId>

若是要刪除所有的 Image，可以指定所有的 ImageId 來刪除。
* -q : 列出 Image Id

docker rmi $(docker images -q)

或是 docker 本身支援的 prune 來刪除

Options :
* -a, `--all` : 刪除全部
* -f : 不跳出確認提醒

 docker image prune <options>

options 沒有填的話只會刪除那些沒有被引用的 Image 和 Dangling Image。

#### Dangling Image
Dangling Image 是指這個 Image 已經沒有被使用到了。例如，同樣的 Dockerfile 重新建立 Image 後，則新建立的 Image 會被 tag 為 latest，舊的 Image 不會再被用到就是 Dangling Image。

### 給 Image 加上 Tag
使用 `tag` 指令給 Image 加上 tag(標籤)。先在 Image 後面加上 `:`，接著再冒號後面填入 tag。tag 通常是版本號碼，例如: ImageName:20200611.1，20200611.1 即為標籤。

呈上，tag 可以是日期、編號或其他能代表出這個 Image 的用途。加上 tag 的目的是為了提供給這個 Image 更詳細的資訊，所以在命名上要特別注意。

另外，若是沒加上 tag，建立好的 Image 預設 tag 會是 latest，所以每次上傳到 Repository 時都是一樣的 ImageName 和 tag。而 Docker 在下載 Image 時，若沒指定 tag 就會自動代入 latest，所以為了避免混淆還是建議要加上 tag。

docker tag <ImageName> <ImageName>:<tag>

### 使用 Dockerfile 建立 Image
除了下載別人做好的 Image，我們也可以自己建立 Image。至於甚麼是 Dockerfile ? 又該如何建立成 Image 呢 ?

詳細作法請參考下一篇 [Docker(三) - 撰寫 Dockerfile](https://tienyulin.github.io/docker-dockerfile/)

## Docker Container 的管理
有了 Image 之後我們就可以使用 Image 來建立 Container。

### 建立 Container
使用 `docker run <ImageName>` 就可以建立起一個 Container，但是通常還會再給予一些變數來設定要啟動的 Container，例如:
* -d : 背景執行
* -h : 自訂 Host Name
* -i : 進入互動模式(interaactive)，讓 Container 的標準輸入保持打開
* -t : 配置一個虛擬終端(pseudo-tty)並綁定到 Container 上
* -p : 設定要對外開啟的 port number(host port:container port)
* -e : 設定環境變數
* -v : 資料對應(host folder:container folder)
* `--name` : 自訂 Container 名稱
* `--restart` : 設定重啟模式，預設是 No，但實務上應設定 always 才不會因為意外停止還需要人為手動重啟

以下以建立 portainer 的 Container 為例，如果 Image 已經有下載過了，則建立 Container 時會直接拿來做使用，若是沒有下載 Image，在建立時 Docker 會自動去 DockerHub 上面下載下來再使用。

docker run \
-d \
--restart always \
--name portainer \
-p 9000:9000 \
-v /var/run/docker.sock:/var/run/docker.sock \
-v /volume1/docker/portainer:/data \
portainer/portainer

建立好後，直接打開瀏覽器輸入 `http://127.0.0.1:9000/` 就會進入到登入畫面，即表示建立成功。

### 列出 Cotainer
透過 `docker ps -a` 可以列出所有的 Container。

docker ps -a

如果只想列出正在執行的 Container，則使用 `docker ps` 即可。

docker ps

### 啟動 Container
若是有建立好的 Container 沒有啟動或是因為某些緣故停止了需要手動啟動，可以使用 `start` 指令來啟動。

docker start <ContainerName>

### 停止 Container

docker stop <ContainerName>

### 刪除 Container

docker rm <ContainerId>

### 查看 Container log
使用 `docker logs` 可以查看 Container 的執行紀錄。
* -f : 持續印出執行紀錄不會跳離，可以不加

docker logs -f <ContainerName>

### 進入 Container
如果需要對 Container 進行操作，而且必需進到 Container 內，可以使用 `exec` 指令來對 Container 執行`bash`。
* -i: 進入互動模式(interaactive)，讓 Container 的標準輸入保持打開
* -t: 配置一個虛擬終端(pseudo-tty)並綁定到 Container 上

docker exec -it <containerName> bash
docker exec -it <containerName> /bin/bash

# 有些 Image 使用 Alpine Linux，可能沒有 bash，改用 sh
docker exec -it <containerName> /bin/sh

exec 後面接到 bash 或是 /bin/bash 其實都是 Container 裡的指令，只是打開 Container 的 bash，所以如果沒有一定要開 bash，其實也可以直接輸入指令。例如 :

docker exec -it <containerName> ls

進入 Container 的另一種方式是使用 `attach` 指令，但是退出 Container 時會導致 Container 停止，所以實務上不太會使用。

docker attach <containerName>

### 清除沒有執行的 Container、Image 、Network 和 Cache
Options :
* `--all` , -a : 刪除所有停止的 Container、Image、Network
* `--force`, -f : 強制刪除不跳出確認提醒
* `--volumes` : 刪除 Volume
* `--filter` : 刪除指定 label 的 Container、Image、Network、Volume

docker system prune <options>

options 沒有填的話只會刪除那些沒有被引用的 Image 和 [Dangling Image](#Dangling-Image)。

## Docker 推送 Image 到 Repository
除了 DockerHub 有提供 Container Registry 讓開發者存放 Image，Google、Microsoft 等等的公司也都有提供，以下以 DockerHub 的 Repository 為範例進行操作。

### 新建 Repository
首先要在 DockerHub 註冊帳號，新建一個 Repository，每個帳號有一個免費的 Private Repository，其他的 Repository 必須是 Public。

接下來回到 CommandLine 開始準備要上傳的 Image。

### 給 Image 加上 Tag
因為要上傳到 DockerHub 所以還必須指定 DockerHubUserName 和 RepositoryName，這樣再上傳的時候才會傳到對應的 Repository。

docker tag <ImageName> <DockerHubUserName>/<RepositoryName>/<ImageName>:<Tag>

### 登入 DockerHub
準備好 Image 後，接著就可以開始上傳了。上傳前要先使用 `login` 指令登入 Docker 的帳戶，再輸入 UserName 和 Password。

docker login

也可以加上 `-u` 和 `-p` 或是 `--username` 和 `--password`，直接打上帳號密碼，一次完成登入步驟

docker login -u <UserName> -p <Password>
docker login --username <UserName> --password <Password>

### 上傳 Image
上傳使用的是 `push` 指令，將已經加好 tag 的 Image 上傳到 Repository。

docker push <DockerHubUserName>/<RepositoryName>/<ImageName>:<Tag>

### 登出 DockerHub
上傳完記得要登出 DockerHub。

docker logout

## Summary
以上介紹完了常用的 Docker 操作方法和指令，下一篇將介紹如何使用 Dockerfile 自己建立 Image。

## 參考
[1] [Docker(一) - 容器與 Docker 的基本概念](/Cz7PXrF0SEeT0LLDsLYeLw)
[2] [把 Docker Image Push 到 Docker Hub](https://ithelp.ithome.com.tw/articles/10191139)
[3] [Docker 基本教學](https://ithelp.ithome.com.tw/articles/10199339)
[4] [Docker 學習筆記(三) — Docker指令講解](https://medium.com/%E4%B8%80%E5%80%8B%E5%B0%8F%E5%B0%8F%E5%B7%A5%E7%A8%8B%E5%B8%AB%E7%9A%84%E9%9A%A8%E6%89%8B%E7%AD%86%E8%A8%98/docker-%E5%AD%B8%E7%BF%92%E7%AD%86%E8%A8%98-docker%E6%8C%87%E4%BB%A4%E4%BD%BF%E7%94%A8%E8%AC%9B%E8%A7%A3-9040d9de4677)
[5] [docker system prune](https://docs.docker.com/engine/reference/commandline/system_prune/#examples)
[6] [如何快速清理 Docker 無用資源](https://kknews.cc/zh-tw/code/kbb6byq.html)

###### tags: `Container` `Docker`