Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/karllhughes/docker-testing-examples

Examples of using Docker to improve your test suite
https://github.com/karllhughes/docker-testing-examples

docker nighthawk nodejs phpunit testing

Last synced: 15 days ago
JSON representation

Examples of using Docker to improve your test suite

Host: GitHub
URL: https://github.com/karllhughes/docker-testing-examples
Owner: karllhughes
Created: 2018-04-19T14:45:25.000Z (almost 7 years ago)
Default Branch: master
Last Pushed: 2018-04-24T21:53:17.000Z (over 6 years ago)
Last Synced: 2024-12-12T09:37:39.157Z (about 1 month ago)
Topics: docker, nighthawk, nodejs, phpunit, testing
Language: Visual Basic
Homepage: https://blog.codeship.com/7-ways-to-improve-your-test-suite-with-docker/
Size: 6.81 MB
Stars: 5
Watchers: 2
Forks: 2
Open Issues: 1
Metadata Files:
- Readme: readme.md

Awesome Lists containing this project

README

# Enhancing Your Test Suite with Docker - Examples

This repository includes examples of how you can improve your test suite with Docker. Examples are in PHP or Node, and require you to have Docker installed locally.

Use the short instructions below, or check out the blog post (coming soon) for more details.

## Ex 1: Running PHPUnit tests in older version of PHP

- Navigate to `/ex-1` directory
- Install dependencies (using Docker and Composer): `docker run --rm -v $(pwd):/app -w /app composer install`
- Run PHPUnit in PHP 7.2: `docker run --rm -v $(pwd):/app -w /app php:7.2 vendor/bin/phpunit index.php` (should pass)
- Run PHPUnit in PHP 7.1: `docker run --rm -v $(pwd):/app -w /app php:7.1 vendor/bin/phpunit index.php` (should pass)
- Run PHPUnit in PHP 7.0: `docker run --rm -v $(pwd):/app -w /app php:7.0 vendor/bin/phpunit index.php` (should pass)
- Run PHPUnit in PHP 5.6: `docker run --rm -v $(pwd):/app -w /app php:5.6 vendor/bin/phpunit index.php` (should throw syntax error)

## Ex 2: Connecting to MySQL when missing database extension

- Navigate to `/ex-2` directory
- Install dependencies (using Docker and Composer): `docker run --rm -v $(pwd):/app -w /app composer install`
- Run a MySQL container to test connections on: `docker run --name database --rm -d -e MYSQL_ALLOW_EMPTY_PASSWORD=true mysql:5.7`
- Run PHPUnit in PHP 7.2: `docker run --rm -v $(pwd):/app -w /app --link database php:7.2 vendor/bin/phpunit index.php` (should fail)
- Build a custom image from Dockerfile (with mysqli extension): `docker build . -t php-72-mysqli`
- Run PHPUnit using custom image: `docker run --rm -v $(pwd):/app -w /app --link database php-72-mysqli vendor/bin/phpunit index.php` (should pass)
- Stop/remove the MySQL container when you're done: `docker rm -f database`

## Ex 3: Integration test with different versions of MySQL

- Navigate to `/ex-3` directory
- Install dependencies (using Docker and Composer): `docker run --rm -v $(pwd):/app -w /app composer install`
- Build the PHP/mysqli image from Dockerfile (same as in Ex 2): `docker build . -t php-72-mysqli`
- Run a MySQL 5.6 container to test with: `docker run --name database --rm -d -e MYSQL_ALLOW_EMPTY_PASSWORD=true -e MYSQL_DATABASE=test mysql:5.6`. Wait a few seconds for the container to boot.
- Run PHPUnit using custom image: `docker run --rm -v $(pwd):/app -w /app --link database php-72-mysqli vendor/bin/phpunit index.php` (should fail)
- Stop/remove the MySQL container: `docker rm -f database`
- Run a MySQL 5.7 container to test with: `docker run --name database --rm -d -e MYSQL_ALLOW_EMPTY_PASSWORD=true -e MYSQL_DATABASE=test mysql:5.7`. Wait a few seconds for the container to boot.
- Run PHPUnit using custom image: `docker run --rm -v $(pwd):/app -w /app --link database php-72-mysqli vendor/bin/phpunit index.php` (should pass)
- Stop/remove the MySQL container when you're done: `docker rm -f database`

## Ex 4: Seeding data with volumes

- Navigate to `/ex-4` directory
- Install dependencies (using Docker and Composer): `docker run --rm -v $(pwd):/app -w /app composer install`
- Build the PHP/mysqli image from Dockerfile (same as in Ex 2): `docker build . -t php-72-mysqli`
- Run a MySQL container with a bind mount: `docker run --name database --rm -d -e MYSQL_ALLOW_EMPTY_PASSWORD=true -v $(pwd)/data:/var/lib/mysql mysql:5.7`. Wait a few seconds for the container to boot.
- Run PHPUnit using custom image: `docker run --rm -v $(pwd):/app -w /app --link database php-72-mysqli vendor/bin/phpunit index.php` (should pass)
- Stop/remove the MySQL container when you're done: `docker rm -f database`

## Ex 5: NodeJS End-to-end tests

- Navigate to `/ex-5` directory
- Run the tests with [Docker Compose](https://docs.docker.com/compose/): `docker-compose run --rm nightwatch`.
- Stop the containers: `docker-compose down`.

This example adapted from [blueimp's open source nightwatch repo](https://github.com/blueimp/nightwatch).

## Ex 6: End-to-end test for networked application

- Navigate to `/ex-6` directory
- Run the tests with [Docker Compose](https://docs.docker.com/compose/): `docker-compose run --rm nightwatch`.
- Stop the containers: `docker-compose down`.

This example adapted from [b00giZm's open source Node/Express example](https://github.com/b00giZm/docker-compose-nodejs-examples/tree/master/00-basic-express-generator).

## Ex 7: Automating with Codeship

# Legal

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.