diff options
author | Scott Rifenbark <srifenbark@gmail.com> | 2018-08-10 16:10:47 -0700 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2018-08-15 10:28:44 +0100 |
commit | e7a5c98b5fe7d7c25f906f7ffebc0fa93af43337 (patch) | |
tree | 63b033ed664959bceae472575229b6b951bc350b /documentation/dev-manual | |
parent | 46fea20b45832d0585f0462fa27315f654a833ec (diff) | |
download | openembedded-core-contrib-e7a5c98b5fe7d7c25f906f7ffebc0fa93af43337.tar.gz |
dev-manual: Updated the section on CROPS
Final edits to this section. The procedure is more complete now.
(From yocto-docs rev: 5dcc32917c360e32475851b2b580d3d8bc988d7e)
Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/dev-manual')
-rw-r--r-- | documentation/dev-manual/dev-manual-start.xml | 101 |
1 files changed, 68 insertions, 33 deletions
diff --git a/documentation/dev-manual/dev-manual-start.xml b/documentation/dev-manual/dev-manual-start.xml index d6271bec96..a8b48bdf03 100644 --- a/documentation/dev-manual/dev-manual-start.xml +++ b/documentation/dev-manual/dev-manual-start.xml @@ -542,21 +542,26 @@ machine as your Yocto Project build host: <orderedlist> <listitem><para> - <emphasis>Go to the Docker Installation Site:</emphasis> + <emphasis>Determine What Your Build Host Needs:</emphasis> <ulink url='https://www.docker.com/what-docker'>Docker</ulink> is a software container platform that you need to install - on the host development machine. - To start the installation process, see the - <ulink url='https://docs.docker.com/engine/installation/'>Docker Installation</ulink> - site. + on the build host. + Depending on your build host, you might have to install + different software to support Docker containers. + Go to the Docker installation page and read about the + platform requirements in + "<ulink url='https://docs.docker.com/install/#supported-platforms'>Supported Platforms</ulink>" + your build host needs to run containers. </para></listitem> <listitem><para> - <emphasis>Choose Your Docker Edition:</emphasis> - Docker comes in several editions. - For the Yocto Project, the stable community edition - (i.e. "Docker CE Stable") is adequate. - You can learn more about the Docker editions from the - site. + <emphasis>Choose What To Install:</emphasis> + Depending on whether or not your build host meets system + requirements, you need to install "Docker CE Stable" or + the "Docker Toolbox". + Most situations call for Docker CE. + However, if you have a build host that does not meet + requirements (e.g. Pre-Windows 10 or Windows 10 "Home" + version), you must install Docker Toolbox instead. </para></listitem> <listitem><para> <emphasis>Go to the Install Site for Your Platform:</emphasis> @@ -567,38 +572,68 @@ edition, click that link under "Supported Platforms". </para></listitem> <listitem><para> - <emphasis>Understand What You Need:</emphasis> - The install page has pre-requisites your build host must - meet. - Be sure you read through this page and make sure your - machine meets the requirements to run Docker. - If your machine does not meet the requirements, the page - has instructions to handle exceptions. - For example, to run Docker on Windows 10, you must have - the pro version of the operating system. - If you have the home version, you need to install the - <ulink url='https://docs.docker.com/toolbox/overview/#ready-to-get-started'>Docker Toolbox</ulink>. - </para> - - <para>Another example is that a Windows machine needs to - have Microsoft Hyper-V. - If you have a legacy version of the the Microsoft - operating system or for any other reason you do not have - Microsoft Hyper-V, you would have to enter the BIOS and - enable virtualization. - </para></listitem> - <listitem><para> <emphasis>Install the Software:</emphasis> Once you have understood all the pre-requisites, you can download and install the appropriate software. Follow the instructions for your specific machine and - the type of the software you need to install. + the type of the software you need to install: + <itemizedlist> + <listitem><para> + Install + <ulink url='https://docs.docker.com/docker-for-windows/install/#install-docker-for-windows-desktop-app'>Docker CE for Windows</ulink> + for Windows build hosts that meet requirements. + </para></listitem> + <listitem><para> + Install + <ulink url='https://docs.docker.com/docker-for-mac/install/#install-and-run-docker-for-mac'>Docker CE for Macs</ulink> + for Mac build hosts that meet requirements. + </para></listitem> + <listitem><para> + Install + <ulink url='https://docs.docker.com/toolbox/toolbox_install_windows/'>Docker Toolbox for Windows</ulink> + for Windows build hosts that do not meet Docker + requirements. + </para></listitem> + <listitem><para> + Install + <ulink url='https://docs.docker.com/toolbox/toolbox_install_mac/'>Docker Toolbox for MacOS</ulink> + for Mac build hosts that do not meet Docker + requirements. + </para></listitem> + <listitem><para> + Install + <ulink url='https://docs.docker.com/install/linux/docker-ce/centos/'>Docker CE for CentOS</ulink> + for Linux build hosts running the CentOS + distribution. + </para></listitem> + <listitem><para> + Install + <ulink url='https://docs.docker.com/install/linux/docker-ce/debian/'>Docker CE for Debian</ulink> + for Linux build hosts running the Debian + distribution. + </para></listitem> + <listitem><para> + Install + <ulink url='https://docs.docker.com/install/linux/docker-ce/fedora/'>Docker CE for Fedora</ulink> + for Linux build hosts running the Fedora + distribution. + </para></listitem> + <listitem><para> + Install + <ulink url='https://docs.docker.com/install/linux/docker-ce/ubuntu/'>Docker CE for Ubuntu</ulink> + for Linux build hosts running the Ubuntu + distribution. + </para></listitem> + </itemizedlist> </para></listitem> <listitem><para> <emphasis>Optionally Orient Yourself With Docker:</emphasis> If you are unfamiliar with Docker and the container concept, you can learn more here - <ulink url='https://docs.docker.com/get-started/'></ulink>. + </para></listitem> + <listitem><para> + <emphasis>Launch Docker or Docker Toolbox:</emphasis> You should be able to launch Docker or the Docker Toolbox and have a terminal shell on your development host. </para></listitem> |