Настройка iis express в visual studio 2019
This page shows you how to add IIS Express servers in Jexus Manager.
In this article:
Background¶
You need to add an IIS Express server in Jexus Manager before managing its configuration.
Global IIS Express¶
In older Visual Studio releases (such as 2012/2013), a global IIS Express configuration file can be found at %userprofile%\documents\iisexpress\config\applicationhost.config or %userprofile%\my documents\iisexpress\config\applicationhost.config .
If Jexus Manager detects this file, a default server called “IIS Express” is automatically created and showed.
Add IIS Express From Custom Configuration File¶
An IIS Express server can be easily created from a custom configuration file.
Click “File | Connect to a Server…” menu item, and a wizard starts,
Choose IIS Express Configuration File and click “Next” button.
Specify full path of the configuration file (.config) in the text box, or click “…” button to browse the file system,
Click Next button.
Give this connectioni a unique and meaningful name.
Click “Finish” button.
Add IIS Express From Visual Studio 2015/2017/2019 Solution File¶
When you create a new web project in Visual Studio 2015/2017, the IDE adds a custom IIS Express configuration file to the project folder at ($SolutionDir)\.vs\config\applicationHost.config .
This file (and the .vs folder) is hidden by default in Windows Explorer.
IIS Express custom configuration is documented in this blog post .
Visual Studio 2019 uses ($SolutionDir)\.vs\config\$(ProjectName)\applicationhost.config .
JetBrains Rider uses a similar approach, and it puts the configuration file at ($SolutionDir)\.idea\config\applicationHost.config .
This file (and the .idea folder) is hidden by default in Windows Explorer.
Jexus Manager allows you to add such a solution file as a new IIS Express server (so it automatically locates and reads the hidden configuration files).
Click “File | Connect to a Server…” menu item, and a wizard starts,
Choose Visual Studio IIS Express Configuration File and click “Next” button.
Specify full path of the solution file (.sln) in the text box, or click “…” button to browse the file system,
Specify which custom configuration file to use, from Visual Studio or Rider.
Jexus Manager takes care of the rest to manage web sites and applications.
For new projects/solutions, please debug/run them at least once in Visual Studio, so that IIS Express configuration file can be added.
Click Next button.
Give this connection a unique and meaningful name.
Click “Finish” button.
Next Step¶
Once a server is added, sites and applications can be managed by choosing one of the categories in the middle panel.
If the server node is not yet expanded for management, double click the node so that Jexus Manager tries to load its configuration.
Предварительные требования
Активация IIS
Для установки служб IIS, возможно, потребуется перезагрузить компьютер.
Настройка IIS
В службах IIS нужно настроить веб-сайт со следующими характеристиками:
Включение поддержки служб IIS в Visual Studio во время разработки
Запустите установщик Visual Studio.
Выберите Изменить в установщике программы Visual Studio, которую планируется использовать для поддержки IIS во время разработки.
Настройка проекта
Профиль запуска служб IIS
Создайте новый профиль запуска, чтобы добавить поддержку IIS во время разработки.
В обозревателе решений щелкните проект правой кнопкой мыши. Выберите пункт Свойства. Откройте вкладку Отладка.
В поле Запуск выберите из списка значение IIS.
Установите флажок Запуск браузера и укажите URL-адрес конечной точки.
Укажите то же имя узла и тот же порт, как в выполненной ранее настройке IIS. Обычно это localhost .
Укажите имя приложения в конце URL-адреса.
В разделе Переменные среды нажмите кнопку Добавить. Для переменной среды задайте имя ASPNETCORE_ENVIRONMENT и значение Development .
В области Параметры веб-сервера в поле URL-адрес приложения задайте значение, соответствующее URL-адресу конечной точки в поле Запуск браузера.
В Visual Studio 2019 и последующих версиях параметру Модель размещения задайте значение По умолчанию, чтобы использовать модель размещения проекта. Если для проекта задано свойство в файле проекта, используется значение свойства InProcess или OutOfProcess . Если свойство не задано, используется модель размещения приложения по умолчанию In Process. Если приложению требуется явно указать модель размещения, отличную от обычной модели размещения приложения, задайте параметру Модель размещения значение In Process или Out Of Process по необходимости.
Запуск проекта
Запустите Visual Studio от имени администратора.
- Убедитесь, что для раскрывающегося списка с конфигурацией сборки построения выбрано значение Отладка.
- Настройте кнопку Начать отладку на профиль IIS и нажмите ее для запуска приложения.
Если вы вошли в Visual Studio без прав администратора, возможно, потребуется перезапуск. Перезапустите Visual Studio при появлении соответствующего запроса.
Если используется сертификат разработки без доверия, возможно, потребуется создать исключение для этого ненадежного сертификата по запросу в браузере.
Отладка конфигурации сборки выпуска с использованием функции Только мой код и оптимизации компилятора приводит к ограничению возможностей. Например, точки останова не будут достигнуты.
Дополнительные ресурсы
Предварительные требования
Активация IIS
Для установки служб IIS, возможно, потребуется перезагрузить компьютер.
Настройка IIS
В службах IIS нужно настроить веб-сайт со следующими характеристиками:
Включение поддержки служб IIS в Visual Studio во время разработки
Запустите установщик Visual Studio.
Выберите Изменить в установщике программы Visual Studio, которую планируется использовать для поддержки IIS во время разработки.
Настройка проекта
Профиль запуска служб IIS
Создайте новый профиль запуска, чтобы добавить поддержку IIS во время разработки.
В обозревателе решений щелкните проект правой кнопкой мыши. Выберите пункт Свойства. Откройте вкладку Отладка.
В поле Запуск выберите из списка значение IIS.
Установите флажок Запуск браузера и укажите URL-адрес конечной точки.
Укажите то же имя узла и тот же порт, как в выполненной ранее настройке IIS. Обычно это localhost .
Укажите имя приложения в конце URL-адреса.
В разделе Переменные среды нажмите кнопку Добавить. Для переменной среды задайте имя ASPNETCORE_ENVIRONMENT и значение Development .
В области Параметры веб-сервера в поле URL-адрес приложения задайте значение, соответствующее URL-адресу конечной точки в поле Запуск браузера.
В Visual Studio 2019 и последующих версиях параметру Модель размещения задайте значение По умолчанию, чтобы использовать модель размещения проекта. Если для проекта задано свойство в файле проекта, используется значение свойства InProcess или OutOfProcess . Если свойство не задано, используется модель размещения приложения по умолчанию Out Of Process. Если приложению требуется явно указать модель размещения, отличную от обычной модели размещения приложения, задайте параметру Модель размещения значение In Process или Out Of Process по необходимости.
Запуск проекта
Запустите Visual Studio от имени администратора.
- Убедитесь, что для раскрывающегося списка с конфигурацией сборки построения выбрано значение Отладка.
- Настройте кнопку Начать отладку на профиль IIS и нажмите ее для запуска приложения.
Если вы вошли в Visual Studio без прав администратора, возможно, потребуется перезапуск. Перезапустите Visual Studio при появлении соответствующего запроса.
Если используется сертификат разработки без доверия, возможно, потребуется создать исключение для этого ненадежного сертификата по запросу в браузере.
Отладка конфигурации сборки выпуска с использованием функции Только мой код и оптимизации компилятора приводит к ограничению возможностей. Например, точки останова не будут достигнуты.
Предварительные требования
Активация IIS
Для установки служб IIS, возможно, потребуется перезагрузить компьютер.
Настройка IIS
В службах IIS нужно настроить веб-сайт со следующими характеристиками:
Включение поддержки служб IIS в Visual Studio во время разработки
Запустите установщик Visual Studio.
Выберите Изменить в установщике программы Visual Studio, которую планируется использовать для поддержки IIS во время разработки.
Настройка проекта
Профиль запуска служб IIS
Создайте новый профиль запуска, чтобы добавить поддержку IIS во время разработки.
В обозревателе решений щелкните проект правой кнопкой мыши. Выберите пункт Свойства. Откройте вкладку Отладка.
В поле Запуск выберите из списка значение IIS.
Установите флажок Запуск браузера и укажите URL-адрес конечной точки.
Укажите то же имя узла и тот же порт, как в выполненной ранее настройке IIS. Обычно это localhost .
Укажите имя приложения в конце URL-адреса.
В разделе Переменные среды нажмите кнопку Добавить. Для переменной среды задайте имя ASPNETCORE_ENVIRONMENT и значение Development .
В области Параметры веб-сервера в поле URL-адрес приложения задайте значение, соответствующее URL-адресу конечной точки в поле Запуск браузера.
В Visual Studio 2019 и последующих версиях параметру Модель размещения задайте значение По умолчанию, чтобы использовать модель размещения проекта. Если для проекта задано свойство в файле проекта, используется значение свойства InProcess или OutOfProcess . Если свойство не задано, используется модель размещения приложения по умолчанию In Process. Если приложению требуется явно указать модель размещения, отличную от обычной модели размещения приложения, задайте параметру Модель размещения значение In Process или Out Of Process по необходимости.
Запуск проекта
Запустите Visual Studio от имени администратора.
- Убедитесь, что для раскрывающегося списка с конфигурацией сборки построения выбрано значение Отладка.
- Настройте кнопку Начать отладку на профиль IIS и нажмите ее для запуска приложения.
Если вы вошли в Visual Studio без прав администратора, возможно, потребуется перезапуск. Перезапустите Visual Studio при появлении соответствующего запроса.
Если используется сертификат разработки без доверия, возможно, потребуется создать исключение для этого ненадежного сертификата по запросу в браузере.
Отладка конфигурации сборки выпуска с использованием функции Только мой код и оптимизации компилятора приводит к ограничению возможностей. Например, точки останова не будут достигнуты.
Дополнительные ресурсы
Предварительные требования
Активация IIS
Для установки служб IIS, возможно, потребуется перезагрузить компьютер.
Настройка IIS
В службах IIS нужно настроить веб-сайт со следующими характеристиками:
Включение поддержки служб IIS в Visual Studio во время разработки
Запустите установщик Visual Studio.
Выберите Изменить в установщике программы Visual Studio, которую планируется использовать для поддержки IIS во время разработки.
Настройка проекта
Профиль запуска служб IIS
Создайте новый профиль запуска, чтобы добавить поддержку IIS во время разработки.
В обозревателе решений щелкните проект правой кнопкой мыши. Выберите пункт Свойства. Откройте вкладку Отладка.
В поле Запуск выберите из списка значение IIS.
Установите флажок Запуск браузера и укажите URL-адрес конечной точки.
Укажите то же имя узла и тот же порт, как в выполненной ранее настройке IIS. Обычно это localhost .
Укажите имя приложения в конце URL-адреса.
В разделе Переменные среды нажмите кнопку Добавить. Для переменной среды задайте имя ASPNETCORE_ENVIRONMENT и значение Development .
В области Параметры веб-сервера в поле URL-адрес приложения задайте значение, соответствующее URL-адресу конечной точки в поле Запуск браузера.
В Visual Studio 2019 и последующих версиях параметру Модель размещения задайте значение По умолчанию, чтобы использовать модель размещения проекта. Если для проекта задано свойство в файле проекта, используется значение свойства InProcess или OutOfProcess . Если свойство не задано, используется модель размещения приложения по умолчанию Out Of Process. Если приложению требуется явно указать модель размещения, отличную от обычной модели размещения приложения, задайте параметру Модель размещения значение In Process или Out Of Process по необходимости.
Запуск проекта
Запустите Visual Studio от имени администратора.
- Убедитесь, что для раскрывающегося списка с конфигурацией сборки построения выбрано значение Отладка.
- Настройте кнопку Начать отладку на профиль IIS и нажмите ее для запуска приложения.
Если вы вошли в Visual Studio без прав администратора, возможно, потребуется перезапуск. Перезапустите Visual Studio при появлении соответствующего запроса.
Если используется сертификат разработки без доверия, возможно, потребуется создать исключение для этого ненадежного сертификата по запросу в браузере.
Отладка конфигурации сборки выпуска с использованием функции Только мой код и оптимизации компилятора приводит к ограничению возможностей. Например, точки останова не будут достигнуты.
Вы можете использовать средство публикации для импорта параметров публикации, а затем развернуть приложение. В этой статье мы используем параметры публикации для IIS.
Файл параметров публикации ( *.publishsettings) отличается от профиля публикации ( *.pubxml). Файл параметров публикации создается в IIS, после чего его можно импортировать в Visual Studio. Visual Studio создает профиль публикации.
Предварительные требования
- Установите последние обновления для Visual Studio, выбрав Справка >Проверить обновления.
- Добавьте рабочую нагрузку, выбрав Инструменты >Получить средства и компоненты.
Службы IIS в Windows не поддерживают создание параметров публикации. Однако вы по-прежнему можете публиковать в службах IIS с помощью средства публикации в Visual Studio.
Установка и настройка веб-развертывания в Windows Server
Веб-развертывание версии 3.6 для серверов размещения реализует дополнительные возможности конфигурации, позволяющие создавать файл параметров публикации из пользовательского интерфейса.
Установщик веб-платформы для служб IIS позволяет устанавливать версию 3.6, а не 4.0, поэтому в этой статье мы рекомендуем использовать именно эту версию.
Если компонент веб-развертывания уже установлен в Windows Server, удалите его, выбрав Панель управления > Программы > Удаление программы.
После этого установите веб-развертывание версии 3.6 для серверов размещения в Windows Server.
Чтобы установить веб-развертывание для серверов размещения, используйте установщик веб-платформы (WebPI). (Чтобы найти ссылку на установщик веб-платформы в службах IIS, выберите пункт IIS в левой области диспетчера сервера. В области сервера щелкните сервер правой кнопкой мыши и выберите Диспетчер служб IIS. Затем воспользуйтесь ссылкой Получить новые компоненты веб-платформы в окне Действия.) Кроме того, установщик веб-платформы (WebPI) можно получить в разделе скачиваемых файлов.
В установщике веб-платформы компонент Веб-развертывание версии 3.6 для серверов размещения находится на вкладке "Приложения".
Если вы еще не установили сценарии и средства управления IIS, сделайте это на данном этапе.
Перейдите в раздел Выбор ролей сервера > Веб-сервер (IIS) > Средства управления, после чего выберите роль Сценарии и средства управления IIS, нажмите кнопку Далее и выполните установку роли.
Эти сценарии и средства необходимы для создания файла параметров публикации.
(Необязательный шаг) Проверьте работоспособность веб-развертывания. Для этого выберите Панель управления > Система и безопасность > Администрирование > Службы и проверьте следующее:
служба агента веб-развертывания запущена (в прежних версиях название этой службы отличалось);
служба веб-управления запущена.
Если какая-то из этих служб агента не запущена, перезапустите службу агента веб-развертывания.
Создание файла параметров публикации в IIS в Windows Server
Закройте и снова откройте консоль управления IIS, чтобы отобразить обновленные параметры конфигурации в пользовательском интерфейсе.
В службах IIS щелкните правой кнопкой мыши элемент Веб-сайт по умолчанию и выберите Развернуть > Включить публикацию веб-развертывания.
Если меню Развернуть не отображается, ознакомьтесь с предыдущим разделом, чтобы проверить, выполняется ли веб-развертывание.
Просмотрите параметры в диалоговом окне Включить публикацию веб-развертывания.
Щелкните Настройка.
Выходные данные в панели Результаты показывают, что права доступа предоставлены конкретному пользователю, а в указанном в диалоговом окне месте был создан файл с расширением .publishsettings.
В зависимости от конфигурации Windows Server и служб IIS в XML-файле будут представлены разные значения. Ниже описываются некоторые значения, которые могут вам встретиться.
Порту publishUrl присваивается значение 8172, которое по умолчанию используется для веб-развертывания.
Порту destinationAppUrl присваивается значение 80, которое по умолчанию используется для служб IIS.
Если на следующих этапах вам не удается подключиться к удаленному узлу из Visual Studio с использованием имени узла, попробуйте использовать вместо имени узла IP-адрес сервера.
Если вы выполняете публикацию в службах IIS, работающих на виртуальной машине Azure, необходимо открыть входящий порт для веб-развертывания и служб IIS в группе безопасности сети. Подробные сведения см. в статье Открытие портов для виртуальной машины.
Скопируйте этот файл на компьютер, на котором выполняется среда Visual Studio.
Импорт параметров публикации в Visual Studio и развертывание
Если ранее вы настроили какие-либо профили публикации, появится панель Опубликовать. Щелкните Создать или Создать профиль.
Выберите вариант для импорта профиля.
В открывшемся диалоговом окне Публикация выберите Импортировать профиль.
В открывшемся диалоговом окне Выбрать целевой объект для публикации выберите Импортировать профиль.
Перейдите в расположение файла параметров публикации, созданного в предыдущем разделе.
В диалоговом окне Импортировать файл параметров публикации перейдите к профилю, созданному в предыдущем разделе, выберите его и нажмите кнопку Открыть.
Щелкните Готово, чтобы сохранить профиль публикации, а затем щелкните Опубликовать.
Visual Studio начинает процесс развертывания, а в окне вывода отображаются ход выполнения и результаты.
При появлении любых ошибок развертывания щелкните Изменить для изменения параметров. Измените параметры и нажмите кнопку Проверить для тестирования новых параметров. Если имя узла не найдено, попробуйте указать IP-адрес вместо имени узла в полях Сервер и Целевой URL-адрес.
Visual Studio начинает процесс развертывания, а в окне вывода отображаются ход выполнения и результаты.
При появлении любых ошибок развертывания щелкните Параметры для изменения параметров. Измените параметры и нажмите кнопку Проверить для тестирования новых параметров. Если имя узла не найдено, попробуйте указать IP-адрес вместо имени узла в полях Сервер и Целевой URL-адрес.
После успешного развертывания приложение должно запускаться автоматически.
Распространенные проблемы
For developers working with ASP.NET and ASP.NET Core, Internet Information Services (IIS) is an essential part of the web development workflow. IIS comes in two different variants, IIS and IIS Express, with the latter being the most commonly used by developers in their daily work. The building, running, and debugging of web applications are necessary components of the ASP.NET development lifecycle. Visual Studio users are familiar with hitting the play button and having everything "just work".
IIS Express
We can choose to run either configuration using Visual Studio's run button.
From here, the running and debugging experience is what most developers would expect. Set a few breakpoints, step through code, and investigate in-memory values.
Developers moving to Rider will have an equivalent experience with IIS Express. From the same solution, we can see that Rider understands the launchSettings.json file.
Additionally, we can see that Rider will let us run any of the defined configurations within the editor.
From the Run Configuration dropdown, we'll notice Rider has discovered all the run configurations from our launchSettings.json file. From this point, we can select the IIS Express configuration and either run or debug our web application running within IIS Express.
We can also use Rider's UI to inspect the settings read from the launchSettings.json . Rider's UI can help us confirm our JSON is well structured and that all the settings are the expected values.
There are instances where developers would prefer to run a full IIS instance rather than relying on IIS Express. This situation is possible in both IDEs but adds a layer of additional complexity. The first step is to publish our web application to our IIS instance. In both Visual Studio and Rider's cases, we'll need to be sure we are running our IDE process under escalated privileges.
From Visual Studio, we'll likely right-click and select the Publish option. From the publish dialog, we can choose IIS and follow the instructions.
From Rider, we can right-click the same project and select Publish to IIS or Publish to folder.
Rider can also use any publish profiles already defined from Visual Studio, which generally end with the .pubxml extension.
Once our application is published, we can see the process running by visiting the configured IIS website. To debug the new IIS process, we need to use Rider's Attach To Process action, which we can find under the Run menu or using the Ctrl+Alt+P command.
From here, we should be able to step into our code as if we were running our application in IIS Express or Kestrel.
Conclusion
Читайте также: