명령줄에서 게시

아티클
12/27/2024

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Azure DevOps(tfx-cli)용 플랫폼 간 CLI를 사용하여 Visual Studio Marketplace에 확장을 게시할 수 있습니다.

자세한 내용은 게시, 설치 및 공유개요를 참조하세요.

필수 구성 요소

노드 패키지 관리자에서 TFX CLI를 가져오고 Microsoft Entra 토큰 또는 PAT(개인용 액세스 토큰)를 생성합니다. 또한 아직 설정하지 않은 경우 갤러리에서 게시자를 설정합니다.

Azure DevOps용 플랫폼 간 CLI 획득

만약 그것이 없는 경우, NodeJS을 다운로드하여 설치합니다. 설정하는 동안 PATH에 추가가 선택된 상태인지 확인하세요.
명령 프롬프트를 열고 npm i -g tfx-cli입력합니다.

TFX CLI가 이미 설치된 경우 npm up -g tfx-cli실행하여 최신 릴리스로 업데이트할 수 있습니다.

Microsoft Entra 토큰을 사용하여 서비스 주체로서 게시하기

확장을 서비스 프린서플로 게시할 수도 있습니다.

서비스 주체를 게시자 계정에 멤버로 추가합니다. 프로필 가져오기(Profile - Get)를 사용하여 서비스 주체의 ID를 프로필에서 가져올 수 있습니다. 그런 다음 이전 단계의 ID를 사용하여 서비스 주체를 멤버 게시자에 추가할 수 있습니다.
서비스 주체를 사용하여 TFX CLI 통해 확장을 게시합니다. 다음의 TFX CLI 명령을 실행하여 액세스 토큰을 활용하세요.

tfx extension publish --publisher my-publisher --vsix my-publisher.my-extension-1.0.0.vsix --auth-type pat -t <ENTRA_TOKEN>

개인용 액세스 토큰을 사용하여 게시

귀하의 조직(https:dev.azure.com/{organization})에 로그인하세요.
홈페이지에서 사용자 설정 아이콘을 열고 프로필을 선택합니다.

선택한 후 프로필 선택
보안에서 개인용 액세스 토큰을 선택하고, 새 토큰을 선택합니다.

만들기
양식을 작성합니다.
- 토큰 이름 지정
- 액세스 가능한 모든 조직 을(를) 선택하세요. CLI를 통해 게시할 때 유일하게 작동하는 값은입니다. 하나의 조직만 선택하면 PAT가 유효한 경우에도 오류가 발생합니다.
- 토큰의 만료 시간 프레임을 선택합니다. Visual Studio Marketplace 게시 API가 조직의 컨텍스트 외부에서 작동하기 때문에 이 작업이 필요합니다.
- 이 토큰과 연결된 액세스 범위를 설정합니다. Marketplace(출판) 범위를 반드시 선택해야 합니다. 이 범위는 토큰을 Marketplace에 확장만 게시할 수 있도록 제한합니다.
- 선택 만들기
생성된 개인 액세스 토큰을 복사합니다. 비밀을 유지해야 합니다.

유지

TFX CLI가 설치되고 토큰이 있으면 도구를 사용하여 확장을 패키지하고 게시할 수 있습니다.

확장의 루트 디렉터리에 대한 명령 프롬프트를 엽니다.
다음 명령을 실행하여 확장을 게시합니다. 메시지가 표시되면 인증할 토큰을 입력합니다.

tfx extension publish --publisher <YOUR_PUBLISHER_ID> --manifest-js <YOUR_EXTENSION_MANIFEST> --share-with <ACCOUNT_NAME>

잠재적 오류

확장이 이미 게시된 경우 다음 오류가 발생할 수 있습니다.

Failed Request: Internal Server Error(500) - Version number must increase each time an extension is published. Extension: fabrikam.my-extension  Current version: 0.1.9  Updated version: 0.1.9

--rev-version 플래그를 추가하여 확장의 패치 버전을 자동으로 증분할 수 있습니다. 또한 새 버전을 매니페스트에 저장합니다.

메모

create에 사용할 수 있는 모든 옵션을 publish 명령에서도 사용할 수 있습니다.

본보기

C:\vso-team-calendar>tfx extension publish --publisher publishFabrikam --manifest-js fabrikam.config.js --share-with fabrikam --rev-version
Copyright Microsoft Corporation
> Personal access token:
Checking if this extension is already published
It is, update the extension
Waiting for server to validate extension package...
Sharing extension with fabrikam.

=== Completed operation: publish extension ===
 - Packaging: C:\vso-team-calendar\fabrikam.team-calendar-0.2.6.vsix
 - Publishing: success
 - Sharing: shared with fabrikam

다음을 통해 공유