Краткое руководство. Развертывание веб-приложения Python (Django, Flask или FastAPI) в службе приложение Azure

git clone https://github.com/Azure-Samples/msdocs-python-flask-webapp-quickstart

git clone https://github.com/Azure-Samples/msdocs-python-django-webapp-quickstart

git clone https://github.com/Azure-Samples/msdocs-python-fastapi-webapp-quickstart.git

1. Перейдите в папку приложения:

   cd msdocs-python-flask-webapp-quickstart
   

2. Создайте виртуальную среду для приложения:

   • Windows
   • macOS/Linux

   py -m venv .venv
   .venv\scripts\activate
   

3. Установка зависимостей:

   pip install -r requirements.txt
   

4. Запустите приложение:

   flask run
   

5. В веб-браузере перейдите к примеру приложения по адресу http://localhost:5000.

   

Возникли проблемы? Сообщите нам об этом.

1. Перейдите в папку приложения:

   cd msdocs-python-django-webapp-quickstart
   

2. Создайте виртуальную среду для приложения:

   • Windows
   • macOS/Linux

   py -m venv .venv
   .venv\scripts\activate
   

3. Установка зависимостей:

   pip install -r requirements.txt
   

4. Запустите приложение:

   python manage.py runserver
   

5. В веб-браузере перейдите к примеру приложения по адресу http://localhost:8000.

   

Возникли проблемы? Сообщите нам об этом.

1. Перейдите в папку приложения:

   cd msdocs-python-fastapi-webapp-quickstart
   

2. Создайте виртуальную среду для приложения:

   • Windows
   • macOS/Linux

   py -m venv .venv
   .venv\scripts\activate
   

3. Установка зависимостей:

   pip install -r requirements.txt
   

4. Запустите приложение:

   uvicorn main:app --reload
   

5. В веб-браузере перейдите к примеру приложения по адресу http://localhost:8000.

   

Возникли проблемы? Сообщите нам об этом.

Команды Azure CLI моно выполнять на компьютере с установленным Azure CLI.

В Azure CLI есть команда az webapp up, которая создаст необходимые ресурсы и развернет приложение за одно действие.

При необходимости войдите в Azure с помощью az login.

az login

Создайте веб-приложение и другие ресурсы, а затем разверните код в Azure с помощью az webapp up.

az webapp up --runtime PYTHON:3.9 --sku B1 --logs

• Параметр --runtime указывает, какая версия Python работает в вашем приложении. В этом примере используется Python 3.9. Чтобы получить список всех доступных сред выполнения, используйте команду az webapp list-runtimes --os linux --output table.
• Параметр --sku определяет размер (ЦП, память) и стоимость плана службы приложений. В этом примере используется план обслуживания B1 (Базовый), который повлечет за собой небольшую стоимость в подписке Azure. Полный список планов службы приложений см. на странице цен на Службу приложений.
• Флаг --logs настраивает ведение журнала по умолчанию, необходимое для включения просмотра потока журнала сразу после запуска веб-приложения.
• При необходимости можно указать имя с аргументом --name <app-name>. Если вы не указали его, имя будет автоматически создано.
• При необходимости вы можете использовать аргумент --location <location-name>, где <location_name> является доступным регионом Azure. Список допустимых регионов для учетной записи Azure можно получить, выполнив команду az appservice list-locations.

Выполнение этой команды может занять несколько минут. По мере выполнения команды будут отображаться сообщения о создании группы ресурсов, плане службы приложений и ресурсе приложения, настройке ведения журнала и последующем выполнении развертывания ZIP-файла. Затем оно выдает сообщение You can launch the app at http://<app-name>.azurewebsites.net (Вы можете запустить приложение по адресу http://.azurewebsites.net). Это URL-адрес приложения в Azure.

