Поделиться через

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

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

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

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

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

Предпосылки

подписка Azure — создайте бесплатную учетную запись.

На локальном компьютере должно быть установлено следующее:

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

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

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

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

Репозиторий 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 успешного завершения отображаются следующие выходные данные:

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

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

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

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

Следующий шаг — незначительно изменить веб-приложение, а затем снова развернуть.

  1. Откройте Visual Studio Code и откройте созданную ранее папку azdtest .

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

  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 Vaults. Выберите команду "Управление удаленными хранилищами", выберите подписку, выберите все хранилища ключей, содержащие имя azdtest или то, что вы назвали вашей средой, и выберите Purge.
  • Повторно выполните шаги, описанные в этом кратком руководстве. На этот раз при появлении запроса выберите более простое имя для вашей среды. Попробуйте короткое имя, строчные буквы, без цифр, без заглавных букв, без специальных символов.
  • При повторных попытках быстрого запуска выберите другое расположение.

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

Связанные материалы