diff --git a/SUMMARY.md b/SUMMARY.md index 9c88cdd..896586c 100644 --- a/SUMMARY.md +++ b/SUMMARY.md @@ -13,6 +13,7 @@ * [安装 Docker](install/README.md) * [Ubuntu](install/ubuntu.md) * [Debian](install/debian.md) + * [Fedora](install/fedora.md) * [CentOS](install/centos.md) * [Raspberry Pi](install/raspberry-pi.md) * [macOS](install/mac.md) diff --git a/install/fedora.md b/install/fedora.md new file mode 100644 index 0000000..fdfeef6 --- /dev/null +++ b/install/fedora.md @@ -0,0 +1,170 @@ +## Fedora 安装 Docker CE + +>警告:切勿在没有配置 Docker dnf 源的情况下直接使用 dnf 命令安装 Docker. + +### 准备工作 + +#### 系统要求 + +Docker CE 支持以下版本的 [Fedora](https://fedoraproject.org/) 操作系统: + +* 26 +* 27 +* 28 + +#### 卸载旧版本 + +旧版本的 Docker 称为 `docker` 或者 `docker-engine`,使用以下命令卸载旧版本: + +```bash +$ sudo dnf remove docker \ + docker-client \ + docker-client-latest \ + docker-common \ + docker-latest \ + docker-latest-logrotate \ + docker-logrotate \ + docker-selinux \ + docker-engine-selinux \ + docker-engine +``` + +### 使用 dnf 安装 + +执行以下命令安装依赖包: + +```bash +$ sudo dnf -y install dnf-plugins-core +``` + +鉴于国内网络问题,强烈建议使用国内源,官方源请在注释中查看。 + +执行下面的命令添加 `dnf 软件源: + +```bash +$ sudo dnf config-manager \ + --add-repo \ + https://mirrors.ustc.edu.cn/docker-ce/linux/fedora/docker-ce.repo + + +# 官方源 +# $ sudo dnf config-manager \ +# --add-repo \ +# https://download.docker.com/linux/fedora/docker-ce.repo +``` + +如果需要测试版本的 Docker CE 请使用以下命令: + +```bash +$ sudo dnf config-manager --set-enabled docker-ce-test +``` + +如果需要每日构建版本的 Docker CE 请使用以下命令: + +```bash +$ sudo dnf config-manager --set-enabled docker-ce-nightly +``` + +你也可以禁用测试版本的 Docker CE + +```bash +$ sudo dnf config-manager --set-disabled docker-ce-test +``` + +#### 安装 Docker CE + +更新 `dnf` 软件源缓存,并安装 `docker-ce`。 + +```bash +$ sudo dnf update +$ sudo dnf install docker-ce +``` + +你也可以使用以下命令安装指定版本的 Docker + +```bash +$ dnf list docker-ce --showduplicates | sort -r + +docker-ce.x86_64 18.06.1.ce-3.fc28 docker-ce-stable + +$ sudo dnf -y install docker-ce-18.06.1.ce +``` + +### 使用脚本自动安装 + +在测试或开发环境中 Docker 官方为了简化安装流程,提供了一套便捷的安装脚本,Debian 系统上可以使用这套脚本安装: + +```bash +$ curl -fsSL get.docker.com -o get-docker.sh +$ sudo sh get-docker.sh --mirror Aliyun +``` + +执行这个命令后,脚本就会自动的将一切准备工作做好,并且把 Docker CE 最新版本安装在系统中。 + +### 启动 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 hello-world + +Unable to find image 'hello-world:latest' locally +latest: Pulling from library/hello-world +d1725b59e92d: Pull complete +Digest: sha256:0add3ace90ecb4adbf7777e9aacf18357296e799f81cabc9fde470971e499788 +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://hub.docker.com/ + +For more examples and ideas, visit: + https://docs.docker.com/get-started/ +``` + +若能正常输出以上信息,则说明安装成功。 + +### 镜像加速 + +鉴于国内网络问题,后续拉取 Docker 镜像十分缓慢,强烈建议安装 Docker 之后配置 [国内镜像加速](mirror.md)。 + +### 参考文档 + +* [Docker 官方 Fedora 安装文档](https://docs.docker.com/install/linux/docker-ce/fedora)。