Руководство: Локальный запуск и отладка с помощью Bridge to Kubernetes в Visual Studio
Заметка
Мост для Kubernetes будет снят с эксплуатации 30 апреля 2025 года. Дополнительные сведения о прекращении поддержки и open-source альтернативы см. в задаче GitHub .
В этом руководстве вы узнаете, как перенаправить трафик между кластером Kubernetes и компьютером разработки. В этом руководстве используется Bridge to Kubernetes и Visual Studio для отладки службы. Сведения об использовании Visual Studio Code см. в статье Запуск и отладка локально с помощью Моста к Kubernetes с помощью VS Code.
Дополнительные сведения о мосте к Kubernetes см. в статье Как работает мост к Kubernetes.
В этом руководстве описано, как:
- Подключитесь к кластеру с помощью Bridge to Kubernetes.
- Маршрутизация запросов к локально запущенной службе для целей разработки.
- Отладка запущенной службы на локальном компьютере.
Необходимые условия
- Кластер Kubernetes. Вы можете создать его на портале Azure . Если у вас нет подписки Azure, вы можете создать учетную запись бесплатно.
- Исполняемый файл kubectl, установленный на вашей системе.
- Visual Studio 2019 версии 16.7 или более поздней, работающая на Windows 10 или более поздней, или Visual Studio 2022.
- Расширение Bridge to Kubernetes для Visual Studio 2019 или Bridge to Kubernetes для Visual Studio 2022.
Настроить службу
В этом руководстве используется Bridge to Kubernetes для работы с простым примером приложения todo в любом кластере Kubernetes.
В демонстрационном приложении есть пользовательский интерфейс для взаимодействия и серверная часть, которая обеспечивает постоянное хранилище.
Откройте окно Bash и убедитесь, что кластер доступен и готов. Затем задайте контекст для этого кластера.
kubectl cluster-info kubectl config use-context <kubernetes-cluster>
Клонируйте пример репозитория.
git clone https://github.com/hsubramanianaks/b2k-samples
Измените каталог на todo-app, а затем создайте пространство имен для примера.
kubectl create namespace todo-app
Примените манифест развертывания:
kubectl apply -n todo-app -f deployment.yaml
Это простое развертывание предоставляет пользовательский интерфейс посредством службы типа
LoadBalancer
. Подождите, пока все поды будут запущены, и внешний IP-адрес службыfrontend
станет доступным.При тестировании с помощью MiniKube используйте
minikube tunnel
для разрешения внешнего IP-адреса. Если вы используете AKS или другой облачный поставщик Kubernetes, внешний IP-адрес назначается автоматически.Используйте следующую команду, чтобы отслеживать службу
frontend
, чтобы ждать, пока она не будет запущена.kubectl get service -n todo-app frontend --watch NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE frontend LoadBalancer 10.0.245.78 10.73.226.228 80:31910/TCP 6m26s
Подключение к кластеру
Откройте Visual Studio. В окне Начало работы выберите Продолжить без кода.
Выберите Open>Project/Solution, а затем найдите проект todo-app\database-api\databaseApi.csproj и выберите Открыть.
В проекте выберите Bridge to Kubernetes из параметров запуска, как показано ниже.
Нажмите кнопку "Пуск" рядом с Bridge to Kubernetes. В диалоговом окне Create profile for Bridge to Kubernetes введите следующие значения:
- Выберите имя кластера.
- Выберите todo-app для пространства имен.
- Выберите database-api для службы , которую нужно перенаправить.
- Выберите тот же URL-адрес, который использовался ранее для запуска браузера.
Если вы хотите запустить изолированный режим, выберите Включить изоляцию маршрутизации. Если включить изоляцию маршрутизации, другие пользователи, использующие кластер, не влияют на изменения. Режим изоляции отправляет ваши запросы в вашу копию каждого вовлеченного сервиса. Обычно он направляет другой трафик. Дополнительные сведения см. в разделе How Bridge to Kubernetes Works.
Выберите Сохранить и отладить, чтобы сохранить изменения.
Заметка
EndpointManager предложит вам разрешить повышенные привилегии для вашего файла hosts.
Компьютер разработки подключается к кластеру. В строке состояния показано, что вы подключены к службе
database-api
.Попробуйте ввести задачи и пометить их как завершенные.
Выберите Отладка>Остановить отладку, чтобы остановить отладку. Ярлык для этого действия: Shift+F5 или кнопка Остановить отладку на панели инструментов.
Мост к Kubernetes перенаправляет весь трафик для службы базы данных. Это перенаправляет на версию вашего приложения на разработочном компьютере. Мост к Kubernetes также направляет весь исходящий трафик из приложения обратно в кластер Kubernetes.
Заметка
По умолчанию остановка задачи отладки также отключает компьютер разработки от кластера Kubernetes. Чтобы изменить это поведение, выберите Инструменты>Параметры, а затем выберите Средства отладки Kubernetes. Установите для отключение после отладки значение False.
После обновления этого параметра компьютер разработки остается подключенным при остановке и запуске отладки. Чтобы отключить компьютер разработки от кластера, нажмите кнопку Отключить на панели инструментов.
Установка точки останова
В этом разделе вы устанавливаете точку останова в своей службе.
В обозревателе решенийвыберите MongoHelper.cs, чтобы открыть файл в редакторе. Если Обозреватель решений не отображается, выберите Просмотр>Обозреватель решений.
Установите курсор на первой строке тела метода CreateTask. Затем выберите Отладка>Переключение точки останова, чтобы установить точку останова.
Ярлык для этого действия — F9.
Нажмите кнопку "Пуск" рядом с Bridge to Kubernetes, как и в предыдущем разделе. Отладка начинается с введенных ранее значений.
В открываемом браузере введите значение в todos и выберите ВВОД. Код достигает введенной точки останова. При выполнении реальных задач отладки можно использовать параметры отладки для пошагового выполнения кода.
Выберите Отладка>Остановить отладку, чтобы остановить отладку.
Чтобы удалить точку останова, выберите эту строку, а затем выберите Отладка>переключить точку останова или выбрать F9.
Изменение профиля запуска
Если вам нужно изменить способ подключения Bridge к Kubernetes к кластеру, в этом разделе вы измените параметры профиля запуска.
На панели команд Visual Studio щелкните стрелку рядом с кнопкой запуска (зеленый треугольник или значок воспроизведения), чтобы открыть раскрывающийся список, а затем щелкните свойства отладки databaseApi.
Щелкните на ссылке "Редактировать профиль для Bridge to Kubernetes" в диалоговом окне "Профили запуска".
Другой способ добраться до этого экрана:
Щелкните правой кнопкой мыши на узле проекта в Обозревателе Решений и выберите Свойства (или нажмите клавиши Alt+Enter).
Прокрутите вниз до Debugи выберите Открыть интерфейс профилей запусков Debug.
Очистка ресурсов
Если вы использовали пример приложения todo для этого руководства, его можно удалить из кластера с помощью портала Azure. Если вы клонировали репозиторий локально, его можно удалить вручную.
Дальнейшие действия
Дополнительные сведения о Bridge to Kubernetes см. в разделе о том, как работает Bridge to Kubernetes.
Чтобы узнать, как подключить компьютер разработки к кластеру с помощью Visual Studio Code, ознакомьтесь с этой статьей: