このイメージは、従来の CircleCI 製 Ruby イメージ circleci/ruby
の後継となるものです。
cimg/ruby
は、継続的インテグレーションでのビルドを想定して CircleCI が作成した Docker イメージです。 各タグには、特定のバージョンの Ruby 一式と gem
コマンド、Bundler、および CircleCI 環境でビルドを正常に完了させるために必要なバイナリとツールが含まれています。
このイメージは、CircleCI Docker
Executor と組み合わせて使用します。 以下に例を示します。
1
2
3
4
5
6
7
jobs:
build:
docker:
- image: cimg/ruby:3.3.6
steps:
- checkout
- run: ruby --version
上記の例では、この CircleCI 製 Ruby Docker イメージをプライマリ コンテナとして使用しています。 具体的に言うと、3.3.6
というタグで、バージョン v3.3.6 の Ruby を指定しています。 こうすることで、このジョブのステップ内で Ruby を使用できます。
このイメージには Ruby プログラミング言語が含まれています。 また、gem
コマンドと Bundler が事前インストールされます。
このイメージのタグ付けのスキームは以下のとおりです。
cimg/ruby:<ruby-version>[-variant]
<ruby-version>
- 使用する Ruby のバージョンを指定します。 完全なセマンティック バージョニング形式でポイント リリースを指定するか (2.6.5
など)、またはマイナー リリースを指定できます (2.6
など)。 マイナー リリースを指定した場合は、将来的にパッチ アップデートがリリースされた時点で、そのパッチ アップデートを参照することになります。 たとえば、タグ 2.6
は、執筆時点では Ruby v2.6.5 を参照しますが、次のリリースが発表された後は v2.6.6 を参照することになります。
[-variant]
- 利用可能な場合は、バリアント タグもオプションとして使用できます。 たとえば、cimg/ruby:2.6.5-node
と指定すると、Node.js バリアントを使うことができます。
通常、バリアント イメージのベース ソフトウェアは元イメージと同一ですが、いくつかの変更が加えられています。
Node.js バリアントのベースは元の Ruby イメージと同一ですが、こちらでは Node.js もインストールされます。 このバリアントは、-node
を既存の cimg/ruby
タグの末尾に追加することで使用できます。
1
2
3
4
5
6
7
8
jobs:
build:
docker:
- image: cimg/ruby:3.3.6-node
steps:
- checkout
- run: ruby --version
- run: node --version
ブラウザー バリアントのベースは元の Ruby イメージと同一ですが、こちらでは apt により Node.js、Java、Selenium、ブラウザーの依存関係が事前インストールされます。 使用するには、-browser
を既存の cimg/ruby
タグの末尾に追加します。 このバリアントは、CircleCI Browser-Tools Orb と組み合わせて使用する想定で設計されています。 この Orb を使用すると、任意のバージョンの Google Chrome と Firefox のいずれかまたは両方をビルドでインストールできます。 このイメージには、各ブラウザーおよびそのドライバーを使用するうえで必要なすべてのサポート対象ツールが含まれています。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
orbs:
browser-tools: circleci/browser-tools@1.1
jobs:
build:
docker:
- image: cimg/ruby:2.7-browsers
steps:
- browser-tools/install-browser-tools
- checkout
- run: |
ruby --version
node --version
java --version
google-chrome --version