README-docker_tests.md

Testing installation with docker

First install docker. We don't cover how to do that here.

Use

run_dockerfile.sh build

to build the docker image. Use

run_dockerfile.sh run

to run installation tests. Use

run_dockerfile.sh

to first build, then run. Use

run_dockerfile.sh fish

for an interactive fish shell. Use

run_dockerfile.sh bash

for an interactive bash shell.

run_dockerfile.sh rootfish

for an interactive fish shell as root

'Manual' building and running

You can build the docker image by changing to the ./docker_tests directory and doing

docker build -t qiskit_alt -f Dockerfile .. | tee dockerfile.log

You can run some installation tests like this

docker run -it qiskit_alt:latest  /usr/bin/su -l quser -c "cd qiskit_alt; sh ./run_init_tests.sh"

Working in the docker container

To experiment with the docker container you can do

docker run -it qiskit_alt /usr/bin/su -l quser -s /usr/bin/fish

This example uses the fish shell.