gitea/ckan
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add documentation for for new uWSGI env var configs

Browse Source
This commit is contained in:
Bruno Willenborg 2025-04-24 09:48:43 +02:00
parent 3c05e565a0
commit fd530da076
No known key found for this signature in database
1 changed files with 49 additions and 32 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

61
README.md
View File

@ -1,27 +1,30 @@
# Docker Compose setup for CKAN
* [1. Overview](#1-overview)
* [2. Installing Docker](#2-installing-docker)
* [3. docker compose vs docker-compose](#3-docker-compose-vs-docker-compose)
* [4. Install (build and run) CKAN plus dependencies](#4-install-build-and-run-ckan-plus-dependencies)
* [Base mode](#base-mode)
* [Development mode](#development-mode)
* [Create an extension](#create-an-extension)
* [Running HTTPS on development mode](#running-https-on-development-mode)
* [Remote Debugging with VS Code](#remote-debugging-with-vs-code)
* [Updating the environment file for development mode](#updating-the-environment-file-for-development-mode)
* [5. CKAN images](#5-ckan-images)
* [Extending the base images](#extending-the-base-images)
* [Applying patches](#applying-patches)
* [6. Debugging with pdb](#6-debugging-with-pdb)
* [7. Datastore and Datapusher](#7-datastore-and-datapusher)
* [8. NGINX](#8-nginx)
* [9. ckanext-envvars](#9-ckanext-envvars)
* [10. CKAN_SITE_URL](#10-CKAN_SITE_URL)
* [11. Manage new users](#11-manage-new-users)
* [12. Changing the base image](#12-changing-the-base-image)
* [13. Replacing DataPusher with XLoader](#13-replacing-datapusher-with-xLoader)
- [Docker Compose setup for CKAN](#docker-compose-setup-for-ckan)
- [1. Overview](#1--overview)
- [2. Installing Docker](#2--installing-docker)
- [3. docker compose *vs* docker-compose](#3--docker-compose-vs-docker-compose)
- [4. Install (build and run) CKAN plus dependencies](#4--install-build-and-run-ckan-plus-dependencies)
- [Base mode](#base-mode)
- [Development mode](#development-mode)
- [Create an extension](#create-an-extension)
- [Running HTTPS on development mode](#running-https-on-development-mode)
- [Remote Debugging with VS Code](#remote-debugging-with-vs-code)
- [Updating the environment file for development mode](#updating-the-environment-file-for-development-mode)
- [5. CKAN images](#5-ckan-images)
- [Extending the base images](#extending-the-base-images)
- [Applying patches](#applying-patches)
- [_uWSGI_ command line arguments](#uwsgi-command-line-arguments)
- [6. Debugging with pdb](#6-debugging-with-pdb)
- [7. Datastore and datapusher](#7-datastore-and-datapusher)
- [8. NGINX](#8-nginx)
- [9. ckanext-envvars](#9-ckanext-envvars)
- [10. CKAN\_SITE\_URL](#10-ckan_site_url)
- [11. Manage new users](#11-manage-new-users)
- [12. Changing the base image](#12-changing-the-base-image)
- [13. Replacing DataPusher with XLoader](#13-replacing-datapusher-with-xloader)
- [Copying and License](#copying-and-license)
## 1. Overview
@ -275,9 +278,23 @@ ckan
├── setup
├── Dockerfile
└── Dockerfile.dev
```
### _uWSGI_ command line arguments
The images use the application server [_uWSGI_](https://uwsgi-docs.readthedocs.io/en/latest/) to run _CKAN_. There are two environment variables, that allow to configure _uWSGI_ using [command line arguments](https://uwsgi-docs.readthedocs.io/en/latest/Configuration.html#command-line-arguments). The available options are described [here](https://uwsgi-docs.readthedocs.io/en/latest/Options.html).
For most use cases, the defaults specified in `ckan-X.XX/setup/start_ckan.sh` in `DEFAULT_UWSGI_OPTS` are fine. If required, you can either _overwrite_ the defaults or _append_ additional arguments.
| Variable | Description | Defaults |
|:--------------------|:------------------------------------------------------| :------------------|
| `UWSGI_OPTS` | If set, overwrites `DEFAULT_UWSGI_OPTS`. If not set, `UWSGI_OPTS` will bet set to `DEFAULT_UWSGI_OPTS`. | unset |
| `EXTRA_UWSGI_OPTS` | If set, appends its content to `UWSGI_OPTS`. | unset |
> [!IMPORTANT]
> These setting **do not** apply for the dev images.
## 6. Debugging with pdb
Add these lines to the `ckan-dev` service in the docker-compose.dev.yml file