Il traffico dai socket viene fatturato come larghezza di banda in uscita. IO asincrono (ad esempio Twisted in Python) non è supportato. App Engine supporta l'API del modulo socket Python standard per il traffico in uscita solo prese di corrente. Basta importare la libreria socket standard utilizzando il seguente :
import socket
Librerie che importano socket
, ad esempio
poplib
o nntplib
e che non violano le
limitazioni e restrizioni elencate
di seguito, dovrebbe funzionare senza modifiche.
Sebbene il runtime Python 2 supporti i socket, ci sono alcune limitazioni e comportamenti da tenere presenti quando si utilizzano i socket.
Puoi prelevare un descrittore socket e passarlo tra App Engine ad esempio parte di un payload per l'attività. In questo scenario, puoi aprire una nel socket di un'istanza di frontend per poi passarlo a un'istanza di backend e utilizzarlo là.
Nelle versioni dell'SDK precedenti alla 1.8.1, puoi: non chiamare le opzioni get/set con i socket. (Questo risultato è stato sollevato come "Non implementato" exceptions.) Tuttavia, l'API Sockets ora consente questa operazione.
Per le opzioni supportate,
le chiamate a getsockopt
restituiranno un valore fittizio
le chiamate al numero setsockopt
verranno ignorate senza alcun avviso. Gli errori continueranno a essere
generati per le opzioni non supportate.
Le opzioni supportate sono:
SO_KEEPALIVE
SO_DEBUG
TCP_NODELAY
SO_LINGER
SO_OOBINLINE
SO_SNDBUF
SO_RCVBUF
SO_REUSEADDR
Limitazioni e restrizioni
Il supporto dei socket in App Engine presenta le seguenti limitazioni:
- Non puoi creare un socket di ascolto. puoi solo creare socket in uscita.
- L'FTP non è supportato.
- Per impostazione predefinita, l'app
httplib
è configurata in modo da utilizzare urlfetch api; se devi usasocket
per aggirare i limiti di urlfetch, puoi farlo modificando questo predefinita, quindihttplib
usa i socket. Per ulteriori informazioni, vedi Fai usare ahttplib
i socket. - Puoi utilizzare solo TCP o UDP. non sono consentiti protocolli arbitrari.
- Non puoi eseguire l'associazione a indirizzi IP o porte specifici.
- La porta 25 (SMTP) è bloccata. puoi comunque utilizzare SMTP autenticato porta di invio 587.
Gli intervalli IP privati, di trasmissione, multicast e di Google sono bloccati, ad eccezione di quelle elencate di seguito:
- Google Public DNS:
8.8.8.8
,8.8.4.4
,2001:4860:4860::8888
, Porta 532001:4860:4860::8844
- SMTPS di Gmail:
smtp.gmail.com
porta 465 e 587 - POP3S di Gmail:
pop.gmail.com
porta 995 - IMAPS di Gmail:
imap.gmail.com
porta 993
- Google Public DNS:
I descrittori del socket sono associati all'app App Engine che li hai creati e non sono trasferibili (non possono essere utilizzati da altre app).
I socket possono essere ripristinati dopo 10 minuti di inattività. qualsiasi operazione socket mantiene in funzione la presa per altri 10 minuti.
Attualmente,
socket.gethostbyaddr()
non è implementato in Python. Puoi comunque utilizzare la libreria standard SMTP di Python (smtplib
) per aprire una connessione:# Open a connection to my mail server s = smtplib.SMTP('smtp.mailhostingcompany.net', 587)
Utilizzo dei socket con il server di sviluppo
Puoi eseguire e testare il codice utilizzando socket sul server di sviluppo, senza utilizzare parametri speciali della riga di comando.
Utilizzo di socket con OpenSSL
App Engine supporta Python OpenSSL nativo per il runtime Python 2.7.
Devi configurare il file app.yaml
per caricare la libreria SSL, come descritto in
Supporto OpenSSL.
Disattivare il recupero URL per evitare la gestione di tutte le richieste in uscita
Se importi httplib
, per impostazione predefinita verrà utilizzata la classe
API urlfetch. Per modificare questa impostazione
in modo che httplib
usi i socket, aggiungi la seguente variabile di ambiente
al tuo file app.yaml
:
env_variables:
GAE_USE_SOCKETS_HTTPLIB : 'anyvalue'
Puoi sostituire anyvalue
con qualsiasi valore, inclusa una stringa vuota.
Esempio di App Engine che utilizza i socket
Per un esempio sull'utilizzo dei socket, vedi la demo dei socket app nel GitHub di Google Cloud.