Skip to content
Docs
Cancel

Windows への CircleCI セルフホストランナーのインストール

Last updated
Tags クラウド Server v3.x

このページでは、CircleCI セルフホストランナーを Windows にインストールする方法を説明します。 以下のインストール方法は、Windows Server 2019 と Windows Server 2016 の両方について、Datacenter エディションでテスト済みです。 デスクトップエクスペリエンスとリモートデスクトップサービスを備えたその他のサーバ SKU でも動作するはずです。

このページはセルフホストランナーのインストールの続きです。 下記の手順を進めるには、既存の名前空間とリソースクラスが必要です。 これは、https://app.circleci.com/[CircleCI Web アプリ] で Self-Hoseted Runners に移動して実行できます ( Web アプリのインストールのドキュメントを参照)。 また、 CLI もご使用いただけます。

ここでは、CircleCI ローンチエージェントとその依存関係 (Chocolatey、Git、Gzip) を Windows サーバーにインストールします。

セットアップ中、CircleCI ジョブを実行する新しいローカル管理者ユーザーを作成します。 そのため、Windows サーバーで、ローカルユーザーを作成し、そのユーザーのリモートログオンを許可できる必要があります。

また、このセットアップをドメイン環境で行う際には、Windows サーバーがドメインメンバーである必要があります。 セルフホストランナーインスタンスは、ドメインコントローラーとして動作している Windows サーバーでは実行できません。

インストールの手順

  1. GitHub から Install-CircleCIRunner.ps1 スクリプトをダウンロードし、アクセスしやすい場所に配置します。

  2. PowerShell を管理者として開き、スクリプト ファイルを配置したディレクトリに移動します。

  3. 以下を PowerShell で実行します。

    Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072;
./Install-CircleCIRunner.ps1

    PowerShell インターフェイスにインストール結果が出力されます。

  4. インストール中、セルフホストランナー (launch-agent-config.yaml) の設定ファイルがメモ帳で開かれます。 必要な情報をファイルに記入してください（セルフホストランナーの設定リファレンスを参照してください）。 The configuration file is located in the installation directory, C:\Program Files\CircleCI, by default.

セットアップが完了すると、ローンチエージェントが自動的に起動し、処理対象のジョブの検索を開始します。

ジョブでセルフホストランナーを参照する

セルフホストランナーのセットアップが完了したら、 .circleci/config.yml ファイルのフィールドを設定してジョブでセルフホストランナーを参照する必要があります。 セルフホストランナーを使って実行するジョブについて、以下のフィールドを指定します。

  • machine: true

  • resource_class: your-namespace/your-resource

以下に、ジョブのセットアップ方法の簡単な例を示します。

version: 2.1
workflows:
  testing:
    jobs:
      - runner
jobs:
  runner:
    machine: true
    resource_class: your-namespace/your-resource
    steps:
      - run: echo "Hi I'm on Runners!"

この設定ファイルを VCS プロバイダーにプッシュすると、セルフホストランナーを使ってジョブが実行されます。

アンインストール・再インストール手順

CircleCI セルフホストランナーをアンインストールすると、システムの再インストールの準備をします。

  1. GitHub から Install-CircleCIRunner.ps1 スクリプトをダウンロードし、アクセスしやすい場所に配置します。

  2. PowerShell を管理者として開き、スクリプトファイルを配置したディレクトリに移動します。

  3. 以下を PowerShell で実行します。

    ./Uninstall-CircleCIRunner.ps1

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

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

サポートが必要ですか？

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

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

クリエイティブ・コモンズ・ライセンス
CircleCI Documentation by CircleCI is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.

6,000 Minutes Free

CircleCI, now with more build minutes
than anyone else for FREE 🎉

Sign up for Free

These teams get it

CCI customer teams