1. はじめに
経緯
OpenShift Origin のインストール方法について Docker 上で簡単に試せるものを探していましたが
なかなか見つからないと思っていたところ OpenShift Origin（公式）に良い方法が記載されていました。
公式の手順を試したところネットワークの構成によって、ハマってしまったので共有します。
コンセプト
下記に該当しそうな方に読んでほしい OpenShift Origin を簡単にインストールする手順です。
- 基本的に面倒なことは嫌っ
- 英語の資料読んでると眠くなるっ
- とりあえず、簡単に新しいことを試したいっ
- 環境構築は面倒なので、なるべくやりたくないっ
概要
- GMOクラウドALTUS Basic の Docker テンプレートを利用して OpenShift Origin のコンテナを起動します
- 今回は GUI のログイン画面を表示するところまでをゴールとしています
- ログイン画面を表示する際に、サーバーのローカルIPをポートフォワードします
（お気づきの方もいらっしゃるかもしれませんが、基本的には Docker 環境上に OpenShift Origin のコンテナをたてるだけです。）
2. OpenShift について
ざっくり言うと RedHat 社が提供している Docker + Kubernetes ベースの PaaS です。
OpenShift の種類
| OpenShiftの種類 | 概要 | |
|---|---|---|
| A. | OpenShift Online | パブリックPaaS |
| B. | OpenShift Enterprise | プライベートPaaS |
| C. | OpenShift Origin | オレオレPaaS |
| ※A, B については RedHat 社の公式から抜粋 | ||
| 今回取り扱うのは C. OpenShift Origin です。（2016/06/02 時点での最新バージョン v1.3.0-alpha-1.41-g681170a ） |
OpenShift Origin インストール方法の種類
| インストール方法 | 概要 | |
|---|---|---|
| 1. | Run Origin in a Container | Docker 入れて run するだけ？ → 簡単そうです！ |
| 2. | Run the All-In-One VM | Vagrant 環境必要？ → Vagrant 環境ないから、見なかったことにします |
| 3. | Download the Binary | やること多そう？ → 今回は見なかったことにします |
とりあえず 1. Run Origin in a Container に的を絞り、 Docker の環境を作ります。
【注意】
この手順では、Ubuntu を利用していますが、公式では Fedora, CentOS, RHEL のみサポートとのことです。
壊しても良い環境で試すことをオススメします！
3. 利用環境
GMOクラウド ALTUS 利用の場合
| 項目 | 内容 |
|---|---|
| サーバー | GMOクラウド ALTUS Basicシリーズ |
| 利用テンプレート | Ubuntu 14.04 64bit with Docker_20160428 |
| 仮想サーバーの種類 | Custom Server |
| CPU | 2vCPU |
| Memory | 4GB |
| HDD | 20GB |
| Docker | v1.11.0 |
| ローカルIP（例） | 10.0.0.1 |
上記環境で、apt-get update, apt-get upgrade しておきます。
Docker の操作について詳しく知りたい方は、 GMOクラウドアカデミーの Docker Tips もどうぞ
（おまけ）ALTUS 以外の場合
Docker 環境無い人用の環境構築概要（Docker の公式手順（英語））はこちら
1. サーバー準備
CentOS 7 や Ubuntu14.04 などの環境を用意します。
2. アップデート
（CentOS） sudo yum update -y
（Ubuntu） sudo apt-get update -y;sudo apt-get upgrade -y;
3. curl 無ければ入れます
（CentOS） sudo yum -y install curl
（Ubuntu） sudo apt-get -y install curl
4. Docker をインストールします
curl -sSL https://get.docker.com/ | sudo sh
5. Docker のバージョン確認（2016/06/02 時点では v1.11.2 でした）
docker -v
4. OpenShift Orgin インストール手順
OpenShift Orign インストール手順（公式手順（英語））はこちらです
下記コマンドを実行するだけで OpenShift Origin 入りの Docker コンテナを起動してくれます。
※ローカルIPアドレス 10.0.0.1 にリダイレクトされていた設定を localhost にリダイレクトさせるため、公式に記載のコマンドに --public-master=localhost を追加しています。
【コンテナ実行前の注意点】
Docker のホスト側で 53, 7001, 8443 ポートが既に起動しているようならコンテナを起動する前に止めてねとのことです。
また、初期設定ではどんな Username/Password でもログインできる状態なのでグローバルIPで公開する場合は気をつけてください。
$ sudo docker run -d --name "origin" \
--privileged --pid=host --net=host \
-v /:/rootfs:ro \
-v /var/run:/var/run:rw \
-v /sys:/sys \
-v /var/lib/docker:/var/lib/docker:rw \
-v /var/lib/origin/openshift.local.volumes:/var/lib/origin/openshift.local.volumes \
openshift/origin start --public-master=localhost
ポートフォワードの設定（TeraTermPro）
OpenShift Origin のコンテナ起動前後で下記設定をしてサーバー（Docker ホスト）のローカルIP 10.0.0.1:8443 ポートを
接続元（PC）の 8443 ポート にフォワーディングします。
[設定(S)] → [SSH転送(O)] 設定にて下記設定を入力します。
- [ローカルポート] :8443
- [リモート側ホスト]:サーバーのローカルIP 10.0.0.1（例）
- [ポート] :8443
ログイン画面の表示
https://localhost:8443/ にアクセスします。
ログイン画面表示までの通信経路
- PC 側で https://localhost:8443 にアクセスします
- PC 側 localhost(127.0.0.1):8443 に接続されます
- ポートフォワードの設定でサーバー側のローカルIP 10.0.0.1:8443 に接続されます
- サーバー側ローカルIP 10.0.0.1:8443 へのアクセスを受け、Opneshift Origin コンテナがサーバー側の localhost(127.0.0.1):8443 にリダイレクトします
- サーバー側 localhost(127.0.0.1):8443 へのアクセスを受け web画面を返します
【注意】
PC 側、サーバー側どちらも localhost を 127.0.0.1 で名前解決できる必要があります！
5. ハマったこと、確認したこと
ハマッたこと
公式に記載のあるコマンドの最後に --public-master=localhost を追加していますが、
追加しない場合はポートフォワード後、 https://localhost:8443 にアクセスすると
ローカルIP 10.0.0.1 にリダイレクトされてしまって正常に接続ができませんでした。
同様の事例が少なかったため、解決に時間がかかってしまいました。
確認したこと
-
sudo docker exec -it origin bashでコンテナに接続します -
more $KUBECONFIGで server: https://10.0.0.1:8443 が記載されているのを確認しました -
一旦 Ctrl + P → Ctrl + Q でコンテナから抜けます
-
sudo docker logs originコマンド（origin はコンテナ名）でもローカルIP 10.0.0.1 が直接利用されていることを確認しました -
この段階では、 Google 先生に聞いても、特にコレ！というのを探せませんでした
-
問題の切り分け作業･･･本手順の ALTUS 環境では eth0 がローカル IP 10.0.0.1 だったので、eth0 がグローバル IP のサーバーで試しました
この場合はグローバルIP:8443 に接続すると問題なくログイン画面へ接続可能でした。
※切り分けの結果として、サーバーの eth0 で利用されている IP アドレスをコンフィグファイルに書き込んでいるようだということがわかりました。 -
試しにインストール方法を YouTube で検索しました（意外と YouTube が参考になりました！）
最終的に
YouTube（英語） のインストール方法を見て
コンテナ起動時に公式のコマンドに追加されているオプション（--public-master=localhost）を発見し
--public-master を再度 Google 先生に聞いたところ ここのサイト や openshift の README.mdで
同様の記載があり、追加したらポートフォワードでも問題なくログイン画面を表示できました。
YouTube でインストール方法を検索してみるのも時には問題解決のヒントを得るきっかけになるんだなぁと思いました。
6. おわりに
次回はtry-it-out などを試し、
結果について記載しようと思います。
【参考】
https://www.openshift.org/
https://en.wikipedia.org/wiki/OpenShift
https://www.redhat.com/ja/technologies/cloud-computing/openshift
Docker Tips 目次～Cloud ServerでDockerを使おう～ | GMOクラウドアカデミー
OpenShift v3 beta (v0.4)を試す - akubicharm’s blog
OpenShift 3: Zero to PaaS to running app - YouTube