Public | Automated Build

Last pushed: 10 months ago
Short Description
OACIS tutorial image
Full Description

oacis_docker_tutorial



You can experience OAICS.

Quick Start

  1. Setup docker engine (version 1.8 or later is required.)

  2. Start an oacis instance

     docker run --name oacis_tutorial -p 3000:3000 -dt oacis/oacis_tutorial
     docker logs -f oacis_tutorial # wait for boot. exit via Ctrl + C
    
    • OACIS is ready when you get the following logs.

        Progress: |====================================================================|
        bundle exec rails s -d -b 0.0.0.0
        => Booting Thin
        => Rails 4.2.0 application starting in production on http://0.0.0.0:3000
        => Run `rails server -h` for more startup options
        ServiceWorker started.
        JobSubmitterWorker started.
        JobObserverWorker started.
        + echo booted
        booted
        + child=807
        + wait 807
        + tail -f /dev/null
      
    • The default port is 3000. (You can choose another port like -p 3001:3000.)
    • (for Mac or Windows users) Run the above command in Docker Quickstart Terminal.
  3. Access OACIS web interface

    • You can access OACIS web interface via a web browser.(http://localhost:3000)
    • (Mac or Windows) Access 192.168.99.100 instead of localhost.
  4. Try Simulations

    • Several simulators have been installed.
    • You can see how to use each simulator on About tab of Simulator page

Stop and Restart

Find a running oacis_tutorial container.

docker ps
#CONTAINER ID        IMAGE                        COMMAND                        CREATED         STATUS        PORTS                        NAMES
#3edbc17ee5e4        oacis/oacis_tutorial:latest  "./oacis_docker_cmd/o"         1 days ago      Up 23 hours   0.0.0.0:3000->3000/tcp       oacis_tutorial

Stop the container.

docker stop oacis_tutorial

Find the stoped oacis_tutorial container.

docker ps -a
#CONTAINER ID        IMAGE                        COMMAND                        CREATED         STATUS                  PORTS                        NAMES
#3edbc17ee5e4        oacis/oacis_tutorial:latest  "./oacis_docker_cmd/o"         1 days ago      Exited (0) 1 week ago   0.0.0.0:3000->3000/tcp       oacis_tutorial

Restart the container.

docker start oacis_tutorial
docker logs -f oacis_tutorial

Revome the container.

docker stop oacis_tutorial
docker rm -v oacis_tutorial

Logging in the container

By logging in the container, you can update the configuration of the container.
For instance, you can install additional packages, set up ssh-agent, and see the logs.

To login the container as a normal user, run

docker exec -it -u oacis oacis_tutorial bash -l

To login as the root user, run

docker exec -it oacis_tutorial bash

Firewall

Linux users must set up firewall for oacis_docker, otherwise anyone can access your oacis web-browser interface.
iptables is an application program for setting up firewall and docker-engine makes iptables configulations.
Run the following command as root on host machine to overwrite the configulations.

iptables -I FORWARD -i eth+ -o docker0 -p tcp -m tcp --dport 3000 -j DROP

If you are also using wifi, you need to run the following command additionally.

iptables -I FORWARD -i wlan+ -o docker0 -p tcp -m tcp --dport 3000 -j DROP

Note: iptables configurations are deleted when host OS reboots.

Contact

  • Just send your feedback to us!
    • oacis-dev _at_ googlegroups.com (replace at with @)
    • We appreciate your questions, feature requests, and bug reports. Do not hesitate to give us your feedbacks.
  • You'll have announcements of new releases if you join the following google group. Take a look at

License

  • oacis_docker_tutorial is a part of OACIS.
  • OACIS and oacis_docker_tutorial are published under the term of the MIT License (MIT).
  • Copyright (c) 2014-2016 RIKEN, AICS
Docker Pull Command
Owner
oacis