확장 게시

아티클
10/06/2023

적용 대상: Windows 관리 Center, Windows 관리 Center 미리 보기

확장을 개발한 후에는 확장을 게시하고 다른 사용자가 테스트하거나 사용할 수 있도록 해야 합니다. 이 문서에서는 대상 그룹 및 게시 목적에 따라 단계 및 요구 사항과 함께 몇 가지 게시 옵션을 소개합니다.

게시 옵션

Windows 관리 Center에서 지원하는 구성 가능한 패키지 원본에 대한 세 가지 기본 옵션이 있습니다.

Microsoft 공용 Windows 관리 Center NuGet 피드
사용자 고유의 프라이빗 NuGet 피드
로컬 또는 네트워크 파일 공유

Windows 관리 Center 확장 피드에 게시

기본적으로 Windows 관리 Center는 Microsoft의 Windows 관리 Center 제품 팀에서 기본 NuGet 피드에 연결됩니다. Microsoft에서 개발한 새 확장의 초기 미리 보기 버전은 이 피드에 게시하고 Windows 관리 Center 사용자가 사용할 수 있습니다. 확장을 공개적으로 빌드하고 릴리스하려는 외부 개발자는 Windows 관리 Center 피드에 확장 게시 요청을 제출할 수도 있습니다. 이 피드에 게시하기 전에 외부 개발자는 Windows 관리 Center의 확장 게시자 계약 및 확장 참여 정책에 동의해야 합니다.

다른 NuGet 피드에 게시

또한 고유한 NuGet 피드를 만들어 프라이빗 원본을 설정하거나 NuGet 호스팅 서비스를 사용하기 위한 다양한 옵션 중 하나를 사용하여 확장을 게시할 수 있습니다. NuGet 피드는 NuGet v2 API를 지원해야 합니다. Windows 관리 Center는 현재 피드 인증을 지원하지 않으므로 모든 사용자가 읽기 액세스를 허용하도록 피드를 구성해야 합니다.

확장 프로그램 액세스를 조직 또는 제한된 사용자 그룹으로 제한하려면 SMB 파일 공유를 확장 피드로 사용할 수 있습니다. 파일 공유를 사용하여 확장 피드를 호스트하는 경우 피드에 대한 액세스를 관리하기 위해 파일 및 폴더 권한이 적용됩니다.

릴리스를 위한 확장 준비

다음 개발 문서를 읽고 고려해야 합니다.

미리 보기 릴리스로 릴리스하는 것이 좋습니다.

평가 목적으로 확장의 미리 보기 버전을 릴리스하는 경우 다음을 수행하는 것이 좋습니다.

파일의 확장명 제목 끝에 "(미리 보기)"를 .nuspec 추가합니다.
파일에서 확장명 설명 .nuspec 의 제한 사항 설명

확장 패키지 만들기

Windows 관리 Center는 확장을 배포하고 다운로드하기 위해 NuGet 패키지 및 피드를 활용합니다. 패키지를 배송하려면 플러그 인 및 확장을 포함하는 NuGet 패키지를 생성해야 합니다. 단일 패키지에는 UI 확장 및 게이트웨이 플러그 인이 포함될 수 있습니다. 다음 섹션에서는 프로세스를 안내합니다.

확장 빌드

확장 패키징을 시작할 준비가 되면 파일 시스템에 새 디렉터리를 만들고 콘솔을 연 다음 CD를 입력합니다. 이 디렉터리란 패키지를 구성하는 모든 nuspec 및 콘텐츠 디렉터리를 포함하는 데 사용하는 루트 디렉터리입니다. 이 문서의 나머지 부분에 대해 이 폴더 NuGet Package 를 호출합니다.

UI 확장

UI 확장에 필요한 모든 콘텐츠를 수집하는 프로세스를 시작하려면 도구에서 "gulp 빌드"를 실행하고 빌드가 성공했는지 확인합니다. 이 프로세스는 확장의 루트 디렉터리(src 디렉터리의 동일한 수준)에 있는 "번들"이라는 폴더에 모든 구성 요소를 함께 패키지합니다. 이 디렉터리와 모든 내용을 "NuGet 패키지" 폴더에 복사합니다.