The webapp '<app-name>' doesn't exist
Creating Resource group '<group-name>' ...
Resource group creation complete
Creating AppServicePlan '<app-service-plan-name>' ...
Creating webapp '<app-name>' ...
Configuring default logging for the app, if not already enabled
Creating zip with contents of dir /home/cephas/myExpressApp ...
Getting scm site credentials for zip deployment
Starting zip deployment. This operation can take a while to complete ...
Deployment endpoint responded with status code 202
You can launch the app at http://<app-name>.azurewebsites.net
{
  "URL": "http://<app-name>.azurewebsites.net",
  "appserviceplan": "<app-service-plan-name>",
  "location": "centralus",
  "name": "<app-name>",
  "os": "<os-type>",
  "resourcegroup": "<group-name>",
  "runtime_version": "python|3.9",
  "runtime_version_detected": "0.0",
  "sku": "FREE",
  "src_path": "<your-folder-location>"
}

Чтобы создать ресурсы Azure в VS Code, необходимо установить пакет расширений инструментов Azure и войти в Azure через VS Code.

В папке приложения откройте VS Code:

code .

Instructions	Снимок экрана
На левой панели инструментов найдите значок Azure. Выберите его, чтобы открыть расширение инструментов Azure для VS Code. Если вы не видите значок инструментов Azure, убедитесь, что у вас установлено расширение инструментов Azure для VS Code.
В расширении средств Azure для VS Code: Найдите раздел RESOURCES и выберите свою подписку. Щелкните + (Создать ресурс...).
Выберите Создать веб-приложение службы приложений.
Введите имя msdocs-python-webapp-quickstart-XYZ для этого веб-приложения, где XYZ — любые три уникальные символа. При развертывании это имя используется в качестве имени приложения в форме https://<app-name>.azurewebsites.net.
Выберите стек среды выполнения для приложения. В этом примере выберите Python 3.9.
Выберите план службы приложений (ценовая категория) для этого веб-приложения. План службы приложений определяет, сколько ресурсов (ЦП и памяти) доступно для вашего приложения, а также стоимость этих ресурсов. В этом примере выберите ценовую категорию Базовый (B1). Этот план повлечет за собой небольшую плату за подписку Azure, но он рекомендуется для повышения производительности по сравнению с планом "Бесплатный" (F1).
Нажмите кнопку Развернуть в уведомлении "Создано новое веб-приложение".
Выберите папку быстрого запуска, в которой вы работаете, в качестве папки для развертывания.
Ответьте Да, чтобы обновить конфигурацию сборки и повысить производительность развертывания.
После завершения развертывания в правом нижнем углу VS Code появится уведомление. Это уведомление можно использовать для перехода к веб-приложению.

Войдите на портал Azure и выполните следующие действия, чтобы создать ресурсы Службы приложений Azure.

Instructions	Снимок экрана
В портал Azure: Введите службы приложений в строку поиска в верхней части портала Azure. Выберите элемент, помеченный Служба приложений под заголовком "Службы" в меню, которое отображается под строкой поиска.
На странице Служба приложений нажмите кнопку +Создать, а затем в раскрывающемся меню выберите +Web App.
На странице Создание веб-приложения заполните форму следующим образом. Группа ресурсов → выберите Создать новый и используйте имя msdocs-python-webapp-quickstart. Имя → msdocs-python-webapp-quickstart-XYZ, где XYZ — это любой из трех случайных символов. Это имя должно быть уникальным в Azure. Стек среды выполнения → Python 3.9. Регион → любой ближайший к вам регион Azure. Служба приложений План → в рамках ценового плана выберите "Обзор планов ценообразования", чтобы выбрать другой план Служба приложений.
План Служба приложений управляет объемом ресурсов (ЦП или памяти), доступных вашему приложению и затратам на эти ресурсы. В этом примере в разделе "Разработка и тестирование" выберите план Basic B1 . План "Базовый" B1 будет взиматься небольшая плата за учетную запись Azure, но рекомендуется повысить производительность по сравнению с планом "Бесплатный F1". По завершении нажмите кнопку " Выбрать ", чтобы применить изменения.
На странице Создание веб-приложения выберите в нижней части экрана Просмотр и создание. Откроется страница Просмотр. Нажмите Создать, чтобы создать вашу Службу приложений.

az webapp up Так как команда создала необходимые ресурсы и развернула приложение на одном шаге, вы можете перейти к следующему шагу.

Так как предыдущий шаг создал необходимые ресурсы и развернул приложение на одном шаге, вы можете перейти к следующему шагу.

