Add draft of Docker instructions

Changes from review

Syntax fix

Change path

Add mention of JSON too

Change path

Restructure

Update docs/installing-solidity.rst

Co-Authored-By: chriseth <chris@ethereum.org>

Update docs/installing-solidity.rst

Co-Authored-By: chriseth <chris@ethereum.org>

Fixes from review
This commit is contained in:
Chris Ward 2019-05-13 15:33:09 +02:00
parent 01dd9ba2ae
commit bfda0de3ff

View File

@ -60,17 +60,36 @@ Please refer to the solc-js repository for instructions.
Docker Docker
====== ======
We provide up to date docker builds for the compiler. The ``stable`` Docker images of Solidity builds are available using the ``solc`` image from the ``ethereum`` organisation.
repository contains released versions while the ``nightly`` Use the ``stable`` tag for the latest released version, and ``nightly`` for potentially unstable changes in the develop branch.
repository contains potentially unstable changes in the develop branch.
The Docker image runs the compiler executable, so you can pass all compiler arguments to it.
For example, the command below pulls the stable version of the ``solc`` image (if you do not have it already),
and runs it in a new container, passing the ``--help`` argument.
.. code-block:: bash .. code-block:: bash
docker run ethereum/solc:stable --version docker run ethereum/solc:stable --help
Currently, the docker image only contains the compiler executable, You can also specify release build versions in the tag, for example, for the 0.5.4 release.
so you have to do some additional work to link in the source and
output directories. .. code-block:: bash
docker run ethereum/solc:0.5.4 --help
To use the Docker image to compile Solidity files on the host machine mount a
local folder for input and output, and specify the contract to compile. For example.
.. code-block:: bash
docker run -v /local/path:/sources ethereum/solc:stable -o /sources/output --abi --bin /sources/Contract.sol
You can also use the standard JSON interface (which is recommended when using the compiler with tooling).
When using this interface it is not necessary to mount any directories.
.. code-block:: bash
docker run ethereum/solc:stable --standard-json < input.json > output.json
Binary Packages Binary Packages
=============== ===============