게이트웨이 플러그 인

빌드 인프라(Visual Studio를 열고 빌드 단추를 선택하는 것만큼 간단할 수 있음)를 사용하여 플러그 인을 컴파일하고 빌드합니다. 빌드 출력 디렉터리를 열고 플러그 인을 나타내는 DLL 또는 DLL을 복사하여 "package"라는 "NuGet 패키지" 디렉터리 내의 새 폴더에 배치합니다. FeatureInterface DLL은 복사할 필요가 없으며 코드를 나타내는 DLL 또는 DLL만 복사할 필요가 없습니다.

nuspec 파일 만들기

NuGet 패키지를 만들려면 먼저 파일을 만들어야 .nuspec 합니다. .nuspec 파일은 NuGet 패키지 메타데이터를 포함하는 XML 매니페스트입니다. 이 매니페스트는 패키지를 빌드하고 소비자에게 정보를 제공하는 데 사용됩니다. 이 파일을 "NuGet 패키지" 폴더의 루트에 배치합니다.

다음은 예제 .nuspec 파일 및 필수 또는 권장 속성 목록입니다. 전체 스키마는 nuspec 참조를 참조하세요. .nuspec 선택한 파일 이름을 사용하여 프로젝트의 루트 폴더에 파일을 저장합니다.

Important

파일의 값은 <id> 프로젝트 파일의 manifest.json 값과 일치 "name" 해야 합니다. 그렇지 않으면 게시된 확장 프로그램이 Windows 관리 Center에서 성공적으로 로드되지 .nuspec 않습니다.

<?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	Required	Windows 관리 Center 확장에 대해 정의된 NuGet 패키지 유형인 를 사용합니다`WindowsAdminCenterExtension`.
ID	Required	피드 내의 고유 패키지 식별자입니다. 이 값은 프로젝트의 manifest.json 파일에서 "name" 값과 일치해야 합니다. 지침은 고유한 패키지 식별자 선택을 참조하세요.
title	Windows 관리 Center 피드에 게시하는 데 필요	Windows 관리 Center Extension Manager에 표시되는 패키지의 이름입니다.
version	Required	확장 버전입니다. 의미 체계 버전 관리(SemVer 규칙)를 사용하는 것이 좋지만 필수는 아닙니다.
authors	Required	회사를 대신하여 게시하는 경우 회사 이름을 사용합니다.
description	필수	확장 기능에 대한 설명을 제공합니다.
iconUrl	Windows 관리 Center 피드에 게시할 때 권장됩니다.	확장 관리자에 표시할 아이콘의 URL입니다.
projectUrl	Windows 관리 Center 피드에 게시하는 데 필요	확장 웹 사이트에 대한 URL입니다. 별도의 웹 사이트가 없는 경우 NuGet 피드의 패키지 웹 페이지에 대한 URL을 사용합니다.
licenseUrl	Windows 관리 Center 피드에 게시하는 데 필요	확장의 최종 사용자 라이선스 계약에 대한 URL입니다.
files	Required	이 두 설정은 Windows 관리 Center에서 UI 확장 및 게이트웨이 플러그 인에 대해 기대하는 폴더 구조를 설정합니다.

확장 NuGet 패키지 빌드

.nuspec 만든 파일을 사용하여 이제 NuGet 피드를 업로드하고 게시할 수 있는 NuGet 패키지 .nupkg 파일을 만들어야 합니다.

NuGet 클라이언트 도구 웹 사이트에서 nuget.exe CLI 도구를 다운로드합니다.
nuget.exe pack <>.nuspec file name>를 실행하여 .nupkg 파일을 만듭니다.

확장 NuGet 패키지 서명

확장에 포함된 모든 .dll 파일은 신뢰할 수 있는 CA(인증 기관)의 인증서로 서명해야 합니다. 기본적으로 서명되지 않은 파일은 Windows 관리 Center가 프로덕션 모드에서 실행 중일 때 실행되지 않습니다.dll.

패키지의 무결성을 보장하기 위해 확장 NuGet 패키지에 서명하는 것이 좋습니다.

참고 항목

