## 樹莓派卡片電腦安裝 Docker CE >警告：切勿在沒有配置 Docker APT 源的情況下直接使用 apt 命令安裝 Docker. ### 系統要求 Docker CE 不僅支持 `x86_64` 架構的計算機，同時也支持 `ARM` 架構的計算機，本小節內容以樹莓派單片電腦為例講解 `ARM` 架構安裝 Docker CE。 Docker CE 支持以下版本的 [Raspbian](https://www.raspberrypi.org/downloads/raspbian/) 操作系統： * Raspbian Stretch * Raspbian Jessie *注：* `Raspbian` 是樹莓派的開發與維護機構 [樹莓派基金會](http://www.raspberrypi.org/) 推薦用于樹莓派的首選系統，其基于 `Debian`。 ### 使用 APT 安裝 由于 apt 源使用 HTTPS 以確保軟件下載過程中不被篡改。因此，我們首先需要添加使用 HTTPS 傳輸的軟件包以及 CA 證書。 ```bash $ sudo apt-get update $ sudo apt-get install \ apt-transport-https \ ca-certificates \ curl \ gnupg2 \ lsb-release \ software-properties-common ``` 鑒于國內網絡問題，強烈建議使用國內源，官方源請在注釋中查看。 為了確認所下載軟件包的合法性，需要添加軟件源的 GPG 密鑰。 ```bash $ curl -fsSL https://mirrors.ustc.edu.cn/docker-ce/linux/raspbian/gpg | sudo apt-key add - # 官方源 # $ curl -fsSL https://download.docker.com/linux/raspbian/gpg | sudo apt-key add - ``` 然后，我們需要向 `source.list` 中添加 Docker CE 軟件源： ```bash $ sudo add-apt-repository \ "deb [arch=armhf] https://mirrors.ustc.edu.cn/docker-ce/linux/raspbian \ $(lsb_release -cs) \ stable" # 官方源 # $ sudo add-apt-repository \ # "deb [arch=armhf] https://download.docker.com/linux/raspbian \ # $(lsb_release -cs) \ # stable" ``` >以上命令會添加穩定版本的 Docker CE APT 源，如果需要測試或每日構建版本的 Docker CE 請將 stable 改為 test 或者 nightly。 #### 安裝 Docker CE 更新 apt 軟件包緩存，并安裝 `docker-ce`。 ```bash $ sudo apt-get update $ sudo apt-get install docker-ce ``` ### 使用腳本自動安裝 在測試或開發環境中 Docker 官方為了簡化安裝流程，提供了一套便捷的安裝腳本，Raspbian 系統上可以使用這套腳本安裝： ```bash $ curl -fsSL get.docker.com -o get-docker.sh $ sudo sh get-docker.sh --mirror Aliyun ``` 執行這個命令后，腳本就會自動的將一切準備工作做好，并且把 Docker CE 的 Edge 版本安裝在系統中。 ### 啟動 Docker CE ```bash $ sudo systemctl enable docker $ sudo systemctl start docker ``` ### 建立 docker 用戶組 默認情況下，`docker` 命令會使用 [Unix socket](https://en.wikipedia.org/wiki/Unix_domain_socket) 與 Docker 引擎通訊。而只有 `root` 用戶和 `docker` 組的用戶才可以訪問 Docker 引擎的 Unix socket。出于安全考慮，一般 Linux 系統上不會直接使用 `root` 用戶。因此，更好地做法是將需要使用 `docker` 的用戶加入 `docker` 用戶組。 建立 `docker` 組： ```bash $ sudo groupadd docker ``` 將當前用戶加入 `docker` 組： ```bash $ sudo usermod -aG docker $USER ``` 退出當前終端并重新登錄，進行如下測試。 ### 測試 Docker 是否安裝正確 ```bash $ docker run arm32v7/hello-world Unable to find image 'hello-world:latest' locally latest: Pulling from library/hello-world ca4f61b1923c: Pull complete Digest: sha256:be0cd392e45be79ffeffa6b05338b98ebb16c87b255f48e297ec7f98e123905c Status: Downloaded newer image for hello-world:latest Hello from Docker! This message shows that your installation appears to be working correctly. To generate this message, Docker took the following steps: 1. The Docker client contacted the Docker daemon. 2. The Docker daemon pulled the "hello-world" image from the Docker Hub. (amd64) 3. The Docker daemon created a new container from that image which runs the executable that produces the output you are currently reading. 4. The Docker daemon streamed that output to the Docker client, which sent it to your terminal. To try something more ambitious, you can run an Ubuntu container with: $ docker run -it ubuntu bash Share images, automate workflows, and more with a free Docker ID: https://cloud.docker.com/ For more examples and ideas, visit: https://docs.docker.com/engine/userguide/ ``` 若能正常輸出以上信息，則說明安裝成功。 *注意：* ARM 平臺不能使用 `x86` 鏡像，查看 Raspbian 可使用鏡像請訪問 [arm32v7](https://hub.docker.com/u/arm32v7/)。 ### 鏡像加速 鑒于國內網絡問題，后續拉取 Docker 鏡像十分緩慢，強烈建議安裝 Docker 之后配置 [國內鏡像加速](mirror.md)。