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

VM サービスを使った仮想マシンの管理

9 months ago1 min read
Server v4.1
サーバー管理者
このページの内容

VM サービスにより、 Machine Executor と リモート Docker ジョブの実行方法を制御できます。

このセクションでは、VM サービスで設定可能なオプションについて説明します。 仮想マシンを事前に拡張する方法の詳細については、デフォルトの values.yaml ファイルを参照してください。

VM プロバイダー

下記は、AWS または GCP の VM プロバイダー用の設定オプションです。

AWS

values.yaml ファイルに、AWS EC2 と連携するように VM サービスを設定するセクションがあります。 インストールの間に、セキュリティグループと認証のセットアップを行います。 詳細については、 インストールステップ 3: 実行環境 を参照してください。

ここではインストール後の VM サービスの設定オプションについて説明します。

Windows イメージ

Windows Executor が必要な場合は、values.yaml ファイルに AMI ID を記述します。 Windows イメージの作成には、 CircleCI Server Windows イメージビルダー を使用します。

vm_service:
  providers:
    ec2:
      ...
      windowsAMI: "<my-windows-ami>"

代替の Linux VM イメージ

Linux Machine Executor にカスタム AMI を指定する場合、values.yaml ファイルに AMI ID を記述します。 Linux イメージの作成には、 CircleCI Server Windows イメージビルダー を使用します。

vm_service:
  providers:
    ec2:
      ...
      linuxAMI: "<my-linux-ami>"

デフォルトの AWS AMI リスト

デフォルトの Server v4.x 用の AMI は Ubuntu 22.04 に基づいています。

x86 AMI リスト
地域AMI

us-east-1

ami-03dc54f7559144972

eu-central-1

ami-0575d605472840942

ap-south-1

ami-047ef6196620f56ca

ap-southeast-2

ami-0521f8d70ef9dbd24

ap-southeast-1

ami-0ef0354f4eb3b7428

eu-central-1

ami-0a8286fff7b5ed33a

eu-west-1

ami-093618a1d0185f9e8

eu-west-2

ami-08f00d41b17d3ea0a

sa-east-1

ami-064b0bfe97e6ec04c

us-east-2

ami-068cb131f91632f12

us-west-1

ami-0a4b7cf088a798be3

us-west-2

ami-018e05f98628cf5e5

ap-northeast-1

ami-06f32ec6aeecbeaa6

ap-northeast-2

ami-084c1abb1e8dabffd

eu-west-3

ami-09b3e24bccae3252f

us-east-1

ami-0de525cac9ac9bea8

us-gov-west-1

ami-02abf947586cae56b

Arm AMI リスト
地域AMI

us-east-1

ami-0b11ce74f44e45578

eu-central-1

ami-07400e987dd82901d

ap-south-1

ami-072fe819d7b94b095

ap-southeast-2

ami-0510826f7f3a83b3e

ap-southeast-1

ami-0e5b703665f3e4517

eu-central-1

ami-045ea67b0f35ef1ef

eu-west-1

ami-044ac39c87438d89d

eu-west-2

ami-0a399817fbbb240e4

sa-east-1

ami-0ebc0e64fb943e191

us-east-2

ami-01f7dc2f8590b1611

us-west-1

ami-085fb1dd323aa02c7

us-west-2

ami-0e5ea38c131f05c8f

ap-northeast-1

ami-02c8fac0dbbbad74f

ap-northeast-2

ami-022e2eacee7328cca

us-east-1

ami-0bb797dcfa52ce04d

us-gov-west-1

ami-0ab175883ff460b17

GCP

values.yaml ファイルに、GCP と連携するように VM サービスを設定するセクションがあります。 インストールの間に、セキュリティグループと認証のセットアップを行います。 詳細については、 インストールステップ 3: 実行環境 を参照してください。

ここではインストール後の VM サービスの設定オプションについて説明します。

Windows イメージ

Windows Executor が必要な場合は、values.yaml ファイルに AMI ID を記述します。 Windows イメージの作成には、 CircleCI Server Windows イメージビルダー を使用します。

vm_service:
  providers:
    gcp:
      ...
      windowsImage: "<my-windows-image>"

代替の Linux VM イメージ

Linux Machine Executor にカスタム AMI を指定する場合、values.yaml ファイルに AMI ID を記述します。 Linux イメージの作成には、 CircleCI Server Windows イメージビルダー を使用します。

vm_service:
  providers:
    gcp:
      ...
      linuxImage: "<my-linux-image>"

インスタンスの事前割り当て

常にインスタンスが事前に割り当てられるようにサーバーを設定するには、以下の values.yaml サンプルに示されているキーを使用します。

vm_scaler:
  # -- Number of replicas to deploy for the vm-scaler deployment.
  replicas: 1
  # -- Configuration options for, and numbers of, prescaled instances for remote Docker jobs.
  prescaled:
    - type: l1.medium
      image: docker-default
      docker-engine: true # remote Docker environment
      cron: ""
      count: 2
vm_scaler:
  # -- Number of replicas to deploy for the vm-scaler deployment.
  replicas: 1
  # -- Configuration options for, and numbers of, prescaled instances for remote Docker jobs.
  prescaled:
    - type: l1.medium
      image: default
      docker-engine: false # machine execution environment
      cron: ""
      count: 2

変更の適用

values.yaml ファイルへの変更を適用します。

namespace=<your-namespace>
helm upgrade circleci-server oci://cciserver.azurecr.io/circleci-server -n $namespace --version 4.1.8 -f <path-to-values.yaml>

Suggest an edit to this page

Make a contribution
Learn how to contribute