Вы можете развернуть код приложения из локального репозитория Git в Azure, настроив удаленный Git в локальном репозитории, который указывает на репозиторий, в который требуется отправить код. URL-адрес удаленного репозитория и учетные данные Git, необходимые для настройки, можно получить с помощью портала Azure или Azure CLI.

• Портал Azure
• Azure CLI

Instructions	Снимок экрана
Перейдите в Службу приложений для своего приложения. В поле поиска в верхней части экрана введите имя вашей Службы приложений. В разделе Ресурсы выберите Службу приложений для перехода к ней.
На странице Служба приложений: В меню с левой стороны экрана выберите пункт Центр развертывания. В раскрывающемся списке Источник выберите Локальный Git. Выберите Сохранить.
После сохранения страницы он обновится и отобразит адрес удаленного репозитория Git. Скопируйте значение URI Git Clone, так как это значение будет использоваться позднее для настройки удаленного репозитория Git.
На странице Центра развертывания: Перейдите на вкладку Учетные данные FTPS/локального Git. Найдите локальное имя пользователя и пароль Git в учетных данных области приложения. Не закрывайте этот экран, чтобы вы могли сразу же скопировать эти учетные данные при развертывании кода в удаленный репозиторий. Обязательно скопируйте локальное имя пользователя Git, которое начинается с $примера $msdocs-python-webapp-quickstart-123. При первой отправке кода в удаленный репозиторий Git эти учетные данные понадобятся для проверки подлинности в удаленном репозитории.

Затем в корневом каталоге приложения настройте удаленный Git, который указывает на Azure, используя URL-адрес Git удаленного Azure, полученный на предыдущем этапе.

git remote add azure <git-deployment-url>

Теперь вы можете отправить код из локального репозитория Git в Azure, используя только что настроенный удаленный Git. Ветвь развертывания по умолчанию для Служба приложений имеет значениеmaster, но многие репозитории Git удаляются и master используютсяmain. Можно указать сопоставление из имени локальной ветви с именем удаленной ветви в push-запросе (как показано ниже) или настроить DEPLOYMENT_BRANCH параметр приложения.

git push azure main:master

При первом отправке кода в Azure Git предложит вам учетные данные развертывания Azure, полученные на предыдущем шаге. Затем Git кэширует эти учетные данные, поэтому их не придется повторно помещать в последующие развертывания.

Приложения можно развертывать в Azure, создавая и передавая ZIP-файл кода приложения в Azure. ZIP-файлы можно передать в Azure с помощью Azure CLI или HTTP-клиента, такого как cURL.

Включение автоматизации сборки

При развертывании ZIP-файла кода Python необходимо установить флаг, чтобы включить автоматизацию сборки Azure. При автоматизации сборки будет установлено все необходимое согласно требованиям и создан пакет приложения для запуска в Azure.

Автоматизация сборки в Azure включается путем настройки параметра приложения SCM_DO_BUILD_DURING_DEPLOYMENT на портале Azure или в Azure CLI.

• Портал Azure
• Azure CLI

Instructions	Снимок экрана
На странице веб-приложения в портал Azure: На панели инструментов слева в разделе Параметры выберите Конфигурация, чтобы открыть параметры приложения. В разделе Параметры приложения выберите Новый параметр приложения.
В диалоговом окне задайте новый параметр следующим образом: Имя → SCM_DO_BUILD_DURING_DEPLOYMENT Значение → true
Выберите Сохранить, чтобы сохранить настройки.

Создание ZIP-файла приложения

Затем создайте ZIP-файл приложения. Необходимо включить только компоненты самого приложения. Не нужно включать файлы или каталоги, которые начинаются с точки (.), например .venv, .gitignore, .github или .vscode.

zip -r <file-name>.zip . -x '.??*'

Передача ZIP-файла в Azure

После получения ZIP-файла файл можно отправить в Azure с помощью Azure CLI или HTTP-клиента, например cURL.

# Change these values to the ones used to create the App Service.
RESOURCE_GROUP_NAME='msdocs-python-webapp-quickstart'
APP_SERVICE_NAME='msdocs-python-webapp-quickstart-123'

az webapp deploy \
    --name $APP_SERVICE_NAME \
    --resource-group $RESOURCE_GROUP_NAME \
    --src-path <zip-file-path>

