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>
This commit is contained in:
Scott Rifenbark
2018-08-10 16:10:47 -07:00
committed by Richard Purdie
parent 46fea20b45
commit e7a5c98b5f

View File

@@ -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>
@@ -566,39 +571,69 @@
Windows Version 10 and you want the Docker CE Stable
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>