第2章 Source-to-Image (S2I)

.NET Core は、自動メモリー管理および最新のプログラム言語が搭載された、汎用の開発プラットフォームです。.NET Core では、効率的に高品質のアプリケーションをビルドできます。.NET Core は、認定済みのコンテナー経由で Red Hat Enterprise Linux (RHEL 7) および OpenShift Container Platform から利用できます。.NET Core は以下の機能を提供します。

.NET Core バージョン 2.1 関連のリリースの詳細は、『Release Notes for Containers』を参照してください。

バージョン 1.1 および 1.0 (rh-dotnetcore11 および rh-dotnetcore10) には project.json ビルドシステム (1.0.0-preview2 SDK) が同梱されています。RHEL システム以外にこの SDK をインストールする方法については、『version 1.1 Release Notes』の既知の問題についての章を参照してください。

RHEL 7 イメージは、Red Hat レジストリーから入手できます。

$ docker pull registry.access.redhat.com/dotnet/dotnet-21-rhel7
$ docker pull registry.access.redhat.com/dotnet/dotnet-20-rhel7
$ docker pull registry.access.redhat.com/dotnet/dotnetcore-11-rhel7
$ docker pull registry.access.redhat.com/dotnet/dotnetcore-10-rhel7

RHEL S2I イメージ上の .NET Core 向けのイメージストリーム定義は、OpenShift Container Platform のインストール時に追加されるようになりました。

S2I は、ソースコードをコンテナーに挿入し、コンテナーにソースコードの実行を準備をさせることで、実行準備が整ったイメージを生成します。S2I では、以下の手順を実行します。

ビルドプロセスの詳細の説明については、「S2I ビルドプロセス」を参照してください。

.NET Core イメージは、複数の環境変数をサポートします。この環境変数を設定して、.NET Core アプリケーションのビルド動作を制御することができます。

サンプルのリポジトリーに対して oc new-app を実行すると、イメージを使用してアプリケーションをビルドできます。

$ oc new-app registry.access.redhat.com/dotnet/dotnet-21-rhel7~https://github.com/redhat-developer/s2i-dotnetcore-ex#dotnetcore-2.1 --context-dir=app
$ oc new-app registry.access.redhat.com/dotnet/dotnet-20-rhel7~https://github.com/redhat-developer/s2i-dotnetcore-ex#dotnetcore-2.0 --context-dir=app
$ oc new-app registry.access.redhat.com/dotnet/dotnetcore-11-rhel7~https://github.com/redhat-developer/s2i-dotnetcore-ex#dotnetcore-1.1 --context-dir=app
$ oc new-app registry.access.redhat.com/dotnet/dotnetcore-10-rhel7~https://github.com/redhat-developer/s2i-dotnetcore-ex#dotnetcore-1.0 --context-dir=app

$ (oc get -n openshift templates; oc get -n openshift is) | grep dotnet

OpenShift Container Platform には .NET Core イメージのテンプレートが含まれており、サンプルアプリケーションを簡単にデプロイしやすくなります。

dotnet/dotnet-21-rhel7 で実行する .NET Core のサンプルアプリケーション は、以下のコマンドでデプロイ可能です。

$ oc new-app --template dotnet-example -p DOTNET_IMAGE_STREAM_TAG=dotnet:2.1 -p SOURCE_REPOSITORY_REF=dotnetcore-2.1

dotnet/dotnetcore-10-rhel7 で実行する .NET Core のサンプルアプリケーション は以下のコマンドでデプロイ可能です。

$ oc new-app --template dotnet-example

PostgreSQL をデータベースとして使用した .NET Core MusicStore アプリケーション は、以下のコマンドでデプロイ可能です。

$ oc new-app --template=dotnet-pgsql-persistent

OpenShift Container Platform には 、Node.js アプリケーションのビルドおよび実行用に S2I が有効な Node.js イメージが含まれています。Node.js S2I ビルダーイメージは、必要な依存関係を使用してアプリケーションソースをアセンブルし、Node.js アプリケーションを含む新規イメージを作成します。このように作成されるイメージは、OpenShift Container Platform または Docker で実行可能です。

現在、OpenShift Container Platform では、Node.js のバージョン 0.10、4 および 6 を提供しています。

これらのイメージには 2 つのフレーバーがあり、ニーズに合わせて選択できます。

RHEL 7 ベースのイメージ

RHEL 7 イメージは、Red Hat レジストリーから入手できます。

$ docker pull registry.access.redhat.com/openshift3/nodejs-010-rhel7
$ docker pull registry.access.redhat.com/rhscl/nodejs-4-rhel7

CentOS 7 ベースのイメージ

このイメージは、Docker Hub で入手できます。

$ docker pull openshift/nodejs-010-centos7

これらのイメージを使用するには、イメージレジストリーから直接アクセスするか、ご自身の OpenShift Container Platform Docker レジストリーにプッシュしてください。さらに、Docker レジストリーまたは外部の場所に、対象イメージを参照するイメージストリームを作成することもでき、OpenShift Container Platform リソースがこのイメージストリームを参照できるようになります。提供されている全 OpenShift Container Platform イメージについてイメージストリームの定義例があります。

S2I は、ソースコードをコンテナーに挿入し、コンテナーにソースコードの実行を準備をさせることで、実行準備が整ったイメージを生成します。S2I では、以下の手順を実行します。

ビルドプロセスの詳細の説明については、「S2I ビルドプロセス」を参照してください。

Node.js イメージは、環境変数を複数サポートし、環境変数を設定することで Node.js のラインタイムの設定や動作を制御できます。

イメージの一部としてこれらの環境変数を設定するには、ソースコードリポジトリーの中にある .s2i/environment ファイルに配置するか、ビルド設定の sourceStrategy 定義の環境セクションに定義します。

また、新規アプリケーションの作成時に既存のイメージを使用するか、デプロイメント設定などの既存のオブジェクトの環境変数を更新して環境変数を設定できます。

ホットデプロイでは、新しい S2I ビルドを生成する必要なしに、アプリケーションに変更をすばやく加え、デプロイすることができます。アプリケーションのソースコードに加えられた変更を即座に検出するには、環境変数を DEV_MODE=true に指定してビルドイメージを実行する必要があります。

新規アプリケーションの作成時または既存オブジェクトの環境変数の更新時に、新しい環境変数を設定できます。

実行中の Pod のソースコードを変更するには、コンテナーにしてリモートシェルを開きます。

$ oc rsh <pod_id>

実行中のコンテナーに入ると、現在のディレクトリーは、ソースコードが配置されている /opt/app-root/src に変わります。

OpenShift Container Platform には 、Perl アプリケーションのビルドおよび実行用に S2I が有効な Perl イメージが含まれています。Perl S2I ビルダーイメージは、必要な依存関係を使用してアプリケーションソースをアセンブルし、Perl アプリケーションを含む新規イメージを作成します。このように作成されたイメージは、OpenShift Container Platform または Docker のいずれかで実行可能です。

現時点で、OpenShift Container Platform は Perl バージョン 5.16、5.20 および 5.24 をサポートしています。

イメージには 2 つのフレーバーがあり、ニーズに合わせて選択できます。

RHEL 7 ベースのイメージ

RHEL 7 イメージは、Red Hat レジストリーから入手できます。

$ docker pull registry.access.redhat.com/openshift3/perl-516-rhel7
$ docker pull registry.access.redhat.com/rhscl/perl-520-rhel7
$ docker pull registry.access.redhat.com/rhscl/perl-524-rhel7

CentOS 7 ベースのイメージ

Perl 5.16 の CentOS イメージは、Docker Hub で入手できます。

$ docker pull openshift/perl-516-centos7

これらのイメージを使用するには、イメージレジストリーから直接アクセスするか、ご自身の OpenShift Container Platform Docker レジストリーにプッシュしてください。さらに、Docker レジストリーまたは外部の場所に、対象イメージを参照するイメージストリームを作成することもでき、OpenShift Container Platform リソースがこのイメージストリームを参照できるようになります。提供されている全 OpenShift Container Platform イメージについてのイメージストリームの定義例があります。

S2I は、ソースコードをコンテナーに挿入し、コンテナーにソースコードの実行を準備をさせることで、実行準備が整ったイメージを生成します。S2I では、以下の手順を実行します。

ビルドプロセスの詳細の説明については、「S2I ビルドプロセス」を参照してください。

Perl イメージは多数の環境変数を複数サポートし、環境変数を設定することで Perl のラインタイムの設定や動作を制御できます。

イメージの一部としてこれらの環境変数を設定するには、ソースコードリポジトリーの中にある .s2i/environment ファイルに配置するか、ビルド設定の sourceStrategy 定義の環境セクションに定義します。

また、新規アプリケーションの作成時に既存のイメージを使用するか、デプロイメント設定などの既存のオブジェクトの環境変数を更新して環境変数を設定できます。

アクセスログは、標準出力にストリーミングされるので、oc logsコマンドを使用して表示可能です。エラーログは /tmp/error_log ファイルに保存されているので、コンテナーにアクセスする oc rshコマンドを使用して表示できます。

ホットデプロイでは、新しい S2I ビルドを生成する必要なしに、アプリケーションに変更をすばやく加え、デプロイすることができます。このイメージでホットデプロイを有効化するには、PERL_APACHE2_RELOAD 環境変数を true に設定する必要があります。たとえば、oc new-app コマンドを参照してください。oc set env コマンドを使用して、既存オブジェクトの環境変数を更新できます。

実行中の Pod でソースコードを変更するには、oc rsh コマンドを使用して、コンテナーに入ります。

$ oc rsh <pod_id>

実行中のコンテナーに入った後に、現在のディレクトリーを、ソースコードが配置されている /opt/app-root/src に設定します。

OpenShift Container Platform には 、PHP アプリケーションのビルドおよび実行用に S2I が有効な PHP イメージが含まれています。PHP S2I ビルダーイメージは、必要な依存関係を使用してアプリケーションソースをアセンブルし、PHP アプリケーションを含む新規イメージを作成します。このように作成されたイメージは、OpenShift Container Platform または Docker のいずれかで実行可能です。

現時点で、OpenShift Container Platform では、PHP のバージョン 5.5、5.6 および 7.0 を提供しています。

これらのイメージには 2 つのフレーバーがあり、ニーズに合わせて選択できます。

RHEL 7 ベースのイメージ

RHEL 7 イメージは、Red Hat レジストリーから入手できます。

$ docker pull registry.access.redhat.com/openshift3/php-55-rhel7
$ docker pull registry.access.redhat.com/rhscl/php-56-rhel7
$ docker pull registry.access.redhat.com/rhscl/php-70-rhel7

CentOS 7 ベースのイメージ

PHP 5.5 および 5.6 の CentOS イメージは、Docker Hub で入手できます。

$ docker pull openshift/php-55-centos7
$ docker pull openshift/php-56-centos7

これらのイメージを使用するには、イメージレジストリーから直接アクセスするか、ご自身の OpenShift Container Platform Docker レジストリーにプッシュしてください。さらに、Docker レジストリーまたは外部の場所に、対象イメージを参照するイメージストリームを作成することもでき、OpenShift Container Platform リソースがこのイメージストリームを参照できるようになります。

提供される全 OpenShift Container Platform イメージに対して イメージストリームの定義例 があります。

S2I は、ソースコードをコンテナーに挿入し、コンテナーにソースコードの実行を準備をさせることで、実行準備が整ったイメージを生成します。S2I では、以下の手順を実行します。

ビルドプロセスの詳細の説明については、「S2I ビルドプロセス」を参照してください。

