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

Azure DevOps Services

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

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

重要

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

前提条件

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

Node.js の最新バージョン。
タスクをアップロードするための Azure DevOps の Node CLI。
- 次を実行してnpm、Node.js のコンポーネントである tfx-cli をインストールします。
```
  npm install -g tfx-cli
```
必要なプロジェクトコレクションを更新するためのアクセス許可。スコープ環境 (読み取りおよび書き込み) で生成された PAT で、プロジェクトコレクションにタスクをアップロードできます。

パイプラインタスクをプロジェクトコレクションにアップロードできるようにするには、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>

Note

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