Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/CleverCloud/django-example
Run Django on Clever Cloud
https://github.com/CleverCloud/django-example
clevercloud-example django python
Last synced: about 1 month ago
JSON representation
Run Django on Clever Cloud
- Host: GitHub
- URL: https://github.com/CleverCloud/django-example
- Owner: CleverCloud
- Fork: true (mekza/cc_django)
- Created: 2013-07-25T08:27:40.000Z (about 11 years ago)
- Default Branch: master
- Last Pushed: 2024-04-23T16:35:03.000Z (5 months ago)
- Last Synced: 2024-05-19T21:13:38.964Z (4 months ago)
- Topics: clevercloud-example, django, python
- Language: Python
- Homepage:
- Size: 21.5 KB
- Stars: 3
- Watchers: 7
- Forks: 15
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-clever-cloud - demo-django
README
# Clever Coud Django project
This project allows you to quickly begin a Django project on Clever Cloud.
## Pre-requisites
A working version of Python. This project has been tested on Python 3.11+ with Django 5.0.4.
### Database
By default, Django will use a local sqlite database that won't persist between deployments. So you need to choose a non-local technology.
Django supports [some DBs](https://docs.djangoproject.com/en/2.1/ref/settings/#databases) and Clever Cloud can host somes as [add-ons](https://developers.clever-cloud.com/doc/addons/).
To keep it simple, you can run it either on MySQL or PostgreSQL. Add the suitable dependancy to `requirements.txt` according to your DB.
For local work, you can grab [PostgreSQL](https://www.postgresql.org/download/) easily; or [MySQL](https://dev.mysql.com/downloads/) and its compatible alternative [MariaDB](https://downloads.mariadb.org/).
## Project creation
First you need to [fork](https://help.github.com/articles/fork-a-repo/) the project or [duplicate it](https://help.github.com/articles/duplicating-a-repository/).
If you want to use a database such as PostgreSQL, refer to the [offical Django documention](https://docs.djangoproject.com/en/5.0/ref/databases/).
## Clever Tools connect
This tutorial will use the [Clever Tools CLI](https://developers.clever-cloud.com/doc/cli/getting_started/).
It will allow you to create, configure and deploy your application on Clever Cloud from console.
In the following steps, we will suppose that you name (adapt to your needs) in the Clever Cloud dashboard :
* your application : `django-cc`
* your corresponding database add-on if needed : `django-cc-pg` (for example)
### Create the app and add-on
At the root of the project :
```bash
clever login
```
Log in the UI and close it. Then create your Python application and PostgreSQL add-on :
```bash
clever create --type python --region par django-cc
clever addon create --region eu --plan dev --link django-cc postgresql-addon django-cc-pg
```
More information on parameters [HERE](https://www.clever-cloud.com/doc/clever-tools/create/).
If needed, you can set the scaling :
```bash
clever scale --min-flavor pico --max-flavor pico
clever scale --min-instances 1 --max-instances 1
```
More information on scaling [HERE](https://www.clever-cloud.com/doc/clever-tools/manage/).
### Environment setup
You need to setup some Environment variables accordingly to your `settings.py` :
```bash
clever env set CC_PYTHON_VERSION "3"
clever env set CC_PYTHON_MODULE "ccdjangodemo.wsgi:application"
clever env set STATIC_FILES_PATH "static/"
clever env set STATIC_URL_PREFIX "/static"
```
More information on Python environement variables [HERE](https://www.clever-cloud.com/doc/python/python_apps/).
Once deployed, from the Console, your environement variables will look like that on **Expert** mode:
```bash
CC_PYTHON_VERSION="3"
CC_PYTHON_MODULE="ccdjangodemo.wsgi:application"
STATIC_FILES_PATH="static/"
STATIC_URL_PREFIX="/static"
```
### Deploy !
Nothing else left to do, just go on and deploy your app :
```bash
clever deploy
```
Note :
If deployement failed with some error like :
```bash
django.db.utils.OperationalError: could not translate host name "XXXXXXXXXX-postgresql.services.clever-cloud.com" to address: Name or service not known
```
It only means that you deployed too quickly after creating the PG add-on and name propagation has not yet been done. Wait a bit and try again later.
### URL
Your application automatically has a domain pointing to it. You can obtain it though :
```bash
clever domain
```
To add other domains, more information [HERE](https://developers.clever-cloud.com/doc/administrate/domain-names/).