第6章 アプリケーションの移行

すべてのデータベースをダンプファイルにエクスポートして、これをローカルマシン (現在のディレクトリー) にコピーします

$ rhc ssh <v2_application_name>
$ mysqldump --skip-lock-tables -h $OPENSHIFT_MYSQL_DB_HOST -P ${OPENSHIFT_MYSQL_DB_PORT:-3306} -u ${OPENSHIFT_MYSQL_DB_USERNAME:-'admin'} \
 --password="$OPENSHIFT_MYSQL_DB_PASSWORD" --all-databases > ~/app-root/data/all.sql
$ exit

dbdump をローカルマシンにダウンロードします。

$ mkdir mysqldumpdir
$ rhc scp -a <v2_application_name> download mysqldumpdir app-root/data/all.sql

テンプレートから v3 mysql-persistent Pod を作成します。

$ oc new-app mysql-persistent -p \
   MYSQL_USER=<your_V2_mysql_username> -p \
   MYSQL_PASSWORD=<your_v2_mysql_password> -p MYSQL_DATABASE=<your_v2_database_name>

Pod の使用準備ができているかどうかを確認します。

$ oc get pods

Pod の実行中に、データベースのアーカイブファイルを v3 MySQL Pod にコピーします。

$ oc rsync /local/mysqldumpdir <mysql_pod_name>:/var/lib/mysql/data

v3 の実行中の Pod に、データベースを復元します。

$ oc rsh <mysql_pod>
$ cd /var/lib/mysql/data/mysqldumpdir

v3 では、データベースを復元するには、root ユーザーとして MySQL にアクセスする必要があります。

v2 では、$OPENSHIFT_MYSQL_DB_USERNAME には全データベースに対する完全な権限がありました。v3 では、権限をデータベースごとに $MYSQL_USER に割り当てる必要があります。

$ mysql -u root
$ source all.sql

<dbname> のすべての権限を <your_v2_username>@localhost に割り当ててから、権限をフラッシュします。

Pod からダンプディレクトリーを削除します。

$ cd ../; rm -rf /var/lib/mysql/data/mysqldumpdir

ギアから v2 PostgreSQL データベースをバックアップします。

$ rhc ssh -a <v2-application_name>
$ mkdir ~/app-root/data/tmp
$ pg_dump <database_name> | gzip > ~/app-root/data/tmp/<database_name>.gz

ローカルマシンに、バックアップファイルを展開します。

$ rhc scp -a <v2_application_name> download <local_dest> app-root/data/tmp/<db-name>.gz
$ gzip -d <database-name>.gz

新規サービスを作成するための v2 アプリケーションのデータベース名、ユーザー名、パスワードを使用して PostgreSQL サービスを作成します。

$ oc new-app postgresql-persistent -p POSTGRESQL_DATABASE=dbname -p
POSTGRESQL_PASSWORD=password -p POSTGRESQL_USER=username

Pod の使用準備ができているかどうかを確認します。

$ oc get pods

Pod を実行中に、バックアップディレクトリーを Pod に同期します。

$ oc rsync /local/path/to/dir <postgresql_pod_name>:/var/lib/pgsql/data

Pod にリモートからアクセスします。

$ oc rsh <pod_name>

データベースを復元します。

psql dbname < /var/lib/pgsql/data/<database_backup_file>

必要のなくなったバックアップファイルをすべて削除します。

$ rm /var/lib/pgsql/data/<database-backup-file>

ssh コマンドを使用して、v2 アプリケーションにリモートからアクセスします。

$ rhc ssh <v2_application_name>

-d <database_name> -c <collections> で単一のデータベースを指定して、mongodump を実行します。このオプションがないと、データベースはすべてダンプされます。各データベースは、独自のディレクトリーにダンプされます。

$ mongodump -h $OPENSHIFT_MONGODB_DB_HOST -o app-root/repo/mydbdump -u 'admin' -p $OPENSHIFT_MONGODB_DB_PASSWORD
$ cd app-root/repo/mydbdump/<database_name>; tar -cvzf dbname.tar.gz
$ exit

dbdump を mongodump ディレクトリーのローカルマシンにダウンロードします。

$ mkdir mongodump
$ rhc scp -a <v2 appname> download mongodump \
  app-root/repo/mydbdump/<dbname>/dbname.tar.gz

v3 で MongoDB Pod を実行します。最新のイメージ (3.2.6) には mongo-tools が含まれないので、mongorestore または mongoimport コマンドを使用するには、デフォルトのmongodb-persistent テンプレートを編集して、mongo-tools, “mongodb:2.4” を含むイメージタグを指定します。このため、以下の oc export コマンドを使用して、編集することが必要です。

