Udostępnij za pośrednictwem

IISWebAppDeployment@1 — wdrożenie aplikacji internetowej usług IIS (przestarzałe) w wersji 1

  • Artykuł

To zadanie służy do wdrażania aplikacji internetowej usług IIS przy użyciu narzędzia MSDeploy, a następnie tworzenia lub aktualizowania witryn internetowych i pul aplikacji.

Ważne

To zadanie jest przestarzałe i zostanie wycofane 31 stycznia 2024 r. Użyj wdrażania aplikacji internetowej usług IIS przy użyciu usługi WinRM — Viual Studio Marketplace.

To zadanie służy do wdrażania aplikacji internetowej usług IIS przy użyciu narzędzia MSDeploy, a następnie tworzenia lub aktualizowania witryn internetowych i pul aplikacji.

Ważne

To zadanie jest przestarzałe. Użyj wdrażania aplikacji internetowej usług IIS przy użyciu usługi WinRM — Viual Studio Marketplace.

Składnia

# IIS Web App deployment (Deprecated) v1
# Deploy using MSDeploy, then create/update websites and app pools.
- task: IISWebAppDeployment@1
  inputs:
    EnvironmentName: # string. Required. Machines. 
    #AdminUserName: # string. Admin Login. 
    #AdminPassword: # string. Password. 
    #WinRMProtocol: # 'Http' | 'Https'. Protocol. 
    #TestCertificate: true # boolean. Optional. Use when WinRMProtocol = Https. Test Certificate. Default: true.
  # Deployment
    WebDeployPackage: # string. Required. Web Deploy Package. 
    #WebDeployParamFile: # string. Web Deploy Parameter File. 
    #OverRideParams: # string. Override Parameters. 
  # Website
    #CreateWebSite: false # boolean. Create or Update Website. Default: false.
    #WebSiteName: # string. Required when CreateWebSite = true. Website Name. 
    #WebSitePhysicalPath: '%SystemDrive%\inetpub\wwwroot' # string. Required when CreateWebSite = true. Physical Path. Default: %SystemDrive%\inetpub\wwwroot.
    #WebSitePhysicalPathAuth: 'Application User (Pass-through)' # 'WebSiteUserPassThrough' | 'WebSiteWindowsAuth'. Required when CreateWebSite = true. Physical Path Authentication. Default: Application User (Pass-through).
    #WebSiteAuthUserName: # string. Required when WebSitePhysicalPathAuth = WebSiteWindowsAuth. User Name. 
    #WebSiteAuthUserPassword: # string. Optional. Use when WebSitePhysicalPathAuth = WebSiteWindowsAuth. Password. 
    #AddBinding: true # boolean. Optional. Use when CreateWebSite = true. Add Binding. Default: true.
    #AssignDuplicateBinding: false # boolean. Optional. Use when AddBinding = true. Assign Duplicate Binding. Default: false.
    Protocol: 'http' # 'https' | 'http'. Required when AddBinding = true. Protocol. Default: http.
    IPAddress: 'All Unassigned' # string. Required when AddBinding = true. IP Address. Default: All Unassigned.
    Port: '80' # string. Required when AddBinding = true. Port. Default: 80.
    #ServerNameIndication: false # boolean. Optional. Use when Protocol = https. Server Name Indication Required. Default: false.
    #HostNameWithOutSNI: # string. Optional. Use when ServerNameIndication = false. Host Name. 
    #HostNameWithHttp: # string. Optional. Use when Protocol = http. Host Name. 
    #HostNameWithSNI: # string. Required when ServerNameIndication = true. Host Name. 
    #SSLCertThumbPrint: # string. Required when Protocol = https. SSL Certificate Thumb Print. 
  # Application Pool
    #CreateAppPool: false # boolean. Create or Update Application Pool. Default: false.
    #AppPoolName: # string. Required when CreateAppPool = true. Name. 
    #DotNetVersion: 'v4.0' # 'v4.0' | 'v2.0' | 'No Managed Code'. Required when CreateAppPool = true. .NET Version. Default: v4.0.
    #PipeLineMode: 'Integrated' # 'Integrated' | 'Classic'. Required when CreateAppPool = true. Managed Pipeline Mode. Default: Integrated.
    #AppPoolIdentity: 'ApplicationPoolIdentity' # 'ApplicationPoolIdentity' | 'LocalService' | 'LocalSystem' | 'NetworkService' | 'SpecificUser'. Required when CreateAppPool = true. Identity. Default: ApplicationPoolIdentity.
    #AppPoolUsername: # string. Required when AppPoolIdentity = SpecificUser. Username. 
    #AppPoolPassword: # string. Optional. Use when AppPoolIdentity = SpecificUser. Password. 
  # Advanced
    #AppCmdCommands: # string. Additional AppCmd.exe Commands. 
    #DeployInParallel: true # boolean. Deploy in Parallel. Default: true.
    #ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Select Machines By. Default: machineNames.
    #MachineFilter: # string. Deploy to Machines.

Dane wejściowe

EnvironmentName - Machines
string. To jest wymagane.

Określa rozdzielaną przecinkami listę adresów IP maszyny lub nazw FQDN wraz z portami. Port domyślny jest oparty na wybranym protokole, na przykład dbserver.fabrikam.com lub dbserver_int.fabrikam.com:5986,192.168.12.34:5986. Można również podać zmienną wyjściową innych zadań, na przykład $(variableName).


logowania administratora AdminUserName -
string.

Określa identyfikator logowania administratora dla maszyn docelowych.


haseł AdminPassword -
string.

Określa hasło administratora dla maszyn docelowych. Może akceptować zmienne zdefiniowane w definicjach kompilacji/wydania, takich jak $(passwordVariable). Możesz oznaczyć typ zmiennej jako secret, aby go zabezpieczyć.


protokołu WinRMProtocol -
string. Dozwolone wartości: Http, Https.

Określa protokół używany do połączenia Usługi WinRM z maszynami. Wartość domyślna to HTTPS.


TestCertificate - certyfikatu testowego
boolean. Opcjonalny. Użyj polecenia , gdy WinRMProtocol = Https. Wartość domyślna: true.

Wybiera opcję pomijania weryfikacji autentyczności certyfikatu maszyny przez zaufany urząd certyfikacji. Parametr jest wymagany dla protokołu HTTPS Usługi WinRM.


WebDeployPackage - web deploy package
string. To jest wymagane.

Określa lokalizację pliku zip web deploy (MSDeploy) na maszynach docelowych lub na ścieżce UNC, na przykład \\BudgetIT\WebDeploy\WebDeployPackage.zip. Ścieżka UNC powinna być dostępna dla konta administratora komputera. Zmienne środowiskowe są również obsługiwane, takie jak $env:windir, $env:systemrooti $env:windir\FabrikamFibre\Web.


WebDeployParamFile - pliku parametrów web deploy
string.

Określa lokalizację pliku parametrów na maszynach docelowych lub na ścieżce UNC. Plik parametrów służy do zastępowania ustawień konfiguracji aplikacji sieci Web, takich jak nazwa aplikacji sieci Web usług IIS lub parametry połączenia bazy danych.


OverRideParams - przesłonięcia parametrów
string.

Parametry określone w tym miejscu zastąpią parametry w pliku ZIP MSDeploy i pliku parametrów. Aby zastąpić więcej niż jeden parametr, użyj separatora linii.
Na przykład: "IIS Web Application Name"="Fabrikam" lub "ConnectionString"="Server=localhost;Database=Fabrikam;".


CreateWebSite - tworzenie lub aktualizowanie witryny sieci Web
boolean. Wartość domyślna: false.

Określa opcję utworzenia witryny internetowej lub zaktualizowania istniejącej witryny internetowej.


WebSiteName - nazwa witryny sieci Web
string. Wymagane, gdy CreateWebSite = true.

Określa nazwę witryny sieci Web usług IIS, która zostanie utworzona, jeśli nie istnieje lub zostanie zaktualizowana, jeśli jest już obecna na serwerze usług IIS. Nazwa witryny sieci Web powinna być taka sama jak określona w pliku pakietu zip w programie Web Deploy. Jeśli określono również ustawienie pliku parametrów i przesłonięcia parametrów, nazwa witryny internetowej powinna być taka sama jak w ustawieniu przesłonięć parametrów.


WebSitePhysicalPath - ścieżka fizyczna
string. Wymagane, gdy CreateWebSite = true. Wartość domyślna: %SystemDrive%\inetpub\wwwroot.

Określa ścieżkę fizyczną, w której jest przechowywana zawartość witryny internetowej. Zawartość może znajdować się na komputerze lokalnym lub w katalogu zdalnym lub udziale, na przykład C:\Fabrikam lub \\ContentShare\Fabrikam.


WebSitePhysicalPathAuth - uwierzytelniania ścieżek fizycznych
string. Wymagane, gdy CreateWebSite = true. Dozwolone wartości: WebSiteUserPassThrough (użytkownik aplikacji (przekazywanie)), WebSiteWindowsAuth (uwierzytelnianie systemu Windows). Wartość domyślna: Application User (Pass-through).

