Windows での Hello World

CircleCI の Windows ビルド環境で継続的インテグレーションを開始する方法を説明します。今回初めて CircleCI をセットアップする場合は、先に入門ガイドをご覧になることをお勧めします。

前提条件
Windows Executor の概要
- Windows Executor イメージ
- 既知の問題
サンプルの設定ファイル
Windows Executor でのシェルの指定
サンプルアプリケーション
ビルドへの SSH 接続
- 手順
次のステップ
Windows イメージにプリインストールされているソフトウェア

前提条件

作業を行う前に、以下を準備しておく必要があります。

CircleCI のアカウント。
Free プラン (デフォルト) または Performance プラン。 CircleCI Server をお使いの方向けには以下に別のコード例を掲載していますので、そちらをご参照ください。
クラウド版をお使いの場合にプロジェクトで Windows を使用するには、パイプラインを有効化する必要があります。

Windows Executor の概要

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

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

Notes:

メモ: Windows Executor は現時点で Windows コンテナのみをサポートしています。現在、Windows で Linux コンテナを実行することはできません。
Orb usage is not supported on Server instances of CircleCI (please view the “server” code samples for server usage.)

Windows Executor イメージ

現在、CircleCI は Windows イメージとして Windows Server 2019 with Visual Studio 2019 のみをサポートしています。このイメージの完全な内容については、このドキュメント末尾のインストール済みソフトウェアの一覧を参照してください。 CircleCI Server の Windows イメージに何が含まれているのか、詳しい情報についてはシステム管理者にお問い合わせください。

Please note that it is possible to run Windows Docker Containers on the Windows executor like so:

version: 2.1

orbs:
  win: circleci/windows@2.2.0

jobs:
  build:
    executor:
      name: win/default
      shell: powershell.exe
    steps:
      - checkout
      - run: systeminfo
      - run:
          name: "Check docker"
          shell: powershell.exe
          command: |
            docker info
            docker run hello-world:nanoserver-1809

version: 2

jobs:
  build: # name of your job
    machine:
      image: windows-default # Windows machine image
    resource_class: windows.medium
    steps:
      - checkout
      - run: systeminfo
      - run:
          name: "Check docker"
          shell: powershell.exe
          command: |
            docker info
            docker run hello-world:nanoserver-1809

既知の問題

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

SSH から Windows ジョブに接続し、bash シェルを使用すると、ターミナルのプロンプトが空になってしまう
It is currently not possible to do nested virtualization (for example, using the --platform linux flag).

サンプルの設定ファイル

以下の構成スニペットを .circleci/config.yml ファイルに貼り付けることで、CircleCI で Windows を使用できるようになります。

version: 2.1 # Use version 2.1 to enable orb usage.

orbs:
  win: circleci/windows@2.2.0 # The Windows orb give you everything you need to start using the Windows executor.

jobs:
  build: # name of your job
    executor:
      name: win/default # executor type
      size: "medium" # resource class, can be "medium", "large", "xlarge", "2xlarge", defaults to "medium" if not specified

    steps:
      # Commands are run in a Windows virtual machine environment
      - checkout
      - run: Write-Host 'Hello, Windows'

version: 2

jobs:
  build: # name of your job
    machine:
      image: windows-default # Windows machine image
    resource_class: windows.medium
    steps:
      # Commands are run in a Windows virtual machine environment
        - checkout
        - run: Write-Host 'Hello, Windows'

ここからはバージョン 2.1 の構文を使用して Windows Executor の使用について説明しますが、CircleCI Server を使用している場合は前述の Executor 定義構文を参考にしてください。

Windows Executor でのシェルの指定

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

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

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

version: 2.1

orbs:
  win: circleci/windows@2.2.0

jobs:
  build:
    executor:
      name: win/default
    steps:
      # デフォルトのシェルは PowerShell
      - run:            
         command: $(echo hello | Out-Host; $?) -and $(echo world | Out-Host; $?)
         shell: powershell.exe
      - run:
         command: echo hello && echo world
         shell: bash.exe
      - run:
         command: echo hello & echo world
         shell: cmd.exe

version: 2.0

jobs:
  build: # name of your job
    machine:
      image: windows-default # Windows machine image
    resource_class: windows.medium
    steps:
      # default shell is Powershell
      - run:
         command: $(echo hello | Out-Host; $?) -and $(echo world | Out-Host; $?)
         shell: powershell.exe
      - run:
         command: echo hello && echo world
         shell: bash.exe
      - run:
         command: echo hello & echo world
         shell: cmd.exe

メモ: 更新版などの Windows シェルツールをインストールすることも可能です。 dotnet CLI で PowerShell Core の最新版をインストールし、ジョブの一連のステップに使用できます。


version: 2.1

orbs:
  win: circleci/windows@2.2.0

jobs:
  build:
    executor: win/default
    steps:
      - checkout
      - run: dotnet tool install --global PowerShell
      - run: pwsh ./<my-script>.ps1

version: 2.0

jobs:
  build: # name of your job
    machine:
      image: windows-default # Windows machine image
    resource_class: windows.medium
    steps:
      - checkout
      - run: dotnet tool install --global PowerShell
      - run: pwsh ./<my-script>.ps1

サンプルアプリケーション

Windows Executor を使用した例として、少し応用した (まだ初歩ですが) “hello world” アプリケーションを考えます。このサンプルアプリケーションも「Hello World」をコンソールに出力します。そのために .NET コアを使用して実行可能ファイルを作成し、依存関係キャッシュを使用し、ビルドごとにアーティファクトを作成します。Note: If you are using Windows on CircleCI Server instances, replace usage of orbs with a machine image as described in the previous code samples.

設定ファイルの全体はこちらで確認してください。

version: 2.1

上記のように、CircleCI のバージョン 2.1 を使用することを最初に宣言します。これにより、Orb とパイプラインを利用できます。

orbs:
  win: circleci/windows@2.2.0

次に、ビルドで使用する Orb を宣言します。最初は Windows Orb のみを使用します。

jobs:
  build:
    executor:
      name: win/default
      shell: powershell.exe

jobs キーの下で、使用している Orb を介して Executor を設定します。以降のステップに適用されるデフォルトのシェルも宣言できます。デフォルトのシェルは powershell.exe です。

    steps:
      - checkout

最初のステップでは、checkout コマンドを実行して、バージョン管理システムからソースコードをプルします。

      - restore_cache:
          keys:
      - run:
          name: "プロジェクト依存関係のインストール"
          command: dotnet.exe restore
      - save_cache:
          paths:
            - C:\Users\circleci\.nuget\packages

次に設定ファイルでは、キャッシュを利用して、キャッシュされた依存関係を以前のビルドから復元します。 dotnet restore コマンドは、まだインストールされていない、または復元されていないすべての依存関係をキャッシュからフェッチします。キャッシュの詳細については、キャッシュに関するドキュメントを参照してください。

      - run:
          name: "ビルド ステップの実行"
          command: dotnet.exe publish -c Release -r win10-x64
      - run:
          name: "実行可能ファイルのテスト"
          command: .\bin\Release\netcoreapp2.1\win10-x64\publish\circleci-demo-windows.exe

続いて 2 つのステップを実行します。 1 つは Windows 10 用の実行可能ファイルをビルドし、もう 1 つはその実行可能ファイルをテストします (コンソールに「Hello World」と出力されます)。

      - store_artifacts:
          path: .\bin\Release\netcoreapp2.1\win10-x64\publish\circleci-demo-windows.exe

最後のステップでは、ビルド実行可能ファイルをアーティファクトとして保存し、CircleCI Web アプリケーションまたは API からアクセスできるようにします。

ビルドへの SSH 接続

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

手順

SSH キーを GitHub アカウントまたは Bitbucket アカウントに追加していることを確認します。
SSH 接続を有効にしてジョブを起動するには、[Rerun Workflow (ワークフローを再実行する)] ドロップダウンメニューから [Rerun job with SSH (SSH でジョブを再実行する)] オプションを選択します。
接続の詳細情報を確認するには、ジョブ出力の [Enable SSH (SSH を有効にする)] セクションを展開します。ここで、接続に必要な SSH コマンドを確認できます。

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

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

powershell.exe
bash.exe
cmd.exe

You can read more about using SSH in your builds here.

次のステップ

CircleCI の機能については、以下のドキュメントを確認してください。

2.0 設定ファイルの概要、および .circleci/config.yml ファイルにおけるトップレベルキーの階層については「コンセプト」を参照してください。
並列実行、順次実行、スケジュール実行、手動承認のワークフローによるジョブのオーケストレーションの例については「ワークフローを使用したジョブのスケジュール」を参照してください。
すべてのキーとビルド済み Docker イメージに関する詳細なリファレンスについては、それぞれ「CircleCI を設定する」、「CircleCI のビルド済み Docker イメージ」を参照してください。

Windows イメージにプリインストールされているソフトウェア

Windows Server 2019 with Visual Studio 2019

Windows Server 2019 Core Datacenter Edition
Visual Studio 2019 Community エディション
- CircleCI でこのバージョンの Visual Studio を使用する組織には、追加のライセンス条項が適用されます。 Windows ジョブでこの Visual Studio バージョンを使用する前に、Visual Studio 2019 Community エディションのライセンス条項を確認してください。
- Azure SDK for Visual Studio 2019
- Visual Studio 2019 Build Tools
シェル
- Powershell 5
- GNU bash 4.4.231 (x86_64-pc-msys)
- cmd
.NET Framework 4.8
.NET Core
- SDK 3.1.406 (x64)
- SDK 3.0.100-preview7-012821
- Runtime 3.0.0-preview6-27804-01
- SDK 2.2.401
- Runtime 2.2.6
- SDK 2.1.801
Git 2.22.0
Git LFS 2.7.2
Windows 10 SDK
- 10.0.26624
- 10.1.18362.1
Docker Engine - Enterprise バージョン 18.09.7
NuGet CLI 5.2.0.6090
Chocolatey v0.10.15
Azure Service Fabric
- SDK 3.3.617.9590
- Runtime 6.4.617.9590
OpenJDK 12.0.2
Node.js v12.8.0
NVM (Node Version Manager)
Ruby 2.6.3
Go 1.12.7
Python 3.7.3
Miniconda 3
テキストエディター
- nano 2.5.3
- vim 8.0.604
jq 1.5

Help make this document better

This guide, as well as the rest of our docs, are open-source and available on GitHub. We welcome your contributions.

Suggest an edit to this page (please read the contributing guide first).
To report a problem in the documentation, or to submit feedback and comments, please open an issue on GitHub.
CircleCI is always seeking ways to improve your experience with our platform. If you would like to share feedback, please join our research community.

CircleCI Documentation by CircleCI is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.