Joomla says you aren't logged in
development:docker
Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
development:docker [2016/05/11 18:46] PhracturedBlue [Building the Deviation Manual] |
development:docker [2017/04/10 01:08] (current) mwm Add docker toolbox reference |
||
---|---|---|---|
Line 11: | Line 11: | ||
If you are using a Linux PC, you need: | If you are using a Linux PC, you need: | ||
* A 64bit variant of Linux | * A 64bit variant of Linux | ||
- | I do not believe there are any special requirements for Mac users. | + | If you are using a Mac, you need: |
+ | * A 2010 or newer Mac with virtualization support. | ||
+ | * MacOS 10.11 or later. | ||
+ | |||
+ | The [[https://www.docker.com/products/docker-toolbox|Docker Toolbox]] legacy product may work on Windows or Mac that don't meet those requirements. | ||
Next you must install Docker. Instructions for all operating systems can be found on the Docker site [[https://docs.docker.com/engine/installation/ | here]] | Next you must install Docker. Instructions for all operating systems can be found on the Docker site [[https://docs.docker.com/engine/installation/ | here]] | ||
Line 48: | Line 52: | ||
To get started run: ''docker start -i deviation_build'' | To get started run: ''docker start -i deviation_build'' | ||
- | Once your started the Docker container, it will update to the latest version of the build script, and then will try to checkout deviation if you did not provide a GIT repo. Next a menu will be shown which allows you to choose what you would like to build. | + | Once you've started the Docker container, it will update to the latest version of the build script, and then will try to checkout deviation if you did not provide a GIT repo. Next a menu will be shown which allows you to choose what you would like to build. |
{{:development:docker_screen.png?600|}} | {{:development:docker_screen.png?600|}} | ||
- | Initially, 'default' an 'emu_default' are selected. This will build all zip files that are normally part of a nightly build. | + | Initially, 'default' and 'emu_default' are selected. This will build all zip files that are normally part of a nightly build. |
The 'Shell' command will provide an interactive Linux shell inside the image. This is likely only useful for developers or users familiar with Linux | The 'Shell' command will provide an interactive Linux shell inside the image. This is likely only useful for developers or users familiar with Linux | ||
Line 73: | Line 77: | ||
==== Building the Deviation Manual ==== | ==== Building the Deviation Manual ==== | ||
The docker image is also capable of building the deviation manual. | The docker image is also capable of building the deviation manual. | ||
- | After creating the Docker container, start docekr and enter the Shell. | + | After creating the Docker container, start docker and enter the Shell. |
- | run: ''sudo /root/build.py --manual-prereq'' to install the necessary build environment | + | Run: ''%%sudo /root/build.py --manual-prereq%%'' to install the necessary build environment |
Next (still from the docker shell), run: | Next (still from the docker shell), run: | ||
''cd /git; git clone https://github.com/DeviationTX/deviation-manual'' | ''cd /git; git clone https://github.com/DeviationTX/deviation-manual'' | ||
You can now build the manual using make or dmake. | You can now build the manual using make or dmake. | ||
- | For instance, from within the docker shell and run: | + | |
+ | For instance, from within the docker shell run: | ||
''cd deviation-manual; make TARGET=devo10 html pdf'' | ''cd deviation-manual; make TARGET=devo10 html pdf'' | ||
development/docker.1463017609.txt.gz (271930 views) · Last modified: 2016/05/11 18:46 by PhracturedBlue