# Change these values to the ones used to create the App Service.
$resourceGroupName='msdocs-python-webapp-quickstart'
$appServiceName='msdocs-python-webapp-quickstart-123'

az webapp deploy `
    --name $appServiceName `
    --resource-group $resourceGroupName `
    --src-path <zip-file-path>

curl -X POST \
    -H 'Content-Type: application/zip' \
    -u '<deployment-user>' \
    -T <zip-file-name> \
    https://<app-name>.scm.azurewebsites.net/api/zipdeploy

curl -X POST `
    -H 'Content-Type: application/zip' `
    -u '<deployment-user>' `
    -T <zip-file-name> `
    https://<app-name>.scm.azurewebsites.net/api/zipdeploy

Служба приложений автоматически обнаруживает наличие приложения Flask. Для этого краткого руководства не требуется дополнительная конфигурация.

Служба приложений автоматически обнаруживает наличие приложения Django. Для этого краткого руководства не требуется дополнительная конфигурация.

Для FastAPI необходимо настроить настраиваемую команду запуска для Служба приложений для запуска приложения. Следующая команда запускает Gunicorn с 2 рабочими процессами Uvicorn: gunicorn -w 2 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 main:app

Сначала настройте команду запуска с помощью команды az webapp config set .

az webapp config set \
    --startup-file "gunicorn -w 2 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 main:app" \
    --name $APP_SERVICE_NAME \
    --resource-group $RESOURCE_GROUP_NAME

Затем перезапустите веб-приложение с помощью команды az webapp restart .

az webapp restart \
    --name $APP_SERVICE_NAME \
    --resource-group $RESOURCE_GROUP_NAME

Служба приложений автоматически обнаруживает наличие приложения Flask. Для этого краткого руководства не требуется дополнительная конфигурация.

Служба приложений автоматически обнаруживает наличие приложения Django. Для этого краткого руководства не требуется дополнительная конфигурация.

Используйте Azure CLI или портал Azure для настройки команды запуска.

Служба приложений автоматически обнаруживает наличие приложения Flask. Для этого краткого руководства не требуется дополнительная конфигурация.

Служба приложений автоматически обнаруживает наличие приложения Django. Для этого краткого руководства не требуется дополнительная конфигурация.

Для FastAPI необходимо настроить настраиваемую команду запуска для Служба приложений для запуска приложения. Следующая команда запускает Gunicorn с 2 рабочими процессами Uvicorn: gunicorn -w 2 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 main:app

Instructions	Снимок экрана
Сначала настройте команду запуска в службе приложение Azure. Перейдите на страницу экземпляра Службы приложений на портале Azure. Выберите "Конфигурация" в заголовке "Параметры " в меню слева от страницы. Убедитесь, что выбрана вкладка "Общие параметры ". В поле "Команда запуска" введите gunicorn -w 2 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 main:app. Выберите Сохранить, чтобы сохранить изменения. Дождитесь уведомления об обновлении параметров перед продолжением.
Затем перезапустите веб-приложение. Выберите "Обзор " в меню слева от страницы. В верхнем меню выберите "Перезапустить".

@app.route('/')
def index():
   print('Request for index page received')
   return render_template('index.html')

@app.route('/favicon.ico')
def favicon():
    return send_from_directory(os.path.join(app.root_path, 'static'),
                               'favicon.ico', mimetype='image/vnd.microsoft.icon')

@app.route('/hello', methods=['POST'])
def hello():
   name = request.form.get('name')

   if name:
       print('Request for hello page received with name=%s' % name)
       return render_template('hello.html', name = name)
   else:
       print('Request for hello page received with no name or blank name -- redirecting')
       return redirect(url_for('index'))

def index(request):
    print('Request for index page received')
    return render(request, 'hello_azure/index.html')

@csrf_exempt
def hello(request):
    if request.method == 'POST':
        name = request.POST.get('name')
        
        if name is None or name == '':
            print("Request for hello page received with no name or blank name -- redirecting")
            return redirect('index')
        else:
            print("Request for hello page received with name=%s" % name)
            context = {'name': name }
            return render(request, 'hello_azure/hello.html', context)
    else:

@app.get("/", response_class=HTMLResponse)
async def index(request: Request):
    print('Request for index page received')
    return templates.TemplateResponse('index.html', {"request": request})

@app.get('/favicon.ico')
async def favicon():
    file_name = 'favicon.ico'
    file_path = './static/' + file_name
    return FileResponse(path=file_path, headers={'mimetype': 'image/vnd.microsoft.icon'})

@app.post('/hello', response_class=HTMLResponse)
async def hello(request: Request, name: str = Form(...)):
    if name:
        print('Request for hello page received with name=%s' % name)
        return templates.TemplateResponse('hello.html', {"request": request, 'name':name})
    else:
        print('Request for hello page received with no name or blank name -- redirecting')
        return RedirectResponse(request.url_for("index"), status_code=status.HTTP_302_FOUND)

Сначала необходимо настроить службу приложение Azure для вывода журналов в файловую систему Служба приложений с помощью команды az webapp log config.

az webapp log config \
    --web-server-logging filesystem \
    --name $APP_SERVICE_NAME \
    --resource-group $RESOURCE_GROUP_NAME

az webapp log config `
    --web-server-logging 'filesystem' `
    --name $APP_SERVICE_NAME `
    --resource-group $RESOURCE_GROUP_NAME

