[BETA] OpenShiftへのデプロイパーマリンク to "[BETA] OpenShiftへのデプロイ"

注意! これはBETA品質の開発中リリースである、新しいサブジェネレータです!フィードバックをお待ちしています!ハッピーOpenShifting!!!

このサブジェネレータを使用すると、JHipsterアプリケーションをOpenshift Container Platform / OpenShift Originにデプロイできます。

開発中パーマリンク to "開発中"

MongoとCassandraのレプリケーションモードはまだテストされていません。

インストールオプションパーマリンク to "インストールオプション"

OpenShiftには2つのオプションがあります。

OpenShift Origin - OpenShiftを支えるオープンソースのアップストリームプロジェクト
OpenShift Container Platform - Red Hatがサポートするエンタープライズコンテナアプリケーションプラットフォーム

Minishift パーマリンク to "Minishift"

Minishiftは、オールインワンのOpenShift VMをローカルで実行するのに役立つツールキットです。Minishiftは、ラップトップ上のVM内でシングルノードのOpenShiftクラスタを実行し、ユーザーがローカルで試すことができるようにします。

Minishiftでは、OpenShiftクラスタがプロビジョニングされている仮想マシンを起動するためのハイパーバイザが必要です。Minishiftを起動する前に、選択したハイパーバイザがシステムにインストールされ、有効になっていることを確認してください。

前提条件パーマリンク to "前提条件"

次をインストールする必要があります。

Docker
Hypervisor - お使いのOSに応じて、さまざまなオプションを選択できます

Dockerレジストリが必要です。レジストリがない場合は、公式のDocker Hubを使用できます。

Minishiftでは、OriginとContainer Platformの両方をローカルで試すことができます。

OpenShift Origin
OpenShift Container Platform - Red Hat Container Development Kitは、Red Hat Enterprise Linuxをベースに構築済みコンテナ開発環境がパッケージ化されたMinishiftを提供します。開発者は、redhat.comから登録およびダウンロードすることにより、開発目的で無料のRed Hat Enterprise Linux®Developer Suiteサブスクリプションを介してRed Hat Container Development Kitを入手できます。

このサブジェネレータは、OriginとContainer Platformの両方で正常に動作し、同じDockerのイメージバージョンを使用します。

サブジェネレータの実行パーマリンク to "サブジェネレータの実行"

OpenShiftの設定ファイルを生成するには、project/rootフォルダで次のコマンドを実行します。

jhipster openshift

次に、アプリケーションをデプロイするためのすべての質問に答えます。

Which type of application would you like to deploy?（どの種類のアプリケーションを展開しますか?）パーマリンク to "Which type of application would you like to deploy?（どの種類のアプリケーションを展開しますか?）"

アプリケーションのタイプは、マイクロサービスとモノリスのどちらをデプロイするかによって異なります。

Enter the root directory where your applications are located（アプリケーションが格納されているルートディレクトリを入力してください）パーマリンク to "Enter the root directory where your applications are located（アプリケーションが格納されているルートディレクトリを入力してください）"

パスを入力してください。すべてのOpenShiftジェネレータファイルはこのパスに保存されます。

Which applications do you want to include in your OpenShift configuration?（どのアプリケーションをOpenShift構成に含めますか?）パーマリンク to "Which applications do you want to include in your OpenShift configuration?（どのアプリケーションをOpenShift構成に含めますか?）"

アプリケーションを選択します。

Enter the admin password used to secure the JHipster Registry admin（JHipsterレジストリの管理者を保護するために使用する管理者パスワードを入力してください）パーマリンク to "Enter the admin password used to secure the JHipster Registry admin（JHipsterレジストリの管理者を保護するために使用する管理者パスワードを入力してください）"

この質問は、JHipsterレジストリを用いたマイクロサービスアーキテクチャを選択した場合にのみ表示されます。

What should we use for the OpenShift namespace?（OpenShiftネームスペースには何を使用しますか?）パーマリンク to "What should we use for the OpenShift namespace?（OpenShiftネームスペースには何を使用しますか?）"

これは、すべてのサービスがデプロイされ、生成されたファイルがこのテンプレートにタグ付けされるOpenShiftプロジェクトスペースです。