Określa mechanizm uwierzytelniania na potrzeby uzyskiwania dostępu do ścieżki fizycznej witryny internetowej.


WebSiteAuthUserName - nazwa użytkownika
string. Wymagane, gdy WebSitePhysicalPathAuth = WebSiteWindowsAuth.

Określa nazwę użytkownika na potrzeby uzyskiwania dostępu do ścieżki fizycznej witryny internetowej.


haseł WebSiteAuthUserPassword -
string. Opcjonalny. Użyj polecenia , gdy WebSitePhysicalPathAuth = WebSiteWindowsAuth.

Określa hasło dostępu do ścieżki fizycznej witryny internetowej. Jeśli używasz konta zarządzanego przez użytkownika, nie jest to wymagane.


AddBinding - dodawanie powiązań
boolean. Opcjonalny. Użyj polecenia , gdy CreateWebSite = true. Wartość domyślna: true.

Określa opcję dodawania powiązania portów dla witryny internetowej.


AssignDuplicateBinding - przypisz zduplikowane powiązanie
boolean. Opcjonalny. Użyj polecenia , gdy AddBinding = true. Wartość domyślna: false.

Określa opcję dodawania powiązań określonych tutaj (nawet jeśli istnieje inna witryna internetowa z tymi samymi powiązaniami). Jeśli występują konflikty powiązań, rozpocznie się tylko jedna z witryn sieci Web.


protokołu Protocol -
string. Wymagane, gdy AddBinding = true. Dozwolone wartości: https, http. Wartość domyślna: http.

Określa protokół HTTP dla witryny internetowej, aby mieć powiązanie HTTP lub HTTPS, aby witryna internetowa miała powiązanie Secure Sockets Layer (SSL).


IPAddress - adres IP
string. Wymagane, gdy AddBinding = true. Wartość domyślna: All Unassigned.

Określa adres IP, którego użytkownicy mogą używać do uzyskiwania dostępu do witryny internetowej. Jeśli wybrano wszystkie nieprzypisane, witryna będzie odpowiadać na żądania dotyczące wszystkich adresów IP na porcie i opcjonalnej nazwy hosta określonej dla lokacji. Lokacja nie odpowie na żądania, jeśli inna lokacja na serwerze ma powiązanie na tym samym porcie, ale z określonym adresem IP.


Port - Port
string. Wymagane, gdy AddBinding = true. Wartość domyślna: 80.

Określa port, na którym stos protokołu hypertext Transfer (HTTP.sys) musi być monitorowany pod kątem żądań wysyłanych do tej witryny internetowej.


ServerNameIndication - wskazanie nazwy serwera wymagane
boolean. Opcjonalny. Użyj polecenia , gdy Protocol = https. Wartość domyślna: false.

Określa, czy witryna sieci Web wymaga wskazania nazwy serwera (SNI). SNI rozszerza protokoły SSL i TLS, aby wskazać, z jaką nazwą hosta klient próbuje nawiązać połączenie. Umożliwia wielu bezpiecznym witrynom internetowym z różnymi certyfikatami używanie tego samego adresu IP.


HostNameWithOutSNI - nazwa hosta
string. Opcjonalny. Użyj polecenia , gdy ServerNameIndication = false.

Przypisuje co najmniej jedną nazwę hosta (lub nazwy domen) do komputera używającego jednego adresu IP. Jeśli określono nazwę hosta, klienci muszą używać nazwy hosta zamiast adresu IP, aby uzyskać dostęp do witryny internetowej.


HostNameWithHttp - nazwa hosta
string. Opcjonalny. Użyj polecenia , gdy Protocol = http.

Przypisuje co najmniej jedną nazwę hosta (lub nazwy domen) do komputera używającego jednego adresu IP. Jeśli określono nazwę hosta, klienci muszą używać nazwy hosta zamiast adresu IP, aby uzyskać dostęp do witryny internetowej.


HostNameWithSNI - nazwa hosta
string. Wymagane, gdy ServerNameIndication = true.

Przypisuje co najmniej jedną nazwę hosta (lub nazwy domen) do komputera używającego jednego adresu IP. Jeśli określono nazwę hosta, klienci muszą używać nazwy hosta zamiast adresu IP, aby uzyskać dostęp do witryny internetowej.


SSLCertThumbPrint - odcisk palca certyfikatu SSL
string. Wymagane, gdy Protocol = https.

Określa odcisk palca certyfikatu Secure Socket Layer, który będzie używany przez witrynę internetową. Certyfikat powinien być już zainstalowany na maszynie i znajdujący się w magazynie Osobistym komputera lokalnego.