Windows Defender 애플리케이션 제어를 지원하는 확장을 계획하는 경우 패키지 및 내의 모든 파일에 서명해야 합니다. Windows Defender 애플리케이션 제어를 사용하여 서명하는 방법에 대해 자세히 알아봅니다.

확장 NuGet 패키지 테스트

이제 확장 패키지를 테스트할 준비가 되었습니다. .nupkg NuGet 피드에 파일을 업로드하거나 파일 공유에 복사합니다. 다른 피드 또는 파일 공유에서 패키지를 보고 다운로드하려면 NuGet 피드 또는 파일 공유를 가리키도록 피드 구성을 변경해야 합니다. 테스트할 때 속성이 확장 관리자에 올바르게 표시되는지 확인하고 확장을 성공적으로 설치하고 제거할 수 있습니다.

Windows 관리 Center 피드에 확장 게시

Windows 관리 Center 피드에 게시하면 모든 Windows 관리 Center 사용자가 확장을 사용할 수 있도록 할 수 있습니다. Windows 관리 Center SDK는 아직 미리 보기 상태이므로 개발 문제를 해결하고 사용자에게 양질의 제품 및 환경을 제공할 수 있도록 귀하와 긴밀히 협력하고 싶습니다.

Microsoft에 확장 검토 요청을 제출하기 전에 공개 피드에 wacextensionrequest@microsoft.com 확장을 게시하려는 의도를 나타내는 이메일을 보내야 합니다. Microsoft는 서면으로 검토하고 승인할 확장 게시자 계약 및 확장 참여 정책의 복사본을 제공합니다.

확장의 초기 버전을 릴리스하기 전에 릴리스 최소 2~3주 전에 Microsoft에 확장 검토 요청을 제출하는 것이 좋습니다. 릴리스 2-3주 전에 허용하면 검토할 충분한 시간이 있으며 필요한 경우 확장을 변경할 수 있습니다. 확장을 게시할 준비가 되면 검토를 위해 확장을 Microsoft에 보내야 합니다. 확장이 승인되면 피드에 게시합니다. Microsoft 확장 패키지를 보내면 확장 게시자 계약 및 확장 참여 정책의 조건에 구속되는 것에 동의합니다.

그 후 확장에 대한 업데이트를 릴리스하려면 검토를 위해 다른 요청을 제출해야 합니다. 변경 범위에 따라 업데이트 검토의 소요 시간은 일반적으로 더 짧습니다.

Microsoft에 확장 검토 요청 제출

확장 검토 요청을 제출하려면 다음 정보를 제공하고 전자 메일 wacextensionrequest@microsoft.com로 보냅니다. 1주일 이내에 전자 메일에 회신합니다.

Windows 관리 센터 - 확장 검토 요청 정보:

확장 소유자/개발자의 이름 및 전자 메일 주소(최대 3명). 회사를 대신하여 확장을 릴리스하는 경우 회사 이메일 주소를 제공합니다.
회사 이름(회사를 대신하여 확장을 릴리스하는 경우에만 필요)
확장 이름
릴리스 대상 날짜(예상)
새 확장 제출의 경우 - 확장 설명(초기 디자인 와이어 프레임, 화면 모형 또는 제품 스크린샷 권장)
확장 업데이트 검토의 경우 – 변경 내용에 대한 설명(UI가 크게 변경된 경우 제품 스크린샷 포함)

검토 및 게시를 위해 확장 패키지 제출

확장 패키지를.nuspec 만들기 위한 이전 지침을 따르고 파일이 올바르게 정의되고 파일이 서명되었는지 확인합니다. 또한 다음을 포함한 프로젝트 웹 사이트가 있는 것이 좋습니다.

스크린샷 또는 비디오를 포함하여 확장에 대한 자세한 설명
피드백 또는 질문을 받는 이메일 주소 또는 웹 사이트 기능

확장을 게시할 준비가 되면 전자 메일을 보냅니다 wacextensionrequest@microsoft.com. 확장 패키지를 보내는 방법에 대한 지침을 제공합니다. 패키지를 받은 후 검토하겠습니다. 확장 패키지가 승인되면 Windows 관리 Center 피드에 게시합니다.