コマンド ラインから発行する

  • [アーティクル]

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

Azure DevOps のクロスプラットフォーム CLI (tfx-cli) を使用して、拡張機能を Visual Studio Marketplace に発行できます。

詳細については、発行、インストール、共有の概要を参照してください。

前提条件

Node パッケージ マネージャー から TFX CLI を取得し、個人用アクセス トークン (PAT) を生成します。 また、まだ行っていない場合は、ギャラリーでパブリッシャーを設定します。

Azure DevOps のクロスプラットフォーム CLI を取得する

  1. お持ちでない場合は、NodeJS をダウンロードしてインストールします。 セットアップ時に、[パスに追加] を選択したままにします。

  2. コマンド プロンプトを開き、「.」と入力します npm i -g tfx-cli。

既に TFX CLI がインストールされている場合は、次を実行 npm up -g tfx-cliして最新リリースに更新できます。

個人用アクセス トークンを作成する

  1. 組織にサインインします (https:dev.azure.com/{organization})。

  2. ホーム ページでユーザー設定アイコンを開き、[プロファイル] を選択 します。

    ユーザー設定アイコンを選択した後にプロファイルを選択する

  3. [セキュリティ] で [個人用アクセス トークン] を選択し、[新しいトークン] を選択します。

    新しい個人用アクセス トークンを作成する

  4. フォームに入力します。

    • トークンに名前を付けます
    • [すべてのアクセス可能な組織] を選択します。これは、CLI を使用して発行するときに機能する唯一の値です。 1 つの組織のみを選択すると、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追加して、拡張機能のパッチ バージョンを自動的にインクリメントできます。 これにより、新しいバージョンもマニフェストに保存されます。

Note

コマンドで使用できる 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