etools-partner-reporting-portal

Container build status

• Polymer:

• PostGIS:

• Django API:

• Nginx proxy:

macOS Setup

1. Install Docker for Mac. Also install Fabric via pip install fabric==1.13.1
2. Create .env file in repository root with the reference of .env.example or receive .env file from your team member.
3. Run fab up !
4. Go to http://127.0.0.1:8081/ to see the frontend / polymer running. The Django app is running under http://127.0.0.1:8082/api/
5. As a separate terminal tab, run fab fixtures if this is first time running environment - load Site & ReportingEntity objects from fixture json files.
6. As a separate terminal tab, run fab fake_data to generate fake data like account, core, partner and other modules. There is also fab real_data command as well.
7. TEMP: Go to http://127.0.0.1:8081/api/admin/ login with admin/Passw0rd! and can now go to http://127.0.0.1:8082/app/ to see the frontend interface. Replace 'ip-reporting' or 'cluster-reporting' in the URL's to switch between the two interfaces.

Ubuntu 16.04 setup

1. Install docker and docker-compose

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
sudo apt-get update -y
apt-cache policy docker-ce
sudo apt-get install -y docker-ce
sudo systemctl status docker

2. Set ubuntu user to docker group

sudo usermod -aG docker ${USER}

# (Password will be prompt)
su - ${USER}

3. Install pip and fabric 1.X

sudo apt-get install --assume-yes --reinstall ca-certificates
sudo apt-get install -y --no-install-recommends build-essential vim python-dev python-setuptools

sudo easy_install pip

sudo pip install --upgrade pip --trusted-host pypi.python.org
sudo pip install fabric==1.13.1 --trusted-host pypi.python.org

sudo curl -L https://github.com/docker/compose/releases/download/1.21.2/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose

sudo chmod +x /usr/local/bin/docker-compose

4. Check docker-compose is installed

docker-compose --version

5. Create .env file in repository root with the reference of .env.example or receive .env file from your team member.
6. Run fab up !
7. Go to http://127.0.0.1:8081/ to see the frontend / polymer running. The Django app is running under http://127.0.0.1:8082/api/
8. As a separate terminal tab, run fab fixtures if this is first time running environment - load Site & ReportingEntity objects from fixture json files.
9. As a separate terminal tab, run fab fake_data to generate fake data like account, core, partner and other modules. There is also fab real_data command as well.
10. TEMP: Go to http://127.0.0.1:8082/api/admin/ login with admin/Passw0rd! and can now go to http://127.0.0.1:8082/app/ to see the frontend interface. Replace 'ip-reporting' or 'cluster-reporting' in the URL's to switch between the two interfaces.

Development

Run migrations:

• ssh into backend container and run the commands below (using docker exec cmd or Docker Dasboard)
• python /code/manage.py makemigrations --merge --noinput
• python /code/manage.py migrate

Here are some docker tips:

1. display all containers:

$ docker-compose ps

2. ssh into running django_api container

$ fab ssh:django_api

3. Stop all containers

$ fab stop

4. Re-build docker images for containers

$ fab rebuild