Anatomy of a Divio Cloud project¶

• The Divio CLI clones (downloads) the project’s files from the Divio CloudGit server.
• The project’s docker-compose.yml file is invoked, telling Dockerwhat containers need to be created, starting with the web container,which is built using…
• …the project’s Dockerfile. This tells Docker how to build thethe project’s containers - Docker begins executing the commands containedin the file.
• If necessary, Docker downloads the layers from which the container imageis built.
• Docker returns to the docker-compose.yml, which sets up filesystem,port and database access for the container, and the database containeritself.
• The docker-compose.yml file contains a default command that startsup the Django server.
• The Divio CLI opens a web browser window with a login page for the locallyrunning site.

Addons’ templates in projects¶

It’s also where you can place templates to override addon applications’templates. Templates at the project level will override templates at theapplication level if they are on similar paths. This is standard Django behaviour,allowing application developers to provide templates that can easily becustomised.

For example, templates from Aldryn News & Blog will be copied to in your project.

After templates have been copied to the project’s directory, theywill not be copied again, so as not to overwrite any changes the projectdeveloper may have made. However, this does mean that if an addon issubsequently updated and its templates change, those changes will not appear inyour project.

• if you have made changes to the templates in your project, you will need toobtain any updated templates and merge them with your own versions