From: 박종현/동작제어Lab(SR)/Senior Engineer/삼성전자 Date: Mon, 23 Apr 2018 02:30:45 +0000 (+0900) Subject: Add 'Getting Started' guide (#109) X-Git-Tag: nncc_backup~2755 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=fd2fc8ab09d794fc3741b4e4baa0d2036591bae1;p=platform%2Fcore%2Fml%2Fnnfw.git Add 'Getting Started' guide (#109) * Add 'Getting Started' guide This commit adds 'getting_started.md' which will include various guide for newcomers although the current version provides guide on docker-based build only. Signed-off-by: Jonghyun Park * Fix a typo * Fix other typos * Fix a typo (environtment -> environment) --- diff --git a/doc/getting_started.md b/doc/getting_started.md new file mode 100644 index 0000000..f5834ae --- /dev/null +++ b/doc/getting_started.md @@ -0,0 +1,42 @@ +#### How to build _nncc_ with docker + +_nncc_ provides ``Dockerfile`` in order to make it easy to setup development environment. + +One may build ``nncc`` docker image with the following command: +``` +nncc$ cat Dockerfile | docker build -t nncc - +... +``` + +By default, this ``Dockerfile`` uses "archive.ubuntu.com" which may be quite slow. One may use mirror site via ``UBUNTU_MIRROR`` variable. +For example, one may enable the use of ``kr.archive.ubuntu.com`` via the following command +``` +nncc$ cat Dockerfile | docker build --build-arg UBUNTU_MIRROR="kr.archive.ubuntu.com" -t nncc - +... +``` + +One who works behind proxy should provide proxy configuration via the following command: +``` +nncc$ cat Dockerfile | docker build --build-arg HTTP_PROXY= --build-arg HTTPS_PROXY= -t nncc - +... +``` +One may use simplified command if ``HTTP_PROXY`` and ``HTTPS_PROXY`` environment variables are already set: +``` +nncc$ export +... +declare -x HTTP_PROXY=... +declare -x HTTPS_PROXY=... +... +nncc$ cat Dockerfile | docker build --build-arg HTTP_PROXY --build-arg HTTPS_PROXY -t nncc - +... +``` + +Note that these configurations are orthogonal to each other. One may freely combine these options as follows: +``` +nncc$ cat Dockerfile | docker build --build-arg HTTP_PROXY --build-arg HTTPS_PROXY --build-arg UBUNTU_MIRROR="kr.archive.ubuntu.com" -t nncc - +``` + +One may easily build _nncc_ with the following command once ``nncc`` docker image is built. +``` +nncc$ ./nncc docker-build +```