OverviewTeaching: 0 min Exercises: 30 minQuestions
What do I need to do to prepare for geohackweek?
Do I need to install specific software on my computer?Objectives
Install Docker on your computer
Test whether Docker is working
Download Docker images for geohackweek
Docker wraps software in a complete filesystem which guarantees that the software will run the same in different computing environments. It works on Linux, OS X and Windows.
We are using Docker for geohackweek because geospatial analysis depends on many different types of software. By using Docker, we will be able to create the correct software environments in advance and minimize the amount of software that participants have to install themselves prior to the start of geohackweek.
**Docker has specific requirements: Windows and Mac OS X users should read the “Important Notes” and “What to know before you install” sections before installing Docker. You may need to update your operating system. Another option is to install Docker Toolbox. If you cannot install Docker or Docker Toolbox, please contact geohackweek organizers via the #installdocker Slack channel as soon as possible.
Windows: Press “Win + X”, and click/tap on Command Prompt, or Command Prompt (Admin) to open it in Administrator mode.
Mac OS X: Open the Utilities folder inside of the Applications folder and click on “Terminal”.
Linux: Press “Ctrl+Alt+T”.
docker run hello-world in the terminal.
You should see something similar to the following:
$ docker run hello-world Unable to find image 'hello-world:latest' locally latest: Pulling from library/hello-world 535020c3e8ad: Pull complete af340544ed62: Pull complete Digest: sha256:a68868bfe696c00866942e8f5ca39e3e31b79c1e50feaee4ce5e28df2f051d5c Status: Downloaded newer image for hello-world:latest Hello from Docker. This message shows that your installation appears to be working correctly. To generate this message, Docker took the following steps: 1. The Docker Engine CLI client contacted the Docker Engine daemon. 2. The Docker Engine daemon pulled the "hello-world" image from the Docker Hub. 3. The Docker Engine daemon created a new container from that image which runs the executable that produces the output you are currently reading. 4. The Docker Engine daemon streamed that output to the Docker Engine CLI client, which sent it to your terminal. To try something more ambitious, you can run an Ubuntu container with: $ docker run -it ubuntu bash Share images, automate workflows, and more with a free Docker Hub account: https://hub.docker.com For more examples and ideas, visit: https://docs.docker.com/userguide/ >>>
Run the following commands in the command terminal.
$ docker pull geohackweek2016/vectortutorial
$ docker pull geohackweek2016/arraystutorial
$ docker pull geohackweek2016/rastertutorial
$ docker pull geohackweek2016/vistutorial
To view the Docker images that have been downloaded, type
docker images in the command terminal:
$ docker images REPOSITORY TAG IMAGE ID CREATED SIZE geohackweek2016/vectortutorial latest 10dc49fb7b22 11 days ago 3.658 GB geohackweek2016/arraystutorial latest 246184b7e4b4 13 days ago 2.658 GB geohackweek2016/rastertutorial latest f8be04b5f1c3 13 days ago 2.905 GB continuumio/anaconda3 latest 54c70f303906 2 weeks ago 2.128 GB ubuntu latest c73a085dc378 3 weeks ago 127.1 MB hello-world latest c54a2cc56cbb 3 months ago 1.848 kB >>>
Make sure that Docker successfully runs on your computer so that we can trouble-shoot issues before the start of geohackweek.
Download Docker images for geohackweek because the download speeds over wireless are slow especially when 40+ people are trying to download simultaneously.