無料でビルドを開始
CircleCI.comアカデミーブログコミュニティサポート

CircleCI Server 上での CircleCI セルフホストランナーのアップグレード

9 months ago1 min read
Server v4.x
Server v3.x
このページの内容

ここでは、CircleCI Server 上で CircleCI *マシンランナー*を更新する方法を説明します。

マシンランナーのサーバーとの互換性

ご使用のプラットフォームに必要なランナーのバージョンは、マシンランナーの各インストールページを参照してください:

サーバー上のマシンランナーのアップグレード

クラウド版 CircleCI とは異なり、CircleCI Server は circleci-launch-agent を自動的に更新しないため、手動による操作が必要です。 以下では、さまざまな環境で CircleCI Server のマシンランナーをアップグレードする方法を詳しく説明します。

コンテナ化された環境におけるマシンランナーのアップグレード

ここでは、Kurbernetes や Docker のコンテナ化された環境でセルフホストランナーをアップグレードする方法について詳しく説明します。

Kubernetes のマシンランナーのアップグレード

Kubernetes のインストールガイドを参照してください。

Docker のマシンランナーのアップグレード

  1. 現在実行中のすべてのセルフホストランナーコンテナを停止する

    docker stop <container-name>
  2. セルフホストランナーのコンテナを削除する

    docker stop <container-name>; docker rm <container-name>;
  3. 新しいマシンランナーの Docker コンテナを起動する

    CIRCLECI_RESOURCE_CLASS=<resource-class> CIRCLECI_API_TOKEN=<runner-token> agent_version=<agent_version_for_server> docker run --env agent_version --env CIRCLECI_API_TOKEN --env CIRCLECI_RESOURCE_CLASS --name <container-name> <image-id-from-previous-step>

コンテナ化されていない環境におけるマシンランナーのアップグレード

コンテナ化されていない環境では、`circleci-launch-agent`バイナリを手動で更新するプロセスは 3 つのステップに分けられます。 各ステップの詳細は次のセクションで説明します。

  1. 既存の circleci-launch-agent バイナリを新しいバージョンに置き換える

  2. 現在実行中の circleci-launch-agent プロセスを停止する

  3. 新しいバージョンの circleci-launch-agent バイナリを起動する

1. 既存の circleci-launch-agent バイナリを新しいバージョンに置き換える

ローンチエージェントバイナリのダウンロード と同じ手順で、agent_version の環境変数を CircleCI Server 用のセルフホストランナーの互換性リスト に記載されている正しいバージョンに更新します。

export agent_version="<launch-agent-version>" && sh ./download-launch-agent.sh
$Env:agentVer = "<launch-agent-version>"
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072;
./Install-CircleCIRunner.ps1

2. 現在実行中のマシンランナーを停止する

新しく更新されたバイナリを開始する前に現在実行中の circleci-launch-agent プロセスを停止する必要があります。 各プラットフォームの停止方法は以下のとおりです。

Linux でのマシンランナーの停止

次のコマンドを実行します。

sudo systemctl stop circleci.service
sudo systemctl disable circleci.service
Mac でのマシンランナーの停止

次のコマンドを実行します。

sudo launchctl unload '/Library/LaunchDaemons/com.circleci.runner.plist'
Windows でのマシンランナーの停止

次のコマンドを実行します。

Stop-ScheduledTask -TaskName "CircleCI Launch Agent"

3. 新しいマシンランナーを起動する

各プラットフォームの起動方法は以下のとおりです。

Linux での起動

次のコマンドを実行します。

sudo systemctl reload circleci.service
sudo systemctl enable circleci.service
sudo systemctl start circleci.service
Mac での起動

次のコマンドを実行します。

sudo launchctl load '/Library/LaunchDaemons/com.circleci.runner.plist'
Windows での起動

次のコマンドを実行します。

Start-ScheduledTask -TaskName "CircleCI Launch Agent"

Suggest an edit to this page

Make a contribution
Learn how to contribute