QuickStart: distribuisci un'applicazione Python su Elastic Beanstalk

Questo QuickStart tutorial illustra il processo di creazione di un'applicazione Python e la sua distribuzione in un ambiente. AWS Elastic Beanstalk

Non per uso in produzione

Gli esempi sono solo a scopo dimostrativo. Non utilizzare applicazioni di esempio in produzione.

Vostro AWS account

Se non sei già AWS cliente, devi creare un AWS account. La registrazione ti consente di accedere a Elastic Beanstalk AWS e ad altri servizi di cui hai bisogno.

Se hai già un AWS account, puoi passare a. Prerequisiti

Crea un AWS account

Iscriviti a un Account AWS

Per iniziare AWS, hai bisogno di un Account AWS. Per informazioni sulla creazione di un Account AWS, vedi Guida introduttiva a un Account AWS nella Guida Gestione dell'account AWS di riferimento.

Prerequisiti

Per seguire le procedure in questa guida, devi usare un terminale a riga di comando o una shell per eseguire i comandi. I comandi vengono visualizzati in elenchi preceduti da un simbolo di prompt ($) e dal nome della directory corrente, se appropriato.

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

Su Linux e macOS usa la tua shell e il tuo programma di gestione dei pacchetti preferiti. Su Windows puoi installare il sottosistema Windows per Linux per ottenere una Windows-integrated versione di Ubuntu e Bash.

CLI EB

Questo tutorial utilizza l'interfaccia a riga di comando di Elastic Beanstalk (CLI EB). Per istruzioni dettagliate su come configurare e utilizzare la CLI EB, consulta Installa EB CLI con lo script di configurazione (consigliato) e Configurazione dell'interfaccia a riga di comando EB.

Framework Python e Flask

Conferma di avere una versione di Python funzionante con pip installata eseguendo i seguenti comandi.

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

Se uno dei comandi precedenti restituisce «Python was not found «, esegui i seguenti comandi che use python invece di. python3 La configurazione degli alias e dei collegamenti simbolici può variare in base al sistema operativo e alle singole personalizzazioni, pertanto il python3 comando potrebbe non funzionare sul computer.

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

Se non hai Python installato sul tuo computer locale, puoi scaricarlo dalla pagina dei download di Python sul sito Web di Python. Per un elenco delle versioni del linguaggio Python supportate da Elastic Beanstalk, consulta Piattaforme Python supportate nella guida Piattaforme.AWS Elastic Beanstalk Il sito Web per i download di Python fornisce un collegamento alla Python Developer's Guide, dove troverai le istruzioni di installazione e configurazione.

Nota

Il pip pacchetto Python è incluso di default in Python 3.4 o versioni successive.

Se l'output indica che disponi di una versione supportata di Python, ma non lo èpip, consulta la pagina di installazione sul sito Web pip.pypa.io. Fornisce indicazioni per installare pip in un ambiente Python che non lo dispone.

Conferma se Flask è installato eseguendo il seguente comando:

~$ pip list | grep Flask

Se Flask non è installato, puoi installarlo con il seguente comando:

~$ pip install Flask

Fase 1: Creare un'applicazione Python

Crea una directory di progetto.

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

Crea un esempio di «Hello Elastic Beanstalk!» Applicazione Python che distribuirai utilizzando Elastic Beanstalk.

Crea un file di testo denominato application.py nella directory appena creata con i seguenti contenuti.

Esempio~/eb- .py python/application

from flask import Flask
application = Flask(__name__)

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

Crea un file di testo denominato requirements.txt con la riga seguente. Questo file contiene i pip pacchetti necessari per l'esecuzione dell'applicazione.

Esempio~/eb- .txt python/requirements

Flask

Fase 2: Esegui l'applicazione localmente

Esegui il comando seguente per eseguire l'applicazione localmente.

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

Dovresti vedere un output simile al seguente

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 -

Accedi a http://localhost:5000 nel tuo browser web. Il browser Web dovrebbe visualizzare «Hello Elastic Beanstalk!».

Passaggio 3: distribuisci la tua applicazione Python con l'EB CLI

Esegui i seguenti comandi per creare un ambiente Elastic Beanstalk per questa applicazione.

Per creare un ambiente e distribuire la tua applicazione Python

1. Inizializza il repository della CLI EB con il comando eb init.

   ~/eb-python$ eb init -p python-3.9 python-tutorial --region us-east-2

   Questo comando crea un'applicazione denominata python-tutorial e configura il repository locale per creare ambienti con la versione della piattaforma Python fornita.

