検索

3.4. OpenShift へのサードパーティーアプリケーションのデプロイ

download PDF

コンパイル済みの WAR ファイルまたは EAR アーカイブを使用して、OpenShift デプロイ用のアプリケーションイメージを作成できます。Dockerfile を使用して、これらのアーカイブを、更新された包括的なランタイムスタック (オペレーティングシステム、Java、および JBoss EAP コンポーネントを含む) とともに JBoss EAP サーバーにデプロイします。

注記

Red Hat は、ビルド済みの JBoss EAP サーバーイメージを提供しません。

3.4.1. デフォルト設定での JBoss EAP サーバーのプロビジョニング

ビルダーイメージを使用すると、デフォルト設定で JBoss EAP サーバーを OpenShift にインストールして設定できます。シームレスなデプロイを実現するために、手順に従ってサーバーをプロビジョニングし、アプリケーションファイルを転送して、必要なカスタマイズを行ってください。

前提条件

  • サポート対象の Red Hat JBoss Enterprise Application Platform コンテナーイメージにアクセスできる。以下に例を示します。

    • registry.redhat.io/jboss-eap-8/eap8-openjdk17-builder-openshift-rhel8
    • registry.redhat.io/jboss-eap-8/eap8-openjdk17-runtime-openshift-rhel8
  • システムに podman がインストールされている。サポート対象の RHEL で利用可能な最新の podman バージョンを使用してください。詳細は、Red Hat JBoss Enterprise Application Platform 8.0 でサポートされる構成 を参照してください。

手順

  1. 下記の Dockerfile の内容をコピーします。

    # Use EAP 8 Builder image to create a JBoss EAP 8 server
    # with its default configuration
    
    FROM registry.redhat.io/jboss-eap-8/eap8-openjdk17-builder-openshift-rhel8:latest AS builder
    
    # Set up environment variables for provisioning. 1
    ENV GALLEON_PROVISION_FEATURE_PACKS org.jboss.eap:wildfly-ee-galleon-pack,org.jboss.eap.cloud:eap-cloud-galleon-pack
    ENV GALLEON_PROVISION_LAYERS cloud-default-config
    # Specify the JBoss EAP version  2
    ENV GALLEON_PROVISION_CHANNELS org.jboss.eap.channels:eap-8.0
    
    
    # Run the assemble script to provision the server.
    RUN /usr/local/s2i/assemble
    
    # Copy the JBoss EAP 8 server from the builder image to the runtime image.
    FROM registry.redhat.io/jboss-eap-8/eap8-openjdk17-runtime-openshift-rhel8:latest AS runtime
    
    # Set appropriate ownership and permissions.
    COPY --from=builder --chown=jboss:root $JBOSS_HOME $JBOSS_HOME
    
    # Steps to add:
    # (1) COPY the WAR/EAR to $JBOSS_HOME/standalone/deployments
    #       with the jboss:root user. For example:
    #     COPY --chown=jboss:root my-app.war $JBOSS_HOME/standalone/deployments 3
    # (2) (optional) server modification. You can modify EAP server configuration:
    #
    #       * invoke management operations. For example
    #
    #        RUN $JBOSS_HOME/bin/jboss-cli.sh --commands="embed-server,/system-property=Foo:add(value=Bar)"
    #
    #        First operation must always be embed-server.
    #
    #       * copy a modified standalone.xml in $JBOSS_HOME/standalone/configuration/
    #          for example
    #
    #      COPY --chown=jboss:root standalone.xml  $JBOSS_HOME/standalone/configuration
    
    # Ensure appropriate permissions for the copied files.
    RUN chmod -R ug+rwX $JBOSS_HOME
    1
    MAVEN_MIRROR_URL 環境変数を指定できます。この変数は、JBoss EAP Maven プラグインによってイメージ内で内部的に使用されます。詳細は、アーティファクトリポジトリーミラー を参照してください。
    2
    この Dockerfile は、マイナーリリース用に更新する必要はありません。特定のバージョンを使用する場合は、GALLEON_PROVISION_CHANNELS 環境変数で JBoss EAP バージョンを指定します。詳細は、環境変数 を参照してください。
    3
    コピーした Dockerfile を変更して、WAR ファイルをコンテナーに含めます。以下に例を示します。
    COPY --chown=jboss:root <my-app.war> $JBOSS_HOME/standalone/deployments

    <myapp.war> は、イメージに追加する Web アーカイブへのパスに置き換えます。

  2. podman を使用してアプリケーションイメージをビルドします。

    $ podman build -t my-app .

    コマンドを実行すると、my-app コンテナーイメージを OpenShift にデプロイする準備が整います。

  3. コンテナーイメージを次のいずれかにアップロードします。

  4. レジストリーからイメージをデプロイする場合は、Helm チャート、Operator、Deployment などのデプロイストラテジーを使用します。希望する方法を選択し、要件に応じてイメージの完全な URL か ImageStreams を使用します。詳細は、Helm チャートを使用した OpenShift 上での JBoss EAP アプリケーションのビルドおよびデプロイ を参照してください。
Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

© 2024 Red Hat, Inc.