Which type of database storage would you like to use?（どのタイプのデータベースストレージを使用しますか?）パーマリンク to "Which type of database storage would you like to use?（どのタイプのデータベースストレージを使用しますか?）"

この質問は、選択したアプリケーションのいずれかでデータベースタイプが選択されている場合にのみ表示されます。これにより、一時的または永続的なストレージオプションが求められます。コンテナは本質的に一時的です（データは再起動/障害の間は保持されません）。永続ストレージオプションを使用すると、 NFS、EBSなどの外部ストレージをマウントできるため、データは再起動と障害の間も存続します。

What should we use for the base Docker repository name?（ベースのDockerリポジトリ名には何を使用しますか?）パーマリンク to "What should we use for the base Docker repository name?（ベースのDockerリポジトリ名には何を使用しますか?）"

メインレジストリとしてDocker Hubを選択すると、Docker Hubログインになります。

What command should we use for push Docker image to repository?（Dockerイメージをリポジトリにプッシュするために、どのコマンドを使用しますか?）パーマリンク to "What command should we use for push Docker image to repository?（Dockerイメージをリポジトリにプッシュするために、どのコマンドを使用しますか?）"

Docker Hubにプッシュするデフォルトのコマンドはdocker image pushです。たとえば、Google Cloudを使用してDockerイメージを公開する場合は、gcloud docker pushになります。

展開したアプリケーションを更新パーマリンク to "展開したアプリケーションを更新"

新しい展開の準備パーマリンク to "新しい展開の準備"

アプリケーションがすでにデプロイされている場合は、新しいDockerイメージを構築することで再デプロイできます。

./mvnw package -Pprod -DskipTests jib:dockerBuild

Gradleを使用する場合は次のようにします。

./gradlew -Pprod bootJar jibDockerBuild -x test

jibプラグインでビルドされたイメージの実行中に問題が発生した場合（chmod +x entrypoint.sh が許可されないなど）は、sccを更新する必要があります。以下のように oc edit scc restrictedおよびrunAsUser.TypeストラテジをRunAsAnyに更新します。

Docker Hubへのプッシュパーマリンク to "Docker Hubへのプッシュ"

イメージにローカルでタグを付けます。

docker image tag application username/application

イメージをDocker Hubにプッシュします。

docker image push username/application

アプリケーションのデプロイパーマリンク to "アプリケーションのデプロイ"

アプリケーションをデプロイします。

次のいずれかを実行することで、すべてのアプリケーションをデプロイできます。 <directoryPath>/ocp/ocp-apply.sh

または、

oc apply -f <directoryPath>/ocp/registry oc apply -f <directoryPath>/ocp/app1gw とします。その後、選択した名前空間に作成されたテンプレートを選択して、OpenShiftコンソールからアプリケーションをインストールします。

これにより、アプリケーションとそれに関連する依存サービス（データベース、elasticsearchなど）のためのOpenShiftデプロイメントと、pod間通信（サービス内部）のためのOpenShiftサービス、および外部からアプリケーションにアクセスするためのルートが作成されます。

マイクロサービスアプリケーションに関する情報パーマリンク to "マイクロサービスアプリケーションに関する情報"

サービスレジストリのデプロイパーマリンク to "サービスレジストリのデプロイ"

OpenShiftは、Kube-DNSを使用した独自の内部サービスディスカバリ、ConfigMapを使用した一元化された構成管理、EFKスタックを介した一元化されたロギングを特徴としていますが、JHipsterは構成管理にSpring Cloud、サービスディスカバリにEureka/Consul、ログ管理にJHipster-console(ELK)に依存しているため、OpenShiftデプロイメントも同様にサポートしています。

その結果、マイクロサービスアプリケーションの場合、JHipster OpenShiftサブジェネレータは、JHipster-Registry（Eurekaベース）またはConsulをデプロイするためのマニフェストファイルを生成します。さらに、生成されたマイクロサービスとゲートウェイマニフェストには、自身を中央レジストリサービスに登録するための適切な設定が含まれます。

JHipsterレジストリまたはConsulの管理パーマリンク to "JHipsterレジストリまたはConsulの管理"

JHipster RegistryとConsulでは、StatefulSets設定が提供されています。これらは、ステートフルアプリケーションを処理でき、高可用性のためにサービスレジストリを拡張できる、ある種のデプロイメントアーティファクトです。StatefulSetsは、OpenShiftではまだプロダクション環境で実用可能な機能ではないことに注意してください。テクノロジープレビュー（ベータ）であり、この機能を使用するにはOpenShiftバージョン3.5以上が必要です。

