Devi definire un server web che utilizzi le API che hai creato. Cloud Endpoints Frameworks per Python implementa l'interfaccia di gateway del server web (WSGI) standard per inoltrare le richieste all'API ai metodi nel codice.
Come per ogni applicazione in esecuzione su App Engine, devi creare un file chiamato app.yaml
in cui configurare le impostazioni dell'app App Engine. Per definire il server web, apporta modifiche al file app.yaml
.
Per definire un server web:
Crea un modulo Python, ad esempio
main.py
, e un oggettoendpoints.api_server
di primo livello:Il codice
api = endpoints.api_server([EchoApi])
crea un'applicazione WSGI che inoltra le richieste API ai metodi della classeEchoAPI
.Puoi fornire un elenco di oggetti
remote.Service
(definiti quando hai creato l'API) aendpoints.api_server
. Se hai un'API implementata in più classi, l'oggettoremote.Service
è una raccolta di classi come descritto in Creazione di un'API implementata con più classi.La creazione di un modulo separato per l'oggetto
endpoints.api_server
dipende dal fatto che tu abbia creato una singola API o più API.Se hai creato più API (utilizzando più sottoclassi
remote.Service
) definite in più file, ti consigliamo di creare un modulo separato per l'oggettoendpoints.api_server
in modo da poter importare tutti i file di classe.Se hai creato una singola API, puoi aggiungere il codice
endpoints.api_server
richiesto al modulo in cui definisci l'API perché non devi importare altre classi.
Nel file
app.yaml
, mappa il server web appena creato alla posizione di Cloud Endpoints come segue:dove
main
è il modulo Python in cui hai definito l'oggettoendpoints.api_server
.
Pubblicazione dell'API da un percorso diverso
(Facoltativo) Per pubblicare l'API da un percorso diverso, ad esempio /api/
:
Modifica il decoratore:
@endpoints.api(name='echo', version='v1', base_path='/api/')
Modifica la sezione
handlers
nel fileapp.yaml
:handlers: - url: /api/.* script: main.api
Logging in Endpoints Frameworks per Python
Endpoints Frameworks per Python utilizza il modulo di logging Python standard per registrare informazioni sullo stato e sul ciclo di vita delle richieste dell'applicazione. Per scoprire di più sui log di App Engine e su come visualizzarli, consulta Lettura e scrittura dei log delle applicazioni nella documentazione di App Engine.
Il modulo di logging di Python fornisce livelli di log predefiniti. In ordine crescente di gravità, i livelli di log sono:
Livello di log | Descrizione |
---|---|
DEBUG |
Fornisce log dettagliati. In genere, questo livello viene impostato solo per la risoluzione dei problemi. |
INFO |
Il livello di log predefinito per Endpoints Frameworks. Consente di monitorare l'avanzamento dell'applicazione a livello generale. |
WARNING |
Ti avvisa che si è verificato un problema imprevisto, ma l'applicazione può recuperare ed eseguire normalmente. |
ERROR |
Ti avvisa che si è verificato un errore che potrebbe causare una perdita di funzionalità, ma l'applicazione è ancora in esecuzione. |
CRITICAL |
Ti avvisa che si è verificato un errore o un evento grave che potrebbe causare l'arresto dell'applicazione. |
I logger esistono in una gerarchia separata da punti. Ad esempio, il loggerendpoints.api_config
è un elemento figlio del logger endpoints
. Questa gerarchia consente di avere un controllo preciso sui log che vengono emessi o eliminati. In genere,
modifichi solo i due logger principali per i framework di Endpoints:
endpoints
e endpoints_management
.
Attiva il logging di DEBUG
per i framework di endpoint
Per evitare di sovraccaricare il lettore di log, Endpoints Frameworks imposta i suoi logger in modo da registrare solo le voci di log con il livello INFO
o superiore. In qualsiasi
momento dopo l'importazione di Endpoints Frameworks nel modulo,
puoi modificare il livello di log come segue:
import logging
logging.getLogger('endpoints').setLevel(logging.DEBUG)
logging.getLogger('endpoints_management').setLevel(logging.DEBUG)
Il metodo setLevel
imposta il livello minimo di log per il logger.