Краткое руководство. Создание и развертывание веб-приложения Python для Azure с помощью шаблона azd

В этом кратком руководстве описан самый простой и быстрый способ создания и развертывания Python веб-решения и решения базы данных для Azure. Следуя данным в этом кратком руководстве инструкциям, вы:

• Выберите шаблон azd на основе веб-платформы Python, платформы баз данных Azure и Azure платформы веб-размещения, которую вы хотите создать.
• Используйте команды CLI для запуска шаблона azd для создания примера веб-приложения и базы данных, а также создания и настройки необходимых ресурсов Azure. Затем разверните пример веб-приложения для Azure.
• Измените веб-приложение на локальном компьютере и используйте команду для повторного azd развертывания.
• Используйте команду azd для очистки Azure ресурсов.

Для выполнения этого руководства потребуется менее 15 минут. По завершении можно начать изменение нового проекта с помощью пользовательского кода.

Дополнительные сведения об этих шаблонах azd для разработки веб-приложений Python см. в следующих статье:

• Что такое шаблоны?
• Как работают шаблоны?
• Почему я хочу использовать это?
• Каковы другие варианты?

Предпосылки

Подписка Azure — Создать бесплатно

Установите следующие средства на локальном компьютере:

• CLI разработчика Azure
• Docker Desktop
• Visual Studio Code
• Расширение контейнера Dev

Выберите шаблон

Выберите шаблон azd на основе веб-платформы Python, платформы веб-размещения Azure и платформы баз данных Azure, на которой вы хотите создать.

1. Выберите имя шаблона (первый столбец) из следующего списка шаблонов в следующих таблицах. Используйте имя шаблона в следующем разделе во время шага azd init.

   Django

   Шаблон	Веб-платформа	База данных	Платформа размещения	репозиторий GitHub
   azure-django-postgres-flexible-aca	Django	Гибкий сервер PostgreSQL	Azure Container Apps	repo
   azure-django-postgres-flexible-appservice	Django	Гибкий сервер PostgreSQL	Azure App Service	repo
   azure-django-cosmos-postgres-aca	Django	Cosmos DB (адаптер PostgreSQL)	Azure Container Apps	repo
   azure-django-cosmos-postgres-appservice	Django	Cosmos DB (адаптер PostgreSQL)	Azure App Service	repo
   azure-django-postgres-addon-aca	Django	Дополнение PostgreSQL для Azure Container Apps	Azure Container Apps	repo

   FastAPI

   Шаблон	Веб-платформа	База данных	Платформа размещения	репозиторий GitHub
   azure-fastapi-postgres-гибкий-ACA	FastAPI	Гибкий сервер PostgreSQL	Azure Container Apps	repo
   azure-fastapi-postgres-flexible-appservice	FastAPI	Гибкий сервер PostgreSQL	Azure App Service	repo
   azure-fastapi-cosmos-postgres-aca	FastAPI	Cosmos DB (адаптер PostgreSQL)	Azure Container Apps	repo
   azure-fastapi-cosmos-postgres-appservice	FastAPI	Cosmos DB (адаптер PostgreSQL)	Azure App Service	repo
   azure-fastapi-postgres-addon-aca	FastAPI	Дополнение PostgreSQL для Azure Container Apps	Azure Container Apps	repo

   Flask

   Шаблон	Веб-платформа	База данных	Платформа размещения	репозиторий GitHub
   azure-flask-postgres-гибкий-aca	Фляга	Гибкий сервер PostgreSQL	Azure Container Apps	repo
   azure-flask-postgres-flexible-appservice	Фляга	Гибкий сервер PostgreSQL	Azure App Service	repo
   azure-flask-cosmos-postgres-aca	Фляга	Cosmos DB (адаптер PostgreSQL)	Azure Container Apps	repo
   azure-flask-cosmos-postgres-appservice	Фляга	Cosmos DB (адаптер PostgreSQL)	Azure App Service	repo
   azure-flask-postgres-addon-aca	Фляга	Надстройка Azure Container Apps для PostgreSQL	Azure Container Apps	repo
   azure-flask-cosmos-mongodb-aca	Фляга	Cosmos DB (MongoDB)	Azure Container Apps	repo
   azure-flask-cosmos-mongodb-сервис приложений	Фляга	Cosmos DB (MongoDB)	Azure App Service	repo

   Столбец "GitHub репозиторий" предназначен только для справки. Клонируйте репозиторий непосредственно, только если вы хотите внести изменения в шаблон. В противном случае следуйте инструкциям из этого краткого руководства, чтобы использовать azd интерфейс командной строки для взаимодействия с шаблоном в обычном рабочем процессе.

Запуск шаблона

Выполнение azd шаблона идентично в разных языках и фреймворках. Одни и те же основные шаги применяются ко всем шаблонам. Вот что нужно сделать:

1. В терминале перейдите к папке на локальном компьютере, где обычно хранятся локальные репозитории Git. Создайте новую папку с именем azdtest. Затем перейдите в этот каталог с помощью cd команды.

   mkdir azdtest
   cd azdtest
   

   Не используйте терминал Visual Studio Code для этого быстрого старта.

2. Чтобы настроить локальную среду разработки, введите следующие команды в терминале и ответьте на все запросы:

   azd init --template <template name>
   

   Замените <template name> одним из шаблонов из таблиц , выбранных на предыдущем шаге, например azure-django-postgres-aca .

   При появлении запроса на имя среды используйте azdtest или любое другое имя. Имя среды используется при именовании групп ресурсов Azure и ресурсов. Для наилучших результатов используйте короткое имя, строчные буквы, без специальных символов.

