に参加して、VS Code の AI 支援開発について学びましょう。

継続的インテグレーション

拡張機能の統合テストはCIサービスで実行できます。@vscode/test-electronライブラリは、CIプロバイダーで拡張機能テストを設定するのに役立ち、Azure Pipelinesでのサンプル拡張機能のセットアップが含まれています。ビルドパイプラインを確認するか、直接azure-pipelines.ymlファイルにジャンプできます。

自動公開

CIを設定して、拡張機能の新しいバージョンを自動的に公開することもできます。

公開コマンドは、vsceを使用してローカル環境から公開する場合と似ていますが、Personal Access Token（PAT）を安全な方法で提供する必要があります。PATをVSCE_PATシークレット変数として保存することで、vsceはそれを使用できるようになります。シークレット変数は決して公開されないため、CIパイプラインで安全に使用できます。

Azure Pipelines

Azure Pipelines

Azure Pipelinesは、Windows、macOS、Linuxでテストを実行できるため、VS Code拡張機能のテストを実行するのに最適です。オープンソースプロジェクトの場合、無制限の実行時間と10個の無料並列ジョブを利用できます。このセクションでは、拡張機能テストを実行するためのAzure Pipelinesのセットアップ方法について説明します。

まず、Azure DevOpsで無料アカウントを作成し、拡張機能用のAzure DevOpsプロジェクトを作成します。

次に、次のazure-pipelines.ymlファイルを拡張機能のリポジトリのルートに追加します。ヘッドレスLinux CIマシンでVS Codeを実行するために必要なLinux用のxvfbセットアップスクリプトを除けば、定義は簡単です。

trigger:
  branches:
    include:
    - main
  tags:
    include:
    - v*

strategy:
  matrix:
    linux:
      imageName: 'ubuntu-latest'
    mac:
      imageName: 'macos-latest'
    windows:
      imageName: 'windows-latest'

pool:
  vmImage: $(imageName)

steps:

- task: NodeTool@0
  inputs:
    versionSpec: '10.x'
  displayName: 'Install Node.js'

- bash: |
    /usr/bin/Xvfb :99 -screen 0 1024x768x24 > /dev/null 2>&1 &
    echo ">>> Started xvfb"
  displayName: Start xvfb
  condition: and(succeeded(), eq(variables['Agent.OS'], 'Linux'))

- bash: |
    echo ">>> Compile vscode-test"
    yarn && yarn compile
    echo ">>> Compiled vscode-test"
    cd sample
    echo ">>> Run sample integration test"
    yarn && yarn compile && yarn test
  displayName: Run Tests
  env:
    DISPLAY: ':99.0'

最後に、DevOpsプロジェクトで新しいパイプラインを作成し、azure-pipelines.ymlファイルを指します。ビルドをトリガーすると、完成です。

pipelines

ブランチへのプッシュ時やプルリクエスト時に、ビルドを継続的に実行するように有効にすることができます。ビルドパイプラインのトリガーを参照して詳細を確認してください。

Azure Pipelinesの自動公開

  1. Azure DevOpsのシークレット手順を使用して、VSCE_PATをシークレット変数として設定します。
  2. vsceをdevDependenciesとしてインストールします（npm install @vscode/vsce --save-devまたはyarn add @vscode/vsce --dev）。
  3. PATなしでpackage.jsonにdeployスクリプトを宣言します（デフォルトでは、vsceはPersonal Access TokenとしてVSCE_PAT環境変数を使用します）。
"scripts": {
  "deploy": "vsce publish --yarn"
}
  1. タグが作成されたときにもビルドが実行されるようにCIを設定します。
trigger:
  branches:
    include:
    - main
  tags:
    include:
    - refs/tags/v*
  1. シークレット変数を使用してyarn deployを呼び出すpublishステップをazure-pipelines.ymlに追加します。
- bash: |
    echo ">>> Publish"
    yarn deploy
  displayName: Publish
  condition: and(succeeded(), startsWith(variables['Build.SourceBranch'], 'refs/tags/'), eq(variables['Agent.OS'], 'Linux'))
  env:
    VSCE_PAT: $(VSCE_PAT)

conditionプロパティは、特定のケースでのみ公開ステップを実行するようにCIに指示します。