PHP イメージは数多くの環境変数を複数サポートし、環境変数を設定することで PHP のラインタイムの設定や動作を制御できます。

イメージの一部としてこれらの環境変数を設定するには、ソースコードリポジトリーの中にある .s2i/environment ファイルに配置するか、ビルド設定の sourceStrategy 定義の環境セクションに定義します。

また、新規アプリケーションの作成時に既存のイメージを使用するか、デプロイメント設定などの既存のオブジェクトの環境変数を更新して環境変数を設定できます。

以下の環境変数は、php.ini ファイルに同等のプロパティー値を設定します。

以下の環境変数は、opcche.ini ファイルに同等のプロパティー値を設定します。

以下を設定して PHP 設定の読み込みに使用するディレクトリー全体を上書きすることも可能です。

デフォルトの 'packagist.org' ではなく、カスタムの Composer リポジトリーのミラー URL を使用して、パッケージをダウンロードできます。

アクセスログは、標準出力にストリーミングされるので、oc logs コマンドを使用して表示可能です。エラーログは /tmp/error_log ファイルに保存されているので、コンテナーにアクセスする oc rshコマンドを使用して表示できます。

ホットデプロイでは、新しい S2I ビルドを生成する必要なしに、アプリケーションに変更をすばやく加え、デプロイすることができます。アプリケーションのソースコードに加えられた変更を即座に検出するには、環境変数を OPCACHE_REVALIDATE_FREQ=0 に指定してビルドイメージを実行する必要があります。

たとえば、oc new-app コマンドを参照してください。oc env コマンドを使用して、既存オブジェクトの環境変数を更新できます。

実行中の Pod でソースコードを変更するには、oc rsh コマンドを使用して、コンテナーに入ります。

$ oc rsh <pod_id>

実行中のコンテナーに入った後に、現在のディレクトリーを、ソースコードが配置されている /opt/app-root/src に設定します。

OpenShift Container Platform には 、Python アプリケーションのビルドおよび実行用に S2I が有効な Python イメージが含まれています。Python S2I ビルダーイメージは、必要な依存関係を使用してアプリケーションソースをアセンブルし、Python アプリケーションを含む新規イメージを作成します。このように作成されたイメージは、OpenShift Container Platform または Docker で実行可能です。

現時点では、OpenShift Container Platform では、Python のバージョン 2.7、3.3、3.4 および 3.5 を提供しています。

これらのイメージには 2 つのフレーバーがあり、ニーズに合わせて選択できます。

RHEL 7 ベースのイメージ

RHEL 7 イメージは、Red Hat レジストリーから入手できます。

$ docker pull registry.access.redhat.com/rhscl/python-27-rhel7
$ docker pull registry.access.redhat.com/openshift3/python-33-rhel7
$ docker pull registry.access.redhat.com/rhscl/python-34-rhel7
$ docker pull registry.access.redhat.com/rhscl/python-35-rhel7

CentOS 7 ベースのイメージ

これらのイメージは、Docker Hub で入手できます。

$ docker pull centos/python-27-centos7
$ docker pull openshift/python-33-centos7
$ docker pull centos/python-34-centos7
$ docker pull centos/python-35-centos7

これらのイメージを使用するには、イメージレジストリーから直接アクセスするか、ご自身の OpenShift Container Platform Docker レジストリーにプッシュしてください。さらに、Docker レジストリーまたは外部の場所に、対象イメージを参照する イメージストリームを作成することもでき、OpenShift Container Platform リソースがこのイメージストリームを参照できるようになります。提供されている全 OpenShift Container Platform イメージについてイメージストリームの定義例 があります。

S2I は、ソースコードをコンテナーに挿入し、コンテナーにソースコードの実行を準備をさせることで、実行準備が整ったイメージを生成します。S2I では、以下の手順を実行します。

ビルドプロセスの詳細の説明については、「S2I ビルドプロセス」を参照してください。

