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

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

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

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

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

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

Предпосылки

Это важно

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

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

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

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

    Шаблон Веб-платформа База данных Платформа размещения Новое пространство кода
    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 Новое пространство кода

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

    Во время этого процесса может потребоваться войти в учетную запись 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. Следуйте инструкциям, которые включают:

    • Копирование созданного кода
    • Выбор ввода для открытия новой вкладки браузера и вставки кода в текстовое поле
    • Выбор учетной записи 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 минут, чтобы узнать, устранена ли проблема перед устранением неполадок.

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

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

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

  • Last updated on