すべてのプロダクト
Search

このプロダクト

    Elastic Compute Service:Java web環境のデプロイ (Apache Tomcat)

    ドキュメントセンター

    Elastic Compute Service:Java web環境のデプロイ (Apache Tomcat)

    最終更新日:Jan 13, 2025

    Java Webは、Javaプログラミング言語とさまざまなテクノロジーおよびフレームワークを統合して、動的webアプリケーションの開発を容易にするテクノロジースタックです。 開発者は、Java Webを使用して、プラットフォーム間で展開できる複雑で高性能なwebアプリケーションを開発できます。 Apache Tomcatは、Java webアプリケーションのデプロイと実行に使用される最も一般的なwebサーバー環境です。 このトピックでは、ECS (Elastic Compute Service) インスタンスにJava web環境をデプロイする方法について説明します。

    クイック展開

    Terraform Explorerに移動し、[コード] タブでTerraformコードを表示および実行して、Apache Tomcat Java web環境をECSインスタンスに自動的にデプロイできます。

    前提条件

    ECSインスタンスにJava web環境をデプロイする前に、インスタンスが次の要件を満たしていることを確認してください。

    • インスタンスにJava環境がデプロイされています。 詳細については、「Java環境のデプロイ」をご参照ください。

    • ECSインスタンスには、静的パブリックIPアドレス (システム割り当てまたは自動割り当てパブリックIPアドレスとも呼ばれます) が割り当てられるか、elastic IPアドレス (EIP) に関連付けられます。 詳細については、「EIP」をご参照ください。

    • インスタンスがLinuxオペレーティングシステムを実行している場合は、ポート22と8080でのインバウンドトラフィックを許可するルールがインスタンスのセキュリティグループに追加されていることを確認してください。

      インスタンスがWindowsオペレーティングシステムを実行している場合は、ポート3389と8080でのインバウンドトラフィックを許可するために、インスタンスのセキュリティグループにルールが追加されていることを確認してください。

      セキュリティグループルールの追加方法については、「セキュリティグループルールの追加」をご参照ください。

    • インスタンスがLinuxオペレーティングシステムを実行している場合は、システムファイアウォールとセキュリティ強化Linux (SELinux) が無効になっていることを確認してください。 詳細については、「Linux ECSインスタンスのシステムファイアウォールの有効化または無効化」および「SELinuxの有効化または無効化」をご参照ください。

      インスタンスがWindowsオペレーティングシステムを実行している場合は、システムファイアウォールが無効になっていることを確認してください。 詳細については、「Windowsインスタンスのシステムファイアウォールの管理」をご参照ください。

    手順

    インスタンスのオペレーティングシステムに基づいて、次の操作を実行します。

    Linux

    この例では、Apache Tomcat 9.0.91が使用されています。 別のバージョンのApache Tomcatをインストールするか、他のディレクトリを使用する場合は、次のコマンドのバージョンとディレクトリを実際のバージョンとディレクトリに置き換えます。

    1. Linux インスタンスに接続します。 詳細については、「ECSリモート接続方法の概要」をご参照ください。

    2. 次のコマンドを実行して、Apache Tomcat 9.0.91インストールパッケージをダウンロードして解凍します。

      説明

      • Apache TomcatのダウンロードURLが変更される場合があります。 次のダウンロードURLが無効な場合は、公式Apache Tomcat Webサイトにアクセスして、最新のダウンロードURLを取得します。

      • 別のバージョンのApache Tomcatをインストールする場合は、公式のApache Tomcat WebサイトにアクセスしてダウンロードURLを取得し、次のwgetコマンドのURLを取得したURLに置き換えます。 

      wget https://archive.apache.org/dist/tomcat/tomcat-9/v9.0.91/bin/apache-tomcat-9.0.91.tar.gz  --no-check-certificate 
tar -zxvf apache-tomcat-9.0.91.tar.gz

    3. 次のコマンドを実行して、Apache Tomcatインストールファイルを /usr/local/tomcat /ディレクトリに移動します。 

      sudo mv apache-tomcat-9.0.91 /usr/local/tomcat/

    4. (オプション) server.xmlファイルを設定します。

      Apache Tomcatの設定を変更する場合は、次の手順を実行します。

      1. 次のコマンドを実行して、/usr/local/tomcat/conf/server.xmlファイルを開きます。 

        vim /usr/local/tomcat/conf/server.xml

      2. Iキーを押して挿入モードに入ります。 この例では、デフォルトのApache Tomcat設定が使用されています。 ビジネス要件に基づいてApache Tomcatの設定を変更することもできます。 例：

        • デフォルトでは、Apache Tomcatはポート8080を使用します。 ポート番号を変更する場合は、portパラメーターの値を変更します。

          説明

          ポート番号を変更した後、インスタンスのセキュリティグループで新しいポートを許可する必要があります。 詳細については、「セキュリティグループルールの追加」をご参照ください。

          image

        • デフォルトでは、Apache TomcatのWebサイトルートディレクトリはwebappsです。 WARファイルやWEB-INFディレクトリを含むフォルダなどのwebアプリケーションをwebappsディレクトリに転送すると、Apache Tomcatは自動的にアプリケーションをデプロイします。 Apache TomcatのWebサイトのルートディレクトリを変更する場合は、appBaseパラメーターの値を変更します。image

      3. Escキーを押して :wqと入力し、enterキーを押してファイルを保存して閉じます。

    5. (オプション) Java Virtual Machine (JVM) メモリパラメータを設定します。

      ビジネス要件に基づいてApache TomcatのJVMメモリパラメータを設定し、Apache Tomcatのパフォーマンスと安定性を最適化する場合は、次の手順を実行します。

      1. 次のコマンドを実行して、/usr/local/tomcat/bin/setenv.shファイルを作成して開きます。 

        vim /usr/local/tomcat/bin/setenv.sh

      2. Iキーを押して挿入モードに入り、次のコンテンツを追加します。

        JAVA_OPTSパラメーターを指定して、JVMメモリ情報とエンコード形式を設定します。 この例では、符号化形式はUTF-8である。

        説明

        次の内容を調整して、ビジネス要件に基づいてJVMメモリパラメータを設定できます。 

        JAVA_OPTS='-Djava.security.egd=file:/dev/./urandom -server -Xms512m -Xmx512m -Dfile.encoding=UTF-8'

      3. Escキーを押して挿入モードを終了します。 :wqと入力し、Enterキーを押してファイルを保存して閉じます。

      4. 次のコマンドを実行して、ファイルに対する実行権限を付与します。 

        sudo chmod +x /usr/local/tomcat/bin/setenv.sh

    6. システム起動時にApache Tomcatが自動的に起動できるようにするスクリプトを設定します。

      1. 次のコマンドを実行して、スクリプトをダウンロードします。

        wget https://help-static-aliyun-doc.aliyuncs.com/software/Tomcat-init.sh

      2. 次のコマンドを実行して、Tomcat-init.shファイルを移動し、名前を変更します。 

        sudo mv Tomcat-init.sh /etc/init.d/tomcat

      3. 次のコマンドを実行して、/etc/init.d/tomcatファイルに対する実行権限を付与します。 

        chmod +x /etc/init.d/tomcat

      4. Java Development Kit (JDK) がインストールされているパスを取得します。 次のコマンドを実行して、Javaバイナリファイルが格納されている実際のパスを取得します。 Javaバイナリファイルの親ディレクトリは、JDKがインストールされているパスです。 

        readlink -f $(which java)
        説明

        たとえば、コマンドの実行後に /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.432.b06-2.0.2.1.al8.x86_64/jre/bin/javaが返された場合、JDKは /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.432.b06-2.0.2.1.al8.x86_64パスにインストールされます。

      5. 次のコマンドを実行して、スクリプトでJAVA_HOMEパラメーターを指定します。

        重要

        JAVA_HOMEパラメーターで指定するJDKパスは、JDKがインストールされているパスである必要があります。 それ以外の場合、Apache Tomcatは起動できません。 

        sudo sed -i 's@^export JAVA_HOME=.*@export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.432.b06-2.0.2.1.al8.x86_64@' /etc/init.d/tomcat

    7. 次のコマンドを順番に実行して、Apache Tomcatがシステム起動時に自動的に起動し、Apache Tomcatを起動できるようにします。 

      sudo systemctl daemon-reload
sudo systemctl start tomcat
sudo systemctl enable tomcat

      Apache Tomcatの起動後、sudo systemctl status tomcatコマンドを実行してApache Tomcatのステータスを確認できます。 active (running) が返されると、Apache Tomcatが起動されます。 image

    8. 環境設定を確認します。

      オンプレミスデバイスのwebブラウザーのアドレスバーに、http:// <ECSインスタンスのパブリックIPアドレス>:8080と入力します。 Apache Tomcatのウェルカムページが表示された場合、Java web環境は期待どおりに設定されます。

      説明

      • http:// <ECSインスタンスのパブリックIPアドレス>:8080を入力した後、Apache Tomcatのウェルカムページが表示されない場合は、インスタンスのセキュリティグループがポート8080でのインバウンドトラフィックを許可しているかどうかを確認します。

      • Apache Tomcatポート番号を変更した場合は、8080を指定した新しいApache Tomcatポート番号に置き換え、インスタンスのセキュリティグループがポートでのインバウンドトラフィックを許可しているかどうかを確認します。

      • オンプレミスのプロジェクトをアップロードして環境をテストする場合は、Apache TomcatのWebサイトのルートディレクトリにWARパッケージをアップロードします。 この例では、/usr/local/tomcat/webappsディレクトリが使用されています。 次に、webブラウザーのアドレスバーにhttp:// <ECSインスタンスのパブリックIPアドレス>:8080/<パッケージ名> と入力して、プロジェクトにアクセスします。 詳細については、「LinuxインスタンスへのファイルのアップロードまたはLinuxインスタンスからのファイルのダウンロード」をご参照ください。

      image

    Windows

    この例では、Apache Tomcat 9.0.97が使用されています。

    1. Windowsインスタンスに接続します。 詳細については、「ECSリモート接続方法の概要」をご参照ください。

    2. Apache Tomcatインストールパッケージをダウンロードします。

      公式Apache Tomcat Webサイトにアクセスし、インストールするバージョンを選択してから、インストールパッケージをダウンロードします。

      image

    3. Apache Tomcatインストールパッケージを解凍します。

      ダウンロードしたインストールパッケージを、Apache Tomcatをインストールするディレクトリに解凍します。 この例では、C:\Program Filesディレクトリが使用されています。

    4. Apache Tomcatをインストールするディレクトリを取得します。

      インストールパッケージをディレクトリに解凍した後、ディレクトリに移動し、アドレスバーからApache Tomcatのインストールディレクトリを取得します。

      image

    5. 環境変数設定を構成します。

      1. [このPC] を右クリックし、[プロパティ] を選択します。 image

      2. Aboutページで、一番下までスクロールし、[システムの詳細設定] をクリックします。

        image

      3. [環境変数] をクリックします。

        image

      4. [システム変数] セクションで、[新規作成] をクリックしてシステム変数を作成します。 そして、[OK] をクリックします。 変数名はCATALINA_HOMEで、変数値はApache Tomcatのインストールディレクトリです。 この例では、C:\Program Files\apache-tomcat-9.0.97ディレクトリが使用されています。

        image

      5. [システム変数] セクションで、[パス] 変数を選択し、[編集] をクリックします。

        image

      6. [環境変数の編集] ダイアログボックスで、[新規] をクリックして % CATALINA_HOME %\binパスを追加します。

        image

      7. [OK] を2回クリックして、環境変数を保存します。

        image

    6. Apache Tomcatを起動します。

      1. Apache Tomcatのインストールディレクトリにあるbinフォルダに移動します。 image

      2. パスバーにcmdと入力し、Enterキーを押してコマンドプロンプトを開きます。 image

      3. startup.batコマンドを実行し、Apache Tomcatを起動します。 コマンドの実行後、デフォルトで新しいコマンドプロンプトウィンドウが開き、Apache Tomcatの起動ログが表示されます。 ウィンドウを閉じないでください。

        image

        image

    7. Apache Tomcatをテストします。

      オンプレミスデバイスのwebブラウザーのアドレスバーに、http:// <ECSインスタンスのパブリックIPアドレス>:8080と入力します。 Apache Tomcatのウェルカムページが表示された場合、Apache Tomcatは期待どおりにデプロイされます。

      説明

      • http:// <ECSインスタンスのパブリックIPアドレス>:8080を入力した後、Apache Tomcatのウェルカムページが表示されない場合は、次の項目を確認します。

        • インスタンスのセキュリティグループがポート8080でのインバウンドトラフィックを許可しているかどうかを確認します。

        • startup.batコマンドを実行してApache Tomcatを起動した後、デフォルトで開いているコマンドプロンプトウィンドウが閉じているかどうかを確認します。 ウィンドウが閉じている場合は、startup.batコマンドを再実行してウィンドウを開きます。

      • オンプレミスのプロジェクトをアップロードしてApache Tomcatをテストする場合は、Apache TomcatのWebサイトのルートディレクトリにWARパッケージをアップロードします。 この例では、C:\Program Files\apache-tomcat-9.0.97\webappsディレクトリが使用されています。 次に、webブラウザーのアドレスバーにhttp:// <ECSインスタンスのパブリックIPアドレス>:8080/<パッケージ名> と入力して、プロジェクトにアクセスします。 詳細については、「LinuxインスタンスへのファイルのアップロードまたはLinuxインスタンスからのファイルのダウンロード」をご参照ください。

      image