Implantando Django + Python 3 + PostgreSQL no AWS Elastic Beanstalk

1. Python v3.4.3
2. Django v1.9
3. Amazon Elastic Beanstalk, EC2, S3 e RDS
4. EB CLI 3.x
5. PostgreSQL

Confira o Python 2 versão deste artigo aqui.

Elastic Beanstalk vs EC2

Primeiros passos

$ git clone https://github.com/realpython/image-of-the-day.git
$ cd image-of-the-day/
$ git checkout tags/start_here_py3

$ pip install -r requirements.txt

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql_psycopg2',
        'NAME': 'iotd',
        'USER': '',
        'PASSWORD': '',
        'HOST': 'localhost',
        'PORT': '5432',
    }
}

$ python manage.py migrate
$ python manage.py createsuperuser
$ python manage.py runserver

CLI para AWS Elastic Beanstalk

$ pip install awsebcli

$ eb --version

EB CLI 3.7.4 (Python 3.4.3)

Configurar EB – Inicializar seu aplicativo

$ eb init

• Python 3.4
• Python 3.4 (pré-configurado - Docker)

Python 3.4

Python 3.4 (Pré-configurado – Docker)

O que realizamos?

├── .elasticbeanstalk
│   └── config.yml
├── .gitignore
├── README.md
├── iotd
│   ├── images
│   │   ├── __init__.py
│   │   ├── admin.py
│   │   ├── migrations
│   │   │   ├── 0001_initial.py
│   │   │   └── __init__.py
│   │   ├── models.py
│   │   ├── tests.py
│   │   └── views.py
│   ├── iotd
│   │   ├── __init__.py
│   │   ├── settings.py
│   │   ├── urls.py
│   │   └── wsgi.py
│   ├── manage.py
│   ├── static
│   │   ├── css
│   │   │   └── bootstrap.min.css
│   │   └── js
│   │       ├── bootstrap.min.js
│   │       └── jquery-1.11.0.min.js
│   └── templates
│       ├── base.html
│       └── images
│           └── home.html
├── requirements.txt
└── www
    └── media
        └── sitelogo.png

Configurar EB – Criar um ambiente

$ eb create

O que acontece agora?

Se você receber um erro ao criar o ambiente, como - aws.auth.client.error.ARCInstanceIdentityProfileNotFoundException - verifique se as credenciais que você está usando possuem permissões apropriadas para criar o ambiente Beanstalk, conforme discutido anteriormente neste post.

Além disso, ele pode avisá-lo com uma mensagem sobre Platform requires a service role . Se isso acontecer, apenas diga sim e deixe-o criar o papel para você.

ERROR: Your requirements.txt is invalid. Snapshot your logs for details.

$ eb logs

Error: pg_config executable not found.

Personalizando o processo de implantação

Instalando pacotes

packages:
  yum:
    git: []
    postgresql93-devel: []
    libjpeg-turbo-devel: []

$ git add .ebextensions/
$ git commit -m "added eb package configuration"

$ eb deploy

INFO: Environment update is starting.
INFO: Deploying new version to instance(s).
ERROR: Your WSGIPath refers to a file that does not exist.
INFO: New application version was deployed to running EC2 instances.
INFO: Environment update completed successfully.

Configurando nosso ambiente Python

$ eb config

aws:elasticbeanstalk:container:python:
  NumProcesses: '1'
  NumThreads: '15'
  StaticFiles: /static/=static/
  WSGIPath: application.py

 aws:elasticbeanstalk:container:python:
   NumProcesses: '1'
   NumThreads: '15'
   StaticFiles: /static/=static/
   WSGIPath: iotd/iotd/wsgi.py

Printing Status:
INFO: Environment update is starting.
INFO: Updating environment iod-test's configuration settings.
INFO: Successfully deployed new configuration to environment.
INFO: Environment update completed successfully.

option_settings:
  "aws:elasticbeanstalk:application:environment":
    DJANGO_SETTINGS_MODULE: "iotd.settings"
    "PYTHONPATH": "/opt/python/current/app/iotd:$PYTHONPATH"
  "aws:elasticbeanstalk:container:python":
    WSGIPath: iotd/iotd/wsgi.py
    NumProcesses: 3
    NumThreads: 20
  "aws:elasticbeanstalk:container:python:staticfiles":
    "/static/": "www/static/"

• DJANGO_SETTINGS_MODULE: "iotd.settings" - adiciona o caminho para o módulo de configurações.
• "PYTHONPATH": "/opt/python/current/app/iotd:$PYTHONPATH" - atualiza nosso PYTHONPATH para que o Python possa encontrar os módulos em nosso aplicativo. Este caminho pode variar dependendo da sua configuração! Veja este comentário para mais detalhes. (Observe que o uso do caminho completo é necessário.)
• WSGIPath: iotd/iotd/wsgi.py define nosso caminho WSGI.
• NumProcesses: 3 e NumThreads: 20 - atualiza o número de processos e threads usados ​​para executar nosso aplicativo WSGI.
• "/static/": "www/static/" define nosso caminho de arquivos estáticos.

Configurando um banco de dados

$ eb open

OperationalError at /
could not connect to server: Connection refused
    Is the server running on host "localhost" (127.0.0.1) and accepting
    TCP/IP connections on port 5432?

Configuração do banco de dados

1. Clique no link "Configuração".
2. Role até o final da página e, na seção "Tier de dados", clique no link "criar um novo banco de dados RDS".
3. Na página de configuração do RDS, altere o "DB Engine" para "postgres".
4. Adicione um "Nome de usuário mestre" e uma "Senha mestre".
5. Salve as alterações.

