QuickStart - ewsdocker/alpine-nginx-dev GitHub Wiki
The information on this page has been designed to get the alpine-nginx-dev container built as quickly as possible.
The following scripts will download the selected alpine-nginx-dev image, create a container, setup and populate the directory structures, and create the execution script(s).
The default values will install all directories and contents in the docker host user's home directory.
docker run --rm \
-v ${HOME}/bin:/userbin \
-v ${HOME}/.local:/usrlocal \
-e LMS_BASE="${HOME}/.local" \
-v ${HOME}/.config/docker:/conf \
-v ${HOME}/.config/docker/alpine-nginx-dev-3.10.0:/root \
--name=alpine-nginx-dev \
ewsdocker/alpine-nginx-dev:3.10.0 lms-setup-alpine
Assuming the values shown above, the following table shows the mapping of the docker host directories to the corresponding container volumes:
| Container Volume | Docker Host Directory |
|---|---|
| /userbin | ~/bin |
| /usrlocal | ~/.local |
| /conf | ~/.config/docker |
| /root | ~/.config/docker/alpine-nginx-dev-3.10.0 |
| Container Variable | Suggested value |
|---|---|
| LMS_BASE | set to the same value as /usrlocal (used only for lms-setup) |
| LMSBUILD_VERSION | Required if a re-tagged version is being installed For Example: docker tag ewsdocker/alpine-nginx-dev:3.10.0 ewsdocker/alpine-nginx-dev:latest. Set to the value of the new docker tag e.g. - -e LMSBUILD_VERSION=latest. |
After running the above command script, and using the settings indicated, the docker host directories, mapped as shown in the above tables, will be configured as follows:
- the execution scripts have been copied to ~/bin;
- the associated alpine-nginx-dev-"version" execution script (shown below) will be found in ~/.local/bin, and should be customized with proper local volume names.
The ~/.local/shared/nginx-html folder (in the calling user's home directory) will contain the html documents to serve.
The following docker run command creates and starts a client container. It is automatically installed by the lms-setup-alpine script, above:
docker run -d \
--restart unless-stopped \
-v ${HOME}/Development:/usr/share/nginx/html \
-v ${HOME}/.config/docker/alpine-nginx-dev-3.10.0/workspace:/workspace \
--name=alpine-nginx-dev \
ewsdocker/alpine-nginx-dev:3.10.0
To create and run the container, the following should work from the command-line:
~/.local/bin/alpine-nginx-dev-3.10.0
Exiting the Interactive Shell
The interactive shell may be exited by entering exit at the bash prompt, or running the following command from the docker host running the container
docker stop alpine-nginx-dev-3.10.0
The following messages will be output:
exit
Shut down