91 lines
2.0 KiB
ReStructuredText
91 lines
2.0 KiB
ReStructuredText
******
|
|
Docker
|
|
******
|
|
|
|
Docker is a useful tool if you want to experiment with Sming in an isolated environment.
|
|
|
|
If you're unfamiliar with Docker, you can find a good overview in the article,
|
|
`What is a Container? <https://www.docker.com/resources/what-container>`__.
|
|
|
|
This page shows how to create docker containers with all the necessary tools to
|
|
build Sming applications.
|
|
|
|
Install Docker
|
|
==============
|
|
|
|
Visit the official
|
|
`Docker Installation Page <https://docs.docker.com/engine/installation/>`__
|
|
and follow the instructions tailored for your operating system.
|
|
|
|
Install docker-compose
|
|
======================
|
|
|
|
Docker Compose makes dealing with the orchestration processes of Docker
|
|
containers (such as starting up, shutting down, and setting up
|
|
intra-container linking and volumes) really easy.
|
|
|
|
With *docker compose* we can define the entire multi-container application
|
|
in a single file and spin it up using one command.
|
|
|
|
Visit the official
|
|
`Docker Compose Installation Page <https://docs.docker.com/compose/install/>`__
|
|
and follow the instructions tailored for your operating system.
|
|
|
|
Building images
|
|
===============
|
|
|
|
You can find the related Docker scripts in ``$SMING_HOME/Tools/Docker``.
|
|
|
|
To build your own images, do this::
|
|
|
|
cd $SMING_HOME/Tools/Docker/cli
|
|
docker-compose build
|
|
cd $SMING_HOME/Tools/Docker/ide
|
|
docker-compose build
|
|
|
|
|
|
Adjust your settings
|
|
====================
|
|
|
|
::
|
|
|
|
sming-ide:
|
|
|
|
build: .
|
|
|
|
volumes:
|
|
- ../../Sming/:/opt/sming/
|
|
|
|
ports:
|
|
#choose a free port to connect to the web C9 editor
|
|
- "10080:80"
|
|
|
|
devices:
|
|
# uncomment to map your serial USB adaptor
|
|
#- "/dev/ttyUSB0:/dev/ttyUSB0"
|
|
|
|
privileged: true
|
|
|
|
|
|
Start your container
|
|
====================
|
|
|
|
.. code-block:: bash
|
|
|
|
cd /opt/sming/Tools/Docker/ide && docker-compose up -d
|
|
|
|
Open your browser
|
|
=================
|
|
|
|
``http://localhost:10080``
|
|
|
|
.. image:: c9-1.png
|
|
:height: 250px
|
|
|
|
.. code-block:: bash
|
|
|
|
cd /opt/sming/samples/Basic_Blink
|
|
make
|
|
make flash
|
|
|