Чтобы выполнить потоковую передачу журналов, используйте команду az webapp log tail.

az webapp log tail \
    --name $APP_SERVICE_NAME \
    --resource-group $RESOURCE_GROUP_NAME

az webapp log tail `
    --name $APP_SERVICE_NAME `
    --resource-group $RESOURCE_GROUP_NAME

Обновите домашнюю страницу в приложении или попытайтесь выполнить другие запросы, чтобы создать какие-то сообщения журнала. Результат должен выглядеть следующим образом.

Starting Live Log Stream ---

2021-12-23T02:15:52.740703322Z Request for index page received
2021-12-23T02:15:52.740740222Z 169.254.130.1 - - [23/Dec/2021:02:15:52 +0000] "GET / HTTP/1.1" 200 1360 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/hello" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"
2021-12-23T02:15:52.841043070Z 169.254.130.1 - - [23/Dec/2021:02:15:52 +0000] "GET /static/bootstrap/css/bootstrap.min.css HTTP/1.1" 200 0 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"
2021-12-23T02:15:52.884541951Z 169.254.130.1 - - [23/Dec/2021:02:15:52 +0000] "GET /static/images/azure-icon.svg HTTP/1.1" 200 0 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"
2021-12-23T02:15:53.043211176Z 169.254.130.1 - - [23/Dec/2021:02:15:53 +0000] "GET /favicon.ico HTTP/1.1" 404 232 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"

2021-12-23T02:16:01.304306845Z Request for hello page received with name=David
2021-12-23T02:16:01.304335945Z 169.254.130.1 - - [23/Dec/2021:02:16:01 +0000] "POST /hello HTTP/1.1" 200 695 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"
2021-12-23T02:16:01.398399251Z 169.254.130.1 - - [23/Dec/2021:02:16:01 +0000] "GET /static/bootstrap/css/bootstrap.min.css HTTP/1.1" 304 0 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/hello" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"
2021-12-23T02:16:01.430740060Z 169.254.130.1 - - [23/Dec/2021:02:16:01 +0000] "GET /static/images/azure-icon.svg HTTP/1.1" 304 0 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/hello" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"

Удалите группу ресурсов с помощью команды az group delete.

az group delete \
    --name msdocs-python-webapp-quickstart \
    --no-wait

Аргумент --no-wait позволяет команде возвращать сведения до завершения операции.

Чтобы удалить группу ресурсов, после входа на портал Azure выполните следующие действия.

Instructions	Снимок экрана
На портале Azure перейдите к группе ресурсов. В поле поиска в верхней части портала введите имя группы ресурсов. В разделе Группы ресурсов выберите имя группы ресурсов, чтобы перейти к ней.
В верхней части страницы выберите Удалить группу ресурсов.
В диалоговом окне подтверждения введите имя группы ресурсов для подтверждения удаления. Нажмите кнопку Удалить для удаления группы ресурсов.