使用 Elastic Beanstalk Java SE 平台 - AWS Elastic Beanstalk
設定您的 Java SE 環境Java SE 組態命名空間

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用 Elastic Beanstalk Java SE 平台

本主題說明如何設定、建置及執行在 AWS Elastic Beanstalk 爪哇東南平臺。

Elastic Beanstalk Java SE 平台是一組用於 Java Web 應用程序的平台版本，可以從編譯JAR的文件自行運行。您可於本機編譯應用程式，或搭配建置指令碼上傳原始碼，藉此在執行個體上進行編譯。Java SE 平台版本分為平台分支，每一個都對應於 Java 的主要版本。

注意

Elastic Beanstalk 不會解析應用程序的JAR文件。將 Elastic Beanstalk 需要的文件保留在文件之JAR外。例如，將 Worker 環境的cron.yaml檔案包括在應用程式的來源服務包的根目錄下，在JAR檔案旁邊。

Elastic Beanstalk 主控台中提供了修改正在執行環境組態的組態選項。要避免在終止環境的組態時遺失組態，您可以使用已儲存組態來儲存您的設定，並在之後套用至另一個環境。

若要將設定儲存於原始程式碼，您可以包含組態檔案。每次您建立環境或部署應用程式，組態檔案裡的設定就會套用。您也可以使用組態檔案來安裝套件、執行指令碼，並在部署期間執行其他執行個體自訂操作。

Elastic Beanstalk Java SE 平台內含可做為反向代理程式的 nginx 伺服器，處理快取靜態內容並將請求傳送至您的應用程式。平台提供了組態選項來設定代理伺服器，從您原始程式碼中的資料夾提供靜態資產，以減輕應用程式的負擔。在進階的使用情境中，您可以在您的原始碼套件中，加入自己的 .conf 檔案，來擴展或完全覆寫掉 Elastic Beanstalk 的代理組態。

如果您只為應用程式來源提供單一JAR檔案 (本身而非在來源套件中)，Elastic Beanstalk 會將JAR檔案重新命名為application.jar，然後使用. java -jar application.jar 欲設定在環境中伺服器執行個體上執行的程序，請於您的原始碼套件納入選用的 Procfile。如果您Procfile的源包根目錄JAR中有多個，或者想要自定義 java 命令以設置JVM選項，則需要 A。

建議務必在原始碼套件和應用程式中，一併提供 Procfile。如此一來，就能精確掌控 Elastic Beanstalk 會針對應用程式執行哪些程序，以及這些程序會收到哪些引數。

若要在部署階段編譯 Java 類別並在環境中的EC2執行個體上執行其他建置命令，請在應用程式來源套件中加入 Buildfile。A Buildfile 允許您按原樣部署源代碼並在服務器上構建，而不是在JARs本地編譯。Java SE 平台包括常見的建置工具，可讓您在伺服器上進行建置作業。

如需各種擴充 Elastic Beanstalk Linux 類型平台方式的詳細資訊，請參閱 擴充 Elastic Beanstalk Linux 平台。

設定您的 Java SE 環境

Java SE 平台設定可讓您微調 Amazon EC2 執行個體的行為。您可以使用 Elastic Beanstalk 控制台編輯 Elastic Beanstalk 環境的 Amazon EC2 實例配置。

使用 Elastic Beanstalk 主控台來啟用至 Amazon S3 的日誌輪換，和設定您的應用程式可以從環境讀取的變數。

在 Elastic Beanstalk 主控台中設定您的 Java SE 環境

  1. 開啟彈性魔豆控制台，然後在「區域」列表中選擇您的 AWS 區域.

  2. 在導覽窗格中，選擇環境，然後在清單中選擇您環境的名稱。

    注意

    如果您有許多環境，請使用搜尋列來篩選環境清單。

  3. 在導覽窗格中，選擇組態。

  4. 在更新、監控和日誌記錄組態類別中，選擇編輯。

日誌選項

Log Options (日誌選項) 區段有兩個設定：

  • 執行個體設定檔 – 指定有權存取與您應用程式相關的 Amazon S3 儲存貯體的執行個體設定檔。

  • 啟用 Amazon S3 的日誌檔輪替 — 指定是否將應用程式 Amazon EC2 執行個體的日誌檔複製到與應用程式關聯的 Amazon S3 儲存貯體。

靜態檔案

若要改善效能，您可以使用 [靜態檔案] 區段，將 Proxy 伺服器設定為從 Web 應用程式內的一組目錄提供靜態檔案 (例如，HTML或影像)。對於每個目錄，您可以設定目錄映射的虛擬路徑。代理伺服器收到位於指定路徑下的檔案請求時，會直接提供檔案而非將請求路由至您的應用程式。

如需使用組態檔案或 Elastic Beanstalk 主控台設定靜態檔案的詳細資訊，請參閱提供靜態檔案。

環境屬性

環境屬性區段可讓您在執行應用程式的 Amazon EC2 執行個體上指定環境組態設定。環境屬性會以金鑰值對的形式傳到應用程式。

在 Elastic Beanstalk 內所執行的 Java SE 環境中，可使用 System.getenv() 來存取環境變數。例如，您可使用下列程式碼，來將名為 API_ENDPOINT 的屬性讀取到變數：

String endpoint = System.getenv("API_ENDPOINT");

如需詳細資訊，請參閱「環境屬性與其他軟體設定」。

Java SE 組態命名空間

您可以使用組態檔案來設定組態選項，並在部署期間執行其他的執行個體設定工作。組態選項可以是平台特定的，也可以整體套用至 Elastic Beanstalk 服務中的所有平台。組態選項會組織成命名空間。

Java SE 平台不會定義任何平台特定的命名空間。您可以使用 aws:elasticbeanstalk:environment:proxy:staticfiles 命名空間設定代理提供靜態檔案。如需詳細資訊和範例，請參閱提供靜態檔案。

Elastic Beanstalk 可提供許多組態選項讓您自訂環境。除了組態檔案之外，您也可以使用主控台、儲存的組態CLI、EB 或 AWS CLI。 組態選項如需詳細資訊，請參閱。

如果您的 Elastic Beanstalk Java SE 環境使用 Amazon Linux AMI 平台版本（在 Amazon Linux 2 之前），請閱讀本節中的其他信息。

備註

您可以使用組態檔案來設定組態選項，並在部署期間執行其他的執行個體設定工作。組態選項可以是平台特定的，也可以整體套用至 Elastic Beanstalk 服務中的所有平台。組態選項會組織成命名空間。

除了所有平台皆支援的命名空間，Java SE 平台亦支援一個平台特定的組態命名空間。aws:elasticbeanstalk:container:java:staticfiles 命名空間可讓您定義選項，將您 Web 應用程式的路徑對應至應用程式原始碼套件中內含靜態內容的資料夾。

例如，此選項 option_settings 程式碼片段會定義靜態檔案命名空間內的兩個選項。第一個會將路徑 /public 對應至名為 public 的資料夾，第二個則將路徑 /images 對應至名為 img 的資料夾：

option_settings:
  aws:elasticbeanstalk:container:java:staticfiles:
    /html: statichtml
    /images: staticimages

您使用此命名空間對應的資料夾，必須為原始碼套件根目錄內的實際資料夾。您無法將路徑對映至JAR檔案中的資料夾。

Elastic Beanstalk 可提供許多組態選項讓您自訂環境。除了組態檔案之外，您也可以使用主控台、儲存的組態CLI、EB 或 AWS CLI。 組態選項如需詳細資訊，請參閱。