Сведения о приложении в отчетах о развертывании
Обновлен: Ноябрь 2007
В XML-отчете о развертывании элемент <Applications> содержит сведения о приложениях, которые требуется развернуть в распределенной системе. Эти сведения необходимы для настройки приложений для развертывания. В этом элементе могут содержаться сведения только для приложений в такой системе или же для других систем в ней. В этот элемент также включены сведения о параметрах, ресурсах и конечных точках для каждого приложения. Дополнительные сведения см. в разделе Общие сведения о ключевых разделах в отчетах о развертывании.
Например, если отчет о развертывании был создан для системы "по умолчанию", в этом элементе будут содержаться все приложения в такой системе по умолчанию, но никакие другие системы. При этом система по умолчанию представляет, как эти приложения подключаются и настраиваются в среде разработки, а не в среде развертывания. Дополнительные сведения см. в разделе Определения развертывания, созданные из диаграмм приложения и системы.
Элемент <Applications> содержит один или несколько элементов <Application>, определяющих каждое приложение в отчете о развертывании. В следующих разделах содержатся дополнительные сведения об элементе <Application>.
Application Information in the <Application> Element
Paths to Application Files
Configuration File Settings for Applications
IIS Metabase Settings for ASP.NET Applications
Information about Application Connections
Web Service and Web Content Absolute URIs
Сведения о приложении в элементе <Application>
В следующем примере показан элемент <Application> для приложения Windows. Атрибут "Extends" – "Microsoft_WindowsApplication:WindowsApplication" определяет приложение Windows.
<Application Name="MyWinAppUse" Definition="MyWinAppDefinition:MyWinAppDefinition" Extends="Microsoft_WindowsApplication:WindowsApplication" InstanceId="ed22d434-f40d-48b1-bbec-0b4e93ad2a9f">
...
</Application>
В этом элементе можно найти следующие сведения.
Пути к файлам приложения, необходимым для развертывания.
Параметры, которые требуется обновить в файлах конфигурации приложения.
Параметры метабазы IIS необходимы приложениям ASP.NET для развертывания.
Сведения о подключении для приложений.
Абсолютные URI (местоположение развертывания) для конечных точек поставщиков веб-служб и веб-содержимого.
Тип приложения определяет типы файлов, параметры и другие сведения, включаемые в отчет о развертывании.
Пути к файлам приложения
Отчет о развертывании содержит сведения о путях для файлов, необходимых для развертывания приложения. Например, в число этих файлов входят библиотеки, исполняемые файлы, файлы содержимого и файлы конфигурации. Эти сведения необходимы для того, чтобы файлы можно было найти для развертывания. При этом перед созданием отчета о развертывании необходимо указать местоположение для копирования этих файлов. Это местоположение необходимо указать в свойстве Destination Path на схеме развертывания, используемой для создания отчета о развертывании. Также при помощи соответствующих свойств требуется указать, следует ли включать исходные файлы, файлы содержимого или двоичные файлы. Это позволит включить файлы и собрать их из заданного местоположения. В процессе создания отчета о развертывании создаются соответствующие каталоги проекта, и файлы копируются в указанное местоположение. Дополнительные сведения см. в разделе Практическое руководство. Создание отчетов о развертывании.
![]() |
---|
Для каждого определения приложения, поддерживающего реализацию на диаграмме приложения, существует только один проект в решении. При этом в развертываемой системе определение может использоваться несколько раз. Например, определение может использоваться в системе несколько раз с различными параметрами безопасности и если развертывание будет выполнено на разных серверах. Случаи многократного использования заносятся в отчет об использовании. Однако в процессе создания для них создается только один каталог проекта. Таким образом, в процессе развертывания должно быть создано и настроено каждое использование на основе сведений в отчете о развертывании. |
Для каждого приложения ASP.NET, Windows или Office в отчете о развертывании элемент <Application> содержит элемент <Resource> с именем "Directory". Элемент "Directory" содержит элементы <Resource>, включающие сведения о каталогах в выходном расположении и файлах, скопированных в эти каталоги. Дополнительные сведения см. в разделе Расположение и структура каталогов выходных файлов развертывания.
Каждый элемент <Resource> в элементе "Directory" ссылается на файл или каталог, а также на путь файловой системы в выходном расположении. Элемент <Resource>, ссылающийся на каталог, может содержать другие элементы <Resource>, которые ссылаются на подкаталоги. При этом все элементы <Resource>, ссылающиеся на файлы, расположены на конечном уровне.
![]() |
---|
Эта группа элементов <Resource> имеет ту же иерархию, что и структура проектов в решении. При этом элементы <Resource>, представляющие каталоги на одном уровне, могут располагаться в порядке, отличном от их папок в решении или на диске. Кроме того, переименование проектов в решении не изменяет имен их папок на диске. Однако для создания каталога проекта в выходном расположении используется имя папки проекта на диске, а не имя проекта в решении. Таким образом, имя каталога проекта в выходном расположении не может совпадать с именем проекта к решении. |
Кроме того, каждый элемент <Resource>, представляющий каталог или файл, содержит элемент <Setting> с именем "Path". Элемент "Path" состоит из трех элементов <Facet>: "Assigned", "Parent" и "Current".
Следующая таблица содержит сведения об этих элементах.
Элемент <Facet> |
Описание |
---|---|
"Assigned" |
Содержит путь выходного расположения, заданный свойством Destination Path в отчете о развертывании. При этом только элемент "Path" в элементе "Directory" содержит это значение. |
"Parent" |
Содержит путь из каталога проекта к родительскому каталогу подкаталога или файла. При этом только элемент "Path" такого подкаталога или файла содержит это значение. ![]()
Если в проекте есть родительский каталог, элемент "Parent" элемента "Path" в элементе "Directory" не содержит пути к этому родительскому каталогу.
|
"Current" |
Содержит путь из каталога проекта к подкаталогу или файлу. Элемент "Path" для каталога проекта, подкаталога или файла содержит это значение. |
Таким образом, полный путь к подкаталогу или файлу можно извлечь, объединив элемент "Assigned" из элемента "Path" в элементе "Directory" с элементом "Current" подкаталога или файла.
![]() |
---|
Чтобы получить допустимый путь, возможно, потребуется добавить символ обратной косой черты (\) в необходимые позиции. |
Дополнительные сведения см. в разделах Практическое руководство. Поиск путей к выходным файлам развертывания в отчетах о развертывании и Расположение и структура каталогов выходных файлов развертывания.
Параметры файла конфигурации для приложений
Файл конфигурации (Web.config для приложений ASP.NET или App.config для приложений Windows или Office) потребуется обновлять при каждом использовании приложения в системе с правильными параметрами развертывания. Изначально, параметры в файле конфигурации представляют конфигурацию приложения в среде разработки, а не в среде развертывания. При этом можно извлечь параметры файла конфигурации, необходимые для развертывания, из отчете о развертывании.
Элемент <Application> для приложения содержит элемент <Resource> с именем "Directory". Дополнительные сведения см. в разделе Paths to Application Files. Этот элемент "Directory" содержит другой элемент <Resource> с именем "Configuration". Этот элемент "Configuration" содержит элементы <Setting> и <Resource>, определяющие параметры файла конфигурации, необходимые для развертывания. Дополнительные сведения см. в разделе Практическое руководство. Поиск параметров файла конфигурации приложения в отчетах о развертывании.
![]() |
---|
Параметры файла конфигурации в отчете о развертывании должны иметь те же имена, что и их аналоги в файле конфигурации. При этом имена ресурсов, с которыми параметры отображаются в отчете о развертывании, могут отличаться от соответствующих разделов в файле конфигурации. Дополнительные сведения см. в разделе Разделы файла конфигурации в отчетах о развертывании. |
Параметры метабазы IIS для приложений ASP.NET
Элемент <Application> для приложения ASP.NET содержит элемент <Resource> с именем "WebApplication". Этот элемент "WebApplication" содержит элементы <Setting>, описывающие параметры метабазы IIS, необходимые для развертывания. Однако некоторые из имен параметров, значений или типов отличаются от своих аналогов IIS и требуют преобразования, прежде чем будут настроены на целевом сервере. Дополнительные сведения см. в следующих разделах:
Сведения о подключениях приложений
Элемент <Application> содержит элемент <Endpoint> для каждой конечной точки в приложении. Элемент <Endpoint> содержит элемент <Setting> с именем "ConnectedToEndpoints", когда конечная точка подключена к другой конечной точке. По элементу "ConnectedToEndpoints" можно определить все конечные точки, подключенные в такой конечной точке. Элемент "ConnectedToEndpoints" содержит идентификатор GUID, соответствующие атрибуту "InstanceId" для подключенной конечной точки. Другие элементы <Setting> в элементе <Endpoint> содержат сведения о параметрах конечной точки.
![]() |
---|
Для просмотра этих параметров можно выбрать конечную точку на диаграмме приложения или диаграмме системы (из которой была создана схема развертывания). Затем в редакторе параметров и ограничений просмотрите узел Параметры конечной точки приложения. Дополнительные сведения см. в разделе Редактор параметров и ограничений. |
В следующем примере содержится элемент "ConnectedToEndpoints" для конечной точки потребителя веб-службы в приложении Windows. Этот элемент содержит GUID, определяющий подключенную конечную точку поставщика веб-служб в веб-приложении ASP.NET. В свою очередь, элемент <Endpoint> для конечной точки поставщика веб-служб имеет элемент "ConnectedToEndpoints" со значением GUID для подключенной конечной точки потребителя веб-службы.
<Application Name="MyWinAppUse" Definition="MyWinAppDefinition:MyWinAppDefinition" Extends="Microsoft_WindowsApplication:WindowsApplication" InstanceId="6b36995a-a6cf-47d6-9dcb-679d07db23ef">
<Endpoint Name="MyWebServiceConsumer" Definition="MyWinAppDefinition:MyWinAppDefinition.WebServiceConsumer1" Extends="Microsoft_Web:WebServiceClient" InstanceId="a18fb424-c1a4-49e3-b4af-e6d7e2e9d063"><Setting Name="ConnectedToEndpoints" Definition="System:Guid" State="Set" List="true"><Value>9c4e0dc0-a29d-4bb7-8061-a9d3e2075581</Value></Setting>
...
</Endpoint>
...
</Application>
<Application Name="MyWebApp1" Definition="MyWebApp1:MyWebApp1" Extends="Microsoft_WebApplication:WebApplication" InstanceId="1a912802-d7f3-4b53-89a5-b8bc7f378411">
...
<Endpoint Name="WebService1" Definition="MyWebApp1:MyWebApp1.WebService1" Extends="Microsoft_Web:WebService" InstanceId="9c4e0dc0-a29d-4bb7-8061-a9d3e2075581"><Setting Name="ConnectedToEndpoints" Definition="System:Guid" State="Set" List="true"><Value>a18fb424-c1a4-49e3-b4af-e6d7e2e9d063</Value></Setting>
...
...
</Endpoint>
...
</Application>
Абсолютные URI веб-служб и веб-содержимого
Конечные точки потребителя необходимо настроить для каждого приложения, использующего веб-службу или веб-содержимое с местоположением развертывания веб-службы или веб-содержимого. Элемент <Application> для приложения ASP.NET, предоставляющий веб-службу или веб-содержимое, включает элемент <Endpoint>. Этот элемент <Endpoint> содержит элемент "Uri" <Setting> с тремя элементами <Facet>: "Relative", "Base" и "Absolute".
Следующая таблица содержит более подробные сведения об этих элементах.
Элемент <Facet> |
Описание |
---|---|
"Relative" |
Содержит параметр Service URL из конечной точки поставщика веб-служб. Этот параметр может содержать относительный или абсолютный URL-адрес веб-службы. -или- Содержит параметр Relative Path из конечной точки поставщика веб-содержимого. Этот параметр содержит относительный путь, ссылающийся на содержимое в местоположении, отличном от корневого каталога приложения. |
"Base" |
Содержит параметр URL из конечной точки веб-узла. Эта конечная точка веб-приложения находится в веб-сервере IIS, где расположена веб-служба или веб-содержимое. |
"Absolute" |
Содержит абсолютный URI конечной точки поставщика веб-служб или веб-содержимого. ![]()
Если параметр Service URL или Relative Path содержит относительный URL-адрес или пут, то этот элемент объединяет параметр URL и Service URL, или параметр Relative Path. При этом, если параметр Service URL или Relative Path содержит абсолютный URL-адрес или путь, то такой абсолютный URL-адрес или путь содержится в этом элементе.
Дополнительные сведения см. в разделе Практическое руководство. Поиск абсолютных URI веб-служб и веб-содержимого в отчетах о развертывании. |
![]() |
---|
Параметры конечной точки поставщика веб-служб или веб-содержимого можно просмотреть, выбрав ее на диаграмме приложения и открыв узел Параметры конечной точки приложения в редакторе параметров и ограничений. Для просмотра параметров конечной точки веб-узла ее можно выбрать на схеме логического центра данных и открыть узел Параметры конечной точки логического сервера в редакторе параметров и ограничений. Дополнительные сведения см. в разделе Редактор параметров и ограничений. |
См. также
Основные понятия
Общие сведения о развертывании с помощью отчетов о развертывании