Criar um aplicativo Python no serviço de Azure App no LinuxCreate a Python app in Azure App Service on Linux

Neste guia de início rápido, você implanta um aplicativo Python simples no serviço de aplicativo no Linux, que fornece um serviço de hospedagem na Web altamente escalonável e com aplicação de patch automática.In this quickstart, you deploy a simple Python app to App Service on Linux, which provides a highly scalable, self-patching web hosting service. Use a interface de linha de comando do Azure (o CLI do Azure) por meio do Azure cloud shell interativo baseado em navegador, para que você possa seguir as etapas usar um computador Mac, Linux ou Windows.You use the Azure command-line interface (the Azure CLI) through the interactive, browser-based Azure Cloud Shell, so you can follow the steps use a Mac, Linux, or Windows computer.

Aplicação de exemplo em execução no Azure

Pré-requisitosPrerequisites

Para concluir este guia de início rápido:To complete this quickstart:

Transferir o exemplo localmenteDownload the sample locally

Numa janela de terminal, execute os seguintes comandos para clonar a aplicação de exemplo no seu computador local e navegue para o diretório com o código de exemplo.In a terminal window, run the following commands to clone the sample application to your local machine, and navigate to the directory with the sample code.

git clone https://github.com/Azure-Samples/python-docs-hello-world
cd python-docs-hello-world

O repositório contém um Application.py, que informa ao serviço de aplicativo que o repositório contém um aplicativo Flask.The repository contains an application.py, which tells App Service that the repository contains a Flask app. Para obter mais informações, consulte personalização e processo de inicialização do contêiner.For more information, see Container startup process and customizations.

Executar a aplicação localmenteRun the app locally

Execute a aplicação localmente, para ver que aspeto deveria ter quando a implemente no Azure.Run the application locally so that you see how it should look when you deploy it to Azure. Abra uma janela de terminal e utilize os comandos abaixo para instalar as dependências necessárias e iniciar o servidor de desenvolvimento incorporado.Open a terminal window and use the commands below to install the required dependencies and launch the built-in development server.

# In Bash
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
FLASK_APP=application.py flask run

# In PowerShell
py -3 -m venv env
env\scripts\activate
pip install -r requirements.txt
Set-Item Env:FLASK_APP ".\application.py"
flask run

Abra um browser e navegue para a aplicação de exemplo em http://localhost:5000/.Open a web browser, and navigate to the sample app at http://localhost:5000/.

Pode ver a mensagem Olá, mundo!You see the Hello World! da aplicação de exemplo apresentada na página.message from the sample app displayed in the page.

Aplicação de exemplo em execução localmente

Na janela do terminal, prima Ctrl+C para desligar o servidor Web.In your terminal window, press Ctrl+C to exit the web server.

Utilizar o Azure Cloud ShellUse Azure Cloud Shell

O Azure hospeda Azure Cloud Shell, um ambiente de shell interativo que você pode usar por meio de seu navegador.Azure hosts Azure Cloud Shell, an interactive shell environment that you can use through your browser. Cloud Shell permite que você use bash o PowerShell ou o para trabalhar com os serviços do Azure.Cloud Shell lets you use either bash or PowerShell to work with Azure services. Você pode usar os comandos pré-instalados Cloud Shell para executar o código neste artigo sem precisar instalar nada em seu ambiente local.You can use the Cloud Shell pre-installed commands to run the code in this article without having to install anything on your local environment.

Para iniciar o Azure Cloud Shell:To launch Azure Cloud Shell:

OpçãoOption Exemplo/linkExample/Link
Selecione Experimentar no canto superior direito de um bloco de código.Select Try It in the upper-right corner of a code block. A seleção de try não copia automaticamente o código para Cloud Shell.Selecting Try It doesn't automatically copy the code to Cloud Shell. Exemplo de teste para Azure Cloud Shell
Vá para https://shell.azure.com ou selecione o botão Iniciar Cloud Shell para abrir Cloud Shell em seu navegador.Go to https://shell.azure.com or select the Launch Cloud Shell button to open Cloud Shell in your browser. Iniciar Cloud Shell em uma nova janelaLaunch Cloud Shell in a new window
Selecione o botão Cloud Shell na barra de menus superior direita na portal do Azure.Select the Cloud Shell button on the top-right menu bar in the Azure portal. Botão Cloud Shell no portal do Azure

Para executar o código neste artigo em Azure Cloud Shell:To run the code in this article in Azure Cloud Shell:

  1. Abra o Cloud Shell.Open Cloud Shell.
  2. Selecione o botão copiar em um bloco de código para copiar o código.Select the Copy button on a code block to copy the code.
  3. Cole o código na sessão de Cloud shell com Ctrl+Shift+v no Windows e Linux, ou cmd+Shift+v no MacOS.Paste the code into the Cloud Shell session with Ctrl+Shift+V on Windows and Linux, or Cmd+Shift+V on macOS.
  4. Pressione Enter para executar o código.Press Enter to run the code.

Transferir o exemploDownload the sample

No Cloud Shell, crie um diretório de início rápido e, em seguida, altere-o.In the Cloud Shell, create a quickstart directory and then change to it.

mkdir quickstart

cd quickstart

Em seguida, execute o seguinte comando para clonar o repositório da aplicação de exemplo para o seu diretório de início rápido.Next, run the following command to clone the sample app repository to your quickstart directory.

git clone https://github.com/Azure-Samples/python-docs-hello-world

Ao executar, apresenta informações semelhantes ao exemplo seguinte:While running, it displays information similar to the following example:

Cloning into 'python-docs-hello-world'...
remote: Enumerating objects: 43, done.
remote: Total 43 (delta 0), reused 0 (delta 0), pack-reused 43
Unpacking objects: 100% (43/43), done.
Checking connectivity... done.

Criar uma aplicação WebCreate a web app

Mude para o diretório que contém o código de exemplo e execute o comando az webapp up.Change to the directory that contains the sample code and run the az webapp up command.

No exemplo a seguir, substitua <app-name> por um nome de aplicativo exclusivo globalmente (oscaracteres a-zválidos 0-9são, -e ).In the following example, replace <app-name> with a globally unique app name (valid characters are a-z, 0-9, and -).

cd python-docs-hello-world

az webapp up -n <app-name>

Este comando pode demorar alguns minutos a ser executado.This command may take a few minutes to run. Ao executar, apresenta informações semelhantes ao exemplo seguinte:While running, it displays information similar to the following example:

The behavior of this command has been altered by the following extension: webapp
Creating Resource group 'appsvc_rg_Linux_CentralUS' ...
Resource group creation complete
Creating App service plan 'appsvc_asp_Linux_CentralUS' ...
App service plan creation complete
Creating app '<app-name>' ....
Webapp creation complete
Creating zip with contents of dir /home/username/quickstart/python-docs-hello-world ...
Preparing to deploy contents to app.
All done.
{
  "app_url": "https:/<app-name>.azurewebsites.net",
  "location": "Central US",
  "name": "<app-name>",
  "os": "Linux",
  "resourcegroup": "appsvc_rg_Linux_CentralUS ",
  "serverfarm": "appsvc_asp_Linux_CentralUS",
  "sku": "BASIC",
  "src_path": "/home/username/quickstart/python-docs-hello-world ",
  "version_detected": "-",
  "version_to_create": "python|3.7"
}

Nota

O comando az webapp up executa as seguintes ações:The az webapp up command does the following actions:

Navegar para a aplicaçãoBrowse to the app

Utilize o browser para navegar para a aplicação implementada.Browse to the deployed application using your web browser.

http://<app-name>.azurewebsites.net

O código de exemplo do Python está em execução no serviço de aplicativo no Linux com uma imagem interna.The Python sample code is running in App Service on Linux with a built-in image.

Aplicação de exemplo em execução no Azure

Parabéns!Congratulations! Implementou a sua primeira aplicação Python no Serviço de Aplicações no Linux.You've deployed your first Python app to App Service on Linux.

Atualizar localmente e reimplementar o códigoUpdate locally and redeploy the code

Na Cloud Shell, digite code application.py para abrir o editor de Cloud Shell.In the Cloud Shell, type code application.py to open the Cloud Shell editor.

Application.py de código

Faça uma pequena alteração no texto da chamada de return:Make a small change to the text in the call to return:

return "Hello Azure!"

Salve as alterações e saia do editor.Save your changes and exit the editor. Utilize o comando ^S para guardar e ^Q para sair.Use the command ^S to save and ^Q to exit.

Reimplante o aplicativo usando o az webapp up comando.Redeploy the app using the az webapp up command. Substitua o nome do aplicativo para <app-name>e especifique um local para <location-name> (usando um dos valores mostrados no az account list-locations comando).Substitute the name of your app for <app-name>, and specify a location for <location-name> (using one of the values shown from the az account list-locations command).

az webapp up -n <app-name> -l <location-name>

Depois de concluída a implementação, volte para a janela do browser aberta que abriu no passo Navegar para a aplicação e atualize a página.Once deployment has completed, switch back to the browser window that opened in the Browse to the app step, and refresh the page.

Aplicação de exemplo atualizada em execução no Azure

Gerenciar seu novo aplicativo do AzureManage your new Azure app

Vá para o portal do Azure para gerenciar o aplicativo que você criou.Go to the Azure portal to manage the app you created.

No menu à esquerda, clique em serviços de aplicativose, em seguida, clique no nome do seu aplicativo do Azure.From the left menu, click App Services, and then click the name of your Azure app.

Navegação do portal para a aplicação do Azure

Você vê a página de visão geral do seu aplicativo.You see your app's Overview page. Aqui, pode realizar tarefas de gestão básicas, como navegar, parar, iniciar, reiniciar e eliminar.Here, you can perform basic management tasks like browse, stop, start, restart, and delete.

Página Serviço de Aplicações no portal do Azure

O menu à esquerda fornece diferentes páginas para configurar a sua aplicação.The left menu provides different pages for configuring your app.

Limpar recursosClean up resources

Nos passos anteriores, criou os recursos do Azure num grupo de recursos.In the preceding steps, you created Azure resources in a resource group. Se achar que não vai precisar destes recursos no futuro, execute o seguinte comando no Cloud Shell para eliminar o grupo de recursos:If you don't expect to need these resources in the future, delete the resource group by running the following command in the Cloud Shell:

az group delete --name myResourceGroup

Este comando pode demorar alguns minutos a ser executado.This command may take a minute to run.

Passos SeguintesNext steps