X-Git-Url: https://git.immae.eu/?a=blobdiff_plain;f=README.md;h=0e47d4e76fa1cbfc167d0c5f5fbf8a9768be76d9;hb=a6507b7805e127da95a8de7c3dcc5c9c0957adea;hp=114bba86612c8cf03c72fef4814fcd20e32f0f7e;hpb=6fc9024b9b39faf35b0dcbd38335c22ac78e55af;p=github%2Ffretlink%2Fdocker-puppeteer.git

diff --git a/README.md b/README.md
index 114bba8..0e47d4e 100644
--- a/README.md
+++ b/README.md
@@ -1,17 +1,88 @@
 # Docker Puppeteer
 
-A Puppeteer Docker image based on [Puppeteer’s own recommendations](https://github.com/GoogleChrome/puppeteer/blob/master/docs/troubleshooting.md#running-puppeteer-in-docker).
+A Node + Puppeteer base image for running Puppeteer scripts. Add your own tools (such as Jest, Mocha, etc), link services you want to test via Docker Compose, and run your Puppeteer scripts with a headless Chromium.
 
-An example for how to use:
+See the list of [Docker Hub tags](https://hub.docker.com/r/buildkite/puppeteer/tags/) for Puppeteer versions available.
+
+## Usage example
+
+Dockerfile.integration-tests:
 
 ```Dockerfile
-FROM buildkite/puppeteer
+FROM buildkite/puppeteer:version
+RUN  npm i mocha
+ENV  PATH="${PATH}:/node_modules/.bin"
+```
+
+docker-compose.integration-tests.yml:
+
+```yml
+version: '3'
+services:
+  tests:
+    build:
+      context: .
+      dockerfile: Dockerfile.integration-tests
+    volumes:
+      - "./integration-tests:/integration-tests"
+      - "/screenshots"
+    command: mocha --recursive /integration-tests
+    links:
+      - app
+  app:
+    image: tutum/hello-world
+    expose:
+      - "80"
+```
+
+integration-tests/index.test.js:
+
+```js
+const assert = require('assert')
+const puppeteer = require('puppeteer')
 
-RUN npm install mocha
-ENV PATH="${PATH}:/node_modules/.bin"
+let browser
+let page
 
-# The `tests` dir is expected to be mounted into here
-WORK_DIR /home/pptr
+before(async() => {
+  browser = await puppeteer.launch({
+    args: [
+      // Required for Docker version of Puppeteer
+      '--no-sandbox',
+      '--disable-setuid-sandbox',
+      // This will write shared memory files into /tmp instead of /dev/shm,
+      // because Docker’s default for /dev/shm is 64MB
+      '--disable-dev-shm-usage'
+    ]
+  })
 
-CMD ["mocha", "--recursive", "tests"]
+  const browserVersion = await browser.version()
+  console.log(`Started ${browserVersion}`)
+})
+
+beforeEach(async() => {
+  page = await browser.newPage()
+})
+
+afterEach(async() => {
+  await page.close()
+})
+
+after(async() => {
+  await browser.close()
+})
+
+describe('App', () => {
+  it('renders', async() => {
+    const response = await page.goto('http://app/')
+    assert(response.ok())
+    await page.screenshot({ path: `/screenshots/app.png` })
+  })
+})
+```
+
+Running:
+
+```
+docker-compose -f integration-tests run tests
 ```