하나의 통합을 패키징하고 게시하다.

Azure DevOps 서비스 | Azure DevOps Server | Azure DevOps Server 2022

Visual Studio Marketplace에서 Azure DevOps와 통합되는 도구, 서비스 또는 제품을 게시합니다. Marketplace는 사용자가 통합 및 확장을 검색할 수 있는 중앙 허브입니다.

필수 조건

Marketplace에 게시하기 전에 다음 요구 사항 목록을 충족해야 합니다.

또한 다음 자산이 필요합니다.

• 통합 스크린샷 하나 이상
• 사용자에 대한 작업 호출 또는 시작 URL

게시자 만들기

Microsoft를 포함한 모든 확장 또는 통합에는 게시자가 있어야 합니다. 누구나 게시자를 만들고 그 아래에 확장을 게시할 수 있습니다. 개발 팀과 같은 다른 사용자와 게시자 액세스를 공유할 수도 있습니다.

1. Visual Studio Marketplace 게시 포털에 로그인합니다.

2. 기존 게시자의 일부가 아닌 경우 + 게시자 만들기를 선택합니다.
   게시자 이름을 입력하면 ID 필드가 입력한 내용에 따라 자동으로 채워집니다.

   

   비고

   • 멀티바이트 문자의 경우 게시자 이름이 16자 이내인지 확인합니다.
   • 게시자 ID를 저장합니다. 확장의 매니페스트 파일에 필요합니다.

   만약 게시자를 만들라는 메시지가 표시되지 않으면, 관련 사이트 아래의 확장 게시로 스크롤합니다.

   • 와 같은 mycompany-myteam고유한 게시자 식별자를 설정합니다. 이 값을 매니페스트에서 속성 publisher로 사용하십시오.
   • 표시 이름(예: My Team.)을 설정합니다.

3. Marketplace 게시자 계약을 검토한 다음 만들기를 선택합니다.

   

게시자를 만든 후에는 게시할 때까지 항목이 표시되지 않지만 항목을 관리할 수 있습니다.

프로젝트 구조 설정

다음 디렉터리 레이아웃을 만듭니다.

home/
├── images/
│   ├── integration-logo.png    (128×128 px minimum)
│   └── screenshot.png          (1366×768 px)
├── overview.md
└── vss-integration.json

매니페스트 만들기

다음 정보를 사용하여 vss-integration.json를 생성한 후 통합에 대한 값을 업데이트하세요.

{
    "manifestVersion": 1,
    "id": "myservice",
    "version": "1.0.0",
    "name": "My Service",
    "publisher": "mycompany",
    "description": "Awesome tools to help you and your team do great things everyday.",
    "targets": [
        {
            "id": "Microsoft.VisualStudio.Services.Integration"
        }
    ],    
    "icons": {
        "default": "images/service-logo.png"
    },
    "categories": [
        "Plan and track"
    ],
    "tags": [
        "working",
        "people person",
        "search"
    ],
    "screenshots": [
        {
            "path": "images/screen1.png"
        },
        {
            "path": "images/screen2.png"
        }
    ],
    "content": {
        "details": {
            "path": "overview.md"
        },
        "license": {
            "path": "fabrikam-license-terms.md"
        }
    },
    "links": {
        "getstarted": {
            "uri": "https://www.mycompany.com/help/getstarted"
        },
        "learn": {
            "uri": "https://www.mycompany.com/features"
        },
        "support": {
            "uri": "https://www.mycompany.com/support"
        }
    },
    "branding": {
        "color": "rgb(34, 34, 34)",
        "theme": "dark"
    }
}

다음 참조를 사용하여 필드를 업데이트합니다.

다음 속성이 필요합니다.

다음 선택적 속성은 사용자가 확장을 검색하고 학습하는 데 도움이 됩니다.

통합을 패키징하세요.

1. 아직 설치하지 않은 경우 패키징 도구를 설치합니다.

   npm install -g tfx-cli
   

2. .vsix 파일로 통합 패키지를 준비하세요.

   tfx extension create --manifest-globs vss-integration.json
   

   팁 (조언)

   패치 버전 번호를 자동으로 증분하는 데 사용합니다 --rev-version .

Marketplace에 게시

확장이 패키지되면 게시자 이름으로 Marketplace에 업로드할 수 있습니다. publisher 확장의 매니페스트 파일에 지정된 식별자는 확장이 업로드된 게시자의 식별자와 일치해야 합니다.

1. 관리 포털의 페이지 맨 위에 있는 드롭다운 메뉴에서 게시자를 선택합니다.

2. 새 확장

   

3. 파일을 끌어서 놓거나 선택하여 이전 패키징 단계에서 만든 VSIX 파일을 찾은 다음 업로드를 선택합니다.

   

   빠른 유효성 검사 후에 확장이 게시된 확장 목록에 표시됩니다. 확장은 당신에게만 보입니다.

   

이 시점에서 확장은 계정에 표시되지 않습니다. 다른 사용자에게 표시하려면 확장을 공유해야 합니다.

통합을 공유하세요

Azure DevOps 조직에 통합을 설치하려면 먼저 해당 조직과 통합을 공유해야 합니다.

1. 표시된 항목 목록에서 통합을 선택합니다.
2. 공유를 선택합니다.
3. 조직 이름을 입력합니다(예: fabrikam-fiber-inc은 dev.azure.com/fabrikam-fiber-inc의 예입니다).

통합 업데이트

이미 게시한 확장을 업데이트하려면 다음 단계를 수행합니다.

1. 표시된 항목 목록에서 확장을 선택합니다.
2. 마우스 오른쪽 단추를 클릭하고 개발 버전에 대한 업데이트를 선택합니다(예: publisher.extension-dev.).
3. 확장의 유효성을 검사합니다.
4. 같은 프로덕션 버전 publisher.extension에 동일한 업데이트를 적용합니다.
5. 확장 프로그램에 대한 .vsix 파일로 이동하여 업로드합니다.

Azure DevOps는 이미 확장이 있는 모든 계정에 대해 업데이트된 버전을 자동으로 설치합니다. 새 설치는 최신 버전도 받습니다.

통합을 공개로 만들기

모든 Marketplace 사용자에게 통합을 표시하려면 매니페스트에 플래그를 publictrue 설정하고 다시 게시합니다.

공개 목록에 필요한 자격에 대한 자세한 내용은 확장 공개 처리를 참조하세요.

관련 콘텐츠

• 확장 매니페스트 참조
• 확장을 패키지하여 게시하기
• Visual Studio Marketplace