if 'RDS_DB_NAME' in os.environ:
    DATABASES = {
        'default': {
            'ENGINE': 'django.db.backends.postgresql_psycopg2',
            'NAME': os.environ['RDS_DB_NAME'],
            'USER': os.environ['RDS_USERNAME'],
            'PASSWORD': os.environ['RDS_PASSWORD'],
            'HOST': os.environ['RDS_HOSTNAME'],
            'PORT': os.environ['RDS_PORT'],
        }
    }
else:
    DATABASES = {
        'default': {
            'ENGINE': 'django.db.backends.postgresql_psycopg2',
            'NAME': 'iotd',
            'USER': 'iotd',
            'PASSWORD': 'iotd',
            'HOST': 'localhost',
            'PORT': '5432',
        }
    }

Gerenciando migrações de banco de dados

container_commands:
  01_migrate:
    command: "source /opt/python/run/venv/bin/activate && python iotd/manage.py migrate --noinput"
    leader_only: true

Criar o usuário administrador

from django.core.management.base import BaseCommand
from django.contrib.auth.models import User


class Command(BaseCommand):

    def handle(self, *args, **options):
        if not User.objects.filter(username="admin").exists():
            User.objects.create_superuser("admin", "[email protected]", "admin")

└─ management
    ├── __init__.py
    └── commands
        ├── __init__.py
        └── createsu.py

02_createsu:
  command: "source /opt/python/run/venv/bin/activate && python iotd/manage.py createsu"
  leader_only: true

Arquivos estáticos

03_collectstatic:
  command: "source /opt/python/run/venv/bin/activate && python iotd/manage.py collectstatic --noinput"

container_commands:
  01_migrate:
    command: "source /opt/python/run/venv/bin/activate && python iotd/manage.py migrate --noinput"
    leader_only: true
  02_createsu:
    command: "source /opt/python/run/venv/bin/activate && python iotd/manage.py createsu"
    leader_only: true
  03_collectstatic:
    command: "source /opt/python/run/venv/bin/activate && python iotd/manage.py collectstatic --noinput"

option_settings:
  "aws:elasticbeanstalk:application:environment":
    DJANGO_SETTINGS_MODULE: "iotd.settings"
    "PYTHONPATH": "/opt/python/current/app/iotd:$PYTHONPATH"
    "ALLOWED_HOSTS": ".elasticbeanstalk.com"
  "aws:elasticbeanstalk:container:python":
    WSGIPath: iotd/iotd/wsgi.py
    NumProcesses: 3
    NumThreads: 20
  "aws:elasticbeanstalk:container:python:staticfiles":
    "/static/": "www/static/"

STATIC_ROOT = os.path.join(BASE_DIR, "..", "www", "static")
STATIC_URL = '/static/'

INFO: Environment update is starting.
INFO: Deploying new version to instance(s).
INFO: New application version was deployed to running EC2 instances.
INFO: Environment update completed successfully.

Usando S3 para armazenamento de mídia

1. Criar um bucket
2. Pegue o ARN do seu usuário (Amazon Resource Name)
3. Adicionar permissões de bucket
4. Configure seu aplicativo Django para usar o S3 para servir seus arquivos estáticos

Configuração do Apache

container_commands:
  01_setup_apache:
    command: "cp .ebextensions/enable_mod_deflate.conf /etc/httpd/conf.d/enable_mod_deflate.conf"

# mod_deflate configuration
<IfModule mod_deflate.c>
  # Restrict compression to these MIME types
  AddOutputFilterByType DEFLATE text/plain
  AddOutputFilterByType DEFLATE text/html
  AddOutputFilterByType DEFLATE application/xhtml+xml
  AddOutputFilterByType DEFLATE text/xml
  AddOutputFilterByType DEFLATE application/xml
  AddOutputFilterByType DEFLATE application/xml+rss
  AddOutputFilterByType DEFLATE application/x-javascript
  AddOutputFilterByType DEFLATE text/javascript
  AddOutputFilterByType DEFLATE text/css
  # Level of compression (Highest 9 - Lowest 1)
  DeflateCompressionLevel 9
  # Netscape 4.x has some problems.
  BrowserMatch ^Mozilla/4 gzip-only-text/html
  # Netscape 4.06-4.08 have some more problems
  BrowserMatch ^Mozilla/4\.0[678] no-gzip
  # MSIE masquerades as Netscape, but it is fine
  BrowserMatch \bMSI[E] !no-gzip !gzip-only-text/html
<IfModule mod_headers.c>
  # Make sure proxies don't deliver the wrong content
  Header append Vary User-Agent env=!dont-vary
</IfModule>
</IfModule>

Solução de problemas

• /opt/python :raiz de onde seu aplicativo terminará.
• /opt/python/current/app :o aplicativo atual que está hospedado no ambiente.
• /opt/python/on-deck/app :O aplicativo é inicialmente colocado no deck e, depois que toda a implantação estiver concluída, ele será movido para current . Se você estiver recebendo falhas em seus container_commands , confira o on-deck pasta e não a pasta current pasta.
• /opt/python/current/env :Todas as variáveis ​​de ambiente que eb configurará para você. Se você estiver tentando reproduzir um erro, talvez seja necessário primeiro source /opt/python/current/env para configurar as coisas como seriam quando eb deploy estiver em execução.
• opt/python/run/venv :O ambiente virtual usado pelo seu aplicativo; você também precisará executar source /opt/python/run/venv/bin/activate se você estiver tentando reproduzir um erro.

Conclusão