$ oc export template mongodb-persistent -n openshift -o json > mongodb-24persistent.json

mongodb-24persistent.json の L80 を編集します。mongodb:latest は mongodb:2.4 に置き換えてください。

$ oc new-app --template=mongodb-persistent -n <project-name-that-template-was-created-in> \
  MONGODB_USER=user_from_v2_app -p \
  MONGODB_PASSWORD=password_from_v2_db -p \
  MONGODB_DATABASE=v2_dbname -p \
  MONGODB_ADMIN_PASSWORD=password_from_v2_db
$ oc get pods

mongodb Pod の実行中に、データベースのアーカイブファイルを v3 MongoDB Pod にコピーします。

$ oc rsync local/path/to/mongodump <mongodb_pod_name>:/var/lib/mongodb/data
$ oc rsh <mongodb_pod>

MongoDB Pod で、復元する各データベースについて以下を実行します。

$ cd /var/lib/mongodb/data/mongodump
$ tar -xzvf dbname.tar.gz
$ mongorestore -u $MONGODB_USER -p $MONGODB_PASSWORD -d dbname -v /var/lib/mongodb/data/mongodump

データベースが復元されたかどうかを確認します。

$ mongo admin -u $MONGODB_USER -p $MONGODB_ADMIN_PASSWORD
$ use dbname
$ show collections
$ exit

Pod から mongodump ディレクトリーを削除します。

$ rm -rf /var/lib/mongodb/data/mongodump

新しい GitHub リポジトリーを設定して、そのリポジトリーをリモートのブランチとして現在のローカル v2 Git リポジトリーに追加します。

$ git remote add <remote-name> https://github.com/<github-id>/<repo-name>.git

ローカルの v2 ソースコードを新規リポジトリーにプッシュします。

$ git push -u <remote-name> master

setup.py、wsgi.py、requirements.txt および etc などの重要なファイルがすべて新規リポジトリーにプッシュされていることを確認します。

oc コマンドを使用して、ビルダーイメージとソースコードから新規の Python アプリケーションを起動します。

$ oc new-app --strategy=source
python:3.3~https://github.com/<github-id>/<repo-name> --name=<app-name> -e
<ENV_VAR_NAME>=<env_var_value>

新しい GitHub リポジトリーを設定して、そのリポジトリーをリモートのブランチとして現在のローカル v2 Git リポジトリーに追加します。

$ git remote add <remote-name> https://github.com/<github-id>/<repo-name>.git

ローカルの v2 ソースコードを新規リポジトリーにプッシュします。

$ git push -u <remote-name> master

Gemfile がなく、単純な rack アプリケーションを実行している場合には、この Gemfile ファイルをソースの root にコピーします。

https://github.com/sclorg/ruby-ex/blob/master/Gemfile

oc コマンドを使用して、ビルダーイメージとソースコードから新規の Ruby アプリケーションを起動します。

$ oc new-app --strategy=source
ruby:2.0~https://github.com/<github-id>/<repo-name>.git

新しい GitHub リポジトリーを設定して、そのリポジトリーをリモートのブランチとして現在のローカル v2 Git リポジトリーに追加します。

$ git remote add <remote-name> https://github.com/<github-id>/<repo-name>

ローカルの v2 ソースコードを新規リポジトリーにプッシュします。

$ git push -u <remote-name> master

oc コマンドを使用して、ビルダーイメージとソースコードから新規の PHP アプリケーションを起動します。

$ oc new-app https://github.com/<github-id>/<repo-name>.git
--name=<app-name> -e <ENV_VAR_NAME>=<env_var_value>

新しい GitHub リポジトリーを設定して、そのリポジトリーをリモートのブランチとして現在のローカル v2 Git リポジトリーに追加します。

$ git remote add <remote-name> https://github.com/<github-id>/<repo-name>

ローカルの v2 ソースコードを新規リポジトリーにプッシュします。

$ git push -u <remote-name> master

ローカルの Git リポジトリーを編集して、変更をアップストリームにプッシュして、v3 との互換性を確保します。

新しい GitHub リポジトリーを設定して、そのリポジトリーをリモートのブランチとして現在のローカル Git リポジトリーに追加します。

$ git remote add <remote-name> https://github.com/<github-id>/<repo-name>

ローカルの v2 ソースコードを新規リポジトリーにプッシュします。

$ git push -u <remote-name> master

ローカルの Git リポジトリーを編集して、変更をアップストリームにプッシュして、v3 との互換性を確保します。

oc コマンドを使用して、ビルダーイメージとソースコードから新規の Node.js アプリケーションを起動します。

$ oc new-app https://github.com/<github-id>/<repo-name>.git
--name=<app-name> -e <ENV_VAR_NAME>=<env_var_value>

新しい GitHub リポジトリーを設定して、そのリポジトリーをリモートのブランチとして現在のローカル Git リポジトリーに追加します。

$ git remote add <remote-name> https://github.com/<github-id>/<repo-name>

ローカルの v2 ソースコードを新規リポジトリーにプッシュします。

$ git push -u <remote-name> master

JBoss EAP 7 ビルダーイメージ (jboss-eap70-openshift) と GitHub からのソースコードリポジトリーを使用して新規アプリケーションを作成します。

$ oc new-app --strategy=source jboss-eap70-openshift:1.6~https://github.com/<github-id>/<repo-name>.git

新しい GitHub リポジトリーを設定して、そのリポジトリーをリモートのブランチとして現在のローカル Git リポジトリーに追加します。

$ git remote add <remote-name> https://github.com/<github-id>/<repo-name>

ローカルの v2 ソースコードを新規リポジトリーにプッシュします。

$ git push -u <remote-name> master

JBoss Web Server 3 (Tomcat 7) ビルダーイメージ (jboss-webserver30-tomcat7) と GitHub からのソースコードリポジトリーを使用して新規アプリケーションを作成します。

$ oc new-app --strategy=source
jboss-webserver30-tomcat7-openshift~https://github.com/<github-id>/<repo-name>.git
--name=<app-name> -e <ENV_VAR_NAME>=<env_var_value>

新しい GitHub リポジトリーを設定して、そのリポジトリーをリモートのブランチとして現在のローカル Git リポジトリーに追加します。

$ git remote add <remote-name> https://github.com/<github-id>/<repo-name>

ローカルの v2 ソースコードを新規リポジトリーにプッシュします。

$ git push -u <remote-name> master

ローカルの Git リポジトリーを編集して、変更をアップストリームにプッシュして v3 との互換性を確保します。

oc コマンドを使用して、ビルダーイメージとソースコードから新規の Wildfly アプリケーションを起動します。

$ oc new-app https://github.com/<github-id>/<repo-name>.git
 --image-stream=”openshift/wildfly:10.0" --name=<app-name> -e
 <ENV_VAR_NAME>=<env_var_value>

クイックスタートテンプレートのクローンを作成して、GitHub リポジトリーをリモートとして追加します。

$ git clone <one-of-the-template-URLs-listed-above>
$ cd <your local git repository>
$ git remote add upstream <https://github.com/<git-id>/<quickstart-repo>.git>
$ git push -u upstream master

ソースコードを GitHub にコミットし、プッシュします。

$ cd <your local repository>
$ git commit -am “added code for my app”
$ git push origin master

v3 で新規アプリケーションを作成します。

$ oc new-app --template=<template> \
-p SOURCE_REPOSITORY_URL=<https://github.com/<git-id>/<quickstart_repo>.git> \
-p DATABASE_USER=<your_db_user> \
-p DATABASE_NAME=<your_db_name> \
-p DATABASE_PASSWORD=<your_db_password> \
-p DATABASE_ADMIN_PASSWORD=<your_db_admin_password> 1

web フレームワーク Pod とデータベース Pod の 2 つの Pod が実行され、web フレームワーク Pod 環境は、データベース Pod 環境と一致しているはずです。oc set env pod/<pod_name> --list を使用して、環境変数を表示できます。

GitHub リポジトリーから BuildConfig を作成した後に、以下を実行します。

$ oc describe bc/<name-of-your-BuildConfig>

以下のように、上記のコマンドは webhook GitHub URL を出力します。

<https://api.starter-us-east-1.openshift.com:443/oapi/v1/namespaces/nsname/buildconfigs/bcname/webhooks/secret/github>.

S2I は、Git リポジトリーまたはローカルのファイルシステムのソースコードからイメージをビルドできます。ビルダーイメージおよびソースコードから新しいコンテナーイメージをビルドするには、以下を実行します。

$ s2i build <source-location> <builder-image-name> <output-image-name>

Docker デーモンでビルドしたイメージをテストします。

$ docker run -d --name <new-name> -p <port-number>:<port-number> <output-image-name>
$ curl localhost:<port-number>

oc コマンドを使用して、OpenShift レジストリーのイメージから新規アプリケーションを作成します。

$ oc new-app <image-name>