From 2df5dc7c2ec18fe9d96ebcaab6de7520139f0ac0 Mon Sep 17 00:00:00 2001 From: lujun Date: Fri, 7 Dec 2018 21:58:57 +0800 Subject: [PATCH] Update docker-image instroduce, test=develop (#459) --- .../install/compile/compile_CentOS.md | 16 ++++++++-------- .../install/compile/compile_MacOS.md | 17 +++++++---------- .../install/compile/compile_Ubuntu.md | 14 +++++++------- .../beginners_guide/install/install_CentOS.md | 8 +++----- .../beginners_guide/install/install_MacOS.md | 9 ++++----- .../beginners_guide/install/install_Ubuntu.md | 6 +++--- 6 files changed, 32 insertions(+), 38 deletions(-) diff --git a/doc/fluid/beginners_guide/install/compile/compile_CentOS.md b/doc/fluid/beginners_guide/install/compile/compile_CentOS.md index e9eed3e8e..b7da31bbe 100644 --- a/doc/fluid/beginners_guide/install/compile/compile_CentOS.md +++ b/doc/fluid/beginners_guide/install/compile/compile_CentOS.md @@ -16,7 +16,7 @@ ## 选择如何编译 我们在CentOS的系统下提供2种编译方式： -* Docker源码编译（不支持CentOS 6 / 7的GPU版本） +* Docker源码编译（不支持CentOS 6 / 7的GPU版本）(该镜像已经包含python2.7、python3.6、python3.7环境) * 直接本机源码编译（不支持CentOS 6的全部版本以及CentOS 7的GPU版本） 我们更加推荐**使用Docker进行编译**，因为我们在把工具和配置都安装在一个 Docker image 里。这样如果遇到问题，其他人可以复现问题以便帮助。另外，对于习惯使用Windows和MacOS的开发者来说，使用Docker就不用配置交叉编译环境了。需要强调的是：Docker 不会虚拟任何硬件，Docker container 里运行的编译工具实际上都是在本机的 CPU 和操作系统上直接运行的，性能和把编译工具安装在本机运行一样。 @@ -60,10 +60,10 @@ `mkdir -p /paddle/build && cd /paddle/build` -7. 使用以下命令安装相关依赖： +7. 使用以下命令安装相关依赖：（For Python3：请选择您希望用的python版本对应的pip，如pip3.5、pip3.6） For Python2: pip install protobuf==3.1.0 - For Python3: pip3 install protobuf==3.1.0 + For Python3: pip3.5 install protobuf==3.1.0 > 安装protobuf 3.1.0。 @@ -80,7 +80,7 @@ `cmake .. -DWITH_FLUID_ONLY=ON -DWITH_GPU=OFF -DWITH_TESTING=OFF -DCMAKE_BUILD_TYPE=Release` - >> 我们目前不支持CentOS下GPU版本PaddlePaddle的编译 + > 我们目前不支持CentOS下GPU版本PaddlePaddle的编译 9. 执行编译： @@ -90,10 +90,10 @@ 10. 编译成功后进入`/paddle/build/python/dist`目录下找到生成的`.whl`包： `cd /paddle/build/python/dist` -11. 在当前机器或目标机器安装编译好的`.whl`包： +11. 在当前机器或目标机器安装编译好的`.whl`包：（For Python3：请选择您希望用的python版本对应的pip，如pip3.5、pip3.6） For Python2: pip install （whl包的名字） - For Python3: pip3 install （whl包的名字） + For Python3: pip3.5 install （whl包的名字） 至此您已经成功使用Docker安装PaddlePaddle，您只需要进入Docker容器后运行PaddlePaddle即可，更多Docker使用请参见[Docker官方文档](https://docs.docker.com)。 @@ -118,7 +118,7 @@ 1. 检查您的计算机和操作系统是否符合我们支持的编译标准： `uname -m && cat /etc/*release` -2. 更新`yum`的源： `yum update`, 并添加必要的yum源：`yum install -y epel-release` +2. 更新`yum`的源： `yum update`, 并添加必要的yum源：`yum install -y epel-release`, 并提前安装openCV 3. 安装必要的工具`bzip2`以及`make`： `yum install -y bzip2` ， `yum install -y make` @@ -212,6 +212,6 @@

## ***如何卸载*** -请使用以下命令卸载PaddlePaddle（使用docker安装PaddlePaddle的用户请进入包含PaddlePaddle的容器中使用以下命令）： +请使用以下命令卸载PaddlePaddle（使用docker安装PaddlePaddle的用户请进入包含PaddlePaddle的容器中使用以下命令,请使用对应版本pip）： * ***CPU版本的PaddlePaddle***: `pip uninstall paddlepaddle` 或 `pip3 uninstall paddlepaddle` diff --git a/doc/fluid/beginners_guide/install/compile/compile_MacOS.md b/doc/fluid/beginners_guide/install/compile/compile_MacOS.md index 28ee06180..4d3d422d4 100644 --- a/doc/fluid/beginners_guide/install/compile/compile_MacOS.md +++ b/doc/fluid/beginners_guide/install/compile/compile_MacOS.md @@ -17,13 +17,12 @@ 在MacOS 10.12/10.13/10.14 的系统下我们提供2种编译方式： -* Docker源码编译 +* Docker源码编译 (该镜像已经包含python2.7、python3.6、python3.7环境) * 直接本机源码编译 - 我们更加推荐**使用Docker进行编译**，因为我们在把工具和配置都安装在一个 Docker image 里。这样如果遇到问题，其他人可以复现问题以便帮助。另外，对于习惯使用Windows和MacOS的开发者来说，使用Docker就不用配置交叉编译环境了。需要强调的是：Docker 不会虚拟任何硬件，Docker container 里运行的编译工具实际上都是在本机的 CPU 和操作系统上直接运行的，性能和把编译工具安装在本机运行一样。 同样对于那些出于各种原因不能够安装Docker的用户我们也提供了可以从**本机直接源码编译**的方法，但是由于在本机上的情况更加复杂，因此我们只支持特定的系统。 @@ -31,8 +30,6 @@ - - @@ -71,10 +68,10 @@ `mkdir -p /paddle/build && cd /paddle/build` -8. 使用以下命令安装相关依赖： +8. 使用以下命令安装相关依赖：（For Python3：请选择您希望用的python版本对应的pip，如pip3.5、pip3.6） For Python2: pip install protobuf==3.1.0 - For Python3: pip3 install protobuf==3.1.0 + For Python3: pip3.5 install protobuf==3.1.0 > 安装protobuf 3.1.0。 @@ -105,10 +102,10 @@ 11. 编译成功后进入`/paddle/build/python/dist`目录下找到生成的`.whl`包： `cd /paddle/build/python/dist` -12. 在当前机器或目标机器安装编译好的`.whl`包： +12. 在当前机器或目标机器安装编译好的`.whl`包：（For Python3：请选择您希望用的python版本对应的pip，如pip3.5、pip3.6） For Python2: pip install （whl包的名字） - For Python3: pip3 install （whl包的名字) + For Python3: pip3.5 install （whl包的名字) 至此您已经成功使用Docker安装PaddlePaddle，您只需要进入Docker容器后运行PaddlePaddle即可，更多Docker使用请参见[Docker官方文档](https://docs.docker.com)。 @@ -124,7 +121,7 @@ **请严格按照以下指令顺序执行** -1. 检查您的计算机和操作系统是否符合我们支持的编译标准： `uname -m` 并且在`关于本机`中查看系统版本。 +1. 检查您的计算机和操作系统是否符合我们支持的编译标准： `uname -m` 并且在`关于本机`中查看系统版本。并提前安装openCV。 2. 安装python以及pip： @@ -223,6 +220,6 @@

## ***如何卸载*** -请使用以下命令卸载PaddlePaddle（使用docker安装PaddlePaddle的用户请进入包含PaddlePaddle的容器中使用以下命令）： +请使用以下命令卸载PaddlePaddle（使用docker安装PaddlePaddle的用户请进入包含PaddlePaddle的容器中使用以下命令，请使用相应版本的pip）： * ***CPU版本的PaddlePaddle***: `pip uninstall paddlepaddle` 或 `pip3 uninstall paddlepaddle` diff --git a/doc/fluid/beginners_guide/install/compile/compile_Ubuntu.md b/doc/fluid/beginners_guide/install/compile/compile_Ubuntu.md index c72d60341..8cc80b40c 100644 --- a/doc/fluid/beginners_guide/install/compile/compile_Ubuntu.md +++ b/doc/fluid/beginners_guide/install/compile/compile_Ubuntu.md @@ -18,7 +18,7 @@ ## 选择如何编译 在Ubuntu的系统下我们提供2种编译方式： -* Docker源码编译 +* Docker源码编译 (该镜像已经包含python2.7、python3.6、python3.7环境) * 直接本机源码编译（不支持ubuntu18.04下GPU版本） 我们更加推荐**使用Docker进行编译**，因为我们在把工具和配置都安装在一个 Docker image 里。这样如果遇到问题，其他人可以复现问题以便帮助。另外，对于习惯使用Windows和MacOS的开发者来说，使用Docker就不用配置交叉编译环境了。有人用虚拟机来类比 Docker。需要强调的是：Docker 不会虚拟任何硬件，Docker container 里运行的编译工具实际上都是在本机的 CPU 和操作系统上直接运行的，性能和把编译工具安装在本机运行一样。 @@ -62,10 +62,10 @@ `mkdir -p /paddle/build && cd /paddle/build` -7. 使用以下命令安装相关依赖： +7. 使用以下命令安装相关依赖：（For Python3：请选择您希望用的python版本对应的pip，如pip3.5、pip3.6） For Python2: pip install protobuf==3.1.0 - For Python3: pip3 install protobuf==3.1.0 + For Python3: pip3.5 install protobuf==3.1.0 > 安装protobuf 3.1.0。 @@ -95,10 +95,10 @@ 10. 编译成功后进入`/paddle/build/python/dist`目录下找到生成的`.whl`包： `cd /paddle/build/python/dist` -11. 在当前机器或目标机器安装编译好的`.whl`包： +11. 在当前机器或目标机器安装编译好的`.whl`包：（For Python3：请选择您希望用的python版本对应的pip，如pip3.5、pip3.6） For Python2: pip install （whl包的名字） - For Python3: pip3 install （whl包的名字） + For Python3: pip3.5 install （whl包的名字） 至此您已经成功使用Docker安装PaddlePaddle，您只需要进入Docker容器后运行PaddlePaddle即可，更多Docker使用请参见[Docker官方文档](https://docs.docker.com)。 @@ -116,7 +116,7 @@ 1. 检查您的计算机和操作系统是否符合我们支持的编译标准： `uname -m && cat /etc/*release` -2. 更新`apt`的源： `apt update` +2. 更新`apt`的源： `apt update`, 并提前安装openCV 3. 我们支持使用virtualenv进行编译安装，首先请使用以下命令创建一个名为`paddle-venv`的虚环境： @@ -205,7 +205,7 @@

## ***如何卸载*** -请使用以下命令卸载PaddlePaddle（使用docker安装PaddlePaddle的用户请进入包含PaddlePaddle的容器中使用以下命令）： +请使用以下命令卸载PaddlePaddle（使用docker安装PaddlePaddle的用户请进入包含PaddlePaddle的容器中使用以下命令，请使用对应版本的pip）： * ***CPU版本的PaddlePaddle***: `pip uninstall paddlepaddle` 或 `pip3 uninstall paddlepaddle` diff --git a/doc/fluid/beginners_guide/install/install_CentOS.md b/doc/fluid/beginners_guide/install/install_CentOS.md index 4eecd3a0b..c3a896885 100644 --- a/doc/fluid/beginners_guide/install/install_CentOS.md +++ b/doc/fluid/beginners_guide/install/install_CentOS.md @@ -24,9 +24,9 @@ 在CentOS的系统下我们提供4种安装方式： * pip安装 -* Docker安装（不支持GPU版本） +* Docker安装（不支持GPU版本）(镜像中python的版本为2.7) * 源码编译安装（不支持CentOS 6的所有版本以及CentOS 7的GPU版本） -* Docker源码编译安装（不支持GPU版本） +* Docker源码编译安装（不支持GPU版本）(镜像中的python版本为2.7，3.5，3.6，3.7) @@ -122,7 +122,6 @@ Python3.5、3.6、3.7: (由于在CentOS下安装Python3的方法较为复杂， - 当您已经**正确安装Docker**后你就可以开始**使用Docker安装PaddlePaddle** 1. 使用以下指令拉取我们为您预安装好PaddlePaddle的镜像： @@ -160,14 +159,13 @@ Python3.5、3.6、3.7: (由于在CentOS下安装Python3的方法较为复杂， > 注：PaddlePaddle Docker镜像为了减小体积，默认没有安装`vim`，您可以在容器中执行 `apt-get install -y vim` 安装后，在容器中编辑代码。 -

## ***验证安装*** 安装完成后您可以使用：`python` 或 `python3` 进入Python解释器，然后使用`import paddle.fluid` 验证是否安装成功。

## ***如何卸载*** -请使用以下命令卸载PaddlePaddle（使用docker安装PaddlePaddle的用户请进入包含PaddlePaddle的容器中使用以下命令）： +请使用以下命令卸载PaddlePaddle（使用docker安装PaddlePaddle的用户请进入包含PaddlePaddle的容器中使用以下命令，请使用相应版本的pip）： * ***CPU版本的PaddlePaddle***: `pip uninstall paddlepaddle` 或 `pip3 uninstall paddlepaddle` diff --git a/doc/fluid/beginners_guide/install/install_MacOS.md b/doc/fluid/beginners_guide/install/install_MacOS.md index 45c5acaf6..05dfdb667 100644 --- a/doc/fluid/beginners_guide/install/install_MacOS.md +++ b/doc/fluid/beginners_guide/install/install_MacOS.md @@ -18,8 +18,8 @@ 在MacOS的系统下我们提供3种安装方式： * pip安装（不支持GPU版本）(python3下不支持分布式） -* Docker安装（不支持GPU版本） -* Docker源码编译安装（不支持GPU版本） +* Docker安装（不支持GPU版本）(镜像中python的版本为2.7) +* Docker源码编译安装（不支持GPU版本）(镜像中的python版本为2.7，3.5，3.6，3.7) **使用pip安装**（最便捷的安装方式），我们为您提供pip安装方法，但它更依赖您的本机环境，可能会出现和您本机环境相关的一些问题。 @@ -63,8 +63,6 @@ - - 现在您已经完成通过`pip install` 来安装的PaddlePaddle的过程。 @@ -114,6 +112,7 @@ 至此您已经成功使用Docker安装PaddlePaddle，您只需要进入Docker容器后运行PaddlePaddle即可，更多Docker使用请参见[Docker官方文档](https://docs.docker.com)。 > 注：PaddlePaddle Docker镜像为了减小体积，默认没有安装`vim`，您可以在容器中执行 `apt-get install -y vim` 安装后，在容器中编辑代码。 + @@ -124,7 +123,7 @@

## ***如何卸载*** -请使用以下命令卸载PaddlePaddle（使用docker安装PaddlePaddle的用户请进入包含PaddlePaddle的容器中使用以下命令）： +请使用以下命令卸载PaddlePaddle（使用docker安装PaddlePaddle的用户请进入包含PaddlePaddle的容器中使用以下命令，请使用相应版本的pip）： * ***CPU版本的PaddlePaddle***: `pip uninstall paddlepaddle` 或 `pip3 uninstall paddlepaddle` diff --git a/doc/fluid/beginners_guide/install/install_Ubuntu.md b/doc/fluid/beginners_guide/install/install_Ubuntu.md index 80867aef3..c3953e7a3 100644 --- a/doc/fluid/beginners_guide/install/install_Ubuntu.md +++ b/doc/fluid/beginners_guide/install/install_Ubuntu.md @@ -24,9 +24,9 @@ 在Ubuntu的系统下我们提供4种安装方式： * pip安装 -* Docker安装 +* Docker安装(镜像中python的版本为2.7) * 源码编译安装 -* Docker源码编译安装 +* Docker源码编译安装(镜像中的python版本为2.7，3.5，3.6，3.7) @@ -173,7 +173,7 @@ Python3.6、Python3.7：（由于版本相对较新，在不同Ubuntu版本上

## ***如何卸载*** -请使用以下命令卸载PaddlePaddle（使用docker安装PaddlePaddle的用户请进入包含PaddlePaddle的容器中使用以下命令）： +请使用以下命令卸载PaddlePaddle（使用docker安装PaddlePaddle的用户请进入包含PaddlePaddle的容器中使用以下命令，请使用相应版本的pip）： * ***CPU版本的PaddlePaddle***: `pip uninstall paddlepaddle` 或 `pip3 uninstall paddlepaddle` -- GitLab