Microsoft Web Deploy v3 추가 정보
가혹한 미탈에 의해
개요
웹 배포는 웹 애플리케이션, 사이트 및 서버의 마이그레이션, 관리 및 배포를 간소화하기 위한 도구입니다. 콘텐츠, 구성, 인증서 및 데이터베이스를 포함하여 웹 사이트를 자동으로 패키지하는 데 사용할 수 있습니다. IIS 6.0, IIS 7.x 및 IIS8.0 간에 동기화하거나 IIS 6.0, IIS7.x에서 IIS 7.x 이상으로 마이그레이션하는 데 사용할 수 있습니다. 만든 패키지는 버전 관리, 백업 또는 배포에 사용할 수 있습니다.
기능
웹 배포에는 다음과 같은 주요 기능이 포함되어 있습니다.
패키지 웹 사이트 및 애플리케이션: 개발자 또는 관리자는 SQL 데이터베이스를 포함하여 설치된 웹 애플리케이션의 구성 및 콘텐츠를 패키지하고 스토리지 또는 재배포에 패키지를 사용할 수 있습니다. 그런 다음, 이러한 패키지는 원격 서버에서 관리 권한을 요구하지 않고 IIS Manager 인터페이스를 사용하여 배포할 수 있습니다.
관리자가 아닌 사용자에게 배포 작업을 위임합니다. 서버 관리자는 관리자가 아닌 사용자에게 배포 작업을 위임하도록 선택할 수 있습니다. 예를 들어 공유 호스팅 및 엔터프라이즈 환경 모두에서 콘텐츠를 배포하고 폴더를 애플리케이션으로 표시할 수 있습니다. 인증서, 웹 사이트 또는 GAC 어셈블리를 배포할 수 있도록 허용하는 등 전용 환경에 적합한 고급 작업을 사용하도록 설정할 수도 있습니다.
관리자를 위한 배포를 간소화합니다. 서버 관리자는 GAC의 어셈블리, 인증서 및 애플리케이션 풀을 포함한 웹 애플리케이션을 배포하는 데 필요한 모든 권한으로도 시간이 오래 걸릴 수 있으므로 위임이 유용하다는 것을 알게 됩니다.
IIS 6.0 및 IIS7에서 마이그레이션: 마이그레이션 작업은 관리자에게 설정 및 콘텐츠를 포함하여 사이트 또는 전체 서버를 IIS 6.0에서 IIS 7 이상으로, IIS7에서 IIS8로 마이그레이션하는 방법을 제공합니다. 마이그레이션은 기본적으로 마이그레이션 규칙에 따라 필터링되는 동기화 방법입니다.
IIS 6.0/IIS 7/IIS8.0 동기화 동기화 작업은 관리자에게 사이트 또는 서버를 신속하게 동기화하고 기존 사이트 및 서버에 변경 내용을 배포하는 방법을 제공합니다. 동기화를 사용하면 하나의 원본을 하나의 대상과 동기화할 수 있습니다. 예를 들어 두 개의 디렉터리 경로 또는 두 개의 웹 서버를 동기화할 수 있습니다. 로컬 또는 원격 개체를 사용하여 동기화를 수행할 수 있습니다.
스냅샷 IIS 7.0 이상 스냅샷 또는 보관 기능을 사용하면 관리자 또는 개발자가 롤백, 복원 또는 백업을 위해 웹 사이트 또는 서버의 보관을 신속하게 수행할 수 있습니다. 또한 자동 스냅샷 기능을 사용하면 웹 사이트 관리자가 위의 작업 중 일부를 셀프 서비스할 수 있습니다.
IIS 6.0 이상 종속성 분석 분석 작업을 통해 관리자는 원본 서버에 설치된 구성 요소를 검사 수 있습니다. 이러한 방식으로 IIS 7.0에 필요한 기능이 있는지 또는 단순히 파일을 복사하는 것보다 고급 설정이 필요한지 확인할 수 있습니다.
문제 해결 및 유효성 검사. 작업의 유효성을 검사하기 위해 -whatif 매개 변수를 사용하면 관리자가 작업을 수행할 때 어떤 작업이 발생하는지 확인할 수 있습니다. 이는 동기화 또는 마이그레이션을 수행하기 전에 변경될 내용의 유효성을 검사하려는 경우에 특히 유용합니다. 문제 해결을 위해 -verbose 매개 변수를 사용하면 관리자가 수행 중인 작업과 실패 시 문제 진단 기능에 대한 자세한 정보를 얻을 수 있습니다.
차등 동기화. 이 도구는 원본과 대상 간에 변경된 내용만 동기화합니다.
PowerShell을 통한 간편한 스크립팅: 일반적인 웹 배포 작업은 PowerShell cmdlet을 사용하여 자동화할 수 있습니다.
설치 참고 사항
요구 사항
도구를 설치하려면 다음 필수 구성 요소를 충족해야 합니다.
· .NET 2.0 SP1 이상이 설치되어 있어야 합니다.
다운로드 및 설치
도구에는 두 개의 별도 다운로드 가능한 패키지가 있습니다. 적절한 패키지를 다운로드해야 합니다. (x86) 또는 (x64) 버전을 다운로드할 수 있습니다.
이 릴리스에서 해결된 중요한 문제:
변경: 이전 버전의 웹 배포에서는 tempAgent 서비스가 항상 포트 80에서 실행됩니다. 웹 배포 v3 RC에서 computername=serverName:#### 형식을 사용하여 computername 인수에 새 포트를 지정하여 이 포트를 변경할 수 있습니다. tempagent=true(여기서 #####은 사용할 포트 번호임).
변경: -useCheckSum 옵션을 사용할 때 변경 횟수가 -whatif 작업에 대해 정확하지 않은 웹 배포 문제를 해결했습니다.
변경: 웹 배포 V3 프록시 설정을 자동으로 사용하지 않도록 설정합니다. 이전에는 동기화를 시작하기 전에 인터넷 Explorer 열고 프록시 설정을 사용하지 않도록 설정해야 하는 일부 클라이언트의 문제였습니다.
변경: 인증서 동기화 논리에서 IPv6 스타일 바인딩에 대한 지원이 추가되었습니다. 이전 버전에서 IPv6 바인딩을 제대로 동기화할 수 없습니다.
변경: 부모 레지스트리 키가 없는 서버에 자식 레지스트리 키를 동기화할 때 이제 동기화 실패가 아니라 자식 키까지 부모 레지스트리 키가 생성됩니다(값 없음). 예를 들어 대상 컴퓨터에 MySoft 키가 없는 레지스트리 키를 HKEY_LOCAL_MACHINE\SOFTWARE\MySoft\TestWeb1 동기화하면 대상 컴퓨터에 MySoft 키가 만들어지며 동기화가 성공할 수 있습니다.
변경: 경우에 따라 웹 배포 게시가 사이트의 루트 폴더에 대한 상속된 권한을 제거했습니다. 웹 배포 V3에서 이 문제를 해결합니다.
알려진 문제
문제: 웹 배포 v3 업그레이드는 웹 배포 v2를 사용하여 작업하던 SQLite 동기화를 중단합니다.
웹 배포 v3 실행 파일(msdeploy.exe.config 및 msdepsvc.exe.config)이 .Net 2.0에서 .Net 4.0으로 업데이트되어 이 중단이 발생합니다.
해결 방법:
- SQLite에는 .Net 4 호환 버전이 있습니다. "%ProgramFiles%\IIS\Microsoft Web Deploy V3" 디렉터리의 이 릴리스에서 sqlite3.exe 복사하면 문제가 resolve.
- 아래와 같이 WebDeploy V3 msdeploy.exe.config 기본 .Net 버전을 .Net 2.0으로 변경
<configuration>
<startup>
<supportedRuntime version="v2.0.50727" />
<supportedRuntime version="v4.0" />
</startup>
</configuration>
문제: 웹 배포 에이전트 서비스는 관리자 사용자 계정이 아니라 Administrators 그룹의 구성원인 로컬 사용자 계정에서 작동하지 않습니다. ERROR_USER_NOT_ADMIN 오류가 반환됩니다.
원격 에이전트 서비스는 기본 제공 관리자 또는 도메인 관리자 자격 증명 을 수락합니다. 다른 관리자 자격 증명은 작동하지 않으며 이 오류가 발생합니다.
해결 방법:
기본 제공 관리자 계정 또는 도메인 사용자 계정(로컬 컴퓨터의 관리 그룹의 일부)을 사용합니다. 원격 에이전트 서비스는 기본 제공 관리자 또는 도메인 관리자 자격 증명을 허용합니다. 비 도메인 설정이 있고 기본 제공 관리자인 다른 계정을 사용하려는 경우 다음을 수행하세요.
- 원격 컴퓨터에서 별도의 사용자 그룹 MSDepSvcUsers를 만듭니다.
- 로컬 & 원격 컴퓨터 모두에서 로컬 계정 A를 크레이트합니다.
- 원격 컴퓨터의 MSDepSvcUsers에 A를 추가합니다.
- 계정 A를 사용하여 게시하면 기본 제공 관리자 계정을 사용하지 않고도 게시할 수 있습니다.
문제: 웹 배포가 웹 배포 3.0으로 업그레이드된 후 일부 관리 서비스 위임 규칙이 작동하지 않습니다.
IIS 7+ 서버가 공유 구성을 사용하는 경우 runAs ID가 SpecificUser로 설정된 특정 위임 규칙이 작동을 중지합니다. 이는 웹 배포 설치 관리자와 .\AddDelegationRules.ps1 스크립트가 로컬 컴퓨터 사용자 계정을 만들고 특정 위임 규칙에서 runAs ID로 설정하기 때문입니다. 이러한 사용자 계정은 다른 컴퓨터에서 인식되지 않으므로 공유 구성에서 규칙이 작동하지 않습니다.
해결 방법:
· 위임 규칙을 이미 덮어쓴 경우 영향을 받는 규칙을 수동으로 다시 만듭니다.
문제: SetupSiteForPublish.ps1 PowerShell 스크립트를 사용하여 만들거나 "웹 배포 게시 구성..."을 통해 웹 배포 게시를 위해 구성된 사이트에 게시할 수 없습니다. Ui
사이트 만들기 스크립트와 기존 사이트에 대한 웹 배포를 구성하는 UI는 게시 URL을 로 https://myserver:8172/msdeploy.axd
설정합니다. 이 컴퓨터 이름은 일반적으로 네트워크 내에서 연결할 수 있습니다. 그러나 네트워크 외부에서 연결할 수 없는 경우가 많으므로 공용 DNS 이름으로 바꿔야 합니다.
해결 방법:
- 스크립트에서: 스크립트는 이 오류에 대해 경고하지 않습니다. URL을 생성된 설정 파일의 올바른 URL(아래와 같이)으로 바꿉니다.
- UI에서: "게시 서버 연결의 URL 지정" 필드에 공용 DNS 이름을 입력합니다(예: 대신
https://myserver:8172/msdeploy.axd
). 를 입력합니다https://some.publicDnsName.com:8172/msdeploy.axd
.
문제: 웹 배포 V3을 사용하여 만든 패키지는 WebDeploy V2에서 작동하지 않습니다. 그러면 System.NullReferenceException이 발생합니다.
해결 방법:
- 대상 컴퓨터를 웹 배포 v3으로 업그레이드
- 웹 배포 V2를 사용하여 패키지를 만듭니다.
문제: IIS 관리자의 웹 배포 UI에서 "형식의 개체를 캐스팅할 수 없음" 오류가 발생합니다.
대상 컴퓨터에 Web Deploy v1.1이 설치되어 있고 원본 컴퓨터에 v2가 설치된 경우 이 오류가 표시될 수 있습니다. 이는 버전 간 비호환성입니다.
해결 방법:
- 원본 컴퓨터를 웹 배포 v2로 업그레이드
- 원본 컴퓨터에서 모든 버전의 웹 배포 제거
문제: IIS 6.0 컴퓨터를 많은 사이트(메타베이스가 500MB 이상)와 동기화하는 경우 도구가 중단되고 응답을 중지할 수 있습니다.
해결 방법:
사이트 목록을 만들고 각 사이트를 개별적으로 동기화합니다.
문제: 컴퓨터에서 콘텐츠 또는 공유 구성이 세 번째 별도의 컴퓨터(즉, UNC)에 있는 원격 머신으로 동기화하는 경우 원격 에이전트가 제대로 인증할 수 없습니다.
해결 방법:
수동으로 동기화하거나 웹 배포 처리기를 대신 사용합니다.
문제: 공유 구성 설정(예: 공유 구성 사용 또는 사용 안 함)을 변경하는 경우 나중에 원격 에이전트를 다시 시작해야 합니다.
해결 방법:
공유 구성을 변경한 후 에이전트를 다시 시작합니다.
문제: 경로가 시스템 드라이브가 다른 대상 웹 사이트(D:가 아닌 C:)에 대한 웹 %systemdrive%\wwwroot
사이트를 동기화하는 경우 웹 사이트의 경로가 대상에서 확장됩니다. 즉, 서로 다른 시스템 드라이브와 구성 수단을 공유하고 콘텐츠가 작동하는지 확인하기 위해 를 사용하는 %systemdrive%
경우 컴퓨터에서 사이트를 중단할 수 있습니다.
해결 방법:
동기화하는 동안 경로를 변경하는 바꾸기 규칙을 추가합니다.
문제: 기존 패키지 파일로 패키지하려고 하면 제대로 작동하지 않을 수 있습니다.
해결 방법:
새 패키지를 만들기 전에 새 이름을 사용하거나 이전 패키지 파일을 삭제합니다.
문제: 파일이 웹 사이트의 콘텐츠 디렉터리에 없는 한 Microsoft 웹 배포는 웹 서비스 확장 제한 목록에서 참조되는 스크립트 맵 및 항목에 대한 물리적 파일을 이동하지 않습니다. 많은 ISAPI가 다음과 같이 올바르게 마이그레이션되지 않을 수 있기 때문입니다.
- ASP.NET(설치 필요).
- WebDAV(기본적으로 Windows Server 2008에 포함되지 않으며 추가 설치가 필요함).
- FrontPage 서버 확장(기본적으로 Windows Server 2008에 포함되지 않으며 추가 설치가 필요함).
해결 방법:
매니페스트 파일에 설치할 필요가 없는 스크립트 맵 또는 파일을 수동으로 포함합니다. 매니페스트 파일을 만드는 방법에 대한 자세한 내용은 도움말을 참조하세요.
문제: 루트 수준 Web.config 참조된 사용자 지정 신뢰 파일 및 CAS(코드 액세스 보안) 정책 설정은 이동되지 않습니다.
해결 방법:
매니페스트 파일에서 사용자 지정 신뢰 파일 및 CAS 정책 파일(security.config)을 수동으로 지정합니다. 매니페스트 파일을 만드는 방법에 대한 자세한 내용은 도움말 파일을 참조하세요.
문제: 다른 신뢰 수준이 있는 서버로 사이트를 이동하는 경우 경고가 표시되지 않습니다.
해결 방법:
사이트 수준 동기화 또는 마이그레이션을 수행할 때 대상 컴퓨터에서 신뢰 수준이 올바르게 설정되어 있는지 확인하세요.
문제: 잘못된 원본을 가리키는 사용자 지정 매니페스트 파일이 있는 경우 오류가 표시되지 않을 수 있습니다.
해결 방법:
매니페스트 파일을 사용할 때 예상 출력이 표시되지 않는 경우 각 항목을 개별적으로 시도하여 잘못 입력되었는지 또는 잘못된지 확인합니다.
문제: FTP 및 SMTP는 webserver60에 대한 기본 정의에 포함되지 않습니다.
해결 방법:
이러한 위치를 동기화해야 하는 경우 메타키 공급자(예: metakey=lm/msftpsvc)를 사용하여 수동으로 동기화합니다.
문제: 상속된 속성은 IIS 6.0 사이트 마이그레이션을 통해 마이그레이션되지 않습니다. 일반적인 예는 이 속성을 상속하는 모든 사이트가 있는 서버 수준에서 설정된 인증입니다. 단일 사이트를 마이그레이션하면 새 대상 서버의 설정이 상속됩니다. 대상 서버 설정이 동일하지 않으면 사이트가 끊어질 수 있습니다. 이는 mime 맵, 스크립트 맵 등을 포함하여 상속된 모든 속성에 적용됩니다.
해결 방법:
IIS 6.0에서 웹 사이트를 동기화하거나 마이그레이션할 때 메타데이터GetInherited 플래그를 사용하여 상속된 설정을 사이트 수준으로 복사합니다. 또는 원본 및 대상 서버에서 서버 설정이 동일한지 확인하거나 올바른 설정을 사용하도록 사이트를 수동으로 설정합니다.
설치 문제 해결
설치하는 동안 문제가 발생하는 경우 Windows 버전에 대해 아래에 나열된 적절한 명령을 실행하여 설치 프로세스에 대한 정보를 포함하는 로그 파일을 만들 수 있습니다.
msiexec /L msdeployinstall.log /I <path_to_msi>
msiexec /L msdeployinstall.log /I <path_to_msi>
설치에 실패한 후 이 로그 파일을 분석하여 오류의 원인을 확인할 수 있습니다.
참조 항목
웹 배포에 대한 다음 추가 리소스는 IIS.net 사용할 수 있습니다.
- 웹 배포 연습. 웹 배포를 다운로드 및 설치하는 방법, 동기화 또는 마이그레이션 작업에 사용하는 방법 등에 대해 설명합니다.
- 또한 도구에 대한 팁, 요령 및 최신 정보는 웹 배포 팀 블로그 를 참조하세요.