https://github.com/uglow/backstopjs
BackstopJS Docker image
https://github.com/uglow/backstopjs
Last synced: over 1 year ago
JSON representation
BackstopJS Docker image
- Host: GitHub
- URL: https://github.com/uglow/backstopjs
- Owner: uglow
- Created: 2017-05-30T10:16:08.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2017-06-05T03:33:56.000Z (about 9 years ago)
- Last Synced: 2025-02-10T15:50:36.139Z (over 1 year ago)
- Language: Shell
- Size: 4.88 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Docker for Visual Regression Testing (VRT)
We are using a Docker image to perform visual regression testing, so that we get consistent results regardless of
the host-OS that is running the test.
## Installing Docker for Mac
Follow the [instructions](https://docs.docker.com/docker-for-mac/install/#download-docker-for-mac) to install Docker for Mac
## Install the VRT image
```
docker pull uglow/backstopjs
```
**Make sure you allocate *enough memory* (more than 2GB) to Docker.** You can change this in your Docker Preferences (in OSX).
## Using the image
See [CONTRIBUTING.md](../../CONTRIBUTING.md).
The base commands in `package.json` are listed below:
```
# On OSX:
docker run --rm -v $PWD:/src/ -it --add-host dockerhost:`ipconfig getifaddr en0` uglow/backstopjs test --config=config/testVisualRegression/backstop.ci.config.js
# ON Linux:
docker run --rm -v $PWD:/src/ -it --add-host dockerhost:`/sbin/ip route|awk '/default/ { print $3}'` uglow/backstopjs test --config=config/testVisualRegression/backstop.ci.config.js
```
The reason for two different commands is that there are OS-specific ways to get the HOST IP address and
pass it to the container.
## Debugging the image
```
docker run --rm -v $PWD:/src/ -it --entrypoint=/bin/bash uglow/backstopjs
```
## Rebuilding the image
You would only ever need to rebuild the image if you are changing it. Once you change it you also need to publish it.
### Changing the image
1. Open a terminal and navigate into the `config/docker` directory
2. Edit `Dockerfile` as required
3. Run `docker build`
### Publishing the image
Hopefully one day there will be a local AusPost repo. Until then, you will need your own Docker account to publish to
the global registry.
1. Create a Docker account on [https://hub.docker.com/](https://hub.docker.com/)
2. Run `docker login` locally, and enter your Docker credentials
3. Run `docker image push :latest`