Kashan University cloud

Project Overview

This README provides instructions on how to install Docker Engine on an Ubuntu server for running the project locally. The project is a Django-based web application with a Celery task queue, using PostgreSQL as the database, Swagger UI for API documentation, and Redis as a message broker.

Prerequisites

Docker installation

Uninstall Old Versions:

1. Before installing Docker Engine, uninstall any conflicting packages:

sudo apt-get remove docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc

2. Set Up Docker's Apt Repository

# Add Docker's official GPG key:
sudo apt-get update
sudo apt-get install ca-certificates curl gnupg
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

# Add the repository to Apt sources:
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

3. Install Docker Packages

sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

4. Install Docker compose

   sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
   
   sudo chmod +x /usr/local/bin/docker-compose
   
   docker-compose --version
   

5. change Docker registery to pass 403 of docker

sudo nano /etc/docker/daemon.json

And pase below text into nano

{
"registry-mirrors": ["https://registry.docker.ir"]
}

Then run

systemctl daemon-reload
systemctl restart docker

Or use this way if above command not work

sudo bash -c 'cat > /etc/docker/daemon.json <<EOF
{
  "insecure-registries" : ["https://docker.arvancloud.ir"],
  "registry-mirrors": ["https://docker.arvancloud.ir"]
}
EOF'

docker logout
sudo systemctl restart docker

Clone Project

```bash
git clone <repository_url>
cd <project_directory>
```

set .env file

you should create .env file from .env.example and configure the project.

Build and start project

```bash
docker-compose up --build
```

create admin user

```bash
docker-compose exec web sh
python manage.py createsuperuser
```

configure openstack

adding new image to openstack

This repose is alpine image for openstack here I use it for test. https://github.com/antoinemartin/alpine-openstack-vm

first download image from github

wget https://github.com/antoinemartin/alpine-openstack-vm/releases/download/latest/alpine-openstack.qcow2

Then create that image in openstack

microstack.openstack  image create --disk-format qcow2 --file alpine-openstack.qcow2 alpine-openstack

Add image metadata

if you upload and create new image in openstack you should set these meta for that image

متا دیتایی که به image های که در اپن ساخته میشه باید اضافه شوند و image ها باید public باشند. os_admin_user, os_distro, photo, Os_version,

microstack.openstack image set \
    --property os_distro=scsi \
    --property os_version=ide \
    --property photo=https://cdn.freebiesupply.com/logos/large/2x/ubuntu-4-logo-png-transparent.png \
    --property os_admin_user=alireza \
    alpine-openstack

I use microstack to develop the app,

Get microStack credential

sudo snap get microstack config.credentials.keystone-password