Skip to content
This repository has been archived by the owner on Jun 21, 2022. It is now read-only.
Scott Numamoto edited this page Aug 27, 2016 · 14 revisions

Dockumentation

What is Docker

Docker is a platform used to run and develop software. Docker is advantageous because it allows developers to run their software in the same environment would be run on a server or elsewhere.

[Get Started with Docker] (http://docs.docker.com/) will walk you through installation as well as your first image and container.

Important Vocabulary

  • Dockerfile: a list of commands to build a Docker image
  • Container: an isolated work environment on a Linux system
  • Image: Software that is loaded into a container that creates a specific state

If making an analogy to programming, an image could be thought of as a class, while a container could be thought of as an instance.

Docker and Web Development

PiE runs the website through a Docker container on the web server.

To try running a website as it would be run on the server:

  1. Open Docker either using the Docker Quick Start Terminal or opening Kitematic and selecting Docker CLI

  2. Navigate to the website folder containing website info, but specifically docker-dev.sh

  3. Run the following command to rebuild and run the website

     bash docker-dev.sh
    

Docker will then create a container off of (nearly) the same image that the server uses. Users should see the Jekyll build script come up. The resulting website will be available at http://localhost:4000.

Debugging

To look inside the container while it has an ENTRYPOINT set. This is useful for debugging.

docker run -ti --rm --entrypoint sh <DOCKER_IMAGE>

or

docker exec -it <CONTAINER_NAME> sh

Useful Resources