mirrors/poky
1
0
Fork 0
mirror of https://git.yoctoproject.org/poky synced 2026-04-02 17:02:21 +02:00
Code Issues Packages Projects Releases Wiki Activity

dev-manua: Added Crops setup section.

Browse Source 
(From yocto-docs rev: e2ba131b98705f98463030dde043d858b500690d)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark
2017-07-21 13:57:25 -07:00
committed by Richard Purdie
parent 38ee8ae876
commit a2dfac68b5
1 changed files with 93 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

98
documentation/dev-manual/dev-manual-start.xml
View File

@@ -96,12 +96,100 @@
</section>
<section id='setting-up-to-use-crops'>
<title>Setting Up to Use CROPS</title>
<title>Setting Up to Use CROss PlatformS (CROPS)</title>
<para role='writernotes'>
Need text.
With CROPS, not sure what the basic package requirements are.
Need to find this out.
<para>
With
<ulink url='https://git.yoctoproject.org/cgit/cgit.cgi/crops/about/'>CROPS</ulink>,
which leverages
<ulink url='https://www.docker.com/'>Docker Containers</ulink>,
you can create a Yocto Project development environment that
is operating system agnostic.
You can set up a container in which you can develop using the
Yocto Project on a Windows, Mac, or Linux machine.
</para>
<para>
Follow these general steps to prepare a Windows, Mac, or Linux
machine as your Yocto Project development host:
<orderedlist>
<listitem><para>
<emphasis>Go to the Docker Installation Site:</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.
</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.
</para></listitem>
<listitem><para>
<emphasis>Go the Install Site for Your Platform:</emphasis>
Click the link for the Docker edition associated with
your development host machine's native software.
For example, if your machine is running Microsoft
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 machine 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.
</para></listitem>
<listitem><para>
<emphasis>Optionally Orient Yourself With Dockers:</emphasis>
If you are unfamiliar with Dockers and the container
concept, you can learn more here -
<ulink url='https://docs.docker.com/get-started/'></ulink>.
You should be able to launch Docker or the Docker Toolbox
and have a terminal shell on your development host.
</para></listitem>
<listitem><para>
<emphasis>Set Up the Containers to Use the Yocto Project:</emphasis>
Go to
<ulink url='https://github.com/crops/docker-win-mac-docs/wiki'></ulink>
and follow the directions for your particular
development host (i.e. Linux, Mac, or Windows).</para>
<para>Once you complete the setup instructions for your
machine, you have the Poky, Extensible SDK, and Toaster
containers available.
You can click those links from the page and learn more
about using each of those containers.
</para></listitem>
</orderedlist>
Once you have a container set up, everything is in place to
develop just as if you were running on a native Linux machine.
</para>
</section>