Condividi tramite


Configurare app Web Python per IIS

Quando si usa Internet Information Services (IIS) come server Web in un computer Windows (incluse le macchine virtuali Windows in Azure), è necessario configurare l'applicazione Web Python per consentire a IIS di elaborare correttamente il codice Python. La configurazione viene eseguita tramite le impostazioni nel web.config file per l'app Web Python. Questo articolo descrive come configurare le impostazioni necessarie.

Prerequisiti

  • Python in Windows installato. Per eseguire un'app Web, installare prima di tutto la versione di Python necessaria direttamente nel computer host Windows come descritto in Installare gli interpreti Python.

    • Identificare la posizione dell'interprete python.exe . Per comodità, aggiungere quindi tale percorso alla variabile di ambiente PATH.
  • Pacchetti necessari installati. Per un host dedicato, è possibile usare l'ambiente Python globale per eseguire l'app anziché un ambiente virtuale. Di conseguenza, è possibile installare tutti i requisiti dell'app nell'ambiente globale eseguendo il pip install -r requirements.txt comando .

Configurare web.config per fare riferimento all'interprete di Python

Il web.config file per l'applicazione Python indica al server Web IIS (versione 7 o successiva) in esecuzione in Windows il modo in cui deve gestire le richieste Python tramite HttpPlatformHandler (scelta consigliata) o FastCGI. Visual Studio versioni 2015 e precedenti apportano automaticamente queste modifiche. Per Visual Studio 2017 e versioni successive, è necessario modificare manualmente il web.config file.

Se il progetto non contiene già un web.config file, è possibile aggiungerne uno facendo clic con il pulsante destro del mouse sulla directory del progetto, selezionando Aggiungi > nuovo elemento e cercando web.config o creando un file XML vuoto web.config .

Opzione 1: Configurare HttpPlatformHandler

Il modulo HttpPlatform passa le connessioni socket direttamente a un processo di Python autonomo. Questo pass-through consente di eseguire qualsiasi server Web desiderato, ma richiede uno script di avvio che esegue un server Web locale. Questo approccio viene in genere eseguito usando un framework Web Python, ad esempio Flask o Django. Specificare lo script nell'elemento <httpPlatform> del web.config file. L'attributo processPath punta all'interprete Python dell'estensione del sito. L'attributo arguments punta allo script di avvio che esegue un server Web locale, in questo caso runserver.pye qualsiasi argomento da fornire:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <system.webServer>
    <handlers>
      <add name="PythonHandler" path="*" verb="*" modules="httpPlatformHandler" resourceType="Unspecified"/>
    </handlers>
    <httpPlatform processPath="c:\python36-32\python.exe"
                  arguments="c:\home\site\wwwroot\runserver.py --port %HTTP_PLATFORM_PORT%"
                  stdoutLogEnabled="true"
                  stdoutLogFile="c:\home\LogFiles\python.log"
                  startupTimeLimit="60"
                  processesPerApplication="16">
      <environmentVariables>
        <environmentVariable name="SERVER_PORT" value="%HTTP_PLATFORM_PORT%" />
      </environmentVariables>
    </httpPlatform>
  </system.webServer>
</configuration>

In questo esempio la HTTP_PLATFORM_PORT variabile di ambiente contiene la porta su cui il server locale deve restare in ascolto per le connessioni da localhost. Questo esempio illustra anche come creare un'altra variabile di ambiente, SERVER_PORT. È possibile creare e assegnare variabili di ambiente in base alle esigenze.

Opzione 2: Configurare il gestore FastCGI

In alternativa, è possibile usare FastCGI per configurare le app. FastCGI è un'interfaccia che funziona a livello di richiesta. IIS riceve le connessioni in ingresso e inoltra ogni richiesta a un'app WSGI in esecuzione in uno o più processi Python persistenti.

Nota

Sebbene sia possibile configurare il progetto usando FastCGI, è consigliabile usare HttpPlatformHandler per configurare le app, perché il progetto WFastCGI non viene più gestito e potrebbe causare bug.

Per usare FastCGI, installare e configurare innanzitutto il pacchetto wfastcgi come descritto in pypi.org/project/wfastcgi/.

Modificare quindi il file dell'applicazione web.config in modo da includere i percorsi completi del python.exe file eseguibile e il wfastcgi.py file nella PythonHandler chiave. I passaggi seguenti presuppongono che Python sia installato nella cartella c:\python36-32 e che il codice dell'app si trova nella cartella c:\home\site\wwwroot . Modificare questi valori per i percorsi di conseguenza.

  1. Modificare la PythonHandler voce nel web.config file in modo che il percorso corrisponda al percorso di installazione di Python. Per altre informazioni, vedere Informazioni di riferimento sulla configurazione di IIS (iis.net).

    <system.webServer>
       <handlers>
         <add name="PythonHandler" path="*" verb="*" modules="FastCgiModule"
             scriptProcessor="c:\python36-32\python.exe|c:\python36-32\wfastcgi.py"
             resourceType="Unspecified" requireAccess="Script"/>
       </handlers>
    </system.webServer>
    
  2. All'interno della <appSettings> sezione del web.config file aggiungere chiavi per WSGI_HANDLER, WSGI_LOG (facoltativo) e PYTHONPATH:

    <appSettings>
       <add key="PYTHONPATH" value="c:\home\site\wwwroot"/>
       <!-- The handler here is specific to Bottle; see the next section. -->
       <add key="WSGI_HANDLER" value="app.wsgi_app()"/>
       <add key="WSGI_LOG" value="c:\home\LogFiles\wfastcgi.log"/>
    </appSettings>
    

    Questi valori di <appSettings> sono disponibili come variabili di ambiente per l'app:

    • Il valore per la PYTHONPATH chiave può essere esteso liberamente, ma deve includere la radice dell'app.
    • La WSGI_HANDLER chiave deve puntare a un'app WSGI importabile dall'app.
    • La WSGI_LOG chiave è facoltativa, ma la chiave è consigliata per il debug dell'app.
  3. Impostare la WSGI_HANDLER voce nel web.config file in base alle esigenze del framework in uso:

    • Bottle: aggiungere parentesi dopo il app.wsgi_app valore come illustrato in questo esempio. Le parentesi sono necessarie perché l'oggetto è una funzione anziché una variabile. È possibile visualizzare la sintassi nel app.py file .

      <!-- Bottle apps only -->
      <add key="WSGI_HANDLER" value="app.wsgi_app()"/>
      
    • Flask: modificare il valore WSGI_HANDLER in <project_name>.app dove <project_name> corrisponde al nome del progetto. È possibile trovare l'identificatore esatto esaminando l'istruzione from <project_name> import app nel runserver.py file. Ad esempio, se il progetto è denominato FlaskAzurePublishExample, la voce viene visualizzata come segue:

      <!-- Flask apps only: Change the project name to match your app -->
      <add key="WSGI_HANDLER" value="FlaskAzurePublishExample.app"/>
      
    • Django: sono necessarie due modifiche al file per i web.config progetti Django.

      • Modificare il WSGI_HANDLER valore in django.core.wsgi.get_wsgi_application(). L'oggetto si trova nel wsgi.py file.

        <!-- Django apps only -->
        <add key="WSGI_HANDLER" value="django.core.wsgi.get_wsgi_application()"/>
        
      • Aggiungere la voce seguente subito dopo la voce per la WSGI_HANDLER chiave. Sostituire il valore DjangoAzurePublishExample con il nome del progetto:

        <add key="DJANGO_SETTINGS_MODULE" value="django_iis_example.settings" />
        
  4. Solo app Django: nel file del settings.py progetto Django aggiungere il dominio o l'indirizzo IP dell'URL del ALLOWED_HOSTS sito alla voce. Sostituire '1.2.3.4' con l'URL o l'indirizzo IP:

    # Change the URL or IP address to your specific site
    ALLOWED_HOSTS = ['1.2.3.4']
    

    Se non si aggiunge l'URL ai risultati della matrice, viene visualizzato l'errore seguente:

    DisallowedHost at / Invalid HTTP_HOST header: '\<site URL\>'. You might need to add '\<site URL\>' to ALLOWED_HOSTS.
    

Quando la matrice è vuota, Django consente 'localhost' automaticamente e '127.0.0.1' come host. Se si aggiunge l'URL di produzione, questi siti host non sono consentiti automaticamente. Per questo motivo, è possibile mantenere copie separate di sviluppo e produzione del settings.py file oppure usare le variabili di ambiente per controllare i valori di runtime.

Eseguire la distribuzione in IIS o in una macchina virtuale Windows

Quando si dispone del file corretto web.config nel progetto, è possibile pubblicare nel computer che esegue IIS da Esplora soluzioni. Fare clic con il pulsante destro del mouse sul progetto, scegliere Pubblica, quindi selezionare IIS, FTP e così via. In questo caso, Visual Studio copia solo i file di progetto nel server. Si è responsabili di tutte le configurazioni lato server.