2. (Facoltativo) Esegui nuovamente eb init per configurare una coppia di chiavi predefinite e connetterti all'istanza EC2 che esegue l'applicazione.

   ~/eb-python$ eb init
   Do you want to set up SSH for your instances?
   (y/n): y
   Select a keypair.
   1) my-keypair
   2) [ Create new KeyPair ]

   Seleziona una coppia di chiavi se ne hai già una, oppure segui le istruzioni per creare una nuova. Se il prompt non è visualizzato o devi modificare le impostazioni in seguito, esegui eb init -i.

3. Crea un ambiente e distribuisci in esso l'applicazione con eb create: Elastic Beanstalk crea automaticamente un file zip per l'applicazione e lo avvia sulla porta 5000.

   ~/eb-python$ eb create python-env

   Elastic Beanstalk impiega circa cinque minuti per creare l'ambiente.

Fase 4: Esegui l'applicazione su Elastic Beanstalk

Una volta completato il processo di creazione dell'ambiente, apri il sito Web con. eb open

~/eb-python$ eb open

Complimenti! Hai distribuito un'applicazione Python con Elastic Beanstalk! Si aprirà una finestra del browser che utilizza il nome di dominio creato per l'applicazione.

Fase 5: rimozione

Puoi chiudere il tuo ambiente quando finisci di lavorare con l'applicazione. Elastic Beanstalk AWS interrompe tutte le risorse associate all'ambiente.

Per terminare l'ambiente Elastic Beanstalk con l'EB CLI, esegui il comando seguente.

~/eb-python$ eb terminate

AWS risorse per la tua applicazione

Hai appena creato un'applicazione a istanza singola. Funge da semplice applicazione di esempio con una singola istanza EC2, quindi non richiede il bilanciamento del carico o la scalabilità automatica. Per le applicazioni a istanza singola Elastic Beanstalk crea le seguenti risorse: AWS

• Istanza EC2: una macchina virtuale di Amazon EC2 configurata per eseguire applicazioni Web sulla piattaforma selezionata.

  Ogni piattaforma esegue un insieme diverso di software, file di configurazione e script per supportare una versione della lingua, un framework, un container Web specifici o una determinata combinazione di tutti questi elementi. La maggior parte delle piattaforme utilizza Apache o nginx come proxy inverso che elabora il traffico web su cui viene eseguita l'app Web, inoltra le richieste all'app, fornisce asset statici e genera log degli accessi e di errore.

• Gruppo di sicurezza istanze: un gruppo di sicurezza di Amazon EC2 configurato per abilitare il traffico in entrata sulla porta 80. Questa risorsa consente al traffico TTP proveniente dal load balancer di raggiungere l'istanza EC2 in esecuzione sull'app Web. Per impostazione predefinita, il traffico non è consentito su altre porte.

• Bucket Amazon S3: posizione di storage per il codice sorgente, i log e altri artefatti creati quando si utilizza Elastic Beanstalk.

• CloudWatch Allarmi Amazon: due CloudWatch allarmi che monitorano il carico sulle istanze nel tuo ambiente e vengono attivati se il carico è troppo alto o troppo basso. Quando viene attivato un allarme, il gruppo Auto Scaling aumenta o diminuisce di conseguenza.

• CloudFormation stack: Elastic CloudFormation Beanstalk utilizza per avviare le risorse nell'ambiente e propagare le modifiche alla configurazione. Le risorse sono definite in un modello, visualizzabile nella console CloudFormation.

• Nome di dominio: un nome di dominio che indirizza alla tua app Web nel modulo. subdomain region.elasticbeanstalk.com.

Elastic Beanstalk gestisce tutte queste risorse. Quando arresti l'ambiente, Elastic Beanstalk termina tutte le risorse che contiene.

Fasi successive

Quando disponi di un'applicazione in esecuzione in un ambiente, puoi distribuire una nuova versione dell'applicazione o un'applicazione diversa in qualsiasi momento. La distribuzione di una nuova versione dell'applicazione è molto veloce perché non richiede il provisioning o il riavvio delle istanze EC2. Puoi anche esplorare il tuo nuovo ambiente utilizzando la console Elastic Beanstalk. Per i passaggi dettagliati, consulta Esplora il tuo ambiente nel capitolo Guida introduttiva di questa guida.

Prova altri tutorial

Se desideri provare altri tutorial con diverse applicazioni di esempio, consulta i seguenti tutorial:

• Implementazione di un'applicazione Flask in Elastic Beanstalk

• Distribuzione di un'applicazione Django in Elastic Beanstalk

Dopo aver distribuito una o due applicazioni di esempio e essere pronti per iniziare a sviluppare ed eseguire applicazioni Python localmente, vedi. Configurazione dell'ambiente di sviluppo Python per Elastic Beanstalk

Esegui la distribuzione con la console Elastic Beanstalk

Puoi anche utilizzare la console Elastic Beanstalk per avviare l'applicazione di esempio. Per i passaggi dettagliati, consulta Creare un'applicazione di esempio nel capitolo Guida introduttiva di questa guida.