Упражнение. Настройка GitHub Copilot для работы с Visual Studio Code
В этом упражнении вы откроете пространство кода для предоставленного Python репозитория веб-API. Вы можете экспериментировать в этой среде, не создавая собственный репозиторий.
Настройка среды
Сначала запустите среду Codespaces, которая предварительно настроена с расширением GitHub Copilot. Перед созданием codespace просмотрите тип компьютера, плательщика, оставшийся лимит и элементы управления расходами.
Внимание
Личные бесплатные учетные записи GitHub включают 120 Codespaces ядро-часов и 15 ГБ-месяцев хранилища каждый месяц. На двухъядерной машине 120 ядро-часов составляют 60 часов работы, если вы не использовали часть этого лимита где-либо ещё. Для личных аккаунтов GitHub Pro действует другой лимит. Организации и корпоративные планы не включают бесплатную квоту Codespaces.
В документации по выставлению счетов Codespaces описываются текущие лимиты и расходы. После просмотра параметров учетной записи создайте среду:
- Откройте пространство кода с предварительно настроенной средой в браузере.
- На странице Создание пространства кода просмотрите параметры конфигурации, а затем выберите Создать новое пространство кода.
- Дождитесь завершения настройки контейнера и установки расширений. Этот процесс может занять несколько минут.
Остальные упражнения происходят в этом контейнере разработки. Используйте среду Python, уже настроенную для проекта, а не создавайте вторую среду.
Ссылка на запуск открывает codespace, связанный с предоставленным репозиторием. Если у вас есть доступ на чтение и разрешение на создание форка, Codespaces может создать форк в вашей учетной записи или связать существующий, когда вы фиксируете изменения или отправляете новую ветвь. Если она появится, следуйте подсказке о создании форка. Коммит, хранящийся только в codespace, не является резервной копией на GitHub.
Включить GitHub Copilot
Войдите в VS Code с помощью учетной записи GitHub, у которой есть доступ к Copilot. Если у вас еще нет доступа, активируйте тариф Copilot Free или используйте подходящий план, предоставленный вашей организацией. Выберите "Чат" в строке заголовка, а затем откройте чат и убедитесь, что вы можете отправить запрос, прежде чем продолжить.
Вам не нужно приобретать платный план Copilot только для того, чтобы начать это упражнение. Copilot Free включает ограниченное использование, включая 2000 ежемесячных завершений кода и лимит AI-кредитов. Перед началом работы проверьте текущий лимит. Доступность функций и их использование зависят от политик учетной записи и организации. Дополнительные сведения см. в тарифных планах Copilot.
Проверенные учащиеся могут активировать Copilot Student через GitHub Education. Проверенные преподаватели и имеющие право мейнтейнеры популярных проектов с открытым кодом могут претендовать на Copilot Pro без затрат. Требования к соответствию условиям и активации отличаются.
Запустите веб-API Python
Контейнер устанавливает зависимости проекта в настроенную среду Python. При присоединении к кодспейсу настроенная команда запуска запускает Uvicorn на порту 8000 с автоматической перезагрузкой.
- Проверьте терминал запуска для успешного запуска приложения. Если появится ошибка, перед продолжением устраните ее. Запись порта только не доказывает, что приложение запущено.
- Откройте представление «Порты» и найдите порт 8000, помеченный как «Приложение».
- Откройте этот порт в браузере и оставьте для него видимость Частный. Корневой URL приложения перенаправляет на интерактивную документацию по API по адресу
/docs.
Сервер обычно работает. Не запускайте вторую копию на порту 8000. При сохранении изменений в Python запускается настроенная перезагрузка. Если необходимо перезапустить сервер вручную, остановите существующий процесс сочетанием клавиш Ctrl+C в терминале, в котором он запущен, перед запуском другой копии.
После остановки предыдущего сервера выполните следующую команду восстановления из корневого каталога репозитория в Codespace:
/home/vscode/venv/bin/python -m uvicorn main:app --host 0.0.0.0 --port 8000 --reload
Используйте URL-адрес пересылаемого приложения в браузере, а не URL-адрес вашего компьютера localhost:8000. Дополнительные сведения см. в статье о переадресации портов в кодспейсе.