Kubernetesでの一元的な設定パーマリンク to "Kubernetesでの一元的な設定"

一元化された構成は、Spring Cloud Config Server（JHipster-Registryを使用する場合）またはConsul Key/Valueストア（Consulを使用する場合）のいずれかを使用して設定できます。デフォルトでは、構成サーバーは両方とも、以下の形式のプロパティファイルが含まれているOpenShift ConfigMapから設定をロードします。

apiVersion: v1
kind: ConfigMap
metadata:
  name: application-config
  namespace: default
data:
  application.yml: |- # すべてのアプリケーションで共有されるグローバルプロパティ
jhipster氏:
      security:
        authentication:
          jwt:
            secret: secret
  gateway-prod.yml: |- # "prod"プロファイルのゲートウェイ・アプリケーション・プロパティー
    foo:
      bar: foobar

トラブルシューティングのヒントパーマリンク to "トラブルシューティングのヒント"

All-in-one VMを実行している場合は、Dockerイメージをプッシュする前に必ず次のコマンドを実行してください。 eval $(docker-machine env <machine_name>)
永続ストレージでStatefulSetsまたはServicesを実行する際に問題が発生した場合は、永続ボリュームが適切に初期化されていることを確認してください。
StatefulSetsの実行中に問題が発生した場合は、永続ボリュームの要求を確認します。PVCの初期化に通常よりも時間がかかる場合は、手動で作成してみてください。
ジェネレータを実行した後、ocコマンドを適用する前に、選択した名前空間oc project <namespace>にいることを確認してください。
elasticsearch、レジストリ、コンソールなどのサービスのイメージプルは、パブリックレジストリからコンテナレジストリにプルする必要があるため、最初は時間がかかります。このために依存サービスのいずれかが失敗した場合は、それが依存するサービスが起動して実行されているときに、それをデプロイしてみてください。
いくつかのpodの実行に必要なsccサービスを実行するために必要な特権（管理者が必要な場合があります）を持っていることを確認してください。

[BETA] OpenShiftへのデプロイ パーマリンク to "[BETA] OpenShiftへのデプロイ"

開発中 パーマリンク to "開発中"

インストールオプション パーマリンク to "インストールオプション"

Minishift パーマリンク to "Minishift"

前提条件 パーマリンク to "前提条件"

サブジェネレータの実行 パーマリンク to "サブジェネレータの実行"

Which type of application would you like to deploy?（どの種類のアプリケーションを展開しますか?） パーマリンク to "Which type of application would you like to deploy?（どの種類のアプリケーションを展開しますか?）"

What should we use for the OpenShift namespace?（OpenShiftネームスペースには何を使用しますか?） パーマリンク to "What should we use for the OpenShift namespace?（OpenShiftネームスペースには何を使用しますか?）"

Which type of database storage would you like to use?（どのタイプのデータベースストレージを使用しますか?） パーマリンク to "Which type of database storage would you like to use?（どのタイプのデータベースストレージを使用しますか?）"

What should we use for the base Docker repository name?（ベースのDockerリポジトリ名には何を使用しますか?） パーマリンク to "What should we use for the base Docker repository name?（ベースのDockerリポジトリ名には何を使用しますか?）"

展開したアプリケーションを更新 パーマリンク to "展開したアプリケーションを更新"

新しい展開の準備 パーマリンク to "新しい展開の準備"

Docker Hubへのプッシュ パーマリンク to "Docker Hubへのプッシュ"

アプリケーションのデプロイ パーマリンク to "アプリケーションのデプロイ"

マイクロサービスアプリケーションに関する情報 パーマリンク to "マイクロサービスアプリケーションに関する情報"

サービスレジストリのデプロイ パーマリンク to "サービスレジストリのデプロイ"

JHipsterレジストリまたはConsulの管理 パーマリンク to "JHipsterレジストリまたはConsulの管理"

Kubernetesでの一元的な設定 パーマリンク to "Kubernetesでの一元的な設定"

トラブルシューティングのヒント パーマリンク to "トラブルシューティングのヒント"

詳細情報 パーマリンク to "詳細情報"