확장 게시
확장을 개발한 후에는 이 확장을 게시하고 다른 사용자가 테스트하거나 사용할 수 있도록 해야 합니다. 해당 문서는 게시 대상 및 목적에 따라 단계 및 요구 사항과 함께 몇 가지 게시 옵션을 소개합니다.
게시 옵션
Windows Admin Center에서 지원하는 구성 가능한 패키지 원본에 대한 세 가지 기본 옵션은 다음과 같습니다.
- Microsoft 공용 Windows Admin Center NuGet 피드
- 사용자 고유의 프라이빗 NuGet 피드
- 로컬 또는 네트워크 파일 공유
Windows Admin Center 확장 피드에 게시
기본적으로 Windows Admin Center는 Microsoft의 Windows Admin Center 제품 팀에서 유지 관리하는 NuGet 피드에 연결됩니다. Microsoft에서 개발한 새 확장의 초기 미리 보기 버전은 이 피드에 게시되어 Windows Admin Center 사용자가 사용할 수 있습니다. 확장을 공개적으로 빌드하고 릴리스하려는 외부 개발자는 확장을 Windows Admin Center 피드에 게시하라는 요청을 제출할 수도 있습니다. 이 피드에 게시하기 전에 외부 개발자는 Windows Admin Center의 확장 게시자 계약 및 확장 참여 정책에 동의해야 합니다.
다른 NuGet 피드에 게시
또한 고유한 NuGet 피드를 만들어 프라이빗 원본을 설정하거나 NuGet 호스팅 서비스를 사용하기 위한 다양한 옵션 중 하나를 사용하여 확장을 게시할 수 있습니다. NuGet 피드는 NuGet v2 API를 지원해야 합니다. Windows Admin Center는 현재 피드 인증을 지원하지 않으므로 모든 사용자가 읽기 액세스를 허용하도록 피드를 구성해야 합니다.
파일 공유에 게시
확장 프로그램 액세스를 조직 또는 제한된 사용자 그룹으로 제한하려면 SMB 파일 공유를 확장 피드로 사용할 수 있습니다. 파일 공유를 사용하여 확장 피드를 호스트하는 경우 피드에 대한 액세스를 관리하기 위해 파일 및 폴더 권한이 적용됩니다.
릴리스를 위한 확장 준비
다음 개발 문서를 읽고 고려하시길 바랍니다.
미리 보기 릴리스로 출시하는 것이 좋습니다.
평가 목적으로 확장의 미리 보기 버전을 릴리스하는 경우 다음을 수행하는 것이 좋습니다.
.nuspec파일의 확장명 제목 끝에 "(미리 보기)"를 추가합니다..nuspec파일에서 확장명 설명 의 제한 사항 설명
확장 패키지 생성하기
Windows Admin Center는 확장을 배포하고 다운로드하기 위해 NuGet 패키지 및 피드를 활용합니다. 패키지를 배송하려면 플러그 인 및 확장을 포함하는 NuGet 패키지를 생성해야 합니다. 단일 패키지에는 UI 확장 및 게이트웨이 플러그 인이 포함될 수 있습니다. 다음 섹션에서는 이 과정을 단계별로 안내합니다.
확장을 빌드하세요.
확장 패키징을 시작할 준비가 되면 파일 시스템에 새 디렉터리를 생성하고 콘솔을 연 다음 CD를 입력합니다. 해당 디렉터리는 패키지를 구성하는 모든 nuspec 및 콘텐츠 디렉터리를 포함하는 데 사용하는 루트 디렉터리입니다. 이 문서의 나머지 부분에 대해 이 폴더 NuGet Package 를 호출합니다.
UI 확장
UI 확장에 필요한 모든 콘텐츠를 수집하는 프로세스를 시작하려면 도구에서 "gulp 빌드"를 실행하고 빌드가 성공했는지 확인합니다. 이 프로세스는 확장의 루트 디렉터리(src 디렉터리의 동일한 수준)에 있는 "bundle"이라는 폴더에 모든 구성 요소를 함께 패키지합니다. 이 디렉터리와 모든 내용을 "NuGet Package" 폴더에 복사합니다.
게이트웨이 플러그 인
빌드 인프라(Visual Studio를 열고 빌드 단추를 선택하는 것만큼 간단할 수 있음)를 사용하여 플러그 인을 컴파일하고 빌드합니다. 빌드 출력 디렉터리를 열고 플러그 인을 나타내는 DLL 또는 DLL을 복사하여 "package"라는 "NuGet Package" 디렉터리 내의 새 폴더에 배치합니다. FeatureInterface DLL은 복사할 필요가 없으며 코드를 나타내는 DLL만 복사합니다.
nuspec 파일 만들기
NuGet 패키지를 만들려면 먼저 .nuspec 파일을 만들어야 합니다. .nuspec 파일은 NuGet 패키지 메타데이터가 포함된 XML 매니페스트입니다. 이 매니페스트는 패키지를 빌드하고 소비자에게 정보를 제공하는 데 사용됩니다. 이 파일을 "NuGet Package" 폴더의 루트에 배치합니다.
다음은 예제 .nuspec 파일 및 필수 또는 권장 속성 목록입니다. 전체 스키마는 nuspec 참조를 확인하세요. 선택한 파일 이름을 사용하여 프로젝트의 루트 폴더에 .nuspec 파일을 저장합니다.
중요
.nuspec 파일의 <id> 값은 프로젝트 manifest.json 파일의 "name" 값과 일치해야 합니다. 그렇지 않으면 게시된 확장 프로그램이 Windows Admin Center에서 성공적으로 로드되지 않습니다.
<?xml version="1.0">
<package>
<metadata>
<id>contoso.project.extension</id>
<version>1.0.0</version>
<title>Contoso Hello Extension</title>
<authors>Contoso</authors>
<owners>Contoso</owners>
<requireLicenseAcceptance>false</requireLicenseAcceptance>
<projectUrl>https://msft-sme.myget.org/feed/windows-admin-center-feed/package/nuget/contoso.sme.hello-extension</projectUrl>
<licenseUrl>http://YourLicenseLink</licenseUrl>
<iconUrl>http://YourLogoLink</iconUrl>
<description>Hello World extension by Contoso</description>
<copyright>(c) Contoso. All rights reserved.</copyright>
<tags></tags>
</metadata>
<files>
<file src="bundle\**\*.*" target="ux" />
<file src="package\**\*.*" target="gateway" />
</files>
</package>
필수 또는 권장 속성
| 속성 이름 | 필수/권장 | 설명 |
|---|---|---|
| packageType | 필수 | Windows Admin Center 확장에 대해 정의된 NuGet 패키지 유형인 WindowsAdminCenterExtension을 사용합니다. |
| ID | 필수 | 피드 내의 고유 패키지 식별자입니다. 이 값은 프로젝트의 manifest.json 파일의 "name" 값과 일치해야 합니다. 지침은 고유한 패키지 식별자 선택을 참조하세요. |
| title | Windows Admin Center 피드에 게시에 필요. | Windows Admin Center 확장 관리자에 표시되는 패키지 식별 이름입니다. |
| version | 필수 | 확장 버전. 유의적 버전(SemVer 규칙)을 사용하는 것이 좋지만 필수는 아닙니다. |
| authors | 필수 | 회사를 대신하여 게시하는 경우 회사 이름을 사용합니다. |
| description | 필수 | 확장 기능에 대한 설명을 제공합니다. |
| iconUrl | Windows Admin Center 피드에 게시할 때 권장됨 | 확장 관리자에 표시할 아이콘의 URL입니다. |
| projectUrl | Windows Admin Center 피드에 게시에 필요. | 확장 웹 사이트에 대한 URL입니다. 별도의 웹 사이트가 없는 경우 NuGet 피드의 패키지 웹 페이지에 대한 URL을 사용하세요. |
| licenseUrl | Windows Admin Center 피드에 게시에 필요. | 확장의 최종 사용자 라이선스 계약에 대한 URL입니다. |
| files | 필수 | 다음 두 설정은 Windows Admin Center에서 UI 확장 및 게이트웨이 플러그 인에 대해 예상하는 폴더 구조를 설정합니다. |
확장 NuGet 패키지 빌드
만든 .nuspec 파일을 사용하여 이제 NuGet 피드를 업로드하고 게시할 수 있는 NuGet 패키지 .nupkg 파일을 만들어야 합니다.
- NuGet 클라이언트 도구 웹 사이트에서 nuget.exe CLI 도구를 다운로드합니다.
nuget.exe pack <>.nuspec file name>를 실행하여.nupkg파일을 만듭니다.
확장 NuGet 패키지 서명
확장에 포함된 모든 .dll 파일은 신뢰할 수 있는 CA(인증 기관)의 인증서로 서명해야 합니다. 기본적으로 서명되지 않은 .dll 파일은 Windows Admin Center가 프로덕션 모드에서 실행될 때 실행되지 않도록 차단됩니다.
패키지의 무결성을 보장하기 위해 확장 NuGet 패키지에 서명하는 것이 좋습니다.
참고 항목
Windows Defender 애플리케이션 제어를 지원하는 확장을 계획하는 경우 패키지 및 내의 모든 파일에 서명해야 합니다. Windows Defender 애플리케이션 제어를 사용하여 서명하는 방법에 대해 자세히 알아봅니다.
확장 NuGet 패키지 서명 테스트
이제 확장 패키지를 테스트할 준비가 되었습니다! NuGet 피드에 .nupkg 파일을 업로드하거나 파일 공유에 복사합니다. 다른 피드 또는 파일 공유에서 패키지를 보고 다운로드하려면 NuGet 피드 또는 파일 공유를 가리키도록 피드 구성을 변경해야 합니다. 테스트할 때 속성이 확장 관리자에 올바르게 표시되는지 확인하고 확장을 성공적으로 설치하고 제거할 수 있습니다.
Windows Admin Center 피드에 확장 게시
Windows Admin Center 피드에 게시하면 모든 Windows Admin Center 사용자가 확장을 사용할 수 있도록 할 수 있습니다. Windows Admin Center SDK는 아직 미리 보기 상태이므로 개발 문제를 해결하고 사용자에게 양질의 제품 및 환경을 제공할 수 있도록 귀하와 긴밀히 협력하고 싶습니다.
Microsoft에 확장 검토 요청을 제출하기 전에 wacextensionrequest@microsoft.com 확장을 공개 피드에 게시하려는 의도를 나타내는 이메일을 보내야 합니다. Microsoft는 서면으로 검토하고 승인할 확장 게시자 계약 및 확장 참여 정책의 복사본을 제공합니다.
확장의 초기 버전 릴리스 전, 릴리스 최소 2~3주 전에 Microsoft에 확장 검토 요청을 제출하는 것이 좋습니다. 릴리스 2~3주 전에 허용하면 검토할 충분한 시간이 있으며 필요한 경우 확장을 변경할 수 있습니다. 확장을 게시할 준비가 되면 검토를 위해 확장을 Microsoft에 보내야 합니다. 확장이 승인되면 피드에 게시합니다. Microsoft 확장 패키지를 보내면 확장 게시자 계약 및 확장 참여 정책의 조건 준수에 동의합니다.
그 후 확장에 대한 업데이트를 릴리스하려면 검토를 위해 다른 요청을 제출해야 합니다. 변경 범위에 따라 업데이트 검토의 소요 시간은 일반적으로 더 짧습니다.
Microsoft에 확장 검토 요청 제출
확장 검토 요청을 제출하려면 다음 정보를 제공하고 wacextensionrequest@microsoft.com에 이메일을 보냅니다. 1주일 이내에 이메일에 회신해 드립니다.
Windows Admin Center - 확장 검토 요청 정보:
- 확장 소유자/개발자의 이름 및 이메일 주소(최대 3명). 회사를 대신하여 확장을 릴리스하는 경우 회사 이메일 주소를 제공합니다.
- 회사 이름(회사를 대신하여 확장을 릴리스하는 경우에만 필요)
- 확장 이름
- 릴리스 대상 날짜(예상)
- 새 확장 제출의 경우 - 확장 설명(초기 디자인 와이어 프레임, 화면 모형 또는 제품 스크린샷 권장)
- 확장 업데이트 검토의 경우 – 변경 내용에 대한 설명(UI가 크게 변경된 경우 제품 스크린샷 포함)
검토 및 게시를 위해 확장 패키지를 제출합니다.
확장 패키지를 만들기 위한 이전 지침을 따르고 .nuspec 파일이 올바르게 정의되고 파일이 서명되었는지 확인합니다. 또한 다음을 포함한 프로젝트 웹 사이트가 있는 것이 좋습니다.
- 스크린샷 또는 비디오를 포함한 확장에 대한 자세한 설명
- 피드백 또는 질문을 받는 이메일 주소 또는 웹 사이트 기능
확장을 게시할 준비가 되면 wacextensionrequest@microsoft.com에 이메일을 보냅니다. 확장 패키지를 보내는 방법에 대한 지침을 제공합니다. 귀하의 패키지를 접수한 후 검토하겠습니다. 확장 패키지가 승인되면 Windows Admin Center 피드에 게시합니다.