Fix format

Remove duplicated words

.devcontainer/devcontainer.json

@@ -1,3 +1,5 @@
+// https://code.visualstudio.com/docs/remote/devcontainerjson-reference
+
 {
   "image": "yeasy/docker_practice:latest",
   "mounts": [

.github/CODEOWNERS

@@ -28,7 +28,6 @@
 /.editorconfig/       @khs1994
 /.gitattributes       @khs1994
 /.gitignore           @khs1994
-/.travis.yml          @khs1994
 /_config.yml          @yeasy @khs1994
 /book.json            @yeasy @khs1994
 /CHANGELOG.md         @yeasy @khs1994

.github/ISSUE_TEMPLATE/Bug_report.md

@@ -21,11 +21,11 @@ about: Create a report to help us improve
 * [x] Others (Pls describe below)
 
 ### Docker Version
-<!--如果你的 Docker 版本低于 19.03 请尽可能升级到该版本，保留你的 Docker 版本，其他选项删除-->
-<!--if Docker version under 19.03, please upgrade Docker to 19.03-->
+<!--如果你的 Docker 版本低于 20.10 请尽可能升级到该版本，保留你的 Docker 版本，其他选项删除-->
+<!--if Docker version under 20.10, please upgrade Docker to 20.10-->
 
-* [x] Edge (v19.03)
-* [x] Stable (v19.03)
+* [x] Test (v20.10)
+* [x] Stable (v20.10)
 * [x] 1.13.0 or Before
 
 ### Problem Description

.github/ISSUE_TEMPLATE/Custom.md

@@ -21,11 +21,11 @@ about: Create a issue about Docker
 * [x] Others (Pls describe below)
 
 ### Docker Version
-<!--如果你的 Docker 版本低于 19.03 请尽可能升级到该版本，保留你的 Docker 版本，其他选项删除-->
-<!--if Docker version under 19.03, please upgrade Docker to 19.03-->
+<!--如果你的 Docker 版本低于 20.10 请尽可能升级到该版本，保留你的 Docker 版本，其他选项删除-->
+<!--if Docker version under 20.10, please upgrade Docker to 20.10-->
 
-* [x] Edge (v19.03)
-* [x] Stable (v19.03)
+* [x] Test (v20.10)
+* [x] Stable (v20.10)
 * [x] 1.13.0 or Before
 
 ### Problem Description

.github/workflows/check-link.yml

@@ -1,4 +1,4 @@
-name: check-link
+name: Check link
 
 on:
   # push:
@@ -25,7 +25,6 @@ jobs:
           "192.168.199.100",\
           "github.com/settings",\
           "github.com/docker/compose/releases/download",\
-          "github.com/docker/machine/releases/download",\
           "github.com/etcd-io/etcd/releases/download",\
           "github.com/tianon/gosu/releases/download",\
           "github.com/yeasy/docker_practice",\
@@ -37,7 +36,6 @@ jobs:
           "nodejs.org/dist/",\
           "c.163.com/hub",\
           "drone.yeasy.com",\
-          "mirrors.ustc.edu.cn",\
           "docs.docker.com",\
           "dockerhub.azk8s.cn",\
           "reg-mirror.qiniu.com",\
@@ -52,7 +50,6 @@ jobs:
           "security.ubuntu.com/ubuntu",\
           "nginx.com",\
           "img.shields.io/github/release/yeasy/docker_practice",\
-          "travis-ci.org/yeasy/docker_practice.svg",\
           "launchpad.net",\
           "www.w3.org/1999",\
           "chat.freenode.net",\
@@ -60,12 +57,13 @@ jobs:
           "product.china-pub.com",\
           "union-click.jd.com",\
           "x.x.x.x/base",\
-          "x.x.x.x:9000/minio/",\
+          "x.x.x.x:9090",\
           "yeasy.gitbooks.io",\
+          "download.fastgit.org",\
           "www.aliyun.com" \
           --allow-dupe \
           --skip-save-results \
           -t 10 \
-          `find . \( -path "./mesos" -o -path "./machine" -o -path "./swarm_mode" \) -prune -o -name "*.md" -exec ls {} \;`
+          `find . \( -path "./mesos" -o -path "./swarm_mode" \) -prune -o -name "*.md" -exec ls {} \;`
         name: check-link
         timeout-minutes: 25

.github/workflows/ci.yaml

@@ -5,18 +5,67 @@ on:
 
 name: CI
 
+defaults:
+  run:
+    shell: bash --noprofile --norc -exo pipefail {0}
+
 jobs:
   build:
-    name: Build GitBook
+    name: Build
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@master
         with:
           fetch-depth: 2
-      - name: Build
+      - name: Build Gitbook
         uses: docker://yeasy/docker_practice
         with:
           args: build
+      - name: Build Gitbook Docker Image
+        if: github.repository == 'docker-practice/docker_practice'
+        run: |
+          sudo chmod -R 777 _book
+          echo "FROM nginx:alpine" >> Dockerfile
+          echo "COPY _book /usr/share/nginx/html" >> Dockerfile
+          echo "COPY .docker/docker-entrypoint.sh /" >> Dockerfile
+          echo "ENTRYPOINT [\"/docker-entrypoint.sh\"]" >> Dockerfile
+
+          export VCS_REF=`git rev-parse --short HEAD`
+
+          docker build \
+          -t dockerpracticesig/docker_practice \
+          -t dockerpracticesig/docker_practice:gitbook \
+          --label org.opencontainers.image.revision=$VCS_REF \
+          --label org.opencontainers.image.source="https://github.com/yeasy/docker_practice" \
+          --label maintainer="https://github.com/docker-practice" \
+          .
+
+          docker run -d --rm -p 4000:80 dockerpracticesig/docker_practice
+
+          sleep 5
+
+          echo "::group::Test"
+          curl 127.0.0.1:4000
+          echo "::endgroup::"
+
+          echo "$DOCKER_PASSWORD" | docker login -u "$DOCKER_USERNAME" --password-stdin
+          docker push dockerpracticesig/docker_practice
+          docker push dockerpracticesig/docker_practice:gitbook
+        env:
+          DOCKER_PASSWORD: ${{secrets.DOCKER_PASSWORD}}
+          DOCKER_USERNAME: ${{secrets.DOCKER_USERNAME}}
+      - name: Upload Gitbook dist
+        uses: docker://pcit/pages
+        if: github.repository == 'docker-practice/docker_practice'
+        env:
+          PCIT_EMAIL: khs1994@khs1994.com
+          PCIT_GIT_TOKEN: ${{ secrets.PCIT_GIT_TOKEN }}
+          PCIT_GIT_URL: github.com/docker-practice/zh-cn
+          PCIT_KEEP_HISTORY: "true"
+          PCIT_LOCAL_DIR: _book
+          PCIT_MESSAGE: Build from yeasy/docker_practice@${{github.sha}}
+          PCIT_TARGET_BRANCH: master
+          PCIT_USERNAME: khs1994
       - name: vuepress
         run: |
           sudo rm -rf _book
@@ -26,12 +75,13 @@ jobs:
           git clone https://github.com/docker-practice/.vuepress  .vuepress2
           cp -r .vuepress2/. .vuepress/
           rm -rf .vuepress2
-          find . \( -path "./mesos" -o -path "./machine" -o -path "./swarm_mode" -o -path "./node_modules" -o -path "./.vuepress" -o -path "./_book" -o -path "./CHANGELOG.md" -o -path "./CONTRIBUTING.md" \) -prune -o -name "*.md" -exec sed -i 'N;2a\<AdSenseTitle/>\n' {} \;
+          find . \( -path "./mesos" -o -path "./swarm_mode" -o -path "./node_modules" -o -path "./.vuepress" -o -path "./_book" -o -path "./CHANGELOG.md" -o -path "./CONTRIBUTING.md" \) -prune -o -name "*.md" -exec sed -i 'N;2a\<AdSenseTitle/>\n' {} \;
 
           npx vuepress --version
 
           npm run vuepress:build
-          echo "vuepress.docker-practice.com" > .vuepress/dist/CNAME
+          # echo "vuepress.docker-practice.com" > .vuepress/dist/CNAME
+          echo "vuepress.mirror.docker-practice.com" > .vuepress/dist/CNAME
 
           cp -r _images .vuepress/dist
           cp -r advanced_network/_images .vuepress/dist/advanced_network
@@ -45,7 +95,6 @@ jobs:
           cp -r install/_images .vuepress/dist/install
           cp -r introduction/_images .vuepress/dist/introduction
           cp -r kubernetes/_images .vuepress/dist/kubernetes
-          cp -r mesos/_images .vuepress/dist/mesos
           cp -r underly/_images .vuepress/dist/underly
 
           echo "include: [_images]" > .vuepress/dist/_config.yml
@@ -58,30 +107,30 @@ jobs:
           PCIT_GIT_URL: github.com/docker-practice/vuepress
           PCIT_KEEP_HISTORY: "true"
           PCIT_LOCAL_DIR: .vuepress/dist
-          PCIT_MESSAGE: Sync from yeasy/docker_practice@${{github.sha}} by PCIT
+          PCIT_MESSAGE: Build from yeasy/docker_practice@${{github.sha}}
           PCIT_TARGET_BRANCH: master
           PCIT_USERNAME: khs1994
-      - name: Set coding.net CNAME
-        run: |
-          echo "vuepress.mirror.docker-practice.com" > .vuepress/dist/CNAME
-      - name: Upload Vuepress dist to coding.net
-        uses: docker://pcit/pages
-        if: github.repository == 'docker-practice/docker_practice'
-        env:
-          PCIT_EMAIL: khs1994@khs1994.com
-          PCIT_GIT_TOKEN: ${{ secrets.CODING_GIT_TOKEN }}
-          PCIT_GIT_URL: e.coding.net/dpsigs/docker_practice
-          PCIT_KEEP_HISTORY: "true"
-          PCIT_LOCAL_DIR: .vuepress/dist
-          PCIT_MESSAGE: Sync from yeasy/docker_practice@${{github.sha}} by PCIT
-          PCIT_TARGET_BRANCH: master
-          PCIT_USERNAME: ptt0xjqzbke3
+      # - name: Set coding.net CNAME
+      #   run: |
+      #     echo "vuepress.mirror.docker-practice.com" > .vuepress/dist/CNAME
+      # - name: Upload Vuepress dist to coding.net
+      #   uses: docker://pcit/pages
+      #   if: github.repository == 'docker-practice/docker_practice'
+      #   env:
+      #     PCIT_EMAIL: khs1994@khs1994.com
+      #     PCIT_GIT_TOKEN: ${{ secrets.CODING_GIT_TOKEN }}
+      #     PCIT_GIT_URL: e.coding.net/dpsigs/docker_practice
+      #     PCIT_KEEP_HISTORY: "true"
+      #     PCIT_LOCAL_DIR: .vuepress/dist
+      #     PCIT_MESSAGE: Build from yeasy/docker_practice@${{github.sha}}
+      #     PCIT_TARGET_BRANCH: master
+      #     PCIT_USERNAME: ptt0xjqzbke3
       - name: Build vuepress docker image
         if: github.repository == 'docker-practice/docker_practice'
         run: |
           sudo rm -rf .vuepress/dist/.git
 
-          echo "FROM nginx:alpine" >> Dockerfile
+          echo "FROM nginx:alpine" > Dockerfile
           echo "COPY .vuepress/dist /usr/share/nginx/html" >> Dockerfile
           echo "COPY .docker/docker-entrypoint.sh /" >> Dockerfile
           echo "ENTRYPOINT [\"/docker-entrypoint.sh\"]" >> Dockerfile
@@ -98,9 +147,13 @@ jobs:
 
           docker push dockerpracticesig/docker_practice:vuepress
 
-          docker run -it --rm -d -p 4000:80 dockerpracticesig/docker_practice:vuepress
+          docker run -it --rm -d -p 4001:80 dockerpracticesig/docker_practice:vuepress
 
-          curl 127.0.0.1:4000
+          sleep 5
+
+          echo "::group::Test"
+          curl 127.0.0.1:4001
+          echo "::endgroup::"
         env:
           DOCKER_PASSWORD: ${{secrets.DOCKER_PASSWORD}}
           DOCKER_USERNAME: ${{secrets.DOCKER_USERNAME}}

.gitignore

@@ -9,3 +9,5 @@ _book/
 
 node_modules/
 package-lock.json
+
+docker-compose.override.yml

.travis.yml

@@ -1,65 +0,0 @@
-language: bash
-
-services:
-- docker
-
-before_install:
-- openssl aes-256-cbc -K $encrypted_6cc8cff04075_key -iv $encrypted_6cc8cff04075_iv
-  -in .travis/id_rsa.enc -out ~/.ssh/id_rsa -d
-- chmod 600 ~/.ssh/id_rsa
-- export TZ='Asia/Shanghai'
-- date
-- git config --global user.name "khs1994"
-- git config --global user.email "khs1994@khs1994.com"
-
-script:
-- docker run -it --rm -v $PWD:/srv/gitbook-src yeasy/docker_practice build
-
-after_success:
-- sudo chmod -R 777 _book
-
-- echo "FROM nginx:alpine" >> Dockerfile
-- echo "COPY _book /usr/share/nginx/html" >> Dockerfile
-- echo "COPY .docker/docker-entrypoint.sh /" >> Dockerfile
-- echo "ENTRYPOINT [\"/docker-entrypoint.sh\"]" >> Dockerfile
-
-- echo "$DOCKER_PASSWORD" | docker login -u "$DOCKER_USERNAME" --password-stdin
-- export VCS_REF=`git rev-parse --short HEAD`
-- |
-  docker build \
-    -t dockerpracticesig/docker_practice \
-    -t dockerpracticesig/docker_practice:gitbook \
-    --label org.opencontainers.image.revision=$VCS_REF \
-    --label org.opencontainers.image.source="https://github.com/yeasy/docker_practice" \
-    --label maintainer="https://github.com/docker-practice" \
-    .
-
-- docker run -dit --rm -p 4000:80 dockerpracticesig/docker_practice
-
-- sleep 5
-- curl 127.0.0.1:4000
-
-- docker push dockerpracticesig/docker_practice
-- docker push dockerpracticesig/docker_practice:gitbook
-
-- cd _book
-- rm -rf .github/workflows
-- git init
-- git remote add origin "$DEPLOY_REPO"
-- git add .
-- COMMIT=`date "+%F %T"`
-- git commit -m "Travis CI Site updated $COMMIT yeasy/docker_practice@${TRAVIS_COMMIT}"
-- git push -f origin master:"$DEPLOY_BRANCH"
-
-env:
-  global:
-  - DEPLOY_BRANCH: master
-  - DEPLOY_REPO: git@github.com:docker-practice/zh-cn.git
-
-addons:
-  ssh_known_hosts:
-  - github.com
-
-branches:
-  only:
-  - master

.vuepress/config.js

@@ -1,8 +1,6 @@
-const resolve = require("vuepress-theme-hope/resolve");
-// const { config } = require('vuepress-theme-hope')
+const { config } = require('vuepress-theme-hope')
 
-// module.exports =config({
-module.exports = resolve({
+module.exports = config({
   title: 'Docker 从入门到实践',
   base: '/',
   head: [['script', {}, `
@@ -40,6 +38,11 @@ module.exports = resolve({
     //   onlyFirstAndLastCommit: true,
     // },
   },
+  locales: {
+    "/": {
+      lang: "zh-CN"
+    }
+  },
   themeConfig: {
     blog: false,
     // comment: false,
@@ -49,29 +52,40 @@ module.exports = resolve({
       appKey: "...", // your appKey
     },
     pageInfo: [
-      // 'Author',
-      'ReadTime',
-      'Word',
+      // 'author',
+      'reading-time',
+      'word',
     ],
     footer: {
-      content: "Made with <a target='_blank' href='https://github.com/mister-hope/vuepress-theme-hope'>vuepress-theme-hope</a>",
+      content: "Made with <a target='_blank' href='https://github.com/vuepress-theme-hope/vuepress-theme-hope'>vuepress-theme-hope</a>",
       display: true,
       copyright: false,
     },
     searchPlaceholder: 'Search',
     repo: 'yeasy/docker_practice',
     repoLabel: 'GitHub',
+    repoDisplay: true,
     hostname: 'https://vuepress.mirror.docker-practice.com',
     // author: 'yeasy',
-    markdown: {
+    mdEnhance: {
       lineNumbers: true,
     },
+    git: {
+      contributor: false,
+    },
     themeColor: {
       blue: '#2196f3',
       // red: '#f26d6d',
       // green: '#3eaf7c',
       // orange: '#fb9b5f'
     },
+    locales: {
+      "/": {
+        lang: "zh-CN"
+      }
+    },
+
+    darkmode: 'auto-switch',
 
     //
 
@@ -84,11 +98,11 @@ module.exports = resolve({
     nav: [
       {
         text: '微信交流群',
-        link: 'https://yewm28.coding-pages.com/wechat.jpg',
+        link: 'https://docker_practice.gitee.io/pic/dpsig-wechat.jpg',
       },
       {
         text: '小程序',
-        link: 'https://yewm28.coding-pages.com/49682252-3ac4c500-faec-11e8-86ab-eafe0139be6b.jpg',
+        link: 'https://docker_practice.gitee.io/pic/dp-wechat-miniprogram.jpg',
       },
       {
         text: '安装 Docker',
@@ -118,17 +132,17 @@ module.exports = resolve({
         text: "云计算",
         link: "/cloud/",
       },
-      {
-        text: 'GitHub',
-        link: 'https://github.com/yeasy/docker_practice'
-      },
+      // {
+      //   text: 'GitHub',
+      //   link: 'https://github.com/yeasy/docker_practice'
+      // },
       // {
       //   text: '捐赠',
       //   link: ''
       // },
       {
-        text: '腾讯云容器服务',
-        link: 'https://cloud.tencent.com/act/cps/redirect?redirect=10058&cps_key=3a5255852d5db99dcd5da4c72f05df61'
+        text: '云服务器99/元首年特惠',
+        link: 'https://cloud.tencent.com/act/cps/redirect?redirect=1062&cps_key=3a5255852d5db99dcd5da4c72f05df61&from=console'
       },
       // {
       //   text: '语言',
@@ -152,7 +166,7 @@ module.exports = resolve({
         'design',
         {
           title: "部署 Kubernetes",
-          collapsable: false,
+          collapsable: true,
           children: [
             "setup/",
             "setup/kubeadm",
@@ -163,7 +177,7 @@ module.exports = resolve({
         },
         {
           title: "Kubernetes 命令行 kubectl",
-          collapsable: false,
+          collapsable: true,
           children: [
             'kubectl/'
           ]
@@ -171,6 +185,7 @@ module.exports = resolve({
       ],
       '/compose/': [
         'introduction',
+        'v2',
         'install',
         'usage',
         'commands',
@@ -185,9 +200,8 @@ module.exports = resolve({
         'debian',
         'fedora',
         'centos',
-        'centos8',
         'raspberry-pi',
-        'offline',
+        // 'offline',
         'mac',
         'windows',
         'mirror',
@@ -218,13 +232,12 @@ module.exports = resolve({
         'actions/',
         {
           title: "Drone",
-          collapsable: false,
+          collapsable: true,
           children: [
             'drone/',
             'drone/install'
           ]
         },
-        'travis/'
       ],
       '/': [
         '/',
@@ -264,7 +277,7 @@ module.exports = resolve({
         },
         {
           title: 'Dockerfile',
-          collapsable: false,
+          collapsable: true,
           children: [
             "image/dockerfile/",
             'image/dockerfile/copy',
@@ -330,7 +343,7 @@ module.exports = resolve({
         },
         {
           title: "高级网络配置",
-          collapsable: false,
+          collapsable: true,
           children: [
             'advanced_network/',
             'advanced_network/quick_guide',
@@ -344,7 +357,7 @@ module.exports = resolve({
         },
         {
           title: "Swarm mode",
-          collapsable: false,
+          collapsable: true,
           children: [
             'swarm_mode/',
             'swarm_mode/overview',
@@ -358,7 +371,7 @@ module.exports = resolve({
         },
         {
           title: "安全",
-          collapsable: false,
+          collapsable: true,
           children: [
             'security/',
             'security/kernel_ns',
@@ -371,7 +384,7 @@ module.exports = resolve({
         },
         {
           title: "底层实现",
-          collapsable: false,
+          collapsable: true,
           children: [
             'underly/',
             'underly/arch',
@@ -394,7 +407,7 @@ module.exports = resolve({
         },
         {
           title: "Etcd",
-          collapsable: false,
+          collapsable: true,
           children: [
             'etcd/',
             'etcd/intro',
@@ -405,7 +418,7 @@ module.exports = resolve({
         },
         {
           title: "Fedora CoreOS",
-          collapsable: false,
+          collapsable: true,
           children: [
             'coreos/',
             'coreos/intro',
@@ -416,7 +429,7 @@ module.exports = resolve({
         'appendix/faq/',
         {
           title: "热门镜像介绍",
-          collapsable: false,
+          collapsable: true,
           children: [
             'appendix/repo/',
             'appendix/repo/ubuntu',
@@ -433,7 +446,7 @@ module.exports = resolve({
         },
         {
           title: "Docker 命令",
-          collapsable: false,
+          collapsable: true,
           children: [
             'appendix/command/',
             'appendix/command/docker',

CHANGELOG.md

@@ -1,5 +1,10 @@
 # 修订记录
 
+* 1.3.0 2021-YY-DD
+  * 全面支持 Docker v20.10 新版本
+  * 新增 Docker Compose v2
+  * Docker Hub 自动构建转为付费功能
+
 * 1.2.0 2020-12-20
   * 错误修复
 

README.md

@@ -1,14 +1,12 @@
 # Docker — 从入门到实践
 
-[![](https://img.shields.io/github/stars/yeasy/docker_practice.svg?style=social&label=Stars)](https://github.com/yeasy/docker_practice) [![](https://travis-ci.org/yeasy/docker_practice.svg?branch=master)](https://travis-ci.org/yeasy/docker_practice) [![](https://img.shields.io/github/release/yeasy/docker_practice/all.svg)](https://github.com/yeasy/docker_practice/releases) [![](https://img.shields.io/badge/Based-Docker%20CE%20v19.03-blue.svg)](https://github.com/docker/docker-ce) [![](https://img.shields.io/badge/Docker%20%E6%8A%80%E6%9C%AF%E5%85%A5%E9%97%A8%E4%B8%8E%E5%AE%9E%E6%88%98-jd.com-red.svg)][1]
+[![](https://img.shields.io/github/stars/yeasy/docker_practice.svg?style=social&label=Stars)](https://github.com/yeasy/docker_practice) [![](https://img.shields.io/github/release/yeasy/docker_practice/all.svg)](https://github.com/yeasy/docker_practice/releases) [![](https://img.shields.io/badge/Based-Docker%20CE%20v20.10-blue.svg)](https://github.com/docker/docker-ce) [![](https://img.shields.io/badge/Docker%20%E6%8A%80%E6%9C%AF%E5%85%A5%E9%97%A8%E4%B8%8E%E5%AE%9E%E6%88%98-jd.com-red.svg)][1]
 
-**v1.2.0**
+**v1.3.0**
 
-| 语言           | 构建状态   | - |
-| :------------- | :------------- | :--- |
-| [zh-hans](https://github.com/yeasy/docker_practice)        | [![](https://travis-ci.org/yeasy/docker_practice.svg?branch=master)](https://travis-ci.org/yeasy/docker_practice)| [阅读](https://vuepress.mirror.docker-practice.com/) |
-| [us-en](https://github.com/yeasy/docker_practice/tree/english)          | [![](https://travis-ci.org/yeasy/docker_practice.svg?branch=english)](https://travis-ci.org/yeasy/docker_practice)| [阅读](https://docker_practice.gitee.io/us-en) |
-| [zh-hant](https://github.com/yeasy/docker_practice/tree/zh-Hant)        | [![](https://travis-ci.org/yeasy/docker_practice.svg?branch=zh-hant)](https://travis-ci.org/yeasy/docker_practice)| [阅读](https://docker_practice.gitee.io/zh-hant) |
+| 语言           | - |
+| :------------- | :--- |
+| [简体中文](https://github.com/yeasy/docker_practice)              | [阅读](https://vuepress.mirror.docker-practice.com/) |
 
 [Docker](https://www.docker.com) 是个划时代的开源项目，它彻底释放了计算虚拟化的威力，极大提高了应用的维护效率，降低了云计算应用开发的成本！使用 Docker，可以让应用的部署、测试和分发都变得前所未有的高效和轻松！
 
@@ -17,7 +15,7 @@
 本书既适用于具备基础 Linux 知识的 Docker 初学者，也希望可供理解原理和实现的高级用户参考。同时，书中给出的实践案例，可供在进行实际部署时借鉴。前六章为基础内容，供用户理解 Docker 的基本概念和操作；7 ~ 9 章介绍包括数据管理、网络等高级操作；第 10 ~ 12 章介绍了容器生态中的几个核心项目；13、14 章讨论了关于 Docker 安全和实现技术等高级话题。后续章节则分别介绍包括 Etcd、Fedora CoreOS、Kubernetes、容器云等相关热门开源项目。最后，还展示了使用容器技术的典型的应用场景和实践案例。
 
 * 在线阅读：[docker-practice.com](https://vuepress.mirror.docker-practice.com/)，[GitBook](https://yeasy.gitbook.io/docker_practice/)，[Github](https://github.com/yeasy/docker_practice/blob/master/SUMMARY.md)
-* [离线阅读 `$ docker run -it --rm -p 4000:80 ccr.ccs.tencentyun.com/dockerpracticesig/docker_practice:vuepress`](https://github.com/yeasy/docker_practice/wiki/%E7%A6%BB%E7%BA%BF%E9%98%85%E8%AF%BB%E5%8A%9F%E8%83%BD%E8%AF%A6%E8%A7%A3)
+* 离线阅读：[`$ docker run -it --rm -p 4000:80 ccr.ccs.tencentyun.com/dockerpracticesig/docker_practice:vuepress`](https://github.com/yeasy/docker_practice/wiki/%E7%A6%BB%E7%BA%BF%E9%98%85%E8%AF%BB%E5%8A%9F%E8%83%BD%E8%AF%A6%E8%A7%A3)
 
 Docker 自身仍在快速发展中，生态环境也在蓬勃成长。建议初学者使用最新稳定版本的 Docker 进行学习实践。欢迎 [参与项目维护](CONTRIBUTING.md)。
 
@@ -27,7 +25,7 @@ Docker 自身仍在快速发展中，生态环境也在蓬勃成长。建议初
 ## 微信小程序
 
 <p align="center">
-<img width="200" src="https://yewm28.coding-pages.com/49682252-3ac4c500-faec-11e8-86ab-eafe0139be6b.jpg">
+<img width="200" src="https://docker_practice.gitee.io/pic/dp-wechat-miniprogram.jpg">
 </p>
 
 <p align="center"><strong>微信扫码 随时随地阅读~</strong></p>
@@ -35,7 +33,7 @@ Docker 自身仍在快速发展中，生态环境也在蓬勃成长。建议初
 ## 技术交流
 
 <p align="center">
-<img width="200" src="https://yewm28.coding-pages.com/wechat.jpg">
+<img width="200" src="https://docker_practice.gitee.io/pic/dpsig-wechat.jpg">
 </p>
 
 <p align="center"><strong>微信扫码 加入群聊~ 或者微信添加 <code>dpsigs</code> 邀请入群</strong></p>
@@ -53,7 +51,7 @@ Docker 自身仍在快速发展中，生态环境也在蓬勃成长。建议初
 * QQ 群 IX  （已满）：571502246
 * QQ 群 X   （可加）：145983035
 
->如果有容器相关的疑问，请通过 [Issues](https://github.com/yeasy/docker_practice/issues/new/choose) 来提出。
+>如果有容器技术相关的疑问，请通过 [Issues](https://github.com/yeasy/docker_practice/issues/new/choose) 来提出。
 
 ## 进阶学习
 
@@ -72,4 +70,4 @@ Docker 自身仍在快速发展中，生态环境也在蓬勃成长。建议初
 
 <p align="center"><strong>欢迎鼓励项目一杯 coffee~</strong></p>
 
-[1]: https://union-click.jd.com/jdc?e=&p=AyIGZRtYFAcXBFIZWR0yEgRQH1kXAhs3EUQDS10iXhBeGlcJDBkNXg9JHU4YDk5ER1xOGRNLGEEcVV8BXURFUFdfC0RVU1JRUy1OVxUBFwNXGVscMlVYLlAaXAV1Z1JHA0dWEHVXZTliY1QLWStaJQAWB10fXhwKEDdlG1wlUHzf462DsLMO0%2F%2BUjp2VIgZlG18RBBcCUBlbEAoTBWUcWxwySVI7HAhBBxEOBUgOFQYQUGUraxYyIjdVK1glQHxXUEhYEVEUUFQcC0IHGgRRSAgVARAPAhsLFgNCDl0ZWiUAEwZREg%3D%3D&t=W1dCFFlQCxxKQgFHREkdSVJKSQVJHFRXFk9FUlpGQUpLCVBaTFhbXQtWVmpSWRtYEAYQBVUS
+[1]: https://union-click.jd.com/jdc?e=&p=JF8AANADIgZlGF0VAxUDVBJdHDISBFAfWRcCGzcRRANLXSJeEF4aVwkMGQ1eD0kdSVJKSQVJHBIEUB9ZFwIbGAxeB0gyS34PbFlHVHNkI0MQEAoIcSxyBWFLRAtZK1olABYHXR9eHAoQN2UbXCVQfN_jrYOwsw7T_5SOnZUiBmUbXBYBFwBVG14UBBAAZRxbHDJJUjscCEEHEQ4FSA4VBhBQZStrFjIiN1UrWCVAfARQT1gQA0cFAEwOEAcRDlMTDEALQAFTEwwRUhMAUR1cJQATBlES

SUMMARY.md

@@ -15,7 +15,6 @@
   * [Debian](install/debian.md)
   * [Fedora](install/fedora.md)
   * [CentOS](install/centos.md)
-    * [CentOS8](install/centos8.md)
   * [Raspberry Pi](install/raspberry-pi.md)
   * [Linux 离线安装](install/offline.md)
   * [macOS](install/mac.md)
@@ -83,6 +82,7 @@
   * [使用 buildx 构建多种系统架构支持的 Docker 镜像](buildx/multi-arch-images.md)
 * [Docker Compose](compose/README.md)
   * [简介](compose/introduction.md)
+  * [Compose v2](compose/v2.md)
   * [安装与卸载](compose/install.md)
   * [使用](compose/usage.md)
   * [命令说明](compose/commands.md)
@@ -126,7 +126,7 @@
   * [基本概念](kubernetes/concepts.md)
   * [架构设计](kubernetes/design.md)
 * [部署 Kubernetes](kubernetes/setup/README.md)
-    * [使用 kubeadm 部署 kubernetes](kubernetes/setup/kubeadm.md)
+  * [使用 kubeadm 部署 kubernetes(CRI 使用 containerd)](kubernetes/setup/kubeadm.md)
   * [在 Docker Desktop 使用](kubernetes/setup/docker-desktop.md)
   * [一步步部署 kubernetes 集群](kubernetes/setup/systemd.md)
   * [部署 Dashboard](kubernetes/setup/dashboard.md)
@@ -147,7 +147,6 @@
   * [GitHub Actions](cases/ci/actions/README.md)
   * [Drone](cases/ci/drone/README.md)
     * [部署 Drone](cases/ci/drone/install.md)
-    * [Travis CI](cases/ci/travis/README.md)
 * [在 IDE 中使用 Docker](ide/README.md)
   * [VS Code](ide/vsCode.md)
 * [podman - 下一代 Linux 容器工具](podman/README.md)
@@ -170,16 +169,3 @@
   * [附录四：Dockerfile 最佳实践](appendix/best_practices.md)
   * [附录五：如何调试 Docker](appendix/debug.md)
   * [附录六：资源链接](appendix/resources.md)
-* [归档](archive/README.md)
-    * [Mesos - 优秀的集群资源调度平台](mesos/README.md)
-        * [Mesos 简介](mesos/intro.md)
-        * [安装与使用](mesos/installation.md)
-        * [原理与架构](mesos/architecture.md)
-        * [Mesos 配置项解析](mesos/configuration.md)
-        * [日志与监控](mesos/monitor.md)
-        * [常见应用框架](mesos/framework.md)
-        * [本章小结](mesos/summary.md)
-    * [Docker Machine](machine/README.md)
-        * [安装](machine/install.md)
-        * [使用](machine/usage.md)
-    * [Docker Swarm](swarm/README.md)

advanced_network/README.md

@@ -6,10 +6,10 @@
 
 当 Docker 启动时，会自动在主机上创建一个 `docker0` 虚拟网桥，实际上是 Linux 的一个 bridge，可以理解为一个软件交换机。它会在挂载到它的网口之间进行转发。
 
-同时，Docker 随机分配一个本地未占用的私有网段（在 [RFC1918](https://tools.ietf.org/html/rfc1918) 中定义）中的一个地址给 `docker0` 接口。比如典型的 `172.17.42.1`，掩码为 `255.255.0.0`。此后启动的容器内的网口也会自动分配一个同一网段（`172.17.0.0/16`）的地址。
+同时，Docker 随机分配一个本地未占用的私有网段（在 [RFC1918](https://datatracker.ietf.org/doc/html/rfc1918) 中定义）中的一个地址给 `docker0` 接口。比如典型的 `172.17.42.1`，掩码为 `255.255.0.0`。此后启动的容器内的网口也会自动分配一个同一网段（`172.17.0.0/16`）的地址。
 
 当创建一个 Docker 容器的时候，同时会创建了一对 `veth pair` 接口（当数据包发送到一个接口时，另外一个接口也可以收到相同的数据包）。这对接口一端在容器内，即 `eth0`；另一端在本地并被挂载到 `docker0` 网桥，名称以 `veth` 开头（例如 `vethAQI2QT`）。通过这种方式，主机可以跟容器通信，容器之间也可以相互通信。Docker 就创建了在主机和所有容器之间一个虚拟共享网络。
 
-![Docker 网络](_images/network.png)
+![Docker 网络](./_images/network.png)
 
 接下来的部分将介绍在一些场景中，Docker 所有的网络定制配置。以及通过 Linux 命令来调整、补充、甚至替换 Docker 默认的网络配置。

advanced_network/access_control.md

@@ -1,4 +1,5 @@
 # 容器访问控制
+
 容器的访问控制，主要通过 Linux 上的 `iptables` 防火墙来进行管理和实现。`iptables` 是 Linux 上默认的防火墙软件，在大部分发行版中都自带。
 
 ## 容器访问外部网络

advanced_network/example.md

@@ -1,4 +1,5 @@
 # 工具和示例
+
 在介绍自定义网络拓扑之前，你可能会对一些外部工具和例子感兴趣：
 
 ## pipework

appendix/debug.md

@@ -21,8 +21,8 @@ $ sudo kill -SIGHUP $(pidof dockerd)
 ## 检查内核日志
 
 ```bash
-$ sudo dmesag |grep dockerd
-$ sudo dmesag |grep runc
+$ sudo dmesg |grep dockerd
+$ sudo dmesg |grep runc
 ```
 
 ## Docker 不响应时处理

appendix/repo/minio.md

@@ -1,8 +1,8 @@
 # minio
-[TOC]
-MinIO 是一个基于Apache License v2.0开源协议的对象存储服务。它兼容亚马逊S3云存储服务接口，非常适合于存储大容量非结构化的数据，例如图片、视频、日志文件、备份数据和容器/虚拟机镜像等，而一个对象文件可以是任意大小，从几kb到最大5T不等。
 
-MinIO是一个非常轻量的服务,可以很简单的和其他应用的结合，类似 NodeJS, Redis 或者 MySQL。
+**MinIO** 是一个基于 Apache License v2.0 开源协议的对象存储服务。它兼容亚马逊 S3 云存储服务接口，非常适合于存储大容量非结构化的数据，例如图片、视频、日志文件、备份数据和容器/虚拟机镜像等，而一个对象文件可以是任意大小，从几 kb 到最大 5T 不等。
+
+MinIO 是一个非常轻量的服务,可以很简单的和其他应用的结合，类似 NodeJS, Redis 或者 MySQL。
 
 [官方文档](https://docs.min.io/)
 
@@ -11,12 +11,9 @@ MinIO是一个非常轻量的服务,可以很简单的和其他应用的结合
 测试、开发环境下不考虑数据存储的情况下可以使用下面的命令快速开启服务。
 
 ```bash
-docker pull minio/minio
-docker run -p 9000:9000 minio/minio server /data
+$ docker run -d -p 9000:9000 -p 9090:9090 minio/minio server /data --console-address ':9090'
 ```
 
-
-
 ## 离线部署
 
 许多生产环境是一般是没有公网资源的，这就需要从有公网资源的服务器上把镜像导出，然后导入到需要运行镜像的内网服务器。
@@ -26,37 +23,36 @@ docker run -p 9000:9000 minio/minio server /data
 在有公网资源的服务器上下载好`minio/minio`镜像
 
 ```bash
-docker save -o minio.tar minio/minio:latest
+$ docker save -o minio.tar minio/minio:latest
 ```
 
-<!--使用docker save 的时候，也可以使用image id 来导出，但是那样导出的时候，就会丢失原来的镜像名称，推荐，还是使用镜像名字+tag来导出镜像-->
+> 使用docker save 的时候，也可以使用image id 来导出，但是那样导出的时候，就会丢失原来的镜像名称，推荐，还是使用镜像名字+tag来导出镜像
 
 ### 导入镜像
 
 把压缩文件复制到内网服务器上，使用下面的命令导入镜像
 
 ```bash
-docker load minio.tar 
+$ docker load minio.tar 
 ```
 
 ### 运行 minio
 
-- 把/mnt/data 改成要替换的数据目录
-- 替换 MINIO_ACCESS_KEY
-- 替换 MINIO_SECRET_KEY
+- 把 `/mnt/data` 改成要替换的数据目录
+- 替换 `MINIO_ROOT_USER` 的值
+- 替换 `MINIO_ROOT_PASSWORD` 的值
 - 替换 name,minio1(可选)
-- 如果9000端口冲突,替换端口前面的如:9009:9000
+- 如果 9000、9090 端口冲突,替换端口前面的如 `9009:9000`
 
 ```bash
-sudo docker run -d -p 9000:9000 --name minio1 \
-  -e "MINIO_ACCESS_KEY=改成自己需要的" \
-  -e "MINIO_SECRET_KEY=改成自己需要的" \
+$ sudo docker run -d -p 9000:9000 -p 9090:9090 --name minio1 \
+  -e "MINIO_ROOT_USER=改成自己需要的" \
+  -e "MINIO_ROOT_PASSWORD=改成自己需要的" \
   -v /mnt/data:/data \
   --restart=always \
-  minio/minio server /data
+  minio/minio server /data --console-address ':9090'
 ```
 
 ### 访问 web 管理页面
 
-http://x.x.x.x:9000/minio/
-
+http://x.x.x.x:9090

appendix/repo/nginx.md

@@ -16,7 +16,7 @@ $ docker run --name some-nginx -v /some/content:/usr/share/nginx/html:ro -d ngin
 
 用户也可以不使用这种映射方式，通过利用 Dockerfile 来直接将静态页面内容放到镜像中，内容为
 
-```bash
+```docker
 FROM nginx
 COPY static-html-directory /usr/share/nginx/html
 ```
@@ -39,7 +39,8 @@ Nginx的默认配置文件路径为 `/etc/nginx/nginx.conf`，可以通过映射
 ```bash
 $ docker run -d \
     --name some-nginx \
-    -v /some/nginx.conf:/etc/nginx/nginx.conf:ro \
+    -p 8080:80 \
+    -v /path/nginx.conf:/etc/nginx/nginx.conf:ro \
     nginx
 ```
 

appendix/repo/nodejs.md

@@ -10,7 +10,7 @@
 
 在项目中创建一个 Dockerfile。
 
-```bash
+```docker
 FROM node:12
 # replace this with your application's default port
 EXPOSE 8888

archive/README.md

@@ -1,7 +1,7 @@
 # 归档项目
 
-以下项目不被官方支持或内容陈旧，将在下一版本中删除。
+以下项目不被官方支持或内容陈旧，将在下一版本中删除（或已经删除）。
 
-* Docker Machine
+* [Docker Machine](https://github.com/yeasy/docker_practice/tree/ca29ab51b121f43563f5d6659dedbda5cb6f048d/machine)
+* [Docker Swarm](https://github.com/yeasy/docker_practice/tree/ca29ab51b121f43563f5d6659dedbda5cb6f048d/swarm)
 * Mesos
-* Docker Swarm

basic_concept/README.md

@@ -1,7 +1,8 @@
 # 基本概念
-Docker 包括三个基本概念
-* 镜像（`Image`）
-* 容器（`Container`）
-* 仓库（`Repository`）
 
-理解了这三个概念，就理解了 Docker 的整个生命周期。
+**Docker** 包括三个基本概念
+* **镜像**（`Image`）
+* **容器**（`Container`）
+* **仓库**（`Repository`）
+
+理解了这三个概念，就理解了 **Docker** 的整个生命周期。

basic_concept/image.md

@@ -1,12 +1,12 @@
 # Docker 镜像
 
-我们都知道，操作系统分为内核和用户空间。对于 Linux 而言，内核启动后，会挂载 `root` 文件系统为其提供用户空间支持。而 Docker 镜像（Image），就相当于是一个 `root` 文件系统。比如官方镜像 `ubuntu:18.04` 就包含了完整的一套 Ubuntu 18.04 最小系统的 `root` 文件系统。
+我们都知道，操作系统分为 **内核** 和 **用户空间**。对于 `Linux` 而言，内核启动后，会挂载 `root` 文件系统为其提供用户空间支持。而 **Docker 镜像**（`Image`），就相当于是一个 `root` 文件系统。比如官方镜像 `ubuntu:18.04` 就包含了完整的一套 Ubuntu 18.04 最小系统的 `root` 文件系统。
 
-Docker 镜像是一个特殊的文件系统，除了提供容器运行时所需的程序、库、资源、配置等文件外，还包含了一些为运行时准备的一些配置参数（如匿名卷、环境变量、用户等）。镜像不包含任何动态数据，其内容在构建之后也不会被改变。
+**Docker 镜像** 是一个特殊的文件系统，除了提供容器运行时所需的程序、库、资源、配置等文件外，还包含了一些为运行时准备的一些配置参数（如匿名卷、环境变量、用户等）。镜像 **不包含** 任何动态数据，其内容在构建之后也不会被改变。
 
 ## 分层存储
 
-因为镜像包含操作系统完整的 `root` 文件系统，其体积往往是庞大的，因此在 Docker 设计时，就充分利用 [Union FS](https://en.wikipedia.org/wiki/Union_mount) 的技术，将其设计为分层存储的架构。所以严格来说，镜像并非是像一个 ISO 那样的打包文件，镜像只是一个虚拟的概念，其实际体现并非由一个文件组成，而是由一组文件系统组成，或者说，由多层文件系统联合组成。
+因为镜像包含操作系统完整的 `root` 文件系统，其体积往往是庞大的，因此在 Docker 设计时，就充分利用 [Union FS](https://en.wikipedia.org/wiki/Union_mount) 的技术，将其设计为分层存储的架构。所以严格来说，镜像并非是像一个 `ISO` 那样的打包文件，镜像只是一个虚拟的概念，其实际体现并非由一个文件组成，而是由一组文件系统组成，或者说，由多层文件系统联合组成。
 
 镜像构建时，会一层层构建，前一层是后一层的基础。每一层构建完就不会再发生改变，后一层上的任何改变只发生在自己这一层。比如，删除前一层文件的操作，实际不是真的删除前一层的文件，而是仅在当前层标记为该文件已删除。在最终容器运行的时候，虽然不会看到这个文件，但是实际上该文件会一直跟随镜像。因此，在构建镜像的时候，需要额外小心，每一层尽量只包含该层需要添加的东西，任何额外的东西应该在该层构建结束前清理掉。
 

basic_concept/repository.md

@@ -14,16 +14,16 @@
 
 Docker Registry 公开服务是开放给用户使用、允许用户管理镜像的 Registry 服务。一般这类公开服务允许用户免费上传、下载公开的镜像，并可能提供收费服务供用户管理私有镜像。
 
-最常使用的 Registry 公开服务是官方的 [Docker Hub](https://hub.docker.com/)，这也是默认的 Registry，并拥有大量的高质量的官方镜像。除此以外，还有 Red Hat 的 [Quay.io](https://quay.io/repository/)；Google 的 [Google Container Registry](https://cloud.google.com/container-registry/)，[Kubernetes](https://kubernetes.io/) 的镜像使用的就是这个服务。
+最常使用的 Registry 公开服务是官方的 [Docker Hub](https://hub.docker.com/)，这也是默认的 Registry，并拥有大量的高质量的 [官方镜像](https://hub.docker.com/search?q=&type=image&image_filter=official)。除此以外，还有 Red Hat 的 [Quay.io](https://quay.io/repository/)；Google 的 [Google Container Registry](https://cloud.google.com/container-registry/)，[Kubernetes](https://kubernetes.io/) 的镜像使用的就是这个服务；代码托管平台 [GitHub](https://github.com) 推出的 [ghcr.io](https://docs.github.com/cn/packages/working-with-a-github-packages-registry/working-with-the-container-registry)。
 
-由于某些原因，在国内访问这些服务可能会比较慢。国内的一些云服务商提供了针对 Docker Hub 的镜像服务（`Registry Mirror`），这些镜像服务被称为 **加速器**。常见的有 [阿里云加速器](https://cr.console.aliyun.com/#/accelerator)、[DaoCloud 加速器](https://www.daocloud.io/mirror#accelerator-doc) 等。使用加速器会直接从国内的地址下载 Docker Hub 的镜像，比直接从 Docker Hub 下载速度会提高很多。在 [安装 Docker](../install/mirror.md)  一节中有详细的配置方法。
+由于某些原因，在国内访问这些服务可能会比较慢。国内的一些云服务商提供了针对 Docker Hub 的镜像服务（`Registry Mirror`），这些镜像服务被称为 **加速器**。常见的有 [阿里云加速器](https://www.aliyun.com/product/acr?source=5176.11533457&userCode=8lx5zmtu)、[DaoCloud 加速器](https://www.daocloud.io/mirror#accelerator-doc) 等。使用加速器会直接从国内的地址下载 Docker Hub 的镜像，比直接从 Docker Hub 下载速度会提高很多。在 [安装 Docker](../install/mirror.md)  一节中有详细的配置方法。
 
-国内也有一些云服务商提供类似于 Docker Hub 的公开服务。比如 [网易云镜像服务](https://c.163.com/hub#/m/library/)、[DaoCloud 镜像市场](https://hub.daocloud.io/)、[阿里云镜像库](https://cr.console.aliyun.com) 等。
+国内也有一些云服务商提供类似于 Docker Hub 的公开服务。比如 [网易云镜像服务](https://c.163.com/hub#/m/library/)、[DaoCloud 镜像市场](https://hub.daocloud.io/)、[阿里云镜像库](https://www.aliyun.com/product/acr?source=5176.11533457&userCode=8lx5zmtu) 等。
 
 ## 私有 Docker Registry
 
 除了使用公开服务外，用户还可以在本地搭建私有 Docker Registry。Docker 官方提供了 [Docker Registry](https://hub.docker.com/_/registry/) 镜像，可以直接使用做为私有 Registry 服务。在 [私有仓库](../repository/registry.md) 一节中，会有进一步的搭建私有 Registry 服务的讲解。
 
-开源的 Docker Registry 镜像只提供了 [Docker Registry API](https://docs.docker.com/registry/spec/api/) 的服务端实现，足以支持 `docker` 命令，不影响使用。但不包含图形界面，以及镜像维护、用户管理、访问控制等高级功能。在官方的商业化版本 [Docker Trusted Registry](https://docs.docker.com/datacenter/dtr/2.0/) 中，提供了这些高级功能。
+开源的 Docker Registry 镜像只提供了 [Docker Registry API](https://docs.docker.com/registry/spec/api/) 的服务端实现，足以支持 `docker` 命令，不影响使用。但不包含图形界面，以及镜像维护、用户管理、访问控制等高级功能。
 
 除了官方的 Docker Registry 外，还有第三方软件实现了 Docker Registry API，甚至提供了用户界面以及一些高级功能。比如，[Harbor](https://github.com/goharbor/harbor) 和 [Sonatype Nexus](../repository/nexus3_registry.md)。

buildx/buildx.md

@@ -1,9 +1,5 @@
 # 使用 Buildx 构建镜像
 
-## 启用 Buildx
-
-`buildx` 命令属于实验特性，请参考 [开启实验特性](../install/experimental.md) 一节开启 Docker CLI 实验特性。
-
 ## 使用
 
 你可以直接使用 `docker buildx build` 命令构建镜像。

cases/ci/actions/README.md

@@ -25,4 +25,4 @@ jobs:
 
 ## 参考资料
 
-* [Actions Docs](https://docs.github.com/en/free-pro-team@latest/actions)
+* [Actions Docs](https://docs.github.com/en/actions)

cases/ci/drone/README.md

@@ -86,7 +86,7 @@ $ git push origin master
 
 打开我们部署好的 `Drone` 网站或者 Drone Cloud，即可看到构建结果。
 
-![](_images/drone-build.png)
+![](./_images/drone-build.png)
 
 当然我们也可以把构建结果上传到 GitHub，Docker Registry，云服务商提供的对象存储，或者生产环境中。
 

cases/ci/drone/docker-compose.yml

@@ -3,7 +3,7 @@ version: '3'
 services:
 
   drone-server:
-    image: drone/drone:1
+    image: drone/drone:2.3.1
     ports:
       - 443:443
       - 80:80
@@ -12,7 +12,6 @@ services:
       - ./ssl:/etc/certs
     restart: always
     environment:
-      - DRONE_AGENTS_ENABLED=true
       - DRONE_SERVER_HOST=${DRONE_SERVER_HOST:-drone.domain.com}
       - DRONE_SERVER_PROTO=${DRONE_SERVER_PROTO:-https}
       - DRONE_RPC_SECRET=${DRONE_RPC_SECRET:-secret}

cases/ci/drone/install.md

@@ -30,7 +30,7 @@ version: '3'
 services:
 
   drone-server:
-    image: drone/drone:1
+    image: drone/drone:2.3.1
     ports:
       - 443:443
       - 80:80
@@ -39,7 +39,6 @@ services:
       - ./ssl:/etc/certs
     restart: always
     environment:
-      - DRONE_AGENTS_ENABLED=true
       - DRONE_SERVER_HOST=${DRONE_SERVER_HOST:-https://drone.yeasy.com}
       - DRONE_SERVER_PROTO=${DRONE_SERVER_PROTO:-https}
       - DRONE_RPC_SECRET=${DRONE_RPC_SECRET:-secret}

cases/ci/travis/README.md

@@ -1,47 +0,0 @@
-# 在 Travis CI 中使用 Docker
-
-当代码提交到 GitHub 时，[Travis CI](https://travis-ci.com/) 会根据项目根目录 `.travis.yml` 文件设置的指令，执行一系列操作。
-
-本小节介绍如何在 Travis CI 中使用 Docker 进行持续集成/持续部署（CI/CD）。这里以当代码提交到 GitHub 时自动构建 Docker 镜像并推送到 Docker Hub 为例进行介绍。
-
-## 准备
-
-首先登录 https://travis-ci.com/account/repositories 选择 GitHub 仓库，按照指引安装 GitHub App 来启用 GitHub 仓库构建。
-
-在项目根目录新建一个 `Dockerfile` 文件。
-
-```docker
-FROM alpine
-
-RUN echo "Hello World"
-```
-
-新建 Travis CI 配置文件 `.travis.yml` 文件。
-
-```yml
-language: bash
-
-dist: xenial
-
-services:
-  - docker
-
-before_script:
-  # 登录到 docker hub
-  - echo "$DOCKER_PASSWORD" | docker login -u "$DOCKER_USERNAME" --password-stdin
-
-script:
-  # 这里编写测试代码的命令
-  - echo "test code"
-
-after_success:
-  # 当代码测试通过后执行的命令
-  - docker build -t username/alpine .
-  - docker push username/alpine
-```
-
-> 请提前在 Travis CI 仓库设置页面配置 `DOCKER_PASSWORD` `DOCKER_USERNAME` 变量
-
-## 查看结果
-
-将项目推送到 GitHub，登录 [Travis CI](https://travis-ci.com/) 查看构建详情。

cases/ci/travis/demo/.travis.yml

@@ -1,16 +0,0 @@
-language: bash
-
-dist: xenial
-
-services:
-  - docker
-
-before_script:
-  - echo "$DOCKER_PASSWORD" | docker login -u "$DOCKER_USERNAME" --password-stdin
-
-script:
-  - echo "test code"
-
-after_success:
-  - docker build -t username/alpine .
-  - docker push username/alpine

cases/ci/travis/demo/Dockerfile

@@ -1,3 +0,0 @@
-FROM alpine
-
-RUN echo "Hello World"

cases/os/alpine.md

@@ -2,7 +2,7 @@
 
 ## 简介
 
-![Alpine Linux 操作系统](_images/alpinelinux-logo.png)
+![Alpine Linux 操作系统](./_images/alpinelinux-logo.png)
 
 `Alpine` 操作系统是一个面向安全的轻型 `Linux` 发行版。它不同于通常 `Linux` 发行版，`Alpine` 采用了 `musl libc` 和 `busybox` 以减小系统的体积和运行时资源消耗，但功能上比 `busybox` 又完善的多，因此得到开源社区越来越多的青睐。在保持瘦身的同时，`Alpine` 还提供了自己的包管理工具 `apk`，可以通过 `https://pkgs.alpinelinux.org/packages` 网站上查询包信息，也可以直接通过 `apk` 命令直接查询和安装各种软件。
 

cases/os/busybox.md

@@ -2,7 +2,7 @@
 
 ## 简介
 
-![Busybox - Linux 瑞士军刀](_images/busybox-logo.png)
+![Busybox - Linux 瑞士军刀](./_images/busybox-logo.png)
 
 `BusyBox` 是一个集成了一百多个最常用 Linux 命令和工具（如 `cat`、`echo`、`grep`、`mount`、`telnet` 等）的精简工具箱，它只需要几 MB 的大小，很方便进行各种快速验证，被誉为“Linux 系统的瑞士军刀”。
 
@@ -10,30 +10,15 @@
 
 ## 获取官方镜像
 
-在 `Docker Hub` 中搜索 `busybox` 相关的镜像。
-
-```bash
-$ docker search busybox
-NAME                            DESCRIPTION                                     STARS     OFFICIAL   AUTOMATED
-busybox                         Busybox base image.                             755       [OK]
-progrium/busybox                                                                63                   [OK]
-radial/busyboxplus              Full-chain, Internet enabled, busybox made...   11                   [OK]
-odise/busybox-python                                                            3                    [OK]
-multiarch/busybox               multiarch ports of ubuntu-debootstrap           2                    [OK]
-azukiapp/busybox                This image is meant to be used as the base...   2                    [OK]
-...
-```
-
-读者可以看到最受欢迎的镜像同时带有 `OFFICIAL` 标记，说明它是官方镜像。用户使用 `docker pull` 指令下载 `busybox:latest` 镜像：
+可以使用 `docker pull` 指令下载 `busybox:latest` 镜像：
 
 ```bash
 $ docker pull busybox:latest
-busybox:latest: The image you are pulling has been verified
-e433a6c5b276: Pull complete
-e72ac664f4f0: Pull complete
-511136ea3c5a: Pull complete
-df7546f9f060: Pull complete
+latest: Pulling from library/busybox
+5c4213be9af9: Pull complete
+Digest: sha256:c6b45a95f932202dbb27c31333c4789f45184a744060f6e569cc9d2bf1b9ad6f
 Status: Downloaded newer image for busybox:latest
+docker.io/library/busybox:latest
 ```
 
 下载后，可以看到 `busybox` 镜像只有 **2.433 MB**：

cases/os/centos.md

@@ -4,21 +4,12 @@
 
 `CentOS` 和 `Fedora` 都是基于 `Redhat` 的常见 Linux 分支。`CentOS` 是目前企业级服务器的常用操作系统；`Fedora` 则主要面向个人桌面用户。
 
-![CentOS 操作系统](_images/centos-logo.png)
+![CentOS 操作系统](./_images/centos-logo.png)
 
 CentOS（Community Enterprise Operating System，中文意思是：社区企业操作系统），它是基于 `Red Hat Enterprise Linux` 源代码编译而成。由于 `CentOS` 与 `Redhat Linux` 源于相同的代码基础，所以很多成本敏感且需要高稳定性的公司就使用 `CentOS` 来替代商业版 `Red Hat Enterprise Linux`。`CentOS` 自身不包含闭源软件。
 
 ### 使用 CentOS 官方镜像
 
-首先使用 `docker search` 命令来搜索标星至少为 `25` 的 `CentOS` 相关镜像。
-
-```bash
-$ docker search -f stars=25 centos
-NAME      DESCRIPTION      STARS     OFFICIAL   AUTOMATED
-centos    The official...  2543      [OK]
-jdeathe/centos-ssh         27                   [OK]
-```
-
 使用 `docker run` 直接运行最新的 `CentOS` 镜像，并登录 `bash`。
 
 ```bash
@@ -34,23 +25,12 @@ CentOS Linux release 7.2.1511 (Core)
 
 ## Fedora 系统简介
 
-![Fedora 操作系统](_images/fedora-logo.png)
+![Fedora 操作系统](./_images/fedora-logo.png)
 
 `Fedora` 由 `Fedora Project` 社区开发，红帽公司赞助的 `Linux` 发行版。它的目标是创建一套新颖、多功能并且自由和开源的操作系统。`Fedora` 的功能对于用户而言，它是一套功能完备的，可以更新的免费操作系统，而对赞助商 `Red Hat` 而言，它是许多新技术的测试平台。被认为可用的技术最终会加入到 `Red Hat Enterprise Linux` 中。
 
 ### 使用 Fedora 官方镜像
 
-首先使用 `docker search` 命令来搜索标星至少为 `2` 的 `Fedora` 相关镜像，结果如下。
-
-```bash
-$ docker search -f stars=2 fedora
-NAME                     DESCRIPTION                                     STARS     OFFICIAL   AUTOMATED
-fedora                   Official Docker builds of Fedora                433       [OK]
-dockingbay/fedora-rust   Trusted build of Rust programming language...   3                    [OK]
-gluster/gluster-fedora   Official GlusterFS image [ Fedora 21 + Glu...   3                    [OK]
-startx/fedora            Simple container used for all startx based...   2                    [OK]
-```
-
 使用 `docker run` 命令直接运行 `Fedora` 官方镜像，并登录 `bash`。
 
 ```bash

cases/os/debian.md

@@ -1,9 +1,10 @@
 # Debian/Ubuntu
+
 `Debian` 和 `Ubuntu` 都是目前较为流行的 **Debian 系** 的服务器操作系统，十分适合研发场景。`Docker Hub` 上提供了官方镜像，国内各大容器云服务也基本都提供了相应的支持。
 
 ## Debian 系统简介
 
-![Debian 操作系统](_images/debian-logo.png)
+![Debian 操作系统](./_images/debian-logo.png)
 
 `Debian` 是由 `GPL` 和其他自由软件许可协议授权的自由软件组成的操作系统，由 **Debian 计划（Debian Project）** 组织维护。**Debian 计划** 是一个独立的、分散的组织，由 `3000` 人志愿者组成，接受世界多个非盈利组织的资金支持，`Software in the Public Interest` 提供支持并持有商标作为保护机构。`Debian` 以其坚守 `Unix` 和自由软件的精神，以及其给予用户的众多选择而闻名。现时 `Debian` 包括了超过 `25,000` 个软件包并支持 `12` 个计算机系统结构。
 
@@ -13,20 +14,7 @@
 
 ### 使用 Debian 官方镜像
 
-读者可以使用 `docker search` 查找 `Debian` 镜像：
-
-```bash
-$ docker search debian
-NAME         DESCRIPTION    STARS     OFFICIAL   AUTOMATED
-debian       Debian is...   1565      [OK]
-neurodebian  NeuroDebian...   26      [OK]
-armbuild/debian port of debian 8                 [OK]
-...
-```
-
-官方提供了大家熟知的 `debian` 镜像以及面向科研领域的 `neurodebian` 镜像。
-
-可以使用 `docker run` 直接运行 `Debian` 镜像。
+官方提供了大家熟知的 `debian` 镜像以及面向科研领域的 `neurodebian` 镜像。可以使用 `docker run` 直接运行 `Debian` 镜像。
 
 ```bash
 $ docker run -it debian bash
@@ -38,37 +26,12 @@ Debian GNU/Linux 8
 
 ## Ubuntu 系统简介
 
-![Ubuntu 操作系统](_images/ubuntu-logo.jpg)
+![Ubuntu 操作系统](./_images/ubuntu-logo.jpg)
 
 `Ubuntu` 是一个以桌面应用为主的 `GNU/Linux` 操作系统，其名称来自非洲南部祖鲁语或豪萨语的“ubuntu”一词（官方译名“友帮拓”，另有“吾帮托”、“乌班图”、“有奔头”或“乌斑兔”等译名）。`Ubuntu` 意思是“人性”以及“我的存在是因为大家的存在”，是非洲传统的一种价值观，类似华人社会的“仁爱”思想。 `Ubuntu` 基于 `Debian` 发行版和 `GNOME/Unity` 桌面环境，与 `Debian` 的不同在于它每 6 个月会发布一个新版本，每 2 年推出一个长期支持 **（Long Term Support，LTS）** 版本，一般支持 3 年时间。
 
 ### 使用 Ubuntu 官方镜像
 
-`Ubuntu` 相关的镜像有很多，这里使用 `--filter=stars=10` 参数，只搜索那些被收藏 `10` 次以上的镜像。
-
-```bash
-$ docker search --filter=stars=10 ubuntu
-
-NAME                                                      DESCRIPTION                                     STARS               OFFICIAL            AUTOMATED
-ubuntu                                                    Ubuntu is a Debian-based Linux operating sys…   10539               [OK]
-dorowu/ubuntu-desktop-lxde-vnc                            Docker image to provide HTML5 VNC interface …   395                                     [OK]
-rastasheep/ubuntu-sshd                                    Dockerized SSH service, built on top of offi…   243                                     [OK]
-consol/ubuntu-xfce-vnc                                    Ubuntu container with "headless" VNC session…   210                                     [OK]
-ubuntu-upstart                                            Upstart is an event-based replacement for th…   105                 [OK]
-ansible/ubuntu14.04-ansible                               Ubuntu 14.04 LTS with ansible                   98                                      [OK]
-neurodebian                                               NeuroDebian provides neuroscience research s…   64                  [OK]
-1and1internet/ubuntu-16-nginx-php-phpmyadmin-mysql-5      ubuntu-16-nginx-php-phpmyadmin-mysql-5          50                                      [OK]
-ubuntu-debootstrap                                        debootstrap --variant=minbase --components=m…   42                  [OK]
-nuagebec/ubuntu                                           Simple always updated Ubuntu docker images w…   24                                      [OK]
-i386/ubuntu                                               Ubuntu is a Debian-based Linux operating sys…   19
-1and1internet/ubuntu-16-apache-php-5.6                    ubuntu-16-apache-php-5.6                        14                                      [OK]
-1and1internet/ubuntu-16-apache-php-7.0                    ubuntu-16-apache-php-7.0                        13                                      [OK]
-eclipse/ubuntu_jdk8                                       Ubuntu, JDK8, Maven 3, git, curl, nmap, mc, …   12                                      [OK]
-1and1internet/ubuntu-16-nginx-php-phpmyadmin-mariadb-10   ubuntu-16-nginx-php-phpmyadmin-mariadb-10       11                                      [OK]
-```
-
-根据搜索出来的结果，读者可以自行选择下载镜像并使用。
-
 下面以 `ubuntu:18.04` 为例，演示如何使用该镜像安装一些常用软件。
 
 首先使用 `-ti` 参数启动容器，登录 `bash`，查看 `ubuntu` 的发行版本号。

cloud/alicloud.md

@@ -1,6 +1,6 @@
 # 阿里云
 
-![阿里云](_images/aliyun-logo.png)
+![阿里云](./_images/aliyun-logo.png)
 
 [阿里云](https://www.aliyun.com?source=5176.11533457&userCode=8lx5zmtu&type=copy) 创立于 2009 年，是中国较早的云计算平台。阿里云致力于提供安全、可靠的计算和数据处理能力。
 

cloud/aws.md

@@ -1,6 +1,6 @@
 # 亚马逊云
 
-![AWS](_images/aws-logo.jpg)
+![AWS](./_images/aws-logo.jpg)
 
 [AWS](https://www.amazonaws.cn)，即 Amazon Web Services，是亚马逊（Amazon）公司的 IaaS 和 PaaS 平台服务。AWS 提供了一整套基础设施和应用程序服务，使用户几乎能够在云中运行一切应用程序：从企业应用程序和大数据项目，到社交游戏和移动应用程序。AWS 面向用户提供包括弹性计算、存储、数据库、应用程序在内的一整套云计算服务，能够帮助企业降低 IT 投入成本和维护成本。
 
@@ -8,4 +8,4 @@
 
 2015 年 AWS 正式发布了 EC2 容器服务(ECS)。ECS 的目的是让 Docker 容器变的更加简单，它提供了一个集群和编排的层，用来控制主机上的容器部署，以及部署之后的集群内的容器的生命周期管理。ECS 是诸如 Docker Swarm、Kubernetes、Mesos 等工具的替代，它们工作在同一个层，除了作为一个服务来提供。这些工具和 ECS 不同的地方在于，前者需要用户自己来部署和管理，而 ECS 是“作为服务”来提供的。
 
-![AWS 容器服务](_images/ECS.jpg)
+![AWS 容器服务](./_images/ECS.jpg)

cloud/tencentCloud.md

@@ -1,6 +1,6 @@
 # 腾讯云
 
-![腾讯云](_images/qcloud-logo.jpg)
+![腾讯云](./_images/qcloud-logo.jpg)
 
 [腾讯云](https://cloud.tencent.com/act/cps/redirect?redirect=1040&cps_key=3a5255852d5db99dcd5da4c72f05df61&from=console) 在架构方面经过多年积累，并且有着多年对海量互联网服务的经验。不管是社交、游戏还是其他领域，都有多年的成熟产品来提供产品服务。腾讯在云端完成重要部署，为开发者及企业提供云服务、云数据、云运营等整体一站式服务方案。
 

compose/commands.md

@@ -18,10 +18,6 @@ docker-compose [-f=<arg>...] [options] [COMMAND] [ARGS...]
 
 * `-p, --project-name NAME` 指定项目名称，默认将使用所在目录名称作为项目名。
 
-* `--x-networking` 使用 Docker 的可拔插网络后端特性
-
-* `--x-network-driver DRIVER` 指定网络后端的驱动，默认为 `bridge`
-
 * `--verbose` 输出更多调试信息。
 
 * `-v, --version` 打印版本并退出。

compose/demo/django/docker-compose.yml

@@ -3,6 +3,8 @@ services:
 
   db:
     image: postgres
+    environment:
+      POSTGRES_PASSWORD: 'postgres'
 
   web:
     build: .
@@ -11,5 +13,3 @@ services:
       - .:/code
     ports:
       - "8000:8000"
-    links:
-      - db

compose/django.md

@@ -35,6 +35,8 @@ services:
 
   db:
     image: postgres
+    environment:
+      POSTGRES_PASSWORD: 'postgres'
 
   web:
     build: .
@@ -43,8 +45,6 @@ services:
       - .:/code
     ports:
       - "8000:8000"
-    links:
-      - db
 ```
 
 查看 [`docker-compose.yml` 章节](compose_file.md) 了解更多详细的工作机制。
@@ -80,6 +80,7 @@ DATABASES = {
         'USER': 'postgres',
         'HOST': 'db',
         'PORT': 5432,
+        'PASSWORD': 'postgres',
     }
 }
 ```

compose/install.md

@@ -9,7 +9,7 @@
 ```bash
 $ docker-compose --version
 
-docker-compose version 1.25.5, build 4667896b
+docker-compose version 1.27.4, build 40524192
 ```
 
 Linux 系统请使用以下介绍的方法安装。
@@ -21,7 +21,10 @@ Linux 系统请使用以下介绍的方法安装。
 例如，在 Linux 64 位系统上直接下载对应的二进制包。
 
 ```bash
-$ sudo curl -L https://github.com/docker/compose/releases/download/1.25.5/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose
+$ sudo curl -L https://github.com/docker/compose/releases/download/1.27.4/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose
+
+# 国内用户可以使用以下方式加快下载
+$ sudo curl -L https://download.fastgit.org/docker/compose/releases/download/1.27.4/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose
 
 $ sudo chmod +x /usr/local/bin/docker-compose
 ```
@@ -42,7 +45,7 @@ $ sudo pip install -U docker-compose
 
 ```bash
 Collecting docker-compose
-  Downloading docker-compose-1.25.5.tar.gz (149kB): 149kB downloaded
+  Downloading docker-compose-1.27.4.tar.gz (149kB): 149kB downloaded
 ...
 Successfully installed docker-compose cached-property requests texttable websocket-client docker-py dockerpty six enum34 backports.ssl-match-hostname ipaddress
 ```
@@ -50,7 +53,7 @@ Successfully installed docker-compose cached-property requests texttable websock
 ## bash 补全命令
 
 ```bash
-$ curl -L https://raw.githubusercontent.com/docker/compose/1.25.5/contrib/completion/bash/docker-compose > /etc/bash_completion.d/docker-compose
+$ curl -L https://raw.githubusercontent.com/docker/compose/1.27.4/contrib/completion/bash/docker-compose > /etc/bash_completion.d/docker-compose
 ```
 
 ## 卸载

compose/rails.md

@@ -45,8 +45,6 @@ services:
       - .:/myapp
     ports:
       - "3000:3000"
-    links:
-      - db
 ```
 
 所有文件就绪后，我们就可以通过使用 `docker-compose run` 命令生成应用的骨架了。

compose/v2.md

@@ -0,0 +1,7 @@
+# Compose V2
+
+目前 Docker 官方用 GO 语言 [重写](https://github.com/docker/compose-cli) 了 Docker Compose，并将其作为了 docker cli 的子命令，称为 `Compose V2`。你可以参照官方文档安装，然后将熟悉的 `docker-compose` 命令替换为 `docker compose`，即可使用 Docker Compose。
+
+## 官方文档
+
+* [Compose V2 beta](https://docs.docker.com/compose/cli-command/)

container/README.md

@@ -1,4 +1,5 @@
 # 操作 Docker 容器
+
 容器是 Docker 又一核心概念。
 
 简单的说，容器是独立运行的一个或一组应用，以及它们的运行态环境。对应的，虚拟机可以理解为模拟运行的一整套操作系统（提供了运行态环境和其他系统环境）和跑在上面的应用。

container/attach_exec.md

@@ -24,7 +24,7 @@ root@243c32535da7:/#
 
 ## `exec` 命令
 
-### -i -t 参数
+### `-i` `-t` 参数
 
 `docker exec` 后边可以跟多个参数，这里主要说明 `-i` `-t` 参数。
 

container/run.md

@@ -1,6 +1,6 @@
 # 启动容器
 
-启动容器有两种方式，一种是基于镜像新建一个容器并启动，另外一个是将在终止状态（`stopped`）的容器重新启动。
+启动容器有两种方式，一种是基于镜像新建一个容器并启动，另外一个是将在终止状态（`exited`）的容器重新启动。
 
 因为 Docker 的容器实在太轻量级了，很多时候用户都是随时删除和新创建容器。
 
@@ -37,7 +37,7 @@ bin boot dev etc home lib lib64 media mnt opt proc root run sbin srv sys tmp usr
 
 当利用 `docker run` 来创建容器时，Docker 在后台运行的标准操作包括：
 
-* 检查本地是否存在指定的镜像，不存在就从公有仓库下载
+* 检查本地是否存在指定的镜像，不存在就从 [registry](../repository/README.md) 下载
 * 利用镜像创建并启动一个容器
 * 分配一个文件系统，并在只读的镜像层外面挂载一层可读写层
 * 从宿主主机配置的网桥接口中桥接一个虚拟接口到容器中去
@@ -47,7 +47,7 @@ bin boot dev etc home lib lib64 media mnt opt proc root run sbin srv sys tmp usr
 
 ## 启动已终止容器
 
-可以利用 `docker container start` 命令，直接将一个已经终止的容器启动运行。
+可以利用 `docker container start` 命令，直接将一个已经终止（`exited`）的容器启动运行。
 
 容器的核心为所执行的应用程序，所需要的资源都是应用程序运行所必需的。除此之外，并没有其它的资源。可以在伪终端中利用 `ps` 或 `top` 来查看进程信息。
 

container/stop.md

@@ -9,7 +9,7 @@
 终止状态的容器可以用 `docker container ls -a` 命令看到。例如
 
 ```bash
-docker container ls -a
+$ docker container ls -a
 CONTAINER ID        IMAGE                    COMMAND                CREATED             STATUS                          PORTS               NAMES
 ba267838cc1b        ubuntu:18.04             "/bin/bash"            30 minutes ago      Exited (0) About a minute ago                       trusting_newton
 ```

coreos/README.md

@@ -1,6 +1,6 @@
 # Fedora CoreOS
 
-`CoreOS` 是一个专门为安全和大规模运行容器化工作负载而构建的新 Fedora 版本，它是 Fedora Atomic Host 和 CoreOS Container Linux 的后继项目。
+`CoreOS` 是一个专门为安全和大规模运行容器化工作负载而构建的新 Fedora 版本，它继承了 Fedora Atomic Host 和 CoreOS Container Linux 的优势。
 
 `CoreOS` 的安装文件和运行依赖非常小，它提供了精简的 Linux 系统。它使用 Linux 容器在更高的抽象层来管理你的服务，而不是通过常规的包管理工具 `yum` 或 `apt` 来安装包。
 

coreos/intro.md

@@ -20,7 +20,7 @@ FCOS 使用 rpm-ostree 系统进行事务性升级。无需像 yum 升级那样
 
 ### 容器工具
 
-对于诸如构建，复制和其他管理容器的任务，FCOS 用一组兼容的容器工具代替了 **Docker CLI** 工具。**podman CLI** 工具支持许多容器运行时功能，例如运行，启动，停止，列出和删除容器和镜像。**skopeo CLI** 工具可以复制，认证和签名镜像。您还可以使用 **crictl CLI** 工具来处理 CRI-O 容器引擎中的容器和镜像。
+对于诸如构建，复制和其他管理容器的任务，FCOS 用一组容器工具代替了 **Docker CLI**。**podman CLI** 工具支持许多容器运行时功能，例如运行，启动，停止，列出和删除容器和镜像。**skopeo CLI** 工具可以复制，认证和签名镜像。您还可以使用 **crictl CLI** 工具来处理 CRI-O 容器引擎中的容器和镜像。
 
 ## 参考文档
 

data_management/README.md

@@ -1,6 +1,6 @@
 # Docker 数据管理
 
-![](_images/types-of-mounts.png)
+![](./_images/types-of-mounts.png)
 
 这一章介绍如何在 Docker 内部以及容器之间管理数据，在容器中管理数据主要有两种方式：
 

docker-compose.yml

@@ -2,30 +2,31 @@ version: "3"
 
 services:
 
-  # $ docker-compose up server => up a server，Only Support Linux or macOS
-  server:
-    image: yeasy/docker_practice:latest
-    ports:
-      - 4000:4000
-    volumes:
-      - ./:/srv/gitbook-src
-    command: server
-
-  # $ docker-compose up build => build gitbook
-
-  build:
+  gitbook-build:
+    &gitbook-build
     image: yeasy/docker_practice:latest
     volumes:
       - ./:/srv/gitbook-src
     command: build
 
-  # $ docker run -it --rm -p 4000:80 dockerpracticesig/docker_practice
-  offline:
-    # this image build by travis ci
-    image: dockerpracticesig/docker_practice
+  gitbook-server:
+    << : *gitbook-build
+    ports:
+      - 4000:4000
+    command: server
+
+  # docker run -it --rm -p 4000:80 dockerpracticesig/docker_practice
+  gitbook-offline:
+    &gitbook-offline
+    # this image build by GitHub Action
+    image: dockerpracticesig/docker_practice:gitbook
     ports:
       - 4000:80
 
+  vuepress-offline:
+    << : *gitbook-offline
+    image: dockerpracticesig/docker_practice:vuepress
+
   # developer test docker image
 
   development:

etcd/install.md

@@ -12,6 +12,10 @@
 
 ```bash
 $ curl -L https://github.com/etcd-io/etcd/releases/download/v3.4.0/etcd-v3.4.0-linux-amd64.tar.gz -o etcd-v3.4.0-linux-amd64.tar.gz
+
+# 国内用户可以使用以下方式加快下载
+$ curl -L https://download.fastgit.org/etcd-io/etcd/releases/download/v3.4.0/etcd-v3.4.0-linux-amd64.tar.gz -o etcd-v3.4.0-linux-amd64.tar.gz
+
 $ tar xzvf etcd-v3.4.0-linux-amd64.tar.gz
 $ cd etcd-v3.4.0-linux-amd64
 ```

etcd/intro.md

@@ -1,6 +1,6 @@
 # 什么是 etcd
 
-![](_images/etcd_logo.png)
+![](./_images/etcd_logo.png)
 
 `etcd` 是 `CoreOS` 团队于 2013 年 6 月发起的开源项目，它的目标是构建一个高可用的分布式键值（`key-value`）数据库，基于 `Go` 语言实现。我们知道，在分布式系统中，各种服务的配置信息的管理分享，服务的发现是一个很基本同时也是很重要的问题。`CoreOS` 项目就希望基于 `etcd` 来解决这一问题。
 

image/build.md

@@ -40,7 +40,7 @@ FROM scratch
 
 如果你以 `scratch` 为基础镜像的话，意味着你不以任何镜像为基础，接下来所写的指令将作为镜像第一层开始存在。
 
-不以任何系统为基础，直接将可执行文件复制进镜像的做法并不罕见，比如 [`swarm`](https://hub.docker.com/_/swarm/)、[`etcd`](https://quay.io/repository/coreos/etcd)。对于 Linux 下静态编译的程序来说，并不需要有操作系统提供运行时支持，所需的一切库都已经在可执行文件里了，因此直接 `FROM scratch` 会让镜像体积更加小巧。使用 [Go 语言](https://golang.org/) 开发的应用很多会使用这种方式来制作镜像，这也是为什么有人认为 Go 是特别适合容器微服务架构的语言的原因之一。
+不以任何系统为基础，直接将可执行文件复制进镜像的做法并不罕见，对于 Linux 下静态编译的程序来说，并不需要有操作系统提供运行时支持，所需的一切库都已经在可执行文件里了，因此直接 `FROM scratch` 会让镜像体积更加小巧。使用 [Go 语言](https://golang.google.cn/) 开发的应用很多会使用这种方式来制作镜像，这也是为什么有人认为 Go 是特别适合容器微服务架构的语言的原因之一。
 
 ## RUN 执行命令
 

image/commit.md

@@ -20,7 +20,7 @@ $ docker run --name webserver -d -p 80:80 nginx
 
 直接用浏览器访问的话，我们会看到默认的 Nginx 欢迎页面。
 
-![](_images/images-mac-example-nginx.png)
+![](./_images/images-mac-example-nginx.png)
 
 现在，假设我们非常不喜欢这个欢迎页面，我们希望改成欢迎 Docker 的文字，我们可以使用 `docker exec` 命令进入容器，修改其内容。
 
@@ -37,7 +37,7 @@ exit
 
 现在我们再刷新浏览器的话，会发现内容被改变了。
 
-![](_images/images-create-nginx-docker.png)
+![](./_images/images-create-nginx-docker.png)
 
 我们修改了容器的文件，也就是改动了容器的存储层。我们可以通过 `docker diff` 命令看到具体的改动。
 

image/demo/multistage-builds/Dockerfile

@@ -1,4 +1,4 @@
-FROM golang:1.9-alpine as builder
+FROM golang:alpine as builder
 
 RUN apk --no-cache add git
 

image/demo/multistage-builds/Dockerfile.build

@@ -1,4 +1,4 @@
-FROM golang:1.9-alpine
+FROM golang:alpine
 
 RUN apk --no-cache add git
 

image/demo/multistage-builds/Dockerfile.one

@@ -1,4 +1,4 @@
-FROM golang:1.9-alpine
+FROM golang:alpine
 
 RUN apk --no-cache add git ca-certificates
 

image/dockerfile/add.md

@@ -1,4 +1,4 @@
-### ADD 更高级的复制文件
+# ADD 更高级的复制文件
 
 `ADD` 指令和 `COPY` 的格式和性质基本一致。但是在 `COPY` 基础上增加了一些功能。
 

image/dockerfile/arg.md

@@ -1,4 +1,4 @@
-### ARG 构建参数
+# ARG 构建参数
 
 格式：`ARG <参数名>[=<默认值>]`
 
@@ -6,7 +6,7 @@
 
 `Dockerfile` 中的 `ARG` 指令是定义参数名称，以及定义其默认值。该默认值可以在构建命令 `docker build` 中用 `--build-arg <参数名>=<值>` 来覆盖。
 
-在 1.13 之前的版本，要求 `--build-arg` 中的参数名，必须在 `Dockerfile` 中用 `ARG` 定义过了，换句话说，就是 `--build-arg` 指定的参数，必须在 `Dockerfile` 中使用了。如果对应参数没有被使用，则会报错退出构建。从 1.13 开始，这种严格的限制被放开，不再报错退出，而是显示警告信息，并继续构建。这对于使用 CI 系统，用同样的构建流程构建不同的 `Dockerfile` 的时候比较有帮助，避免构建命令必须根据每个 Dockerfile 的内容修改。
+灵活的使用 `ARG` 指令，能够在不修改 Dockerfile 的情况下，构建出不同的镜像。
 
 ARG 指令有生效范围，如果在 `FROM` 指令之前指定，那么只能用于 `FROM` 指令中。
 

image/dockerfile/cmd.md

@@ -1,4 +1,4 @@
-### CMD 容器启动命令
+# CMD 容器启动命令
 
 `CMD` 指令的格式和 `RUN` 相似，也是两种格式：
 

image/dockerfile/copy.md

@@ -1,4 +1,4 @@
-### COPY 复制文件
+# COPY 复制文件
 
 格式：
 

image/dockerfile/entrypoint.md

@@ -1,4 +1,4 @@
-### ENTRYPOINT 入口点
+# ENTRYPOINT 入口点
 
 `ENTRYPOINT` 的格式和 `RUN` 指令格式一样，分为 `exec` 格式和 `shell` 格式。
 

image/dockerfile/env.md

@@ -1,4 +1,4 @@
-### ENV 设置环境变量
+# ENV 设置环境变量
 
 格式有两种：
 

image/dockerfile/expose.md

@@ -1,7 +1,7 @@
-### EXPOSE 声明端口
+# EXPOSE 声明端口
 
 格式为 `EXPOSE <端口1> [<端口2>...]`。
 
-`EXPOSE` 指令是声明运行时容器提供服务端口，这只是一个声明，在运行时并不会因为这个声明应用就会开启这个端口的服务。在 Dockerfile 中写入这样的声明有两个好处，一个是帮助镜像使用者理解这个镜像服务的守护端口，以方便配置映射；另一个用处则是在运行时使用随机端口映射时，也就是 `docker run -P` 时，会自动随机映射 `EXPOSE` 的端口。
+`EXPOSE` 指令是声明容器运行时提供服务的端口，这只是一个声明，在容器运行时并不会因为这个声明应用就会开启这个端口的服务。在 Dockerfile 中写入这样的声明有两个好处，一个是帮助镜像使用者理解这个镜像服务的守护端口，以方便配置映射；另一个用处则是在运行时使用随机端口映射时，也就是 `docker run -P` 时，会自动随机映射 `EXPOSE` 的端口。
 
 要将 `EXPOSE` 和在运行时使用 `-p <宿主端口>:<容器端口>` 区分开来。`-p`，是映射宿主端口和容器端口，换句话说，就是将容器的对应端口服务公开给外界访问，而 `EXPOSE` 仅仅是声明容器打算使用什么端口而已，并不会自动在宿主进行端口映射。

image/dockerfile/healthcheck.md

@@ -1,4 +1,4 @@
-### HEALTHCHECK 健康检查
+# HEALTHCHECK 健康检查
 
 格式：
 

image/dockerfile/onbuild.md

@@ -1,4 +1,4 @@
-### ONBUILD 为他人做嫁衣裳
+# ONBUILD 为他人做嫁衣裳
 
 格式：`ONBUILD <其它指令>`。
 

image/dockerfile/references.md

@@ -1,4 +1,4 @@
-### 参考文档
+# 参考文档
 
 * `Dockerfie` 官方文档：https://docs.docker.com/engine/reference/builder/
 

image/dockerfile/user.md

@@ -1,10 +1,10 @@
-### USER 指定当前用户
+# USER 指定当前用户
 
 格式：`USER <用户名>[:<用户组>]`
 
 `USER` 指令和 `WORKDIR` 相似，都是改变环境状态并影响以后的层。`WORKDIR` 是改变工作目录，`USER` 则是改变之后层的执行 `RUN`, `CMD` 以及 `ENTRYPOINT` 这类命令的身份。
 
-当然，和 `WORKDIR` 一样，`USER` 只是帮助你切换到指定用户而已，这个用户必须是事先建立好的，否则无法切换。
+注意，`USER` 只是帮助你切换到指定用户而已，这个用户必须是事先建立好的，否则无法切换。
 
 ```docker
 RUN groupadd -r redis && useradd -r -g redis redis

image/dockerfile/volume.md

@@ -1,4 +1,4 @@
-### VOLUME 定义匿名卷
+# VOLUME 定义匿名卷
 
 格式为：
 
@@ -11,10 +11,10 @@
 VOLUME /data
 ```
 
-这里的 `/data` 目录就会在运行时自动挂载为匿名卷，任何向 `/data` 中写入的信息都不会记录进容器存储层，从而保证了容器存储层的无状态化。当然，运行时可以覆盖这个挂载设置。比如：
+这里的 `/data` 目录就会在容器运行时自动挂载为匿名卷，任何向 `/data` 中写入的信息都不会记录进容器存储层，从而保证了容器存储层的无状态化。当然，运行容器时可以覆盖这个挂载设置。比如：
 
 ```bash
-docker run -d -v mydata:/data xxxx
+$ docker run -d -v mydata:/data xxxx
 ```
 
 在这行命令中，就使用了 `mydata` 这个命名卷挂载到了 `/data` 这个位置，替代了 `Dockerfile` 中定义的匿名卷的挂载配置。

image/dockerfile/workdir.md

@@ -1,4 +1,4 @@
-### WORKDIR 指定工作目录
+# WORKDIR 指定工作目录
 
 格式为 `WORKDIR <工作目录路径>`。
 
@@ -33,4 +33,4 @@ WORKDIR c
 RUN pwd
 ```
 
-`pwd` 输出的结果为 `/a/b/c`。
+`RUN pwd` 的工作目录为 `/a/b/c`。

image/list.md

@@ -9,21 +9,21 @@ redis                latest              5f515359c7f8        5 days ago
 nginx                latest              05a60462f8ba        5 days ago          181 MB
 mongo                3.2                 fe9198c04d62        5 days ago          342 MB
 <none>               <none>              00285df0df87        5 days ago          342 MB
-ubuntu               18.04               f753707788c5        4 weeks ago         127 MB
-ubuntu               latest              f753707788c5        4 weeks ago         127 MB
+ubuntu               18.04               329ed837d508        3 days ago          63.3MB
+ubuntu               bionic              329ed837d508        3 days ago          63.3MB
 ```
 
 列表包含了 `仓库名`、`标签`、`镜像 ID`、`创建时间` 以及 `所占用的空间`。
 
-其中仓库名、标签在之前的基础概念章节已经介绍过了。**镜像 ID** 则是镜像的唯一标识，一个镜像可以对应多个 **标签**。因此，在上面的例子中，我们可以看到 `ubuntu:18.04` 和 `ubuntu:latest` 拥有相同的 ID，因为它们对应的是同一个镜像。
+其中仓库名、标签在之前的基础概念章节已经介绍过了。**镜像 ID** 则是镜像的唯一标识，一个镜像可以对应多个 **标签**。因此，在上面的例子中，我们可以看到 `ubuntu:18.04` 和 `ubuntu:bionic` 拥有相同的 ID，因为它们对应的是同一个镜像。
 
 ## 镜像体积
 
-如果仔细观察，会注意到，这里标识的所占用空间和在 Docker Hub 上看到的镜像大小不同。比如，`ubuntu:18.04` 镜像大小，在这里是 `127 MB`，但是在 [Docker Hub](https://hub.docker.com/_/ubuntu?tab=tags) 显示的却是 `50 MB`。这是因为 Docker Hub 中显示的体积是压缩后的体积。在镜像下载和上传过程中镜像是保持着压缩状态的，因此 Docker Hub 所显示的大小是网络传输中更关心的流量大小。而 `docker image ls` 显示的是镜像下载到本地后，展开的大小，准确说，是展开后的各层所占空间的总和，因为镜像到本地后，查看空间的时候，更关心的是本地磁盘空间占用的大小。
+如果仔细观察，会注意到，这里标识的所占用空间和在 Docker Hub 上看到的镜像大小不同。比如，`ubuntu:18.04` 镜像大小，在这里是 `63.3MB`，但是在 [Docker Hub](https://hub.docker.com/layers/ubuntu/library/ubuntu/bionic/images/sha256-32776cc92b5810ce72e77aca1d949de1f348e1d281d3f00ebcc22a3adcdc9f42?context=explore) 显示的却是 `25.47 MB`。这是因为 Docker Hub 中显示的体积是压缩后的体积。在镜像下载和上传过程中镜像是保持着压缩状态的，因此 Docker Hub 所显示的大小是网络传输中更关心的流量大小。而 `docker image ls` 显示的是镜像下载到本地后，展开的大小，准确说，是展开后的各层所占空间的总和，因为镜像到本地后，查看空间的时候，更关心的是本地磁盘空间占用的大小。
 
 另外一个需要注意的问题是，`docker image ls` 列表中的镜像体积总和并非是所有镜像实际硬盘消耗。由于 Docker 镜像是多层存储结构，并且可以继承、复用，因此不同镜像可能会因为使用相同的基础镜像，从而拥有共同的层。由于 Docker 使用 Union FS，相同的层只需要保存一份即可，因此实际镜像硬盘占用空间很可能要比这个列表镜像大小的总和要小的多。
 
-你可以通过以下命令来便捷的查看镜像、容器、数据卷所占用的空间。
+你可以通过 `docker system df` 命令来便捷的查看镜像、容器、数据卷所占用的空间。
 
 ```bash
 $ docker system df
@@ -76,8 +76,8 @@ $ docker image ls -a
 ```bash
 $ docker image ls ubuntu
 REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
-ubuntu              18.04               f753707788c5        4 weeks ago         127 MB
-ubuntu              latest              f753707788c5        4 weeks ago         127 MB
+ubuntu              18.04               329ed837d508        3 days ago          63.3MB
+ubuntu              bionic              329ed837d508        3 days ago          63.3MB
 ```
 
 列出特定的某个镜像，也就是说指定仓库名和标签
@@ -85,7 +85,7 @@ ubuntu              latest              f753707788c5        4 weeks ago
 ```bash
 $ docker image ls ubuntu:18.04
 REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
-ubuntu              18.04               f753707788c5        4 weeks ago         127 MB
+ubuntu              18.04               329ed837d508        3 days ago          63.3MB
 ```
 
 除此以外，`docker image ls` 还支持强大的过滤器参数 `--filter`，或者简写 `-f`。之前我们已经看到了使用过滤器来列出虚悬镜像的用法，它还有更多的用法。比如，我们希望看到在 `mongo:3.2` 之后建立的镜像，可以用下面的命令：
@@ -116,9 +116,8 @@ $ docker image ls -q
 05a60462f8ba
 fe9198c04d62
 00285df0df87
-f753707788c5
-f753707788c5
-1e0c3dd64ccd
+329ed837d508
+329ed837d508
 ```
 
 `--filter` 配合 `-q` 产生出指定范围的 ID 列表，然后送给另一个 `docker` 命令作为参数，从而针对这组实体成批的进行某种操作的做法在 Docker 命令行使用过程中非常常见，不仅仅是镜像，将来我们会在各个命令中看到这类搭配以完成很强大的功能。因此每次在文档看到过滤器后，可以多注意一下它们的用法。
@@ -133,9 +132,8 @@ $ docker image ls --format "{{.ID}}: {{.Repository}}"
 05a60462f8ba: nginx
 fe9198c04d62: mongo
 00285df0df87: <none>
-f753707788c5: ubuntu
-f753707788c5: ubuntu
-1e0c3dd64ccd: ubuntu
+329ed837d508: ubuntu
+329ed837d508: ubuntu
 ```
 
 或者打算以表格等距显示，并且有标题行，和默认一样，不过自己定义列：
@@ -147,6 +145,6 @@ IMAGE ID            REPOSITORY          TAG
 05a60462f8ba        nginx               latest
 fe9198c04d62        mongo               3.2
 00285df0df87        <none>              <none>
-f753707788c5        ubuntu              18.04
-f753707788c5        ubuntu              latest
+329ed837d508        ubuntu              18.04
+329ed837d508        ubuntu              bionic
 ```

image/manifest.md

@@ -24,18 +24,16 @@ $ docker run -it --rm username/test
 
 这样做显得很繁琐，那么有没有一种方法让 Docker 引擎根据系统架构自动拉取对应的镜像呢？
 
-我们发现在 `Linux x86_64` 和 `Linux arm64v8` 架构的计算机中执行 `$ docker run golang:alpine go version` 时我们发现可以正确的运行。
+我们发现在 `Linux x86_64` 和 `Linux arm64v8` 架构的计算机中分别使用 `golang:alpine` 镜像运行容器 `$ docker run golang:alpine go version` 时，容器能够正常的运行。
 
 这是什么原因呢？
 
-原因就是 `golang:alpine` 官方镜像有一个 [`manifest` 列表](https://docs.docker.com/registry/spec/manifest-v2-2/)。
+原因就是 `golang:alpine` 官方镜像有一个 [`manifest` 列表 (`manifest list`)](https://docs.docker.com/registry/spec/manifest-v2-2/)。
 
 当用户获取一个镜像时，Docker 引擎会首先查找该镜像是否有 `manifest` 列表，如果有的话 Docker 引擎会按照 Docker 运行环境（系统及架构）查找出对应镜像（例如 `golang:alpine`）。如果没有的话会直接获取镜像（例如上例中我们构建的 `username/test`）。
 
 我们可以使用 `$ docker manifest inspect golang:alpine` 查看这个 `manifest` 列表的结构。
 
-> 该命令属于实验特性，请参考 [开启实验特性](../install/experimental) 一节。
-
 ```bash
 $ docker manifest inspect golang:alpine
 ```
@@ -122,7 +120,7 @@ $ docker manifest create username/test \
       username/arm64v8-test
 ```
 
-当要修改一个 `manifest` 列表时，可以加入 `-a,--amend` 参数。
+当要修改一个 `manifest` 列表时，可以加入 `-a` 或 `--amend` 参数。
 
 ## 设置 `manifest` 列表
 

image/multistage-builds/README.md

@@ -27,7 +27,7 @@ func main(){
 编写 `Dockerfile.one` 文件
 
 ```docker
-FROM golang:1.9-alpine
+FROM golang:alpine
 
 RUN apk --no-cache add git ca-certificates
 
@@ -57,7 +57,7 @@ $ docker build -t go/helloworld:1 -f Dockerfile.one .
 例如，编写 `Dockerfile.build` 文件
 
 ```docker
-FROM golang:1.9-alpine
+FROM golang:alpine
 
 RUN apk --no-cache add git
 
@@ -126,7 +126,7 @@ go/helloworld   1      f55d3e16affc    2 minutes ago   295MB
 例如，编写 `Dockerfile` 文件
 
 ```docker
-FROM golang:1.9-alpine as builder
+FROM golang:alpine as builder
 
 RUN apk --no-cache add git
 
@@ -173,7 +173,7 @@ go/helloworld     1     f55d3e16affc     2 minutes ago      295MB
 我们可以使用 `as` 来为某一阶段命名，例如
 
 ```docker
-FROM golang:1.9-alpine as builder
+FROM golang:alpine as builder
 ```
 
 例如当我们只想构建 `builder` 阶段的镜像时，增加 `--target=builder` 参数即可

image/multistage-builds/example/laravel/Dockerfile

@@ -5,7 +5,7 @@ COPY package.json /app/
 RUN set -x ; cd /app \
       && npm install --registry=https://registry.npm.taobao.org
 
-COPY webpack.mix.js /app/
+COPY webpack.mix.js webpack.config.js tailwind.config.js /app/
 COPY resources/ /app/resources/
 
 RUN set -x ; cd /app \

image/multistage-builds/laravel.md

@@ -63,7 +63,7 @@ COPY package.json /app/
 RUN set -x ; cd /app \
       && npm install --registry=https://registry.npm.taobao.org
 
-COPY webpack.mix.js /app/
+COPY webpack.mix.js webpack.config.js tailwind.config.js /app/
 COPY resources/ /app/resources/
 
 RUN set -x ; cd /app \
@@ -181,7 +181,7 @@ COPY package.json /app/
 RUN set -x ; cd /app \
       && npm install --registry=https://registry.npm.taobao.org
 
-COPY webpack.mix.js /app/
+COPY webpack.mix.js webpack.config.js tailwind.config.js /app/
 COPY resources/ /app/resources/
 
 RUN set -x ; cd /app \

image/pull.md

@@ -5,12 +5,12 @@
 从 Docker 镜像仓库获取镜像的命令是 `docker pull`。其命令格式为：
 
 ```bash
-docker pull [选项] [Docker Registry 地址[:端口号]/]仓库名[:标签]
+$ docker pull [选项] [Docker Registry 地址[:端口号]/]仓库名[:标签]
 ```
 
 具体的选项可以通过 `docker pull --help` 命令看到，这里我们说一下镜像名称的格式。
 
-* Docker 镜像仓库地址：地址的格式一般是 `<域名/IP>[:端口号]`。默认地址是 Docker Hub(docker.io)。
+* Docker 镜像仓库地址：地址的格式一般是 `<域名/IP>[:端口号]`。默认地址是 Docker Hub(`docker.io`)。
 * 仓库名：如之前所说，这里的仓库名是两段式名称，即 `<用户名>/<软件名>`。对于 Docker Hub，如果不给出用户名，则默认为 `library`，也就是官方镜像。
 
 比如：
@@ -18,16 +18,15 @@ docker pull [选项] [Docker Registry 地址[:端口号]/]仓库名[:标签]
 ```bash
 $ docker pull ubuntu:18.04
 18.04: Pulling from library/ubuntu
-bf5d46315322: Pull complete
-9f13e0ac480c: Pull complete
-e8988b5b3097: Pull complete
-40af181810e7: Pull complete
-e6f7c7e5c03e: Pull complete
-Digest: sha256:147913621d9cdea08853f6ba9116c2e27a3ceffecf3b492983ae97c3d643fbbe
+92dc2a97ff99: Pull complete
+be13a9d27eb8: Pull complete
+c8299583700a: Pull complete
+Digest: sha256:4bc3ae6596938cb0d9e5ac51a1152ec9dcac2a1c50829c74abd9c4361e321b26
 Status: Downloaded newer image for ubuntu:18.04
+docker.io/library/ubuntu:18.04
 ```
 
-上面的命令中没有给出 Docker 镜像仓库地址，因此将会从 Docker Hub 获取镜像。而镜像名称是 `ubuntu:18.04`，因此将会获取官方镜像 `library/ubuntu` 仓库中标签为 `18.04` 的镜像。
+上面的命令中没有给出 Docker 镜像仓库地址，因此将会从 Docker Hub （`docker.io`）获取镜像。而镜像名称是 `ubuntu:18.04`，因此将会获取官方镜像 `library/ubuntu` 仓库中标签为 `18.04` 的镜像。`docker pull` 命令的输出结果最后一行给出了镜像的完整名称，即： `docker.io/library/ubuntu:18.04`。
 
 从下载过程中可以看到我们之前提及的分层存储的概念，镜像是由多层存储所构成。下载也是一层层的去下载，并非单一文件。下载过程中给出了每一层的 ID 的前 12 位。并且下载结束后，给出该镜像完整的 `sha256` 的摘要，以确保下载一致性。
 

install/centos.md

@@ -6,7 +6,7 @@
 
 ### 系统要求
 
-Docker 支持 64 位版本 CentOS 7，并且要求内核版本不低于 3.10。 CentOS 7 满足最低内核的要求，但由于内核版本比较低，部分功能（如 `overlay2` 存储层驱动）无法使用，并且部分功能可能不太稳定。
+Docker 支持 64 位版本 CentOS 7/8，并且要求内核版本不低于 3.10。 CentOS 7 满足最低内核的要求，但由于内核版本比较低，部分功能（如 `overlay2` 存储层驱动）无法使用，并且部分功能可能不太稳定。
 
 ### 卸载旧版本
 
@@ -40,9 +40,9 @@ $ sudo yum install -y yum-utils
 ```bash
 $ sudo yum-config-manager \
     --add-repo \
-    https://mirrors.ustc.edu.cn/docker-ce/linux/centos/docker-ce.repo
+    https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
 
-$ sudo sed -i 's/download.docker.com/mirrors.ustc.edu.cn\/docker-ce/g' /etc/yum.repos.d/docker-ce.repo
+$ sudo sed -i 's/download.docker.com/mirrors.aliyun.com\/docker-ce/g' /etc/yum.repos.d/docker-ce.repo
 
 # 官方源
 # $ sudo yum-config-manager \
@@ -50,7 +50,7 @@ $ sudo sed -i 's/download.docker.com/mirrors.ustc.edu.cn\/docker-ce/g' /etc/yum.
 #     https://download.docker.com/linux/centos/docker-ce.repo
 ```
 
-如果需要测试版本的 Docker 请使用以下命令：
+如果需要测试版本的 Docker 请执行以下命令：
 
 ```bash
 $ sudo yum-config-manager --enable docker-ce-test
@@ -64,11 +64,33 @@ $ sudo yum-config-manager --enable docker-ce-test
 $ sudo yum install docker-ce docker-ce-cli containerd.io
 ```
 
+## CentOS8 额外设置
+
+由于 CentOS8 防火墙使用了 `nftables`，但 Docker 尚未支持 `nftables`， 我们可以使用如下设置使用 `iptables`：
+
+更改 `/etc/firewalld/firewalld.conf`
+
+```bash
+# FirewallBackend=nftables
+FirewallBackend=iptables
+```
+
+或者执行如下命令：
+
+```bash
+$ firewall-cmd --permanent --zone=trusted --add-interface=docker0
+
+$ firewall-cmd --reload
+```
+
 ## 使用脚本自动安装
 
 在测试或开发环境中 Docker 官方为了简化安装流程，提供了一套便捷的安装脚本，CentOS 系统上可以使用这套脚本安装，另外可以通过 `--mirror` 选项使用国内源进行安装：
 
+> 若你想安装测试版的 Docker, 请从 test.docker.com 获取脚本
+
 ```bash
+# $ curl -fsSL test.docker.com -o get-docker.sh
 $ curl -fsSL get.docker.com -o get-docker.sh
 $ sudo sh get-docker.sh --mirror Aliyun
 # $ sudo sh get-docker.sh --mirror AzureChinaCloud
@@ -104,12 +126,12 @@ $ sudo usermod -aG docker $USER
 ## 测试 Docker 是否安装正确
 
 ```bash
-$ docker run hello-world
+$ docker run --rm hello-world
 
 Unable to find image 'hello-world:latest' locally
 latest: Pulling from library/hello-world
-d1725b59e92d: Pull complete
-Digest: sha256:0add3ace90ecb4adbf7777e9aacf18357296e799f81cabc9fde470971e499788
+b8dfde127a29: Pull complete
+Digest: sha256:308866a43596e83578c7dfa15e27a73011bdd402185a84c5cd7f32a88b501a24
 Status: Downloaded newer image for hello-world:latest
 
 Hello from Docker!
@@ -167,3 +189,5 @@ $ sudo sysctl -p
 ## 参考文档
 
 * [Docker 官方 CentOS 安装文档](https://docs.docker.com/install/linux/docker-ce/centos/)。
+* https://firewalld.org/2018/07/nftables-backend
+* https://github.com/moby/libnetwork/issues/2496

install/centos8.md

@@ -1,29 +0,0 @@
-# CentOS8 安装 Docker
-
-当前官方版本的 Docker [尚未支持][docker-docker] CentOS8，我们可以使用 Moby 项目维护者 AkihiroSuda 所构建的包，具体请参考 https://github.com/AkihiroSuda/moby-snapshot
-
-[docker-docker]:https://download.docker.com/linux/centos/
-
-## 设置
-
-由于 CentOS8 防火墙使用了 `nftables`，但 Docker 尚未支持 `nftables`， 我们可以使用如下设置使用 `iptables`：
-
-更改 `/etc/firewalld/firewalld.conf`
-
-```bash
-# FirewallBackend=nftables
-FirewallBackend=iptables
-```
-
-或者执行如下命令：
-
-```bash
-$ firewall-cmd --permanent --zone=trusted --add-interface=docker0
-
-$ firewall-cmd --reload
-```
-
-## 参考链接
-
-* https://firewalld.org/2018/07/nftables-backend
-* https://github.com/moby/libnetwork/issues/2496

install/debian.md

@@ -8,8 +8,8 @@
 
 Docker 支持以下版本的 [Debian](https://www.debian.org/intro/about) 操作系统：
 
-* Buster 10
-* Stretch 9
+* Debian Bullseye 11
+* Debian Buster 10
 
 ### 卸载旧版本
 
@@ -32,9 +32,8 @@ $ sudo apt-get install \
      apt-transport-https \
      ca-certificates \
      curl \
-     gnupg-agent \
-     lsb-release \
-     software-properties-common
+     gnupg \
+     lsb-release
 ```
 
 鉴于国内网络问题，强烈建议使用国内源，官方源请在注释中查看。
@@ -42,26 +41,28 @@ $ sudo apt-get install \
 为了确认所下载软件包的合法性，需要添加软件源的 GPG 密钥。
 
 ```bash
-$ curl -fsSL https://mirrors.ustc.edu.cn/docker-ce/linux/debian/gpg | sudo apt-key add -
+$ curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/debian/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
 
 
 # 官方源
-# $ curl -fsSL https://download.docker.com/linux/debian/gpg | sudo apt-key add -
+# $ curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
 ```
 
 然后，我们需要向 `sources.list` 中添加 Docker 软件源：
 
+> 在一些基于 Debian 的 Linux 发行版中 `$(lsb_release -cs)` 可能不会返回 Debian 的版本代号，例如 [Kail Linux](https://www.kali.org/docs/policy/kali-linux-relationship-with-debian/)、 [BunsenLabs Linux](https://www.bunsenlabs.org/)。在这些发行版中我们需要将下面命令中的 `$(lsb_release -cs)` 替换为 https://mirrors.aliyun.com/docker-ce/linux/debian/dists/ 中支持的 Debian 版本代号，例如 `buster`。
+
 ```bash
-$ sudo add-apt-repository \
-   "deb [arch=amd64] https://mirrors.ustc.edu.cn/docker-ce/linux/debian \
-   $(lsb_release -cs) \
-   stable"
+$ echo \
+  "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://mirrors.aliyun.com/docker-ce/linux/debian \
+  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
+
 
 # 官方源
-# $ sudo add-apt-repository \
-#    "deb [arch=amd64] https://download.docker.com/linux/debian \
-#    $(lsb_release -cs) \
-#    stable"
+# $ echo \
+#   "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/debian \
+#   $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
+
 ```
 
 >以上命令会添加稳定版本的 Docker APT 源，如果需要测试版本的 Docker 请将 stable 改为 test。
@@ -80,7 +81,10 @@ $ sudo apt-get install docker-ce docker-ce-cli containerd.io
 
 在测试或开发环境中 Docker 官方为了简化安装流程，提供了一套便捷的安装脚本，Debian 系统上可以使用这套脚本安装，另外可以通过 `--mirror` 选项使用国内源进行安装：
 
+> 若你想安装测试版的 Docker, 请从 test.docker.com 获取脚本
+
 ```bash
+# $ curl -fsSL test.docker.com -o get-docker.sh
 $ curl -fsSL get.docker.com -o get-docker.sh
 $ sudo sh get-docker.sh --mirror Aliyun
 # $ sudo sh get-docker.sh --mirror AzureChinaCloud
@@ -116,12 +120,12 @@ $ sudo usermod -aG docker $USER
 ## 测试 Docker 是否安装正确
 
 ```bash
-$ docker run hello-world
+$ docker run --rm hello-world
 
 Unable to find image 'hello-world:latest' locally
 latest: Pulling from library/hello-world
-d1725b59e92d: Pull complete
-Digest: sha256:0add3ace90ecb4adbf7777e9aacf18357296e799f81cabc9fde470971e499788
+b8dfde127a29: Pull complete
+Digest: sha256:308866a43596e83578c7dfa15e27a73011bdd402185a84c5cd7f32a88b501a24
 Status: Downloaded newer image for hello-world:latest
 
 Hello from Docker!

install/experimental.md

@@ -2,35 +2,11 @@
 
 一些 docker 命令或功能仅当 **实验特性** 开启时才能使用，请按照以下方法进行设置。
 
-## 开启 Docker CLI 的实验特性
+## Docker CLI 的实验特性
 
-编辑 `~/.docker/config.json` 文件，新增如下条目
+从 `v20.10` 版本开始，Docker CLI 所有实验特性的命令均默认开启，无需再进行配置或设置系统环境变量。
 
-```json
-{
-  "experimental": "enabled"
-}
-```
-
-或者通过设置环境变量的方式：
-
-**Linux/macOS**
-
-```bash
-$ export DOCKER_CLI_EXPERIMENTAL=enabled
-```
-
-**Windows**
-
-```powershell
-# 临时生效
-$ set $env:DOCKER_CLI_EXPERIMENTAL="enabled"
-
-# 永久生效
-$ [environment]::SetEnvironmentvariable("DOCKER_CLI_EXPERIMENTAL","enabled","User")
-```
-
-## 开启 Dockerd 的实验特性
+## 开启 dockerd 的实验特性
 
 编辑 `/etc/docker/daemon.json`，新增如下条目
 

install/fedora.md

@@ -8,8 +8,8 @@
 
 Docker 支持以下版本的 [Fedora](https://getfedora.org/) 操作系统：
 
-* 30
-* 31
+* 33
+* 34
 
 ### 卸载旧版本
 
@@ -43,9 +43,9 @@ $ sudo dnf -y install dnf-plugins-core
 ```bash
 $ sudo dnf config-manager \
     --add-repo \
-    https://mirrors.ustc.edu.cn/docker-ce/linux/fedora/docker-ce.repo
+    https://mirrors.aliyun.com/docker-ce/linux/fedora/docker-ce.repo
 
-$ sudo sed -i 's/download.docker.com/mirrors.ustc.edu.cn\/docker-ce/g' /etc/yum.repos.d/docker-ce.repo
+$ sudo sed -i 's/download.docker.com/mirrors.aliyun.com\/docker-ce/g' /etc/yum.repos.d/docker-ce.repo
 
 # 官方源
 # $ sudo dnf config-manager \
@@ -84,17 +84,14 @@ docker-ce.x86_64          18.06.1.ce-3.fc28                     docker-ce-stable
 $ sudo dnf -y install docker-ce-18.06.1.ce
 ```
 
-由于 Fedora 31 默认启用了 **Cgroupv2**，暂时 Docker 与 Cgroupv2 不兼容，请执行以下命令切换到 **Cgroupv1** 并重启计算机:
-
-```bash
-$ sudo grubby --update-kernel=ALL --args="systemd.unified_cgroup_hierarchy=0"
-```
-
 ## 使用脚本自动安装
 
 在测试或开发环境中 Docker 官方为了简化安装流程，提供了一套便捷的安装脚本，Debian 系统上可以使用这套脚本安装，另外可以通过 `--mirror` 选项使用国内源进行安装：
 
+> 若你想安装测试版的 Docker, 请从 test.docker.com 获取脚本
+
 ```bash
+# $ curl -fsSL test.docker.com -o get-docker.sh
 $ curl -fsSL get.docker.com -o get-docker.sh
 $ sudo sh get-docker.sh --mirror Aliyun
 # $ sudo sh get-docker.sh --mirror AzureChinaCloud
@@ -130,12 +127,12 @@ $ sudo usermod -aG docker $USER
 ## 测试 Docker 是否安装正确
 
 ```bash
-$ docker run hello-world
+$ docker run --rm hello-world
 
 Unable to find image 'hello-world:latest' locally
 latest: Pulling from library/hello-world
-d1725b59e92d: Pull complete
-Digest: sha256:0add3ace90ecb4adbf7777e9aacf18357296e799f81cabc9fde470971e499788
+b8dfde127a29: Pull complete
+Digest: sha256:308866a43596e83578c7dfa15e27a73011bdd402185a84c5cd7f32a88b501a24
 Status: Downloaded newer image for hello-world:latest
 
 Hello from Docker!

install/mac.md

@@ -2,7 +2,7 @@
 
 ## 系统要求
 
-[Docker Desktop for Mac](https://docs.docker.com/docker-for-mac/) 要求系统最低为 macOS Catalina 10.13。
+[Docker Desktop for Mac](https://docs.docker.com/docker-for-mac/) 要求系统最低为 macOS Mojave 10.14。
 
 ## 安装
 
@@ -11,44 +11,38 @@
 [Homebrew](https://brew.sh/) 的 [Cask](https://github.com/Homebrew/homebrew-cask) 已经支持 Docker Desktop for Mac，因此可以很方便的使用 Homebrew Cask 来进行安装：
 
 ```bash
-$ brew cask install docker
+$ brew install --cask docker
 ```
 
 ### 手动下载安装
 
-如果需要手动下载，请点击以下链接下载 [Stable](https://download.docker.com/mac/stable/Docker.dmg) 或 [Edge](https://download.docker.com/mac/edge/Docker.dmg) 版本的 Docker Desktop for Mac。
+如果需要手动下载，请点击以下 [链接](https://desktop.docker.com/mac/main/amd64/Docker.dmg) 下载 Docker Desktop for Mac。
+
+> 如果你的电脑搭载的是 M1 芯片（`arm64` 架构），请点击以下 [链接](https://desktop.docker.com/mac/main/arm64/Docker.dmg) 下载 Docker Desktop for Mac。你可以在 [官方文档](https://docs.docker.com/docker-for-mac/apple-silicon/) 查阅已知的问题。
 
 如同 macOS 其它软件一样，安装也非常简单，双击下载的 `.dmg` 文件，然后将那只叫 [Moby](https://www.docker.com/blog/call-me-moby-dock/) 的鲸鱼图标拖拽到 `Application` 文件夹即可（其间需要输入用户密码）。
 
-![](_images/install-mac-dmg.png)
+![](./_images/install-mac-dmg.png)
 
 ## 运行
 
 从应用中找到 Docker 图标并点击运行。
 
-![](_images/install-mac-apps.png)
+![](./_images/install-mac-apps.png)
 
 运行之后，会在右上角菜单栏看到多了一个鲸鱼图标，这个图标表明了 Docker 的运行状态。
 
-![](_images/install-mac-menubar.png)
+![](./_images/install-mac-menubar.png)
 
-第一次点击图标，可能会看到这个安装成功的界面，点击 "Got it!" 可以关闭这个窗口。
+每次点击鲸鱼图标会弹出操作菜单。
 
-![](_images/install-mac-success.png)
+![](./_images/install-mac-menu.png)
 
-以后每次点击鲸鱼图标会弹出操作菜单。
-
-![](_images/install-mac-menu.png)
-
-启动终端后，通过命令可以检查安装后的 Docker 版本。
+之后，你可以在终端通过命令检查安装后的 Docker 版本。
 
 ```bash
 $ docker --version
-Docker version 19.03.8, build afacb8b
-$ docker-compose --version
-docker-compose version 1.25.5, build 8a1c60f6
-$ docker-machine --version
-docker-machine version 0.16.1, build cce350d7
+Docker version 20.10.0, build 7287ab3
 ```
 
 如果 `docker version`、`docker info` 都正常的话，可以尝试运行一个 [Nginx 服务器](https://hub.docker.com/_/nginx/)：
@@ -59,7 +53,7 @@ $ docker run -d -p 80:80 --name webserver nginx
 
 服务运行后，可以访问 <http://localhost>，如果看到了 "Welcome to nginx!"，就说明 Docker Desktop for Mac 安装成功了。
 
-![](_images/install-mac-example-nginx.png)
+![](./_images/install-mac-example-nginx.png)
 
 要停止 Nginx 服务器并删除执行下面的命令：
 

install/mirror.md

@@ -2,7 +2,7 @@
 
 国内从 Docker Hub 拉取镜像有时会遇到困难，此时可以配置镜像加速器。国内很多云服务商都提供了国内加速器服务，例如：
 
-* [阿里云加速器(点击管理控制台 -> 登录账号(淘宝账号) -> 右侧镜像中心 -> 镜像加速器 -> 复制地址)](https://www.aliyun.com/product/acr?source=5176.11533457&userCode=8lx5zmtu)
+* [阿里云加速器(点击管理控制台 -> 登录账号(淘宝账号) -> 右侧镜像工具 -> 镜像加速器 -> 复制加速器地址)](https://www.aliyun.com/product/acr?source=5176.11533457&userCode=8lx5zmtu)
 * [网易云加速器 `https://hub-mirror.c.163.com`](https://www.163yun.com/help/documents/56918246390157312)
 * [百度云加速器 `https://mirror.baidubce.com`](https://cloud.baidu.com/doc/CCE/s/Yjxppt74z#%E4%BD%BF%E7%94%A8dockerhub%E5%8A%A0%E9%80%9F%E5%99%A8)
 

install/raspberry-pi.md

@@ -6,7 +6,7 @@
 
 Docker 不仅支持 `x86_64` 架构的计算机，同时也支持 `ARM` 架构的计算机，本小节内容以树莓派单片电脑为例讲解 `ARM` 架构安装 Docker。
 
-Docker 支持以下版本的 [Raspberry Pi OS](https://www.raspberrypi.org/downloads/raspberry-pi-os/) 操作系统：
+Docker 支持以下版本的 [Raspberry Pi OS](https://www.raspberrypi.org/software/operating-systems/) 操作系统：
 
 * Raspberry Pi OS Buster
 
@@ -33,7 +33,7 @@ $ sudo apt-get install \
 为了确认所下载软件包的合法性，需要添加软件源的 GPG 密钥。
 
 ```bash
-$ curl -fsSL https://mirrors.ustc.edu.cn/docker-ce/linux/raspbian/gpg | sudo apt-key add -
+$ curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/raspbian/gpg | sudo apt-key add -
 
 
 # 官方源
@@ -44,7 +44,7 @@ $ curl -fsSL https://mirrors.ustc.edu.cn/docker-ce/linux/raspbian/gpg | sudo apt
 
 ```bash
 $ sudo add-apt-repository \
-    "deb [arch=armhf] https://mirrors.ustc.edu.cn/docker-ce/linux/raspbian \
+    "deb [arch=armhf] https://mirrors.aliyun.com/docker-ce/linux/raspbian \
     $(lsb_release -cs) \
     stable"
 
@@ -72,7 +72,10 @@ $ sudo apt-get install docker-ce
 
 在测试或开发环境中 Docker 官方为了简化安装流程，提供了一套便捷的安装脚本，Raspberry Pi OS 系统上可以使用这套脚本安装，另外可以通过 `--mirror` 选项使用国内源进行安装：
 
+> 若你想安装测试版的 Docker, 请从 test.docker.com 获取脚本
+
 ```bash
+# $ curl -fsSL test.docker.com -o get-docker.sh
 $ curl -fsSL get.docker.com -o get-docker.sh
 $ sudo sh get-docker.sh --mirror Aliyun
 # $ sudo sh get-docker.sh --mirror AzureChinaCloud
@@ -108,12 +111,12 @@ $ sudo usermod -aG docker $USER
 ## 测试 Docker 是否安装正确
 
 ```bash
-$ docker run arm32v7/hello-world
+$ docker run --rm hello-world
 
 Unable to find image 'hello-world:latest' locally
 latest: Pulling from library/hello-world
-d1725b59e92d: Pull complete
-Digest: sha256:0add3ace90ecb4adbf7777e9aacf18357296e799f81cabc9fde470971e499788
+4ee5c797bcd7: Pull complete
+Digest: sha256:308866a43596e83578c7dfa15e27a73011bdd402185a84c5cd7f32a88b501a24
 Status: Downloaded newer image for hello-world:latest
 
 Hello from Docker!
@@ -122,7 +125,7 @@ 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)
+    (arm32v7)
  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

install/ubuntu.md

@@ -8,9 +8,10 @@
 
 Docker 支持以下版本的 [Ubuntu](https://ubuntu.com/server) 操作系统：
 
+* Ubuntu Hirsute 21.04
+* Ubuntu Groovy 20.10
 * Ubuntu Focal 20.04 (LTS)
-* Bionic 18.04 (LTS)
-* Xenial 16.04 (LTS)
+* Ubuntu Bionic 18.04 (LTS)
 
 Docker 可以安装在 64 位的 x86 平台或 ARM 平台上。Ubuntu 发行版中，LTS（Long-Term-Support）长期支持版本，会获得 5 年的升级维护支持，这样的版本会更稳定，因此在生产环境中推荐使用 LTS 版本。
 
@@ -35,8 +36,8 @@ $ sudo apt-get install \
     apt-transport-https \
     ca-certificates \
     curl \
-    gnupg-agent \
-    software-properties-common
+    gnupg \
+    lsb-release
 ```
 
 鉴于国内网络问题，强烈建议使用国内源，官方源请在注释中查看。
@@ -44,27 +45,25 @@ $ sudo apt-get install \
 为了确认所下载软件包的合法性，需要添加软件源的 `GPG` 密钥。
 
 ```bash
-$ curl -fsSL https://mirrors.ustc.edu.cn/docker-ce/linux/ubuntu/gpg | sudo apt-key add -
+$ curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
 
 
 # 官方源
-# $ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
+# $ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
 ```
 
 然后，我们需要向 `sources.list` 中添加 Docker 软件源
 
 ```bash
-$ sudo add-apt-repository \
-    "deb [arch=amd64] https://mirrors.ustc.edu.cn/docker-ce/linux/ubuntu \
-    $(lsb_release -cs) \
-    stable"
+$ echo \
+  "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://mirrors.aliyun.com/docker-ce/linux/ubuntu \
+  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
 
 
 # 官方源
-# $ sudo add-apt-repository \
-#    "deb [arch=amd64] https://download.docker.com/linux/ubuntu \
-#    $(lsb_release -cs) \
-#    stable"
+# $ echo \
+#   "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \
+#   $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
 ```
 
 >以上命令会添加稳定版本的 Docker APT 镜像源，如果需要测试版本的 Docker 请将 stable 改为 test。
@@ -83,7 +82,10 @@ $ sudo apt-get install docker-ce docker-ce-cli containerd.io
 
 在测试或开发环境中 Docker 官方为了简化安装流程，提供了一套便捷的安装脚本，Ubuntu 系统上可以使用这套脚本安装，另外可以通过 `--mirror` 选项使用国内源进行安装：
 
+> 若你想安装测试版的 Docker, 请从 test.docker.com 获取脚本
+
 ```bash
+# $ curl -fsSL test.docker.com -o get-docker.sh
 $ curl -fsSL get.docker.com -o get-docker.sh
 $ sudo sh get-docker.sh --mirror Aliyun
 # $ sudo sh get-docker.sh --mirror AzureChinaCloud
@@ -119,12 +121,12 @@ $ sudo usermod -aG docker $USER
 ## 测试 Docker 是否安装正确
 
 ```bash
-$ docker run hello-world
+$ docker run --rm hello-world
 
 Unable to find image 'hello-world:latest' locally
 latest: Pulling from library/hello-world
-d1725b59e92d: Pull complete
-Digest: sha256:0add3ace90ecb4adbf7777e9aacf18357296e799f81cabc9fde470971e499788
+b8dfde127a29: Pull complete
+Digest: sha256:308866a43596e83578c7dfa15e27a73011bdd402185a84c5cd7f32a88b501a24
 Status: Downloaded newer image for hello-world:latest
 
 Hello from Docker!

install/windows.md

@@ -8,33 +8,33 @@
 
 **手动下载安装**
 
-点击以下链接下载 [Stable](https://download.docker.com/win/stable/Docker%20Desktop%20Installer.exe) 或 [Edge](https://download.docker.com/win/edge/Docker%20Desktop%20Installer.exe) 版本的 Docker Desktop for Windows。
+点击以下 [链接](https://desktop.docker.com/win/main/amd64/Docker%20Desktop%20Installer.exe) 下载 Docker Desktop for Windows。
 
 下载好之后双击 `Docker Desktop Installer.exe` 开始安装。
 
 **使用 [winget](https://docs.microsoft.com/zh-cn/windows/package-manager/) 安装**
 
 ```powershell
-# stable
 $ winget install Docker.DockerDesktop
-
-# edge
-$ winget install Docker.DockerDesktopEdge
 ```
 
+## 在 WSL2 运行 Docker 
+
+若你的 Windows 版本为 Windows 10 专业版或家庭版 v1903 及以上版本可以使用 WSL2 运行 Docker，具体请查看 [Docker Desktop WSL 2 backend](https://docs.docker.com/docker-for-windows/wsl/)。
+
 ## 运行
 
 在 Windows 搜索栏输入 **Docker** 点击 **Docker Desktop** 开始运行。
 
-![](_images/install-win-docker-app-search.png)
+![](./_images/install-win-docker-app-search.png)
 
 Docker 启动之后会在 Windows 任务栏出现鲸鱼图标。
 
-![](_images/install-win-taskbar-circle.png)
+![](./_images/install-win-taskbar-circle.png)
 
-等待片刻，点击 Got it 开始使用 Docker。
+等待片刻，当鲸鱼图标静止时，说明 Docker 启动成功，之后你可以打开 PowerShell 使用 Docker。
 
-![](_images/install-win-success-popup-cloud.png)
+> 推荐使用 [Windows Terminal](https://docs.microsoft.com/zh-cn/windows/terminal/get-started) 在终端使用 Docker。
 
 ## 镜像加速
 
@@ -43,5 +43,4 @@ Docker 启动之后会在 Windows 任务栏出现鲸鱼图标。
 ## 参考链接
 
 * [官方文档](https://docs.docker.com/docker-for-windows/install/)
-* [Docker Desktop WSL 2 backend](https://docs.docker.com/docker-for-windows/wsl/)
 * [WSL 2 Support is coming to Windows 10 Versions 1903 and 1909](https://devblogs.microsoft.com/commandline/wsl-2-support-is-coming-to-windows-10-versions-1903-and-1909/)

introduction/README.md

@@ -1,4 +1,5 @@
 # 简介
+
 本章将带领你进入 **Docker** 的世界。
 
 什么是 **Docker**？

introduction/what.md

@@ -4,7 +4,7 @@
 
 **Docker** 自开源后受到广泛的关注和讨论，至今其 [GitHub 项目](https://github.com/moby/moby) 已经超过 5 万 7 千个星标和一万多个 `fork`。甚至由于 `Docker` 项目的火爆，在 `2013` 年底，[dotCloud 公司决定改名为 Docker](https://www.docker.com/blog/dotcloud-is-becoming-docker-inc/)。`Docker` 最初是在 `Ubuntu 12.04` 上开发实现的；`Red Hat` 则从 `RHEL 6.5` 开始对 `Docker` 进行支持；`Google` 也在其 `PaaS` 产品中广泛应用 `Docker`。
 
-**Docker** 使用 `Google` 公司推出的 [Go 语言](https://golang.org/) 进行开发实现，基于 `Linux` 内核的 [cgroup](https://zh.wikipedia.org/wiki/Cgroups)，[namespace](https://en.wikipedia.org/wiki/Linux_namespaces)，以及 [OverlayFS](https://docs.docker.com/storage/storagedriver/overlayfs-driver/) 类的 [Union FS](https://en.wikipedia.org/wiki/Union_mount) 等技术，对进程进行封装隔离，属于 [操作系统层面的虚拟化技术](https://en.wikipedia.org/wiki/Operating-system-level_virtualization)。由于隔离的进程独立于宿主和其它的隔离的进程，因此也称其为容器。最初实现是基于 [LXC](https://linuxcontainers.org/lxc/introduction/)，从 0.7 版本以后开始去除 `LXC`，转而使用自行开发的 [libcontainer](https://github.com/docker/libcontainer)，从 1.11 开始，则进一步演进为使用 [runC](https://github.com/opencontainers/runc) 和 [containerd](https://github.com/containerd/containerd)。
+**Docker** 使用 `Google` 公司推出的 [Go 语言](https://golang.google.cn/) 进行开发实现，基于 `Linux` 内核的 [cgroup](https://zh.wikipedia.org/wiki/Cgroups)，[namespace](https://en.wikipedia.org/wiki/Linux_namespaces)，以及 [OverlayFS](https://docs.docker.com/storage/storagedriver/overlayfs-driver/) 类的 [Union FS](https://en.wikipedia.org/wiki/Union_mount) 等技术，对进程进行封装隔离，属于 [操作系统层面的虚拟化技术](https://en.wikipedia.org/wiki/Operating-system-level_virtualization)。由于隔离的进程独立于宿主和其它的隔离的进程，因此也称其为容器。最初实现是基于 [LXC](https://linuxcontainers.org/lxc/introduction/)，从 `0.7` 版本以后开始去除 `LXC`，转而使用自行开发的 [libcontainer](https://github.com/docker/libcontainer)，从 `1.11` 版本开始，则进一步演进为使用 [runC](https://github.com/opencontainers/runc) 和 [containerd](https://github.com/containerd/containerd)。
 
 ![Docker 架构](https://docs.microsoft.com/en-us/virtualization/windowscontainers/deploy-containers/media/docker-on-linux.png)
 
@@ -16,8 +16,8 @@
 
 下面的图片比较了 **Docker** 和传统虚拟化方式的不同之处。传统虚拟机技术是虚拟出一套硬件后，在其上运行一个完整操作系统，在该系统上再运行所需应用进程；而容器内的应用进程直接运行于宿主的内核，容器内没有自己的内核，而且也没有进行硬件虚拟。因此容器要比传统虚拟机更为轻便。
 
-![传统虚拟化](_images/virtualization.png)
+![传统虚拟化](./_images/virtualization.png)
 
-![Docker](_images/docker.png)
+![Docker](./_images/docker.png)
 
 [docker-soft]:https://en.wikipedia.org/wiki/Docker_(software)

kubernetes/concepts.md

@@ -1,6 +1,6 @@
 # 基本概念
 
-![](_images/kubernetes_design.jpg)
+![](./_images/kubernetes_design.jpg)
 
 * 节点（`Node`）：一个节点是一个运行 Kubernetes 中的主机。
 * 容器组（`Pod`）：一个 Pod 对应于由若干容器组成的一个容器组，同个组内的容器共享一个存储卷(volume)。

kubernetes/design.md

@@ -13,7 +13,7 @@
 
 下面这张图完整展示了 Kubernetes 的运行原理。
 
-![Kubernetes 架构](_images/k8s_architecture.png)
+![Kubernetes 架构](./_images/k8s_architecture.png)
 
 可见，Kubernetes 首先是一套分布式系统，由多个节点组成，节点分为两类：一类是属于管理平面的主节点/控制节点（Master Node）；一类是属于运行平面的工作节点（Worker Node）。
 
@@ -41,4 +41,4 @@
 * kubelet 是工作节点执行操作的 agent，负责具体的容器生命周期管理，根据从数据库中获取的信息来管理容器，并上报 pod 运行状态等；
 * kube-proxy 是一个简单的网络访问代理，同时也是一个 Load Balancer。它负责将访问到某个服务的请求具体分配给工作节点上的 Pod（同一类标签）。
 
-![Proxy 代理对服务的请求](_images/kube-proxy.png)
+![Proxy 代理对服务的请求](./_images/kube-proxy.png)

kubernetes/intro.md

@@ -1,6 +1,6 @@
 # 项目简介
 
-![](_images/kubernetes_logo.png)
+![](./_images/kubernetes_logo.png)
 
 Kubernetes 是 Google 团队发起的开源项目，它的目标是管理跨多个主机的容器，提供基本的部署，维护以及应用伸缩，主要实现语言为 Go 语言。Kubernetes 是：
 

kubernetes/setup/README.md

@@ -1,6 +1,6 @@
 # 部署 Kubernetes
 
-目前，Kubernetes 支持在多种环境下使用，包括本地主机（Fedora）、云服务（Google GAE、AWS 等）。
+目前，Kubernetes 支持在多种环境下使用，包括本地主机（Ubuntu、Debian、CentOS、Fedora 等）、云服务（[腾讯云](https://cloud.tencent.com/act/cps/redirect?redirect=10058&cps_key=3a5255852d5db99dcd5da4c72f05df61)、[阿里云](https://www.aliyun.com/product/kubernetes?source=5176.11533457&userCode=8lx5zmtu&type=copy)、[百度云](https://cloud.baidu.com/product/cce.html) 等）。
 
 你可以使用以下几种方式部署 Kubernetes：
 

kubernetes/setup/kubeadm-docker.md

@@ -0,0 +1,187 @@
+# 使用 kubeadm 部署 kubernetes(使用 Docker)
+
+`kubeadm` 提供了 `kubeadm init` 以及 `kubeadm join` 这两个命令作为快速创建 `kubernetes` 集群的最佳实践。
+
+## 安装 Docker
+
+参考 [安装 Docker](../../install) 一节安装 Docker。
+
+## 安装 **kubelet** **kubeadm** **kubectl**
+
+### Ubuntu/Debian
+
+```bash
+$ apt-get update && apt-get install -y apt-transport-https
+$ curl https://mirrors.aliyun.com/kubernetes/apt/doc/apt-key.gpg | apt-key add -
+
+$ cat <<EOF | sudo tee /etc/apt/sources.list.d/kubernetes.list
+deb https://mirrors.aliyun.com/kubernetes/apt/ kubernetes-xenial main
+EOF
+
+$ apt-get update
+$ apt-get install -y kubelet kubeadm kubectl
+```
+
+### CentOS/Fedora
+
+```bash
+$ cat <<EOF | sudo tee /etc/yum.repos.d/kubernetes.repo
+[kubernetes]
+name=Kubernetes
+baseurl=https://mirrors.aliyun.com/kubernetes/yum/repos/kubernetes-el7-x86_64/
+enabled=1
+gpgcheck=1
+repo_gpgcheck=1
+gpgkey=https://mirrors.aliyun.com/kubernetes/yum/doc/yum-key.gpg https://mirrors.aliyun.com/kubernetes/yum/doc/rpm-package-key.gpg
+EOF
+
+$ sudo yum install -y kubelet kubeadm kubectl
+```
+
+## 修改内核的运行参数
+
+```bash
+$ cat <<EOF | sudo tee /etc/sysctl.d/99-kubernetes-cri.conf
+net.bridge.bridge-nf-call-iptables  = 1
+net.ipv4.ip_forward                 = 1
+net.bridge.bridge-nf-call-ip6tables = 1
+EOF
+
+# 应用配置
+$ sysctl --system
+```
+
+## 配置 kubelet
+
+### 修改 `kubelet.service`
+
+`/etc/systemd/system/kubelet.service.d/10-proxy-ipvs.conf` 写入以下内容
+
+```bash
+# 启用 ipvs 相关内核模块
+[Service]
+ExecStartPre=-/sbin/modprobe ip_vs
+ExecStartPre=-/sbin/modprobe ip_vs_rr
+ExecStartPre=-/sbin/modprobe ip_vs_wrr
+ExecStartPre=-/sbin/modprobe ip_vs_sh
+```
+
+执行以下命令应用配置。
+
+```bash
+$ sudo systemctl daemon-reload
+```
+
+## 部署
+
+### master
+
+```bash
+$ sudo kubeadm init --image-repository registry.cn-hangzhou.aliyuncs.com/google_containers \
+      --pod-network-cidr 10.244.0.0/16 \
+      --v 5 \
+      --ignore-preflight-errors=all
+```
+
+* `--pod-network-cidr 10.244.0.0/16` 参数与后续 CNI 插件有关，这里以 `flannel` 为例，若后续部署其他类型的网络插件请更改此参数。
+
+> 执行可能出现错误，例如缺少依赖包，根据提示安装即可。
+
+执行成功会输出
+
+```bash
+...
+[addons] Applied essential addon: CoreDNS
+I1116 12:35:13.270407   86677 request.go:538] Throttling request took 181.409184ms, request: POST:https://192.168.199.100:6443/api/v1/namespaces/kube-system/serviceaccounts
+I1116 12:35:13.470292   86677 request.go:538] Throttling request took 186.088112ms, request: POST:https://192.168.199.100:6443/api/v1/namespaces/kube-system/configmaps
+[addons] Applied essential addon: kube-proxy
+
+Your Kubernetes control-plane has initialized successfully!
+
+To start using your cluster, you need to run the following as a regular user:
+
+  mkdir -p $HOME/.kube
+  sudo cp -i /etc/kubernetes/admin.conf $HOME/.kube/config
+  sudo chown $(id -u):$(id -g) $HOME/.kube/config
+
+You should now deploy a pod network to the cluster.
+Run "kubectl apply -f [podnetwork].yaml" with one of the options listed at:
+  https://kubernetes.io/docs/concepts/cluster-administration/addons/
+
+Then you can join any number of worker nodes by running the following on each as root:
+
+kubeadm join 192.168.199.100:6443 --token cz81zt.orsy9gm9v649e5lf \
+    --discovery-token-ca-cert-hash sha256:5edb316fd0d8ea2792cba15cdf1c899a366f147aa03cba52d4e5c5884ad836fe
+```
+
+### node 工作节点
+
+在 **另一主机** 重复 **部署** 小节以前的步骤，安装配置好 kubelet。根据提示，加入到集群。
+
+```bash
+$ kubeadm join 192.168.199.100:6443 --token cz81zt.orsy9gm9v649e5lf \
+    --discovery-token-ca-cert-hash sha256:5edb316fd0d8ea2792cba15cdf1c899a366f147aa03cba52d4e5c5884ad836fe
+```
+
+## 查看服务
+
+所有服务启动后，查看本地实际运行的 Docker 容器。这些服务大概分为三类：主节点服务、工作节点服务和其它服务。
+
+### 主节点服务
+
+* `apiserver` 是整个系统的对外接口，提供 RESTful 方式供客户端和其它组件调用；
+
+* `scheduler` 负责对资源进行调度，分配某个 pod 到某个节点上；
+
+* `controller-manager` 负责管理控制器，包括 endpoint-controller（刷新服务和 pod 的关联信息）和 replication-controller（维护某个 pod 的复制为配置的数值）。
+
+### 工作节点服务
+
+* `proxy` 为 pod 上的服务提供访问的代理。
+
+### 其它服务
+
+* Etcd 是所有状态的存储数据库；
+
+## 使用
+
+将 `/etc/kubernetes/admin.conf` 复制到 `~/.kube/config`
+
+执行 `$ kubectl get all -A` 查看启动的服务。
+
+由于未部署 CNI 插件，CoreDNS 未正常启动。如何使用 Kubernetes，请参考后续章节。
+
+## 部署 CNI
+
+这里以 `flannel` 为例进行介绍。
+
+### flannel
+
+检查 podCIDR 设置
+
+```bash
+$ kubectl get node -o yaml | grep CIDR
+
+# 输出
+    podCIDR: 10.244.0.0/16
+    podCIDRs:
+```
+
+```bash
+$ kubectl apply -f https://raw.githubusercontent.com/coreos/flannel/v0.11.0/Documentation/kube-flannel.yml
+```
+
+## master 节点默认不能运行 pod
+
+如果用 `kubeadm` 部署一个单节点集群，默认情况下无法使用，请执行以下命令解除限制
+
+```bash
+$ kubectl taint nodes --all node-role.kubernetes.io/master-
+
+# 恢复默认值
+# $ kubectl taint nodes NODE_NAME node-role.kubernetes.io/master=true:NoSchedule
+```
+
+## 参考文档
+
+* [官方文档](https://kubernetes.io/zh/docs/setup/production-environment/tools/kubeadm/install-kubeadm/)

kubernetes/setup/kubeadm.md

@@ -1,12 +1,205 @@
-# 使用 kubeadm 部署 kubernetes
+# 使用 kubeadm 部署 kubernetes(CRI 使用 containerd)
 
 `kubeadm` 提供了 `kubeadm init` 以及 `kubeadm join` 这两个命令作为快速创建 `kubernetes` 集群的最佳实践。
 
-## 安装 Docker
+## 安装 containerd
 
-参考 [安装 Docker](../../install) 一节安装 Docker。
+参考 [安装 Docker](../../install) 一节添加 apt/yum 源，之后执行如下命令。
 
-## 安装 **kubelet** **kubeadm** **kubectl**
+```bash
+# debian 系
+$ sudo apt install containerd.io
+
+# rhel 系
+$ sudo yum install containerd.io
+```
+
+## 配置 containerd
+
+新建 `/etc/systemd/system/cri-containerd.service` 文件
+
+```
+[Unit]
+Description=containerd container runtime for kubernetes
+Documentation=https://containerd.io
+After=network.target local-fs.target
+
+[Service]
+ExecStartPre=-/sbin/modprobe overlay
+ExecStart=/usr/bin/containerd --config //etc/cri-containerd/config.toml
+
+Type=notify
+Delegate=yes
+KillMode=process
+Restart=always
+RestartSec=5
+# Having non-zero Limit*s causes performance problems due to accounting overhead
+# in the kernel. We recommend using cgroups to do container-local accounting.
+LimitNPROC=infinity
+LimitCORE=infinity
+LimitNOFILE=infinity
+# Comment TasksMax if your systemd version does not supports it.
+# Only systemd 226 and above support this version.
+TasksMax=infinity
+OOMScoreAdjust=-999
+
+[Install]
+WantedBy=multi-user.target
+```
+
+新建 `/etc/cri-containerd/config.toml` containerd 配置文件
+
+```toml
+version = 2
+# persistent data location
+root = "/var/lib/cri-containerd"
+# runtime state information
+state = "/run/cri-containerd"
+plugin_dir = ""
+disabled_plugins = []
+required_plugins = []
+# set containerd's OOM score
+oom_score = 0
+
+[grpc]
+  address = "/run/cri-containerd/cri-containerd.sock"
+  tcp_address = ""
+  tcp_tls_cert = ""
+  tcp_tls_key = ""
+  # socket uid
+  uid = 0
+  # socket gid
+  gid = 0
+  max_recv_message_size = 16777216
+  max_send_message_size = 16777216
+
+[debug]
+  address = ""
+  format = "json"
+  uid = 0
+  gid = 0
+  level = ""
+
+[metrics]
+  address = "127.0.0.1:1338"
+  grpc_histogram = false
+
+[cgroup]
+  path = ""
+
+[timeouts]
+  "io.containerd.timeout.shim.cleanup" = "5s"
+  "io.containerd.timeout.shim.load" = "5s"
+  "io.containerd.timeout.shim.shutdown" = "3s"
+  "io.containerd.timeout.task.state" = "2s"
+
+[plugins]
+  [plugins."io.containerd.gc.v1.scheduler"]
+    pause_threshold = 0.02
+    deletion_threshold = 0
+    mutation_threshold = 100
+    schedule_delay = "0s"
+    startup_delay = "100ms"
+  [plugins."io.containerd.grpc.v1.cri"]
+    disable_tcp_service = true
+    stream_server_address = "127.0.0.1"
+    stream_server_port = "0"
+    stream_idle_timeout = "4h0m0s"
+    enable_selinux = false
+    selinux_category_range = 1024
+    sandbox_image = "registry.cn-hangzhou.aliyuncs.com/google_containers/pause:3.5"
+    stats_collect_period = 10
+    # systemd_cgroup = false
+    enable_tls_streaming = false
+    max_container_log_line_size = 16384
+    disable_cgroup = false
+    disable_apparmor = false
+    restrict_oom_score_adj = false
+    max_concurrent_downloads = 3
+    disable_proc_mount = false
+    unset_seccomp_profile = ""
+    tolerate_missing_hugetlb_controller = true
+    disable_hugetlb_controller = true
+    ignore_image_defined_volumes = false
+    [plugins."io.containerd.grpc.v1.cri".containerd]
+      snapshotter = "overlayfs"
+      default_runtime_name = "runc"
+      no_pivot = false
+      disable_snapshot_annotations = false
+      discard_unpacked_layers = false
+      [plugins."io.containerd.grpc.v1.cri".containerd.runtimes]
+        [plugins."io.containerd.grpc.v1.cri".containerd.runtimes.runc]
+          runtime_type = "io.containerd.runc.v2"
+          pod_annotations = []
+          container_annotations = []
+          privileged_without_host_devices = false
+          base_runtime_spec = ""
+          [plugins."io.containerd.grpc.v1.cri".containerd.runtimes.runc.options]
+            # SystemdCgroup enables systemd cgroups.
+            SystemdCgroup = true
+            # BinaryName is the binary name of the runc binary.
+            # BinaryName = "runc"
+            # BinaryName = "crun"
+            # NoPivotRoot disables pivot root when creating a container.
+            # NoPivotRoot = false
+
+            # NoNewKeyring disables new keyring for the container.
+            # NoNewKeyring = false
+
+            # ShimCgroup places the shim in a cgroup.
+            # ShimCgroup = ""
+
+            # IoUid sets the I/O's pipes uid.
+            # IoUid = 0
+
+            # IoGid sets the I/O's pipes gid.
+            # IoGid = 0
+
+            # Root is the runc root directory.
+            Root = ""
+
+            # CriuPath is the criu binary path.
+            # CriuPath = ""
+
+            # CriuImagePath is the criu image path
+            # CriuImagePath = ""
+
+            # CriuWorkPath is the criu work path.
+            # CriuWorkPath = ""
+    [plugins."io.containerd.grpc.v1.cri".cni]
+      bin_dir = "/opt/cni/bin"
+      conf_dir = "/etc/cni/net.d"
+      max_conf_num = 1
+      conf_template = ""
+    [plugins."io.containerd.grpc.v1.cri".registry]
+      config_path = "/etc/cri-containerd/certs.d"
+      [plugins."io.containerd.grpc.v1.cri".registry.headers]
+        # Foo = ["bar"]
+    [plugins."io.containerd.grpc.v1.cri".image_decryption]
+      key_model = ""
+    [plugins."io.containerd.grpc.v1.cri".x509_key_pair_streaming]
+      tls_cert_file = ""
+      tls_key_file = ""
+  [plugins."io.containerd.internal.v1.opt"]
+    path = "/opt/cri-containerd"
+  [plugins."io.containerd.internal.v1.restart"]
+    interval = "10s"
+  [plugins."io.containerd.metadata.v1.bolt"]
+    content_sharing_policy = "shared"
+  [plugins."io.containerd.monitor.v1.cgroups"]
+    no_prometheus = false
+  [plugins."io.containerd.runtime.v2.task"]
+    platforms = ["linux/amd64"]
+  [plugins."io.containerd.service.v1.diff-service"]
+    default = ["walking"]
+  [plugins."io.containerd.snapshotter.v1.devmapper"]
+    root_path = ""
+    pool_name = ""
+    base_image_size = ""
+    async_remove = false
+```
+
+## 安装 **kubelet** **kubeadm** **kubectl** **cri-tools** **kubernetes-cni**
 
 ### Ubuntu/Debian
 
@@ -77,8 +270,14 @@ $ sudo systemctl daemon-reload
 ### master
 
 ```bash
-$ sudo kubeadm init --image-repository registry.cn-hangzhou.aliyuncs.com/google_containers \
+$ systemctl enable cri-containerd
+
+$ systemctl start cri-containerd
+
+$ sudo kubeadm init \
+      --image-repository registry.cn-hangzhou.aliyuncs.com/google_containers \
       --pod-network-cidr 10.244.0.0/16 \
+      --cri-socket /run/cri-containerd/cri-containerd.sock \
       --v 5 \
       --ignore-preflight-errors=all
 ```
@@ -119,13 +318,23 @@ kubeadm join 192.168.199.100:6443 --token cz81zt.orsy9gm9v649e5lf \
 在 **另一主机** 重复 **部署** 小节以前的步骤，安装配置好 kubelet。根据提示，加入到集群。
 
 ```bash
-$ kubeadm join 192.168.199.100:6443 --token cz81zt.orsy9gm9v649e5lf \
-    --discovery-token-ca-cert-hash sha256:5edb316fd0d8ea2792cba15cdf1c899a366f147aa03cba52d4e5c5884ad836fe
+$ systemctl enable cri-containerd
+
+$ systemctl start cri-containerd
+
+$ kubeadm join 192.168.199.100:6443 \
+    --token cz81zt.orsy9gm9v649e5lf \
+    --discovery-token-ca-cert-hash sha256:5edb316fd0d8ea2792cba15cdf1c899a366f147aa03cba52d4e5c5884ad836fe \
+    --cri-socket /run/cri-containerd/cri-containerd.sock
 ```
 
 ## 查看服务
 
-所有服务启动后，查看本地实际运行的 Docker 容器。这些服务大概分为三类：主节点服务、工作节点服务和其它服务。
+所有服务启动后，通过 `crictl` 查看本地实际运行的容器。这些服务大概分为三类：主节点服务、工作节点服务和其它服务。
+
+```bash
+CONTAINER_RUNTIME_ENDPOINT=/run/cri-containerd/cri-containerd.sock crictl ps -a
+```
 
 ### 主节点服务
 
@@ -185,3 +394,4 @@ $ kubectl taint nodes --all node-role.kubernetes.io/master-
 ## 参考文档
 
 * [官方文档](https://kubernetes.io/zh/docs/setup/production-environment/tools/kubeadm/install-kubeadm/)
+* [Container runtimes](https://kubernetes.io/docs/setup/production-environment/container-runtimes/#containerd)

machine/README.md

@@ -1,9 +0,0 @@
-# Docker Machine 项目
-
-![](https://docs.docker.com/machine/img/machine.png)
-
-Docker Machine 是 Docker 官方编排（Orchestration）项目之一，负责在多种平台上快速安装 Docker 环境。
-
-Docker Machine 项目基于 Go 语言实现，目前在 [Github](https://github.com/docker/machine) 上进行维护。
-
-本章将介绍 Docker Machine 的安装及使用。