Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/iconoeugen/docker-fedora-dev
https://github.com/iconoeugen/docker-fedora-dev
development development-environment development-tools docker docker-container environment fedora
Last synced: 16 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/iconoeugen/docker-fedora-dev
- Owner: iconoeugen
- License: mit
- Created: 2016-08-04T14:54:30.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2019-09-10T09:32:58.000Z (over 5 years ago)
- Last Synced: 2024-11-30T17:26:07.518Z (3 months ago)
- Topics: development, development-environment, development-tools, docker, docker-container, environment, fedora
- Language: Shell
- Size: 21.5 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Support: support/dev
Awesome Lists containing this project
README
# docker-fedora-dev
Development environment based on Fedora in Docker container.
## Requirements
* Docker 1.9+
* An X11 socker (if GUI is used)
## Quickstart
### Making data persist between sessions
The data is usually persisted in the home directory of an user, so if you want to persist the data for a later session you have to share it with your host.
The home directory `/home/default` inside the container is mapped to the directory `.home` that is stored in the working directory.
For example for the working directory `~/work` that caches the container home directory in `~/work/.home`:
``` bash
mkdir -p ~/work
cd ~/work
mkdir -p .home
```
the docker run command will look like:
``` bash
docker run -it --rm --net=host \
-e USER=$(id -u -n) -e GROUP=$(id -g -n) -u "$(id -u):$(id -g)" \
-v $PWD:/workspace \
-v $PWD/.home:/home/default \
-v ~/.ssh:/home/default/.ssh \
-e DISPLAY=${DISPLAY} -v ~/.Xauthority:/home/default/.Xauthority \
-v /dev/shm:/dev/shm \
iconoeugen/fedora-dev /bin/bash
```
### bash-it
The development environment includes the [bash-it](https://github.com/Bash-it/bash-it/) framework. To configure the appearance you can provide
the following environment to the docker container:
- **BASH_IT_ENABLE**: Set this to `false` to disable or to `true` to enable the bash-it framework (Defaults: **true**)
- **BASH_IT**: Path to the bash it configuration (Defauts: **/opt/bash-it**)
- **BASH_IT_THEME**: Lock and Load a custom theme file (Defaults: **standard**)
- **SCM_CHECK**: Set this to `false` to turn off or `true` the version control status checking within the prompt for all themes (Defaults: **true**)
- **DEBUG**: Start entrypoint script using `set -x` flag
## Support tools
For an easier use of docker images for developemnt environment, you can just add the [dev](support/dev) script to your execution path (environment `PATH`) and start using it.
```
$ dev -h
Development environment in docker containers
Synopsys:
dev [-h] [-u ] [-d ] [-e ] []
Arguments:
: Action to be executed:
run : run a new container instance.
exec : execute in running instance.
ps : process status for running instances.
: Docker image name or id.
Options:
-d : Working directory that will be mounted in the development container under '/workspace'.
-e [=] : environments parameters which should be passed to the docker instance.
-u : Username.
-p : Publish a container’s port(s) to the host passed on to docker command.
-P : Automatically map any network port passed on to docker command.
-h : This help message.
ENVIRONMENT:
DEV_DOCKER_OPTS: Options that are passed directly to the docker 'run' command. i.e. DEV_DOCKER_OPT='-e BASH_IT_THEME=modern -v /tmp:/tmp'\n"
```
### Usage example
Start a container and mount the current working directory:
```
$ id
uid=2376(dev) gid=2376(dev) groups=2376(dev),10(wheel),977(dockerroot),2377(docker)
$ dev run iconoeugen/fedora-dev
Activating nss_wrapper for dev:dev
bash-4.3$ id
uid=2376(dev) gid=2376(dev) groups=2376(dev)
bash-4.3$ pwd
/workspace
bash-4.3$ ls -l
total 20
-rw-r--r--. 1 dev dev 556 Aug 4 14:12 Dockerfile
-rw-rw-r--. 1 dev dev 187 Aug 4 07:22 Makefile
-rw-r--r--. 1 dev dev 1624 Aug 4 18:37 README.md
-rwxr--r--. 1 dev dev 591 Aug 4 14:11 entrypoint.sh
-rw-r--r--. 1 dev dev 185 Aug 4 14:03 nss_wrapper.sh
drwxrwxr-x. 2 dev dev 16 Aug 4 18:33 support
bash-4.3$
```
Execute command in running container:
```
$ pwd
/home/dev
$ dev exec iconoeugen/fedora-dev
No container found for image 'iconoeugen/fedora-dev' running in working directory '/home/dev'.
$ dev -d /home/dev/github/iconoeugen/docker-fedora-dev exec iconoeugen/fedora-dev
bash-4.3$ exit
$ cd /home/dev/github/iconoeugen/docker-fedora-dev
$ dev exec iconoeugen/fedora-dev
bash-4.3$
```
List containers:
```
$ pwd
/home/dev
$ dev ps iconoeugen/fedora-dev
No container found for image 'iconoeugen/fedora-dev' running in working directory '/home/vlad'.
$ dev -d /home/dev/github/iconoeugen/docker-fedora-dev ps iconoeugen/fedora-dev
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
969c9d041e31 iconoeugen/fedora-dev "/entrypoint.sh /bin/" 7 minutes ago Up 7 minutes evil_bohr
$ cd /home/dev/github/iconoeugen/docker-fedora-dev
$ dev ps iconoeugen/fedora-dev
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
969c9d041e31 iconoeugen/fedora-dev "/entrypoint.sh /bin/" 8 minutes ago Up 8 minutes evil_bohr
```
Environment configuration:
```
$ unset DEV_DOCKER_OPTIONS
$ dev run iconoeugen/fedora-dev
Activating nss_wrapper for dev:dev
[dev@localhost workspace]$ exit
$ export DEV_DOCKER_OPTIONS='-e BASH_IT_THEME=modern'
$ dev run iconoeugen/fedora-dev
Activating nss_wrapper for dev:dev
┌─[±][master ?:2 ✗][workspace][]
└─▪ exit
```