Início rápido: implantar uma aplicação Python no Elastic Beanstalk

Este tutorial de início rápido orienta no processo de criação de uma aplicação Python e sua implantação em um ambiente AWS Elastic Beanstalk.

Sua conta da AWS

Se você ainda não for um cliente da AWS, será necessário criar uma conta da AWS. O cadastro habilita o acesso ao Elastic Beanstalk e outros serviços necessários da AWS.

Se você já tem uma conta da AWS, pode prosseguir para Pré-requisitos.

Pré-requisitos

Para seguir os procedimentos neste manual, você precisa de um terminal de linha de comando ou de um shell para executar os comandos. Nas listagens, os comandos são mostrados precedidos por um símbolo de prompt ($) e pelo nome do diretório atual, quando apropriado.

~/eb-project$ this is a command
this is output

No Linux e no macOS, você pode usar seu gerenciador de pacotes e de shell preferido. No Windows, você pode instalar o subsistema Windows para Linux para obter uma versão do Ubuntu e Bash integrada ao Windows.

EB CLI

Este tutorial também usa a Interface de Linhas de Comando do Elastic Beanstalk (CLI do EB). Para obter detalhes sobre a instalação e configuração da CLI do EB, consulte Instalar a interface de linha de comando do Elastic Beanstalk e Configurar a EB CLI.

Framework Python e Flask

Confirme que você tem uma versão funcional do Python com o pip instalado, executando os seguintes comandos.

~$ python3 --version
Python 3.N.N
>~$ python3 -m pip --version
pip X.Y.Z from ... (python 3.N.N)

Se algum dos comandos anteriores retornar "Python não encontrado", execute os seguintes comandos que usam python em vez de python3. A configuração de aliases e links simbólicos pode variar de acordo com o sistema operacional e as personalizações individuais, portanto, o comando python3 pode não funcionar no seu computador.

~$ python --version
Python 3.N.N
>~$ python -m pip --version
pip X.Y.Z from ... (python 3.N.N)

Se você não tiver o Python instalado no computador local, poderá baixá-lo na página de downloads do Python no site do Python. Para obter uma lista das versões da linguagem Python compatíveis com o Elastic Beanstalk, consulte Plataformas Python compatíveis no guia de Plataformas do AWS Elastic Beanstalk. O site de downloads do Python fornece um link para o Guia do desenvolvedor do Python, onde você encontrará instruções de instalação e configuração.

Se o resultado indicar que você tem uma versão compatível do Python, mas não pip, consulte a página de instalação no site pip.pypa.io. Ele fornece orientação para instalar o pip em um ambiente Python que não o tenha.

Confirme se o Flask está instalado executando o seguinte comando:

~$ pip list | grep Flask

Se o Flask não estiver instalado, você poderá instalá-lo com o seguinte comando:

~$ pip install Flask

Etapa 1: criar uma aplicação Python

Crie um diretório do projeto.

~$ mkdir eb-python
~$ cd eb-python

Crie um exemplo de "Hello Elastic Beanstalk!" Aplicação Python que você implantará usando o Elastic Beanstalk.

Crie um arquivo de texto application.py no diretório que você acabou de criar com o seguinte conteúdo.

from flask import Flask
application = Flask(__name__)

@application.route('/')
def hello_elastic_beanstalk():
        return 'Hello Elastic Beanstalk!'

Crie um arquivo de texto requirements.txt com a seguinte linha. Esse arquivo contém os pacotes pip necessários para a execução da aplicação.

Flask

Etapa 2: executar a aplicação localmente

Execute o seguinte comando para executar sua aplicação localmente.

~/eb-python$ export FLASK_APP=application.py && flask run --port 5000

Você deve ver saída semelhante ao seguinte

Serving Flask app 'application.py'
Debug mode: off
WARNING: This is a development server. Do not use it in a production deployment. Use a production WSGI server instead.
Running on http://127.0.0.1:5000
Press CTRL+C to quit
127.0.0.1 - - [01/Jan/1970 00:00:00] "GET / HTTP/1.1" 200 -

Navegue até http://localhost:5000 no seu navegador da Web. O navegador deve exibir “Hello Elastic Beanstalk!”.

Etapa 3: implantar sua aplicação Python com a EB CLI

Execute os seguintes comandos para criar um ambiente Elastic Beanstalk para essa aplicação.

Etapa 4: executar a aplicação no Elastic Beanstalk

Quando o processo de criação de seu ambiente for concluído, abra seu site com eb open.

~/eb-python$ eb open

Parabéns! Você implantou uma aplicação Python com o Elastic Beanstalk! Isso abre uma janela do navegador usando o nome de domínio criado para o seu aplicativo.

Etapa 5: limpar

Você pode encerrar o ambiente quando terminar de trabalhar com a aplicação. O Elastic Beanstalk encerra todos os recursos da AWS associados ao seu ambiente.

Para encerrar seu ambiente do Elastic Beanstalk com a CLI do EB, execute o seguinte comando.

~/eb-python$ eb terminate

Recursos da AWS para sua aplicação

Você acabou de criar uma aplicação de instância única. Ela serve como uma aplicação de exemplo simples com uma única instância do EC2 e, portanto, não requer balanceamento de carga ou ajuste de escala automático. Para aplicações de instância única, o Elastic Beanstalk cria os seguintes recursos da AWS:

O Elastic Beanstalk gerencia todos esses recursos. Quando você encerra o ambiente, o Elastic Beanstalk encerra todos os recursos dele.

Próximas etapas

Depois que um ambiente estiver executando um aplicativo, você poderá implantar uma nova versão do aplicativo ou um aplicativo diferente a qualquer momento. A implantação de uma nova versão do aplicativo é muito rápida, pois não é necessário provisionar ou reiniciar as instâncias do EC2. Também é possível explorar o novo ambiente usando o console do Elastic Beanstalk. Para conhecer as etapas detalhadas, consulte Explore seu ambiente, no capítulo Primeiros passos deste guia.

Depois de implantar um ou dois aplicações de amostra e estiver pronto para começar a desenvolver e executar aplicações Python localmente, consulte Configurar seu ambiente de desenvolvimento Python para o Elastic Beanstalk.

Implantar com o console do Elastic Beanstalk

Você também pode usar o console do Elastic Beanstalk para iniciar a aplicação de exemplo. Para conhecer as etapas detalhadas, consulte Criar uma aplicação de exemplo, no capítulo Primeiros passos deste guia.