Lines Matching full:docker

6 Other host platforms such as Windows and Mac **should** work (with Docker installed), but have not …
8 …d Tool through the use of Docker. However, the scripts may be [executed directly on your machine](…
10 …e Docker installed** and want to quickly build the Arm NN Dockerfile with some default build argum…
14 * [Install Docker](#install-docker)
17 * [Docker Build Arguments Reference](#docker-build-arguments-reference)
20 * [Docker Build Steps](#docker-build-steps)
21 * [Build Arm NN Without Docker](#build-arm-nn-without-docker)
24   * [Additional Docker Build Arguments](#additional-docker-build-arguments)
25   * [Inspect the contents of the Docker Image](#inspect-the-contents-of-the-docker-image)
35 6. **```docker-copy-to-host```:** helpful script to copy contents of a Docker Image to the host mac…
37 …t document which outlines the instructions for building a **Docker Image**. Running ```docker buil…
38 on the Arm NN Dockerfile will result in a Docker Image that contains:
44 All scripts except ```docker-copy-to-host.sh``` are used during the ```docker build``` process.
46 The ```docker-copy-to-host.sh``` script creates a temporary [**Docker Container**](https://www.dock…
47 Docker Image. A Docker Container is a **runtime** version of a Docker Image. It can be interacted w…
48 terminal, like a lightweight virtual machine (VM). The ```docker-copy-to-host.sh``` script is desig…
49 machine after ```docker build``` to copy the Arm NN build to the host.
51 …the operation of the Arm NN **Dockerfile** and the contents of the resulting **Docker Image** after
52 running ```docker build```. During ```docker build```, the provided **```SETUP_ARGS```** determine …
53 dependencies to download and build. The **```BUILD_ARGS```** Docker argument determines which compo…
55 The resulting Docker Image contains the Arm NN build (along with everything required to build it) i…
61 Docker Image during the ```docker build``` process.
69 **Benefits of using Docker:**
70 1. Run one ```docker build``` command instead of executing multiple scripts, saving developer time
71 2. Can easily manage multiple different build configurations at once, each in their own Docker Image
72 3. System packages are installed in the Docker Image only, isolated from the host machine
74 5. Allows Arm NN to be built on a wide range of hosts, as long as they support Docker
76 **Disadvantages of using Docker:**
77 1. Requires the developer to install Docker on their host machine
78 2. Requires the developer to get familiar with Docker (this guide should help)
80 base OS in the Docker Image. This is due to the fact that Docker Containers share the Linux Kernel …
86 …de will not provide the system requirements for installing Docker - please refer to the Docker doc…
88 The built Docker Image has disk requirements of **less than 6GB**, depending on the Arm NN componen…
90 beyond 6GB. The ```docker images``` command shows the disk usage of each Docker Image. To view tota…
91 Docker Images and Docker Containers, use the command ```docker system df```.
93 This Dockerfile was built on a **Ubuntu 18.04 host machine with Docker version 20.10.14**. We recom…
94 with at least Ubuntu 18.04 and a similar Docker version, if possible. Other Linux distros such as *…
95 long as the Docker version is similar to **20.10.14**.
100 To view the system packages that are installed during ```docker build```, please refer to the ```in…
104 ## Install Docker
106 Whilst other platforms have not been tested, Docker should be able to build the Arm NN Dockerfile o…
107 On **Linux**, we recommend using **Docker Engine** which is used through the command-line interface…
108 For **Windows and Mac** users, **Docker Desktop** is available which allows the use of the CLI plus…
109 This guide will **only** provide steps on using Docker through the use of the CLI and not Docker De…
112 For Ubuntu users, we recommend installing **Docker Engine** with the following steps from the Docke…
113 1. [Uninstall any old versions of Docker](https://docs.docker.com/engine/install/ubuntu/#uninstall-…
114 2. [Install using the repository](https://docs.docker.com/engine/install/ubuntu/#install-using-the-…
115 …Docker Unix Group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-no…
117 …lling Docker Engine on other Linux distributions can be found by clicking on your distro under the…
120 …ockerfile on Windows or Mac. However, it's likely that it will work if your system supports Docker.
121 For **Windows**, use the Docker Desktop download link on [this page](https://docs.docker.com/deskto…
122 For **Mac** users, please use the Docker Desktop download link on [this page](https://docs.docker.c…
123 **Note:** we unfortunately cannot provide support for the installation of Docker and/or the use of …
127 ## Docker Build Arguments Reference
128 The following describes the ```docker build``` arguments that can be used to customize the Arm NN b…
129 Docker build arguments such as ```SETUP_ARGS``` and ```BUILD_ARGS``` are provided in the ```docker …
133 For ease of use (but longer initial docker build), use ```--all``` to have all Arm NN dependencies …
134 …docker builds with the same ```SETUP_ARGS``` will skip the setup process (using [caching](https://…
205 ## Docker Build Steps
219 …docker build```, which downloads and builds Arm NN and its dependencies. This process is isolated …
227 docker build \
231 --file docker/Dockerfile .
236 …l of its dependencies are now built within a Docker Image. Built Docker images can be listed with …
238 docker images
246 A tarball archive of the Arm NN build is located inside the Docker home directory (```/home/arm-use…
248 The ```docker-copy-to-host.sh``` script will copy a file from the Docker Image (in arm-user's home …
250 The filename is a relative path from the home directory created inside the Docker Image (```/home/a…
252 ./scripts/docker-copy-to-host.sh armnn:aarch64 armnn_aarch64_build.tar.gz
279 …Docker builds may result in an accumulation of unwanted, dangling images. **To remove dangling ima…
283 ## Build Arm NN without Docker
285 If you'd like to build locally on a Ubuntu host machine without Docker, execute the build-tool scri…
307 By default, the docker build process (specifically, during ```build-armnn.sh```) will download the …
309 When providing custom repositories, the following ```docker build``` argument must be provided ```-…
310 This will trigger Docker to copy the custom repos into the Docker Image during build. The ACL repo …
315 If you repeat the ```docker build``` process multiple times (e.g. with different ```BUILD_ARGS```),…
332 # Example docker build with BUILD_TYPE=dev, ran inside the build-tool directory
333 docker build \
338 --file docker/Dockerfile .
343 ### Additional Docker Build Arguments
346 The default base Image used during ```docker build``` is ```ubuntu:18.04```. Building Arm NN with t…
347 To use a different Ubuntu base Image, provide ```UBUNTU_VERSION``` during ```docker build``` e.g. `…
354 …re additional ```SETUP_ARGS``` and ```BUILD_ARGS``` that can be provided to the ```docker build```.
362 By default, the Docker Image creates a user called ```arm-user``` with user/group ID of 1000. This …
367 ### Inspect the contents of the Docker Image
368 To inspect the full contents of the Docker Image, the Image must be run as a **Docker Container**.
371 The following shows how to run a container with an interactive terminal based on a specified Docker…
374 docker run --interactive --tty armnn:aarch64
382 …rectory can be run as you wish, changes will persist within the container but not the Docker Image.
383 To exit the docker container, run ```CTRL-D```. A list of Docker containers can be obtained with th…
386 docker ps --all
395 docker start 4da7c575a95a # restart container in background
396 docker attach 4da7c575a95a # re-attach to terminal
399 docker stop 4da7c575a95a
401 To save space over time, stopped Docker containers can be deleted with the following command:<br>
402 ```docker container prune```.
407 **Bind Mounts** may be used to mount directories from the host machine to inside a Docker container…
409 … inside the container. Note that bind mounts are a feature that apply to runtime versions of Docker
410 images i.e. Docker Containers (```docker run```, not ```docker build```).
411 Please refer to the [Docker documentation for more information about bind mounts](https://docs.dock…