Python イメージは多数の環境変数を複数サポートし、環境変数を設定することで Python のラインタイムの設定や動作を制御できます。

イメージの一部としてこれらの環境変数を設定するには、ソースコードリポジトリーの中にある .s2i/environment ファイルに配置するか、ビルド設定の sourceStrategy 定義の環境セクションに定義します。

また、新規アプリケーションの作成時に既存のイメージを使用するか、デプロイメント設定などの既存のオブジェクトの環境変数を更新して環境変数を設定できます。

ホットデプロイでは、新しい S2I ビルドを生成する必要なしに、アプリケーションに変更をすばやく加え、デプロイすることができます。Django を使用する場合は、ホットデプロイメントはカスタマイズなしに使用できます。

Gunicorn を使用したホットデプロイメントを有効にするには、reload オプション を true に設定して、リポジトリーに Gunicorn 設定ファイルが配置されているようにします。設定ファイルは、APP_CONFIG 環境変数を使用して指定します。たとえば、oc new-app コマンドを参照してください。oc set env コマンドを使用して、既存オブジェクトの環境変数を更新できます。

実行中の Pod でソースコードを変更するには、oc rsh コマンドを使用して、コンテナーに入ります。

$ oc rsh <pod_id>

実行中のコンテナーに入った後に、現在のディレクトリーを、ソースコードが配置されている /opt/app-root/src に設定します。

OpenShift Container Platform には 、Ruby アプリケーションのビルドおよび実行用に S2I が有効な Ruby イメージが含まれています。Ruby S2I ビルダーイメージは、必要な依存関係を使用してアプリケーションソースをアセンブルし、Ruby アプリケーションを含む新規イメージを作成します。このように作成されたイメージは、OpenShift Container Platform または Docker で実行可能です。

現時点で、OpenShift Container Platform では、Ruby のバージョン 2.0、2.2 および 2.3 を提供しています。

これらのイメージには 2 つのフレーバーがあり、ニーズに合わせて選択できます。

RHEL 7 ベースのイメージ

RHEL 7 イメージは、Red Hat レジストリーから入手できます。

$ docker pull registry.access.redhat.com/openshift3/ruby-20-rhel7
$ docker pull registry.access.redhat.com/rhscl/ruby-22-rhel7
$ docker pull registry.access.redhat.com/rhscl/ruby-23-rhel7

CentOS 7 ベースのイメージ

これらのイメージは、Docker Hub で入手できます。

$ docker pull openshift/ruby-20-centos7
$ docker pull openshift/ruby-22-centos7
$ docker pull centos/ruby-23-centos7

これらのイメージを使用するには、イメージレジストリーから直接アクセスするか、ご自身の OpenShift Container Platform Docker レジストリーにプッシュしてください。さらに、Docker レジストリーまたは外部の場所に、対象イメージを参照する イメージストリームを作成することもでき、OpenShift Container Platform リソースがこのイメージストリームを参照できるようになります。提供されている全 OpenShift Container Platform イメージについてイメージストリームの定義例 があります。

S2I は、ソースコードをコンテナーに挿入し、コンテナーにソースコードの実行を準備をさせることで、実行準備が整ったイメージを生成します。S2I では、以下の手順を実行します。

ビルドプロセスの詳細の説明については、「S2I ビルドプロセス」を参照してください。

Ruby イメージは多数の環境変数を複数サポートし、環境変数を設定することで Ruby のラインタイムの設定や動作を制御できます。

イメージの一部としてこれらの環境変数を設定するには、ソースコードリポジトリーの中にある .s2i/environment ファイルに配置するか、ビルド設定の sourceStrategy 定義の環境セクションに定義します。

また、新規アプリケーションの作成時に既存のイメージを使用するか、デプロイメント設定などの既存のオブジェクトの環境変数を更新して環境変数を設定できます。

ホットデプロイでは、新しい S2I ビルドを生成する必要なしに、アプリケーションに変更をすばやく加え、デプロイすることができます。このイメージでホットデプロイメントを有効にする方法は、アプリケーションの種類により異なります。

