{{ project_name|title }}

GeoNode template project. Generates a django project with GeoNode support.

Developer Workshop

Available at:

http://geonode.org/dev-workshop

Create a custom project

Note: You can call your geonode project whatever you like following the naming conventions for python packages (generally lower case with underscores (_). In the examples below, replace my_geonode with whatever you would like to name your project.

Using a Python virtual environment

To setup your project using a local python virtual environment, follow these instructions:

1. Prepare the Environment

git clone https://github.com/GeoNode/geonode-project.git -b 2.10.x
mkvirtualenv my_geonode
pip install Django==1.11.21

django-admin startproject --template=./geonode-project -e py,rst,json,yml,ini,env,sample -n Dockerfile my_geonode

cd my_geonode

2. Setup the Python Dependencies

pip install -r requirements.txt --upgrade
pip install -e . --upgrade

GDAL_VERSION=`gdal-config --version`
PYGDAL_VERSION="$(pip install pygdal==$GDAL_VERSION 2>&1 | grep -oP '(?<=: )(.*)(?=\))' | grep -oh $GDAL_VERSION\.[0-9])"
pip install pygdal==$PYGDAL_VERSION

# Using Default Settings
DJANGO_SETTINGS_MODULE=my_geonode.settings paver reset
DJANGO_SETTINGS_MODULE=my_geonode.settings paver setup
DJANGO_SETTINGS_MODULE=my_geonode.settings paver sync
DJANGO_SETTINGS_MODULE=my_geonode.settings paver start

# Using Custom Local Settings
cp my_geonode/local_settings.py.sample my_geonode/local_settings.py

vim my_geonode/wsgi.py
--> os.environ.setdefault("DJANGO_SETTINGS_MODULE", "my_geonode.local_settings")

DJANGO_SETTINGS_MODULE=my_geonode.local_settings paver reset
DJANGO_SETTINGS_MODULE=my_geonode.local_settings paver setup
DJANGO_SETTINGS_MODULE=my_geonode.local_settings paver sync
DJANGO_SETTINGS_MODULE=my_geonode.local_settings paver start

3. Access GeoNode from browser:

   http://localhost:8000/
   

Note

default admin user is admin (with pw: admin)

Start your server

You need Docker 1.12 or higher, get the latest stable official release for your platform.

1. Prepare the Environment

git clone https://github.com/GeoNode/geonode-project.git -b 2.10.x
mkvirtualenv my_geonode
pip install Django==1.11.21

django-admin startproject --template=./geonode-project -e py,rst,json,yml,ini,env,sample -n Dockerfile my_geonode

cd my_geonode

2. Run docker-compose to start it up (get a cup of coffee or tea while you wait)

Remember to update "wsgi.py" in case you are using "local_settings" vim my_geonode/wsgi.py --> os.environ.setdefault("DJANGO_SETTINGS_MODULE", "my_geonode.local_settings")

docker-compose build --no-cache
docker-compose up -d

set COMPOSE_CONVERT_WINDOWS_PATHS=1

before running docker-compose up

3. Access the site on http://localhost/

If you want to run the instance for development

Use dedicated docker-compose files while developing

Note

In this example we are going to keep localhost as the target IP for GeoNode

docker-compose -f docker-compose.development.yml -f docker-compose.development.override.yml up

How to debug

Note

We are supposing to use IPDB for debugging which is already available as package from the container

1. Stop the container for the "django" service:

docker-compose stop django

2. Run the container again with the option for service ports:

docker-compose run -e DOCKER_ENV=development --rm --service-ports django python manage.py runserver --settings=my_geonode.settings 0.0.0.0:8000

3. Access the site on http://localhost/

If you set an IPDB debug point with import ipdb ; ipdb.set_trace() then you should be facing its console and you can see the django server which is restarting at any change of your code from your local machine.

If you want to run the instance on a public site

Preparation of the image (First time only)

Note

In this example we are going to publish to the public IP http://123.456.789.111

vim docker-compose.override.yml
  --> replace localhost with 123.456.789.111 everywhere

Startup the image

docker-compose up --build -d

To Stop the Docker Images

docker-compose stop

To Fully Wipe-out the Docker Images

Warning

This will wipe out all the repositories created until now.

Note

The images must be stopped first

docker system prune -a

Recommended: Track your changes

Step 1. Install Git (for Linux, Mac or Windows).

Step 2. Init git locally and do the first commit:

git init

git add *

git commit -m "Initial Commit"

Step 3. Set up a free account on github or bitbucket and make a copy of the repo there.

Hints: Configuring Requirements.txt

You may want to configure your requirements.txt, if you are using additional or custom versions of python packages. For example:

Django==1.11.21
six==1.10.0
django-cuser==2017.3.16
django-model-utils==3.1.1
pyshp==1.2.12
celery==4.1.0
Shapely>=1.5.13,<1.6.dev0
proj==0.1.0
pyproj==1.9.5.1
pygdal==2.2.1.3
inflection==0.3.1
git+git://github.com/<your organization>/geonode.git@<your branch>

Hints: Using Ansible

You will need to use Ansible Role in order to run the playbook.

In order to install and setup Ansible, run the following commands:

sudo apt-get install software-properties-common
sudo apt-add-repository ppa:ansible/ansible
sudo apt-get update
sudo apt-get install ansible

A sample Ansible Role can be found at https://github.com/GeoNode/ansible-geonode

To install the default one, run:

sudo ansible-galaxy install GeoNode.geonode

you will find the Ansible files into the ~/.ansible/roles folder. Those must be updated in order to match the GeoNode and GeoServer versions you will need to install.

To run the Ansible playbook use something like this:

ANSIBLE_ROLES_PATH=~.ansible/roles ansible-playbook -e "gs_root_password=<new gs root password>" -e "gs_admin_password=<new gs admin password>" -e "dj_superuser_password=<new django admin password>" -i inventory --limit all playbook.yml

Configuration

Since this application uses geonode, base source of settings is geonode.settings module. It provides defaults for many items, which are used by geonode. This application has own settings module, {{project_name}}.settings, which includes geonode.settings. It customizes few elements:

• static/media files locations - they will be collected and stored along with this application files by default. This is useful during development.
• Adds {{project_name}} to installed applications, updates templates, staticfiles dirs, sets urlconf to {{project_name}}.urls.

Whether you deploy development or production environment, you should create additional settings file. Convention is to make {{project_name}}.local_settings module. It is recommended to use {{project_name}}/local_settings.py.. That file contains small subset of settings for edition. It should:

• not be versioned along with application (because changes you make for your private deployment may become public),
• have customized at least DATABASES, SECRET_KEY and SITEURL.

You can add more settings there, note however, some settings (notably DEBUG_STATIC, EMAIL_ENABLE, *_ROOT, and few others) can be used by other settings, or as condition values, which change other settings. For example, EMAIL_ENABLE defined in geonode.settings enables whole email handling block, so if you disable it in your local_settings, derived settings will be preserved. You should carefully check if additional settings you change don't trigger other settings.

To illustrate whole concept of chained settings:

+------------------------+-------------+-------------------------------+-------------+----------------------------------+
|  GeoNode configuration |             |   Your application default    |             |  (optionally) Your deployment(s) |
|                        |             |        configuration          |             |                                  |
+========================|=============|===============================|=============|==================================+
|                        | included by |                               | included by |                                  |
|   geonode.settings     |     ->      |  {{project_name}}.settings    |      ->     |  {{project_name}}.local_settings |
+------------------------|-------------|-------------------------------|-------------|----------------------------------+