https://github.com/hackoregon/transportation-systems-docker
2018 Repo for Transportation Systems Docker Environment
https://github.com/hackoregon/transportation-systems-docker
Last synced: about 1 year ago
JSON representation
2018 Repo for Transportation Systems Docker Environment
- Host: GitHub
- URL: https://github.com/hackoregon/transportation-systems-docker
- Owner: hackoregon
- License: gpl-3.0
- Created: 2018-01-18T21:45:04.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2018-01-31T03:09:51.000Z (over 8 years ago)
- Last Synced: 2025-02-02T04:23:19.817Z (over 1 year ago)
- Language: Shell
- Homepage:
- Size: 508 KB
- Stars: 4
- Watchers: 17
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
## Quickstart
Quickest way to to get a GEODJANGO container up and running:
1. Unless you are developing on the image itself you'll want to create your own Github repo and then clone locally so you have a base repo. Use the python .gitignore template.
2. cd into directory `$ cd /bin/bash
```
15. At this point you can run bash commands and the like.
16. You should be able to start developing. You may want to add a more advanced database (https://github.com/hackoregon/postgis-geocoder-test), walkthrough the GeoDjango tutorial (https://docs.djangoproject.com/en/2.0/ref/contrib/gis/tutorial/), or build a Django Rest Framework (http://www.django-rest-framework.org/) app with the POSTGIS backing as next steps. Using the ssh shell could help with this.
## Docker Environment
This portion of the guide, will also provide some introductory information into Docker to help our volunteers get up and running in this project season.
## Getting Started - What is Docker?
If you are not familiar with Docker, your first step should be understanding the basics of Docker, ie how it works, some terms, and how it is different then running a full virtual machine like Vagrant.
I would suggest watching this video to get a short introduction into Docker:
[Docker Tutorial - What is Docker & Docker Containers, Images, etc?](https://www.youtube.com/watch?v=pGYAg7TMmp0)
This is also a great guide to review:
[A Beginner-Friendly Introduction to Containers, VMs and Docker](https://medium.freecodecamp.org/a-beginner-friendly-introduction-to-containers-vms-and-docker-79a9e3e119b)
Next, you will need to install Docker if you have not already...
## Installing Docker
Instead of providing specific instructions here, we will link to the Docker guides on installing.
* We will be working with Docker CE (Community Edition) as an Open Source Project.
### Installing for Macs
*System Requirements*
* Mac hardware must be a 2010 or newer model, with Intel’s hardware support for memory management unit (MMU) virtualization; i.e., Extended Page Tables (EPT) and Unrestricted Mode. You can check to see if your machine has this support by running the following command in a terminal: sysctl kern.hv_support
* macOS El Capitan 10.11 and newer macOS releases are supported. At a minimum, Docker for Mac requires macOS Yosemite 10.10.3 or newer, with the caveat that going forward 10.10.x is a use-at-your-own risk proposition.
* Starting with Docker for Mac Stable release 1.13, and concurrent Edge releases, we will no longer address issues specific to macOS Yosemite 10.10. In future releases, Docker for Mac could stop working on macOS Yosemite 10.10 due to the deprecated status of this macOS version. We recommend upgrading to the latest version of macOS.
* At least 4GB of RAM
* VirtualBox prior to version 4.3.30 must NOT be installed (it is incompatible with Docker for Mac). If you have a newer version of VirtualBox installed, it’s fine.
If your system does not meet these minimum requirements you will not be able to run Docker for Mac. You may attempt to run using [Docker Toolbox](https://docs.docker.com/toolbox/overview/) but this has not been tested and we may have limited assistance to troubleshoot issues.
*Installation*
When you are ready follow Docker's Official Guide to install Docker for Mac:
[Docker for Mac Installation](https://docs.docker.com/docker-for-mac/install/)
All work should be done using the "Stable" build.
### Installing for Windows 10
### Installing for Ubuntu/Linux Systems
You will want to consult Docker's Guides to installation on Linux Systems:
* [Ubuntu](https://docs.docker.com/engine/installation/linux/docker-ce/ubuntu/)
* [Debian](https://docs.docker.com/engine/installation/linux/docker-ce/debian/)
* [CentOS](https://docs.docker.com/engine/installation/linux/docker-ce/centos/)
* [Fedora](https://docs.docker.com/engine/installation/linux/docker-ce/fedora/)
### About this Repo
This repo contains the source files for building the docker images that will be used to and deploy the 2018 Hack Oregon Transportation Systems API and Database. The base image has been built to use only env variables for repo name and other assets. As such it should be useful across other teams.