Azure DevOps サービス
Azure DevOps 用 Node CLI (tfx-cli) を使用して、カスタム タスクまたは Azure DevOps のインザボックス タスクのタスクを組織にアップロードする方法について説明します。
たとえば、このガイドラインは、Azure DevOps Server のインザボックス タスクの更新に役立ちます。
重要
オンプレミスインスタンスにインザボックス タスクをアップロードする場合、古いエージェントバージョンや Azure DevOps Server 側のサポートがないため、一部のタスク機能がサポートされない場合があります。
前提 条件
プロジェクト コレクションにタスクをアップロードするには、前提条件が必要です。
Node.js の最新バージョン。
タスクをアップロードするための Azure DevOps 用の
Node 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 のドキュメントを参照してください。