3. Чтобы выполнить проверку подлинности azd в учетной записи Azure, введите следующие команды в терминале и следуйте инструкциям в командной строке:

   azd auth login
   

   Следуйте инструкциям при появлении запроса "Выбрать учетную запись" или войти в учетную запись Azure. После успешной проверки подлинности на веб-странице отображается следующее сообщение: "Проверка подлинности завершена. Вы можете вернуться в приложение. Вы можете закрыть эту вкладку браузера".

   При закрытии вкладки оболочка отображает сообщение:

   Logged in to Azure.
   

4. Перед попыткой следующего шага убедитесь, что Docker Desktop открыт и запущен в фоновом режиме.

5. Чтобы создать необходимые ресурсы Azure, введите следующие команды в терминале и ответьте на все запросы:

   azd up
   

   Это важно

   После успешного завершения azd up пример веб-приложения доступен в общедоступном Интернете, а подписка Azure начинает взимать плату за все созданные ресурсы. Создатели шаблонов azd намеренно выбрали недорогие уровни, но не обязательно бесплатные уровни, так как бесплатные уровни часто имеют ограниченную доступность.

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

   Выполнение azd up может занять несколько минут после подготовки и развертывания нескольких служб Azure. Следите за ошибками по мере отображения прогресса. Если вы видите ошибки, попробуйте устранить эту проблему:

   • Удалите папку azd-quickstart и инструкции быстрого запуска с самого начала.
   • При появлении запроса выберите более простое имя для вашего окружения. Используйте только строчные буквы и дефисы. Цифры, буквы верхнего регистра или специальные символы.
   • Выберите другое расположение.

   Если у вас по-прежнему возникли проблемы, см. раздел "Устранение неполадок " в нижней части этого документа.

   Это важно

   Завершив работу с примером веб-приложения, используйте azd down для удаления всех созданных служб azd up .

6. После azd up успешного завершения отображаются следующие выходные данные:

   

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

7. Откройте новую вкладку в веб-браузере.

   1. Скопируйте второй URL-адрес из предыдущего шага и вставьте его в строку расположения.
   2. На портале Azure отображаются все службы в новой группе ресурсов, развернутой для размещения примера проекта веб-приложения.

Редактировать и повторно развернуть

Затем внесите небольшое изменение в веб-приложение, а затем повторно разверните его.

1. Откройте Visual Studio Code и откройте папку azdtest.

2. Этот шаблон настраивается для необязательного использования контейнеров разработки. Когда появится уведомление о контейнере разработки в Visual Studio Code, нажмите кнопку Reopen в контейнере.

3. Используйте представление обозревателя Visual Studio Code для перехода к папке src/templates и откройте файл index.html. Найдите следующую строку кода:

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

   Измените текст внутри H1:

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

   Сохраните ваши изменения.

4. Чтобы повторно развернуть приложение с изменением, выполните следующую команду в терминале:

   azd deploy
   

   Так как вы используете контейнеры разработки и удаленно подключены к оболочке контейнера, не используйте панель терминала Visual Studio Code для выполнения команд azd.

5. По завершении команды обновите веб-браузер, чтобы увидеть обновление. В зависимости от используемой платформы веб-размещения может потребоваться несколько минут, прежде чем изменения видны.

   Теперь вы готовы редактировать и удалять файлы в шаблоне. Дополнительные сведения см. в разделе "Что можно изменить или удалить" в шаблоне?

Очистите ресурсы

1. Очистите ресурсы, созданные шаблоном azd down , выполнив команду.

   azd down
   

   Команда azd down удаляет ресурсы Azure и рабочий процесс GitHub Actions. При появлении запроса примите согласие на удаление всех ресурсов, связанных с группой ресурсов.

   Вы также можете удалить папку azdtest или использовать ее в качестве основы для собственного приложения, изменив файлы проекта.

Устранение неполадок

Если во время выполнения azd upвозникают ошибки, выполните следующие действия:

• Выполните команду azd down , чтобы удалить все ресурсы, созданные командой. Кроме того, можно удалить группу ресурсов, созданную на портале Azure.
• Удалите папку azdtest на локальном компьютере.
• На портале Azure найдите Key Vault. Выберите "Управление удаленными хранилищами", выберите свою подписку, выберите все хранилища ключей, содержащие имя azdtest или то, что вы назвали вашей средой, и выберите Purge.
• Повторите действия, описанные в этом кратком руководстве. На этот раз при появлении запроса выберите более простое имя для вашей среды. Попробуйте использовать короткое имя, строчные буквы, без цифр, заглавных букв и специальных символов.
• При повторных попытках быстрого запуска выберите другое расположение.

Более полный список возможных проблем и решений см. в разделе часто задаваемых вопросов.

Связанный контент

• Узнайте больше о веб-шаблонах Pythonazd.
• Дополнительные сведения о azd командах.
• Узнайте, что делают папки и файлы в проекте и что можно изменить или удалить.
• Дополнительные сведения о контейнерах разработки.
• Обновите шаблоны Bicep для добавления или удаления служб Azure. Вы не знаете, что такое Bicep? Попробуйте этот учебный курс: Основы Bicep.
• Use azd для настройки конвейера CI/CD GitHub Actions для повторного развертывания при слиянии в основную ветвь.
• Настройте мониторинг, чтобы вы могли отслеживать ваше приложение с помощью интерфейса командной строки разработчика Azure.