Start Building for Free
CircleCI.comアカデミーブログコミュニティサポート

Windows 実行環境の使用

1 month ago2 min read
クラウド
Server v4.x
Server v3.x
このページの内容

Windows 実行環境は、Universal Windows Platform (UWP) アプリケーションや .NET 実行可能ファイル、Windows 固有プロジェクト (.NET フレームワークなど) といった、Windows プロジェクトをビルドするためのツールを提供します。 Windows Executor の仕様と機能は以下のとおりです。

  • VM ベースでジョブの完全分離を保証
  • Windows Server 2019 Datacenter エディションと Windows Server 2022 Datacenter エディションの Server Core バージョンのどちらでも使用可能
  • PowerShell がデフォルトのシェル (Bash と cmd を手動で選択可能)
  • Windows コンテナの実行に Docker Engine - Enterprise を使用可能

Machine Executor を使用して Windows イメージを指定すると、Windows 実行環境にアクセスできます。

設定をシンプルに保ち、最新のイメージを使用していることを確認するために、代わりに Windows Orb を使ってジョブ設定の Orb からデフォルトの Executor を指定することも可能です。 CircleCI では、 Windows Orb を使って設定を簡素化することを強く推奨します。

次に、両方のオプションの例を示します。 Windows 実行環境がサーバー管理者によって管理されているため、CircleCI Server の設定が異なります。

version: 2.1

orbs:
  win: circleci/windows@4.1.1

jobs:
  build:
    executor: win/server-2022
    steps:
      - run: Write-Host 'Hello, Windows'
workflows:
  my-workflow:
    jobs:
      - build

利用可能なリソースクラス

クラスvCPURAMディスクサイズ
medium (デフォルト)415GB200 GB
large830GB200 GB
xlarge1660GB200 GB
2xlarge32128GB200 GB

Windows の Machine Executor イメージ

CircleCI は Windows Server 2019 では Visual Studio 2019 を、Windows Server 2022 では Visual Studio 2022 をサポートしています。 Windows イメージにプリインストールされているソフトウェアに関する情報は、 Developer Hub または Discuss フォーラムをご覧ください。 Developer Hub の Windows イメージのページには、最新のアップデートへのリンクが掲載されています。

Windows Server 2022 イメージに関する詳細は、 Discuss の投稿 (英語) を参照してください。

Windows イメージは約 30 日ごとにアップデートされます。 Windows イメージの使用時にタグが指定されていない場合、デフォルトでは最新の安定バージョンが適用されます。 Windows イメージのタグ付けスキームは以下のとおりです。

  • Current (Stable から変更): 本番環境で使用可能な最新の Windows イメージを参照します。 このイメージは、安定性を適度に確保しつつ、ソフトウェアの定期アップデートを取り入れたいプロジェクトで使用してください。 アップデートは、通常 1 か月に 1 回の頻度で行われます。
  • Previous: 本番環境で使用可能な過去の Windows イメージを参照します。 このイメージは、最新のソフトウェアのアップデートに破壊的変更が含まれる場合などに使用できます。 アップデートは、通常 1 か月に 1 回の頻度で行われます。

  • Edge: 最新の Windows イメージを参照し、メインブランチの HEAD からビルドされます。 このタグは、最新の変更を含み完全な安定性が保証されていないテストバージョンのイメージとして使うことが想定されています。

Windows Executor でのシェルの指定

Windows では 3 種類のシェルを使用してジョブステップを実行できます。

  • PowerShell (Windows Orb のデフォルト)
  • Bash
  • コマンド

シェルは、ジョブレベルまたはステップレベルで設定できます。 同じジョブ内で複数のシェルを使用可能です。 以下の例では、job 宣言と step 宣言に shell: 引数を追加して、Bash、PowerShell、およびコマンドを使用しています。

注: 更新された、または他の Windows シェルツールをインストールすることも可能です。 たとえば、dotnet CLI により Powershell Core の最新版をインストールし、ジョブの連続するステップで使用することができます。

Windows Executor での Windows Docker コンテナの実行

Windows Docker コンテナは、このように Windows Executor で実行することも可能です。

Windows ビルドへの SSH 接続

Windows ビルドコンテナに SSH 接続することができます。 これは、パイプラインに関する問題のトラブルシューティングに便利です。 Windows コンテナに SSH 接続するには、以下の手順を実行します。

手順

  1. SSH キーを GitHub アカウントまたは Bitbucket アカウントに追加していることを確認します。

  2. SSH 接続を有効にしてジョブを起動するには、Rerun Workflow ドロップダウンメニューから Rerun job with SSH オプションを選択します。

  3. 接続の詳細情報を確認するには、ジョブ出力の Enable SSH セクションを展開します。ここで、接続に必要な SSH コマンドを確認できます。SSH 接続の詳細情報

SSH 接続するときには、実行するシェルの名前を渡してください。 上のビルドで cmd.exe を実行するには、ssh -p <remote_ip> -- cmd.exe を実行します。

以下のオプションが利用できます。

  • powershell.exe
  • bash.exe
  • cmd.exe

ビルドで SSH を使用する方法については、 こちらを参照してください。

既知の問題と制限事項

Windows Executor には以下に挙げる問題が確認されており、可能な限り早期に対処することを目指しています。

  • SSH から Windows ジョブに接続し、bash シェルを使用すると、ターミナルのプロンプトが空になってしまう
  • 現時点では、ネストされた仮想化をサポートしていない(--platform linux フラグの使用など)
  • Windows Executor は現時点で Windows コンテナのみをサポートしている。 現在、Windows で Linux コンテナを実行することはできません。

次のステップ

Windows での Hello World」ページを参照してください。


ドキュメントの改善にご協力ください

このガイドは、CircleCI の他のドキュメントと同様にオープンソースであり、 GitHub でご利用いただけます。 ご協力いただき、ありがとうございます。

サポートが必要ですか

CircleCI のサポートエンジニアによる、サービスに関する問題、請求およびアカウントについての質問への対応、設定の構築に関する問題解決のサポートを行っています。 サポートチケットを送信して、CircleCI のサポートエンジニアにお問い合わせください。日本語でお問い合わせいただけます。

または、 サポートサイト から、サポート記事やコミュニティフォーラム、トレーニングリソースをご覧いただけます。