次の方法で共有

プロジェクト コレクションにタスクをアップロードする

  • [アーティクル]

Azure DevOps Services

Azure DevOps 用 Node CLI (tfx-cli) を使用して、カスタム タスクまたは Azure DevOps のインザボックス タスクのタスクを組織にアップロードする方法について説明します。

たとえば、このガイドラインは、Azure DevOps Server のインザボックス タスクの更新に役立ちます。

重要

オンプレミスインスタンスにインザボックス タスクをアップロードする場合、古いエージェントバージョンや Azure DevOps Server 側のサポートがないため、一部のタスク機能がサポートされない場合があります。

tfx-cliの詳細については、GitHubの Azure DevOps 用の Node CLI を参照してください。

前提 条件

プロジェクト コレクションにタスクをアップロードするには、前提条件が必要です。

  • Node.js の最新バージョン。

  • タスクをアップロードするための Azure DevOps 用の Node CLI。

    • を実行し、Node.js のコンポーネントである npmを使用して tfx-cli をインストールします。
      npm install -g tfx-cli

  • 必要なプロジェクト コレクションを更新するための権限。タスクをプロジェクト コレクションにアップロードできるようにするためのスコープ [環境 (読み取り & 書き込み)] で生成された PAT。

    重要

    Microsoft Entra トークン 使用することをお勧めします。 PAT の使用量を削減するための取り組みの詳細については、ブログの参照してください。 認証ガイダンス を確認して、ニーズに適した認証メカニズムを選択します。

Tfx-cli で個人用アクセス トークンを使用してサインインする

tfx-cli を使用して Azure DevOps にサインインし、パイプライン タスクをプロジェクト コレクションにアップロードします。

重要

Azure DevOps のプロジェクト コレクションに対する認証には、既定で個人用アクセス トークンが必要です。 スコープ [環境 (読み取り & 管理)] を使用して個人用アクセス トークン (PAT) を作成します。 他の方法で tfx-cli を使って認証できます。 詳細については、「Azure DevOpsのクロスプラットフォーム CLI での認証」を参照してください。

サインインするには、プロジェクト コレクションへのパスを URL として指定します。 プロジェクト コレクションの既定の名前は DefaultCollectionです。

Azure DevOps Services の場合、プロジェクト コレクションへのパスの形式は次のようになります:https://{Azure DevOps organization name}.visualstudio.com/DefaultCollection

Azure DevOps Server の場合、既定のプロジェクト コレクション URL は、URL サーバーとそのテンプレートの場所によって異なります:http://{Azure DevOps Server url}/DefaultCollection

次のコマンドを入力し、要求された情報を指定します。

~$ tfx login

プロジェクト コレクションへのタスクのアップロード

ヒント

インザボックス パイプライン タスクを更新する必要がある場合は、azure-pipelines-tasks リポジトリを複製し、タスクの構築方法に関するガイドラインに従って必要なタスクを構築できます。

これで、tfx-cliを使用してタスクのアップロードを開始できます。

次のコマンドを入力します。

tfx build tasks upload --task-path <PATH_TO_TASK>

手記

PATH_TO_TASKは、コンパイル済みタスクを含むフォルダーへのパスです。 tfx-cli の使用の詳細については、Node CLI for Azure DevOps のドキュメントを参照してください。