この例では、条件には3つのチェックがあります。

  • succeeded() - テストが成功した場合のみ公開します。
  • startsWith(variables['Build.SourceBranch'], 'refs/tags/') - タグ付けされた（リリース）ビルドの場合のみ公開します。
  • eq(variables['Agent.OS'], 'Linux') - ビルドが複数のエージェント（Windows、Linuxなど）で実行される場合に含めます。そうでない場合は、条件のその部分を削除します。

VSCE_PATはシークレット変数であるため、すぐに環境変数として使用することはできません。したがって、環境変数VSCE_PATをシークレット変数に明示的にマッピングする必要があります。

GitHub Actions

GitHub Actionsを設定して、拡張機能のCIを実行することもできます。ヘッドレスLinux CIマシンでは、VS Codeを実行するためにxvfbが必要なので、現在のOSがLinuxの場合は、Xvfbが有効な環境でテストを実行します。

on:
  push:
    branches:
      - main

jobs:
  build:
    strategy:
      matrix:
        os: [macos-latest, ubuntu-latest, windows-latest]
    runs-on: ${{ matrix.os }}
    steps:
    - name: Checkout
      uses: actions/checkout@v4
    - name: Install Node.js
      uses: actions/setup-node@v4
      with:
        node-version: 18.x
    - run: npm install
    - run: xvfb-run -a npm test
      if: runner.os == 'Linux'
    - run: npm test
      if: runner.os != 'Linux'

GitHub Actionsの自動公開

  1. GitHub Actionsのシークレット手順を使用して、VSCE_PATを暗号化されたシークレットとして設定します。
  2. vsceをdevDependenciesとしてインストールします（npm install @vscode/vsce --save-devまたはyarn add @vscode/vsce --dev）。
  3. PATなしでpackage.jsonにdeployスクリプトを宣言します。
"scripts": {
  "deploy": "vsce publish --yarn"
}
  1. タグが作成されたときにもビルドが実行されるようにCIを設定します。
on:
  push:
    branches:
    - main
  release:
    types:
    - created
  1. シークレット変数を使用してnpm run deployを呼び出すpublishジョブをパイプラインに追加します。
- name: Publish
  if: success() && startsWith(github.ref, 'refs/tags/') && matrix.os == 'ubuntu-latest'
  run: npm run deploy
  env:
    VSCE_PAT: ${{ secrets.VSCE_PAT }}

ifプロパティは、特定のケースでのみ公開ステップを実行するようにCIに指示します。

この例では、条件には3つのチェックがあります。

  • success() - テストが成功した場合のみ公開します。
  • startsWith(github.ref, 'refs/tags/') - タグ付けされた（リリース）ビルドの場合のみ公開します。
  • matrix.os == 'ubuntu-latest' - ビルドが複数のエージェント（Windows、Linuxなど）で実行される場合に含めます。そうでない場合は、条件のその部分を削除します。

GitLab CI

GitLab CIは、ヘッドレスDockerコンテナで拡張機能をテストおよび公開するために使用できます。これは、事前に設定されたDockerイメージをプルするか、パイプライン中にxvfbとVisual Studio Codeを実行するために必要なライブラリをインストールすることで実行できます。

image: node:12-buster

before_script:
  - npm install

test:
  script:
    - |
      apt update
      apt install -y libasound2 libgbm1 libgtk-3-0 libnss3 xvfb
      xvfb-run -a npm run test

GitLab CIの自動公開

  1. GitLab CIドキュメントを使用して、VSCE_PATをマスクされた変数として設定します。
  2. vsceをdevDependenciesとしてインストールします（npm install @vscode/vsce --save-devまたはyarn add @vscode/vsce --dev）。
  3. PATなしでpackage.jsonにdeployスクリプトを宣言します。
"scripts": {
  "deploy": "vsce publish --yarn"
}
  1. タグでのみトリガーされる、マスクされた変数を使用してnpm run deployを呼び出すdeployジョブを追加します。
deploy:
  only:
    - tags
  script:
    - npm run deploy

よくある質問

継続的インテグレーションにYarnを使用する必要がありますか？

上記のすべての例は、Yarnで構築された架空のプロジェクトを参照していますが、npm、Grunt、Gulp、またはその他のJavaScriptビルドツールを使用するように適応させることができます。

10/09/2025
© . This site is unofficial and not affiliated with Microsoft.