Ruby on Rails アプリケーション

Ruby on Rails アプリケーションの場合は、RAILS_ENV=development 環境変数を実行中の Pod に渡して、ビルド済みの Rails アプリケーションを実行します。既存のデプロイメント設定では、oc set envコマンドを使用できます。

$ oc set env dc/rails-app RAILS_ENV=development

他のタイプの Ruby アプリケーション (Sinatra、Padrino など)

他のタイプの Ruby アプリケーションでは、アプリケーションは実行中のコンテナー内でソースコードが変更されるたびに、サーバーを再読み込みできる gem でビルドする必要があります。

開発モードでアプリケーションを実行できるようにするには、選択した gem で Web サーバーを起動し、ソースコードへの変更の有無を確認するように、S2I run スクリプトを変更する必要があります。

S2I run スクリプトでアプリケーションイメージをビルドした後に、RACK_ENV=development 環境変数でイメージを実行します。たとえば、oc new-app コマンドを確認します。oc set env コマンドを使用して、既存オブジェクトの環境変数を更新することができます。

実行中の Pod でソースコードを変更するには、oc rsh コマンドを使用して、コンテナーに入ります。

$ oc rsh <pod_id>

実行中のコンテナーに入った後に、現在のディレクトリーを、ソースコードが配置されている /opt/app-root/src に設定します。

S2I ビルダーイメージには通常、assemble と run スクリプトが含まれていますが、これらのスクリプトのデフォルトの動作はすべてのユーザーに適さない場合があります。以下のトピックでは、デフォルトのスクリプトなど、S2I ビルダーの動作をカスタマイズするいくつかの方法について説明します。

一般的に、ビルダーイメージでは、最も一般的なユースケースを含む、独自の S2I スクリプトが提供されます。これらのスクリプトで各自のニーズが満たされない場合に向け、S2I には .s2i/bin ディレクトリーにカスタムのスクリプトを追加して上書きできる手段があります。ただし、カスタムのスクリプトを追加すると、標準のスクリプトを完全に置き換えられます。これは許容範囲の場合もありますが、シナリオによっては、イメージに含まれるスクリプトのロジックを保持しつつ、スクリプトの前 (または後) にコマンドをいくつか実行する必要がある場合があります。そのような場合には、カスタムのロジックを実行し、イメージ内のデフォルトのスクリプトに追加のタスクを委譲するラッパースクリプトを作成できます。

ビルダーイメージ内のスクリプトの場所を判断するには、io.openshift.s2i.scripts-url ラベルの値を確認します。以下のように docker inspect を使用してください。

$ docker inspect --format='{{ index .Config.Labels "io.openshift.s2i.scripts-url" }}' openshift/wildfly-100-centos7
image:///usr/libexec/s2i

openshift/wildfly-100-centos7 ビルダーイメージを確認し、対象のスクリプトが /usr/libexec/s2i ディレクトリーにあることを確認できます。

この情報を基にして、呼び出しをラップし、独自のスクリプトからこれらのスクリプトを呼び出します。

#!/bin/bash
echo "Before assembling"

/usr/libexec/s2i/assemble
rc=$?

if [ $rc -eq 0 ]; then
    echo "After successful assembling"
else
    echo "After failed assembling"
fi

exit $rc

以下の例では、メッセージを出力するカスタムの assemble スクリプトを表示し、イメージから標準の assemble スクリプトを実行して、assemble スクリプトの終了コードに応じて別のメッセージを出力します。

run スクリプトをラップする場合には、スクリプトの呼び出しに exec を実行して、シグナルが正しく処理されるようにする必要があります。残念ながら、exec を使用すると、デフォルトのイメージ実行スクリプトを呼び出した後に追加でコマンドを実行できなくなります。

#!/bin/bash
echo "Before running application"
exec /usr/libexec/s2i/run