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

Краткий старт: создание и развертывание Python веб-приложения из GitHub Codespaces в Azure с помощью шаблона Azure Developer CLI

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

  • Выберите шаблон Azure CLI разработчика (azd) на основе веб-платформы Python, платформы баз данных Azure и платформы веб-размещения Azure, которую вы хотите создать.
  • Создайте новое пространство кода GitHub, содержащее код, созданный на основе выбранного шаблона azd.
  • Используйте GitHub пространства codespaces и терминал Bash в сети Visual Studio Code. Терминал позволяет использовать команды cli разработчика Azure для запуска шаблона azd для создания примера веб-приложения и базы данных, а также создания и настройки необходимых ресурсов Azure, а затем развернуть пример веб-приложения для Azure.
  • Измените веб-приложение в пространстве кода GitHub и используйте команду azd для повторного развертывания.
  • Используйте команду azd для очистки Azure ресурсов.
  • Закройте и снова откройте ваш GitHub Codespace.
  • Опубликуйте новый код в репозитории GitHub.

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

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

Предпосылки

Это важно

Как GitHub пространства кода, так и Azure являются платными службами на основе подписки. После некоторых бесплатных квот вам могут начислить плату за использование этих сервисов. Следование этому краткому руководству может повлиять на эти выделения или выставление счетов. По возможности azd шаблоны используют наименьший дорогой уровень параметров, но некоторые могут не быть бесплатными. Используйте калькулятор цен Azure, чтобы лучше понять затраты. Для получения дополнительной информации см. GitHub о ценах на Codespaces.

Выбор шаблона и создание пространства кода

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

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

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

  1. Для удобства последний столбец каждой таблицы содержит ссылку, которая создает новое пространство кода и инициализирует шаблон azd в учетной записи GitHub. Щелкните правой кнопкой мыши ссылку New Codespace рядом с выбранным именем шаблона и выберите "Открыть на новой вкладке" , чтобы инициировать процесс установки.

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

  2. Через несколько минут веб-версия Visual Studio Code загружается на новой вкладке браузера с Python веб-шаблоном, загруженным в виде рабочей области в представлении обозревателя.

Проверка подлинности в Azure и развертывание шаблона azd

Теперь, когда у вас есть пространство кода GitHub, содержащее только что созданный код, используйте служебную программу azd из пространства Codespace для публикации кода в Azure.

  1. Visual Studio Code в веб-версии терминал открыт по умолчанию. Если это не так, используйте ключ тильды ~ , чтобы открыть терминал. По умолчанию терминал является терминалом bash. Если это не так, переключитесь на bash в правой верхней части окна терминала.

  2. В терминале bash введите следующую команду:

    azd auth login

    azd auth login начинает аутентификацию вашего Codespace в учетной записи 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. Следуйте инструкциям, которые включают:

    • Копирование созданного кода
    • Нажмите Enter для открытия новой вкладки браузера и вставки кода в текстовое поле.
    • Выбор учетной записи Azure из списка
    • Подтверждение того, что вы пытаетесь войти в Microsoft Azure CLI

  4. При успешном выполнении следующее сообщение отображается на вкладке Codespaces в терминале:

    Device code authentication completed.
Logged in to Azure.

  5. Разверните новое приложение для Azure, введя следующую команду:

    azd up

    В ходе этого процесса вам будет предложено:

    • Введите новое имя среды
    • Выберите подписку Azure для использования [стрелки для перемещения, введите для фильтрации]
    • Выберите расположение Azure для использования: [Используйте стрелки для перемещения, введите для фильтрации]

    После ответа на эти вопросы выходные данные azd указывают, что развертывание выполняется.

    Это важно

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

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

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

  6. После успешного завершения azd up отображается аналогичный результат:

    (✓) 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

    Если отображается экран по умолчанию или экран ошибки, приложение может запуститься. Подождите 5–10 минут, чтобы узнать, устранена ли проблема перед устранением неполадок.

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

  7. Ctrl+ щелкните второй URL-адрес из предыдущего шага, чтобы просмотреть подготовленные ресурсы на портале Azure.

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

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

  1. Вернитесь на вкладку браузера, содержащую Visual Studio Code. Используйте представление обозревателя Visual Studio Code, чтобы перейти в папку src/templates. Откройте файлindex.html . Найдите следующую строку кода:

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

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

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

    Код сохраняется при вводе.

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

    azd deploy

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

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

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

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

azd down

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

Опционально: Найдите ваше пространство разработчика

В этом разделе показано, как код временно выполняется и краткосрочно сохраняется в Codespace. Если вы планируете продолжить работу над кодом, опубликуйте код в новом репозитории.

  1. Закройте все вкладки, связанные с этой статьей краткого руководства, или полностью закройте веб-браузер.

  2. Откройте веб-браузер и новую вкладку и перейдите на https://github.com/codespaces.

  3. Ближе к нижней части вы увидите список последних Codespaces. Найдите тот, который вы создали в разделе "Принадлежит Azure-Samples".

  4. Выберите многоточие справа от Codespace, чтобы просмотреть контекстное меню. Здесь можно переименовать пространство кода, опубликовать в новом репозитории, изменить тип компьютера, остановить пространство кода и многое другое.

По желанию: Опубликовать репозиторий GitHub из Codespaces

На этом этапе у вас есть Codespace – это контейнер, размещённый на GitHub и выполняющий вашу среду разработки Visual Studio Code с новым кодом, созданным на основе шаблона azd. Однако код не хранится в репозитории GitHub. Если вы планируете продолжить работу над кодом, приоритетно сохраните его в репозитории.

  1. В контекстном меню пространства кода выберите "Опубликовать" в новом репозитории.
  2. В диалоговом окне публикации в новом репозитории переименуйте новый репозиторий и выберите, является ли он общедоступным или частным репозиторием. Выберите Создать репозиторий.
  3. Через несколько минут репозиторий создается и код, созданный ранее в этом кратком руководстве, отправляется в новый репозиторий. Нажмите кнопку "Просмотреть репозиторий" , чтобы перейти к новому репозиторию.
  4. Чтобы повторно открыть и продолжить редактирование кода, выберите раскрывающийся список "<> Код", перейдите на вкладку Codespaces и выберите имя пространства кода, над которым вы работали ранее. Вы вернеесь в среду разработки Codespace Visual Studio Code.
  5. Используйте панель управления версиями для создания ветвей и этапа и фиксации новых изменений в коде.

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

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

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

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

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

  • Last updated on