다음을 통해 공유

명령줄에서 게시

  • 아티클

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

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

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

필수 조건

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

Azure DevOps용 플랫폼 간 CLI 획득

  1. 없는 경우 NodeJS를 다운로드하여 설치 합니다. 설정하는 동안 PATH에 추가를 선택한 상태로 둡니다.

  2. 명령 프롬프트를 열고 를 입력합니다 npm i -g tfx-cli.

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

개인용 액세스 토큰 만들기

  1. 조직에 로그인합니다(https:dev.azure.com/{organization}).

  2. 홈페이지에서 사용자 설정 아이콘을 열고 프로필을 선택합니다.

    사용자 설정 아이콘을 선택한 후 프로필 선택

  3. 보안에서 개인 액세스 토큰을 선택한 다음 새 토큰을 선택합니다.

    새 개인용 액세스 토큰 만들기

  4. 양식을 작성합니다.

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

    ..

  5. 생성된 개인 액세스 토큰을 복사합니다. 비밀을 유지해야 합니다.

    토큰 복사 및 비밀 유지

명령줄에서 게시

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

  1. 확장의 루트 디렉터리에 대한 명령 프롬프트를 엽니다.
  2. 다음 명령을 실행하여 확장을 게시합니다. 메시지가 표시되면 인증할 개인 액세스 토큰을 입력합니다.
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