CreateAppPool - tworzenie lub aktualizowanie puli aplikacji
boolean. Wartość domyślna: false.

Określa opcję utworzenia puli aplikacji lub zaktualizowania istniejącej puli aplikacji.


AppPoolName - nazwa
string. Wymagane, gdy CreateAppPool = true.

Określa nazwę puli aplikacji usług IIS do utworzenia lub zaktualizowania. Istniejąca pula aplikacji zostanie zaktualizowana o określone ustawienia.


DotNetVersion - wersji platformy .NET
string. Wymagane, gdy CreateAppPool = true. Dozwolone wartości: v4.0, v2.0, No Managed Code. Wartość domyślna: v4.0.

Określa wersję programu .NET Framework ładowaną przez tę pulę aplikacji. Jeśli aplikacje przypisane do tej puli aplikacji nie zawierają kodu zarządzanego, wybierz opcję Brak kodu zarządzanego z listy.


trybu zarządzanego potoku PipeLineMode -
string. Wymagane, gdy CreateAppPool = true. Dozwolone wartości: Integrated, Classic. Wartość domyślna: Integrated.

Tryb zarządzanego potoku określa, w jaki sposób usługi IIS przetwarzają żądania dotyczące zawartości zarządzanej. Używaj trybu klasycznego tylko wtedy, gdy aplikacje w puli aplikacji nie mogą działać w trybie zintegrowanym.


AppPoolIdentity - Identity
string. Wymagane, gdy CreateAppPool = true. Dozwolone wartości: ApplicationPoolIdentity, LocalService, LocalSystem, NetworkService, SpecificUser (konto niestandardowe). Wartość domyślna: ApplicationPoolIdentity.

Konfiguruje konto, na którym jest uruchamiany proces roboczy puli aplikacji. Określ jedno ze wstępnie zdefiniowanych kont zabezpieczeń lub skonfiguruj konto niestandardowe.


nazwy użytkownika AppPoolUsername -
string. Wymagane, gdy AppPoolIdentity = SpecificUser.


haseł AppPoolPassword -
string. Opcjonalny. Użyj polecenia , gdy AppPoolIdentity = SpecificUser.

Jeśli używasz konta zarządzanego przez użytkownika, nie jest to wymagane.


AppCmdCommands - dodatkowe polecenia AppCmd.exe
string.

Określa dodatkowe polecenia AppCmd.exe, aby ustawić właściwości witryny internetowej lub puli aplikacji. W przypadku więcej niż jednego polecenia użyj separatora wiersza.
Na przykład:
<listy pul aplikacji>
<witryn listy>


DeployInParallel - Wdrażanie w równoległych
boolean. Wartość domyślna: true.

Jeśli ustawiono wartość true, aplikacja internetowa jest wdrażana równolegle na maszynach docelowych.


ResourceFilteringMethod - wybierz maszyny według
string. Dozwolone wartości: machineNames (nazwy maszyn), tags. Wartość domyślna: machineNames.

Opcjonalny. Określa podzbiór maszyn, podając nazwy maszyn lub tagi.


MachineFilter - Wdrażanie na maszynach
string.

Te dane wejściowe są prawidłowe tylko dla grup maszyn i nie są jeszcze obsługiwane dla płaskiej listy maszyn lub zmiennych wyjściowych.

Określa listę maszyn, takich jak dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34 lub tagów, takich jak Role:DB; OS:Win8.1. Jeśli podano wiele tagów, zadanie zostanie uruchomione na wszystkich maszynach z określonymi tagami. W obszarze Grupy zasobów platformy Azure określ nazwę maszyny wirtualnej, taką jak ffweb, ffdb. Domyślnie uruchamia zadanie na wszystkich maszynach.


Opcje sterowania zadaniami

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań podrzędnych. Aby uzyskać więcej informacji, zobacz opcje kontroli i typowe właściwości zadań.

Zmienne wyjściowe

Żaden.

Uwagi

Ważne

To zadanie jest przestarzałe. Użyj wdrażania aplikacji internetowej usług IIS przy użyciu usługi WinRM — Viual Studio Marketplace.

Wymagania

Wymaganie Opis
Typy potoków YAML, klasyczna kompilacja, wersja klasyczna
Działa na Agent, DeploymentGroup
Wymagania Żaden
możliwości To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
ograniczenia poleceń Jakikolwiek
zmienne ustawiane Jakikolwiek
Wersja agenta 1.91.0 lub nowsza
Kategoria zadań Wdroż