使用 Elastic Beanstalk Java SE 平台

AWS Elastic Beanstalk Java SE 平台是一組適用於 Java Web 應用程式的平台版本，可自行從編譯的 JAR 檔案執行。您可於本機編譯應用程式，或搭配建置指令碼上傳原始碼，藉此在執行個體上進行編譯。Java SE 平台版本被分組到平台分支中，每個分支會對應於 Java 的主要版本，例如 Java 8 和 Java 7。

注意

Elastic Beanstalk 不會剖析應用程式的 JAR 檔案。請將 Elastic Beanstalk 需要的檔案保存在 JAR 檔案外面。例如，將工作者環境的 cron.yaml 檔案包含在應用程式原始碼套件的根目錄 (在 JAR 檔案旁邊)。

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

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

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

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

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

欲在部署時編譯 Java 類別並於環境中 EC2 執行個體上執行其他建置命令，請將 Buildfile 納入您的應用程式原始碼套件。Buildfile 可讓您依原狀部署原始碼，並可建置在伺服器上，而非於本機編譯 JAR。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. 開啟 Elastic Beanstalk 主控台，然後在 Regions (區域) 清單中選取您的 AWS 區域。

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

   注意

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

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

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

日誌選項

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

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

• Enable log file rotation to Amazon S3 (啟用 Amazon S3 的日誌檔案輪換) – 指定是否將應用程式 Amazon EC2 執行個體的日誌檔案複製到與應用程式關聯的 Amazon S3 儲存貯體。

靜態檔案

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

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

環境屬性

Environment Properties (環境屬性) 的部分可讓您針對執行您應用程式的 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 可提供許多組態選項讓您自訂環境。除了組態檔案，您也可以使用主控台、已儲存組態、EB CLI 或 AWS CLI 來設定組態選項。如需詳細資訊，請參閱組態選項。

Amazon Linux AMI (Amazon Linux 2 之前) Java SE 平台

如果您的 Elastic Beanstalk Java SE 環境使用 Amazon Linux AMI 平台版本 (Amazon Linux 2 之前)，請閱讀本節中的其他資訊。

備註

• 本主題中的資訊僅適用於以 Amazon Linux AMI (AL1) 為基礎的平台分支。AL2023/AL2 平台分支與舊版 Amazon Linux AMI (AL1) 平台版本不相容，需要不同的組態設定。

• 2022 年 7 月 18 日，Elastic Beanstalk 已將所有以 Amazon Linux AMI (AL1) 為基礎的平台分支狀態設為已淘汰。如需有關遷移至完全支援的目前 Amazon Linux 2023 平台分支的詳細資訊，請參閱 將您的 Elastic Beanstalk Linux 應用程式遷移到 Amazon Linux 2023 或 Amazon Linux 2。

Amazon SE 組態命名空間 — Amazon Linux AMI (AL1)

您可以使用組態檔案來設定組態選項，並在部署期間執行其他的執行個體設定工作。組態選項可透過 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 可提供許多組態選項讓您自訂環境。除了組態檔案，您也可以使用主控台、已儲存組態、EB CLI 或 AWS CLI 來設定組態選項。如需詳細資訊，請參閱組態選項。