Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Simplify Soos usage #9

Open
elmariofredo opened this issue Jan 7, 2016 · 1 comment
Open

Simplify Soos usage #9

elmariofredo opened this issue Jan 7, 2016 · 1 comment

Comments

@elmariofredo
Copy link
Member

Make Soos usage much more simpler for users, so they don't have to deal with docker specifics from the beginning.

Let's take a tour of developer who want's to start developing his own project using Soos

  1. Install Docker Toolbox ( Win / OS X )

    User needs docker tooling in order to build and run docker containers.

  2. Ensure Docker Environment ( Win / OS X )

    We need to make sure that

    2.1. Docker machine is running
    2.2. Docker environment variables are set
    2.3. Docker daemon is reachable

  3. Add Dockerfile to project folder

    Necessary receipt for docker command to build image from

  4. Build Image

    We need to build image before we can start creating container form it

  5. Run Container

    Start container with predefined command in Dockerfile

  6. CI Build Image

    We need to setup TravisCI to build image for each commit so other developers can benefit from Soos

This is quite lot of steps to be done specifically 1-4 so first timers can get confused. We need to make this process much simpler.

@elmariofredo
Copy link
Member Author

My take would be that simple soos command will do following

  1. Docker Toolbox

    On OS X or Win will check for presence of docker-machine command and if it is missing it will show message

    It doesn't seems that you have docker-machine command reachable within command line. Make sure you have installed Docker Toolbox from https://www.docker.com/docker-toolbox and check that 'docker-machine' command is working from command line

  2. Docker Machine Instance

    On OS X or Win check if default docker machine is running if not try to start it with message explaining what is happening.

    Soos can't reach instance of docker-machine called default on your system and it's trying to start is with command 'docker-machine start default'

    if command will fail let's print

    Soos failed to start docker-machine called default with command 'docker-machine start default' please run this command manually and try to find out what is wrong.

  3. Docker Environment

    On OS X or Win check if DOCKER_HOST environment variable is present if not run eval command specific for the platform e.g. '$(docker-machine env default)'.

  4. Init Dockerfile

    Check if Dockerfile is missing then show message

    Docker file is missing do you want me to set it up for you? ( Y / n )

    Y => init
    n => exit

  5. Run Container

    Check if process exits with missing image on local or on hub.docker.com if yes ask user

    It seems that image for your project doesn't exists yet, do you want me to create it? ( Y / n )

    Y => build && run
    n => exit

This way all the new user has to do is to simply run soos command which will guide him thru whole process of setting up environment.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant