Condividi tramite

Guida introduttiva: Creare e distribuire un'app Web Python da GitHub Codespaces in Azure usando un modello dell'interfaccia della riga di comando per sviluppatori di Azure

  • Articolo

Questa guida introduttiva illustra il modo più semplice e rapido per creare e distribuire una soluzione Web e di database Python in Azure. Seguendo le istruzioni riportate in questa guida introduttiva, si eseguiranno le operazioni seguenti:

  • Scegliere un modello dell'interfaccia della riga di comando per sviluppatori di Azure (azd) basato sul framework Web Python, sulla piattaforma di database di Azure e sulla piattaforma di hosting Web di Azure su cui si vuole eseguire la compilazione.
  • Creare un nuovo codice GitHub Codespace contenente il azd codice generato dal modello selezionato.
  • Usare GitHub Codespaces e il terminale Bash di Visual Studio Code online. Il terminale consente di usare i comandi dell'interfaccia della riga di comando per sviluppatori di Azure per eseguire un azd modello per creare un'app Web e un database di esempio e creare e configurare le risorse di Azure necessarie, quindi distribuire l'app Web di esempio in Azure.
  • Modificare l'app Web in gitHub Codespace e usare un azd comando per ridistribuire.
  • Usare un azd comando per pulire le risorse di Azure.
  • Chiudere e riaprire GitHub Codespace.
  • Pubblicare il nuovo codice in un repository GitHub.

Il completamento di questa esercitazione richiede meno di 25 minuti. Al termine, è possibile iniziare a modificare il nuovo progetto con il codice personalizzato.

Per altre informazioni su questi azd modelli per lo sviluppo di app Web Python:

Prerequisiti

Importante

Sia GitHub Codespaces che Azure sono servizi basati su sottoscrizione a pagamento. Dopo alcuni allocamenti gratuiti, è possibile che vengano addebitati costi per l'uso di questi servizi. Seguendo questo argomento di avvio rapido è possibile influire su questi allocamenti o fatturazione. Quando possibile, i azd modelli sono stati compilati usando il livello di opzioni meno costoso, ma alcuni potrebbero non essere gratuiti. Usare il calcolatore prezzi di Azure per comprendere meglio i costi. Per altre informazioni, vedere Prezzi di GitHub Codespaces per altri dettagli.

Scegliere un modello e creare uno spazio di codice

Scegliere un azd modello basato sul framework Web Python, sulla piattaforma di hosting Web di Azure e sulla piattaforma di database di Azure su cui si vuole eseguire la compilazione.

  1. Nell'elenco seguente di modelli scegliere uno che usa le tecnologie da usare nella nuova applicazione Web.

    Template Web Framework Database Piattaforma di hosting Nuovo spazio di codice
    azure-django-postgres-flexible-aca Django Server flessibile PostgreSQL App contenitore di Azure Nuovo spazio di codice
    azure-django-postgres-flexible-appservice Django Server flessibile PostgreSQL Servizio app di Azure Nuovo spazio di codice
    azure-django-cosmos-postgres-aca Django Cosmos DB (adapter PostgreSQL) App contenitore di Azure Nuovo spazio di codice
    azure-django-cosmos-postgres-appservice Django Cosmos DB (adapter PostgreSQL) Servizio app di Azure Nuovo spazio di codice
    azure-django-postgres-addon-aca Django Componente aggiuntivo PostgreSQL per app Contenitore di Azure App contenitore di Azure Nuovo spazio di codice

  1. Per praticità, l'ultima colonna di ogni tabella contiene un collegamento che crea un nuovo codespace e inizializza il modello nell'account azd GitHub. Fare clic con il pulsante destro del mouse e selezionare "Apri in nuova scheda" nel collegamento "New Codespace" accanto al nome del modello selezionato per avviare il processo di installazione.

    Durante questo processo, potrebbe essere richiesto di accedere all'account GitHub e viene chiesto di confermare che si vuole creare codespace. Selezionare il pulsante "Crea codespace" per visualizzare la pagina "Configurazione dello spazio di codice".

  2. Dopo alcuni minuti, una versione basata sul Web di Visual Studio Code viene caricata in una nuova scheda del browser con il modello Web Python caricato come area di lavoro nella visualizzazione Explorer.

Eseguire l'autenticazione in Azure e distribuire il modello azd

Ora che si dispone di un codice GitHub Codespace contenente il codice appena generato, è possibile usare l'utilità azd dall'interno di Codespace per pubblicare il codice in Azure.

  1. In Visual Studio Code basato sul Web il terminale deve essere aperto per impostazione predefinita. In caso contrario, usare la chiave tilde ~ per aprire il terminale. Inoltre, per impostazione predefinita, il terminale deve essere un terminale bash. In caso contrario, passare a bash nell'area in alto a destra della finestra del terminale.

  2. Nel terminale bash immettere il comando seguente:

    azd auth login

    azd auth login avvia il processo di autenticazione di Codespace per l'account Azure.

    Start by copying the next code: XXXXXXXXX
Then press enter and continue to log in from your browser...

Waiting for you to complete authentication in the browser...

  3. Seguire le istruzioni, che includono:

    • Copia di un codice generato
    • Selezionando INVIO per aprire una nuova scheda del browser e incollando il codice nella casella di testo
    • Scelta dell'account Azure da un elenco
    • Conferma del tentativo di accesso all'interfaccia della riga di comando di Microsoft Azure

  4. Al termine, il messaggio seguente viene visualizzato di nuovo nella scheda Codespaces nel terminale:

    Device code authentication completed.
Logged in to Azure.

  5. Distribuire la nuova applicazione in Azure immettendo il comando seguente:

    azd up

    Durante questo processo, viene chiesto di:

    • Immettere un nuovo nome di ambiente
    • Selezionare una sottoscrizione di Azure da usare [Usare le frecce per spostare, digitare per filtrare]
    • Selezionare un percorso di Azure da usare: [Usare le frecce per spostare, digitare per filtrare]

    Dopo aver risposto a queste domande, l'output di azd indica che la distribuzione è in corso.

    Importante

    Al azd up termine, l'app Web di esempio sarà disponibile su Internet pubblico e la sottoscrizione di Azure inizierà ad accumulare addebiti per tutte le risorse create. I creatori dei azd modelli hanno scelto intenzionalmente livelli economici, ma non necessariamente livelli gratuiti , poiché i livelli gratuiti spesso hanno una disponibilità limitata. Al termine dell'uso dell'app Web di esempio, usare azd down per rimuovere tutti i servizi creati da azd up.

    Seguire le istruzioni quando viene richiesto di scegliere sottoscrizione di Azure da usare per il pagamento, quindi selezionare una località di Azure da usare. Scegliere un'area vicina geograficamente.

    L'esecuzione potrebbe richiedere alcuni minuti perché è in esecuzione azd up il provisioning e la distribuzione di più servizi di Azure. Quando viene visualizzato lo stato di avanzamento, controllare la ricerca di errori. Se vengono visualizzati errori, vedere la sezione Risoluzione dei problemi nella parte inferiore di questo documento.

  6. Al azd up termine, viene visualizzato un output simile:

    (✓) Done: Deploying service web
- Endpoint: https://xxxxx-xxxxxxxxxxxxx-ca.example-xxxxxxxx.westus.azurecontainerapps.io/

SUCCESS: Your application was provisioned and deployed to Azure in 11 minutes 44 seconds.
You can view the resources created under the resource group xxxxx-rg in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/xxxxx-rg/overview

    Se viene visualizzata una schermata predefinita o una schermata di errore, l'app potrebbe essere avviata. Attendere 5-10 minuti per verificare se il problema si risolve prima della risoluzione dei problemi.

    Ctrl + fare clic sul primo URL dopo la parola - Endpoint: per visualizzare il progetto di app Web di esempio in esecuzione in Azure.

  7. Ctrl + fare clic sul secondo URL del passaggio precedente per visualizzare le risorse di cui è stato effettuato il provisioning nel portale di Azure.

Modificare e ridistribuire

Il passaggio successivo consiste nell'apportare una piccola modifica all'app Web e quindi ridistribuire.

  1. Tornare alla scheda del browser contenente Visual Studio Code e usare la visualizzazione Esplora risorse di Visual Studio Code per passare alla cartella src/templates e aprire il file index.html . Individuare la riga di codice seguente:

    <h1 id="page-title">Welcome to ReleCloud</h1>

    Modificare il testo all'interno di H1:

    <h1 id="page-title">Welcome to ReleCloud - UPDATED</h1>

    Il codice viene salvato durante la digitazione.

  2. Per ridistribuire l'app con la modifica, eseguire il comando seguente nel terminale:

    azd deploy

  3. Al termine del comando, aggiornare la scheda del browser con il sito Web ReleCloud per visualizzare l'aggiornamento. A seconda della piattaforma di hosting Web in uso, potrebbero essere necessari alcuni minuti prima che le modifiche siano visibili.

    È ora possibile modificare ed eliminare i file nel modello. Per altre informazioni, vedere Cosa è possibile modificare o eliminare nel modello?

Pulire le risorse

Pulire le risorse create dal modello eseguendo il comando azd down .

azd down

Il azd down comando elimina le risorse di Azure e il flusso di lavoro di GitHub Actions. Quando richiesto, accettare di eliminare tutte le risorse associate al gruppo di risorse.

Facoltativo: trovare lo spazio di codice

Questa sezione illustra in che modo il codice è (temporaneamente) in esecuzione e persistente in uno spazio di codice. Se si prevede di continuare a lavorare sul codice, è necessario pubblicare il codice in un nuovo repository.

  1. Chiudere tutte le schede correlate a questo articolo di Avvio rapido o arrestare completamente il Web browser.

  2. Aprire il Web browser e una nuova scheda e passare a: https://github.com/codespaces

  3. Nella parte inferiore viene visualizzato un elenco di codespace recenti. Cercare quello creato in una sezione intitolata "Owned by Azure-Samples".

  4. Selezionare i puntini di sospensione a destra di questo codespace per visualizzare un menu di scelta rapida. Da qui è possibile rinominare lo spazio di codice, pubblicare in un nuovo repository, modificare il tipo di computer, arrestare lo spazio di codice e altro ancora.

Facoltativo: pubblicare un repository GitHub da Codespaces

A questo punto, si dispone di un codespace, che è un contenitore ospitato da GitHub che esegue l'ambiente di sviluppo di Visual Studio Code con il nuovo codice generato da un azd modello. Tuttavia, il codice non viene archiviato in un repository GitHub. Se si prevede di continuare a lavorare sul codice, è consigliabile impostarla come priorità.

  1. Dal menu di scelta rapida per lo spazio di codice selezionare "Pubblica in un nuovo repository".
  2. Nella finestra di dialogo "Pubblica in un nuovo repository" rinominare il nuovo repository e scegliere se si vuole che sia un repository pubblico o privato. Selezionare "Crea repository".
  3. Dopo alcuni istanti, il repository verrà creato e il codice generato in precedenza in questa guida introduttiva verrà inserito nel nuovo repository. Selezionare il pulsante "See repository" (Visualizza repository) per passare al nuovo repository.
  4. Per riaprire e continuare a modificare il codice, selezionare l'elenco a discesa "<> Codice" verde, passare alla scheda Spazi di codice e selezionare il nome dello spazio di codice su cui si stava lavorando in precedenza. A questo momento si dovrebbe tornare all'ambiente di sviluppo di Visual Studio Codespace.
  5. Usare il riquadro Controllo del codice sorgente per creare nuovi rami e creare nuove fasi ed eseguire il commit di nuove modifiche al codice.

Risoluzione dei problemi

Se vengono visualizzati errori durante azd up, provare a eseguire le operazioni seguenti:

  • Eseguire azd down per rimuovere tutte le risorse che potrebbero essere state create. In alternativa, è possibile eliminare il gruppo di risorse creato nel portale di Azure.
  • Passare alla pagina Codespaces per l'account GitHub, individuare il codespace creato durante questa guida introduttiva, selezionare i puntini di sospensione a destra e scegliere "Elimina" dal menu di scelta rapida.
  • Nella portale di Azure cercare Insiemi di credenziali delle chiavi. Selezionare Gestisci insiemi di credenziali eliminati, scegliere la sottoscrizione, selezionare tutti gli insiemi di credenziali delle chiavi che contengono il nome azdtest o qualsiasi elemento denominato nell'ambiente e selezionare Ripulisci.
  • Ripetere i passaggi in questa guida introduttiva. Questa volta quando richiesto, scegliere un nome più semplice per l'ambiente. Provare un nome breve, lettere minuscole, senza numeri, senza lettere maiuscole, senza caratteri speciali.
  • Quando si ritentano i passaggi di avvio rapido, scegliere un percorso diverso.

Vedere le domande frequenti per un elenco più completo di possibili problemi e soluzioni.

Contenuto correlato