平台特定選項 - AWS Elastic Beanstalk

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

平台特定選項

某些 Elastic Beanstalk 平台會定義特定於平台的選項命名空間。這些命名空間及其選項會列在每個平台的下方。

注意

以前,在以 Amazon Linux 為基礎的平台版本中 AMI (在 Amazon Linux 2 之前) 中,以下兩個功能及其各自的命名空間被視為平台特定功能,並在此列於每個平台:

在 Amazon Linux 2 平台版本中,Elastic Beanstalk 會以一致的方式在所有支援的平台上實作這些功能。相關的命名空間現在會列在 適用於所有環境的一般選項 頁面中。對於具有不同名稱的命名空間平台,我們只會在此頁面上提到它們。

Docker 平台選項

下列 Docker 特定的組態選項會套用至 Docker 和預先設定的 Docker 平台。

注意

這些組態選項不適用於

  • 碼頭平台(Amazon Linux 2)與碼頭構成

  • 多容器碼頭平台(Amazon Linux AMIAL1)-該平台已退休

命名空間:aws:elasticbeanstalk:environment:proxy
名稱 描述 預設 有效值

ProxyServer

指定 Web 伺服器當成 Proxy 使用。

nginx

nginx

noneAmazon Linux AMDocker (僅包含 DC)

Go 平台選項

Amazon LinuxAMI(Amazon 之前的 Linux 2)平台選項

您可以使用以下命名空間,設定代理伺服器以提供靜態檔案。代理伺服器收到位於指定路徑下的檔案請求時,會直接提供檔案而非將請求路由至您的應用程式。這可減少應用程式必須處理的請求數量。

將代理伺服器提供的路徑對應至包含靜態資產之原始程式碼中的資料夾。您在此命名空間中定義的每個選項都會對應至不同路徑。

名稱 Value

代理伺服器提供檔案的路徑。

範例:/images 將於 subdomain.eleasticbeanstalk.com/images 提供檔案。

內含檔案的資料夾名稱。

範例:staticimages 將自原始碼套件最上層名為 staticimages 的資料夾提供檔案。

Java SE 平台選項

Amazon LinuxAMI(Amazon 之前的 Linux 2)平台選項

您可以使用以下命名空間,設定代理伺服器以提供靜態檔案。代理伺服器收到位於指定路徑下的檔案請求時,會直接提供檔案而非將請求路由至您的應用程式。這可減少應用程式必須處理的請求數量。

將代理伺服器提供的路徑對應至包含靜態資產之原始程式碼中的資料夾。您在此命名空間中定義的每個選項都會對應至不同路徑。

名稱 Value

代理伺服器提供檔案的路徑。

範例:/images 將於 subdomain.eleasticbeanstalk.com/images 提供檔案。

內含檔案的資料夾名稱。

範例:staticimages 將自原始碼套件最上層名為 staticimages 的資料夾提供檔案。

搭配 Tomcat 平台的 Java 選項

命名空間:aws:elasticbeanstalk:application:environment
名稱 描述 預設 有效值

JDBC_CONNECTION_STRING

外部資料庫的連線字串。

N/A

如需更多資訊,請參閱環境屬性與其他軟體設定

命名空間:aws:elasticbeanstalk:container:tomcat:jvmoptions
名稱 描述 預設 有效值

JVM Options

JVM在啟動時將命令列選項傳遞給。

N/A

Xmx

JVM堆集大小上限。

256m

N/A

XX:MaxPermSize

用來儲存類別定義和關聯中繼資料的JVM堆積區段。

注意

此選項僅適用於 Java 8 之前的 Java 版本,在以 Amazon Linux 2 和更新版本為依據的 Elastic Beanstalk Tomcat 平台上不受支援。

64m

N/A

Xms

初始JVM堆積大小。

256m

N/A

optionName

除了 Tomcat 平台定義的JVM選項之外,還要指定任意選項。

N/A

命名空間:aws:elasticbeanstalk:environment:proxy
名稱 描述 預設 有效值

GzipCompression

設定為 false 以停用回應內容壓縮。

僅在 Amazon LinuxAMI(之前的 Amazon Linux 2)平台版本上有效。

true

true

false

ProxyServer

設定 Proxy 在您的環境的執行個體上使用。如果您將此選項設定為 apache,則 Elastic Beanstalk 會使用 Apache 2.4

如果您的應用程式因為不相容的代理組態設定而未準備好從 Apache 2.2 遷移,請設定 apache/2.2此值僅在 Amazon LinuxAMI(之前的 Amazon Linux 2)平台版本上有效。

設定為 nginx 以使用 nginx。這是從 Amazon Linux 2 平台版本開始的預設值。

如需詳細資訊,請參閱設定代理伺服器

nginx (Amazon Linux 2)

apache(Amazon LinuxAMI)

apache

apache/2.2AMI僅限 Amazon Linux

nginx

。 NETLinux 平台上的核心選項

命名空間:aws:elasticbeanstalk:environment:proxy
名稱 描述 預設 有效值

ProxyServer

指定 Web 伺服器當成 Proxy 使用。

nginx

nginx

none

。 NET平台選項

命名空間:aws:elasticbeanstalk:container:dotnet:apppool
名稱 描述 預設 有效值

Target Runtime

選擇的版本。 NET您的應用程式的架構。

4.0

2.0

4.0

Enable 32-bit Applications

設定為 True 以執行 32 位元應用程式。

False

True

False

Node.js 平台選項

命名空間:aws:elasticbeanstalk:environment:proxy
名稱 描述 預設 有效值

ProxyServer

設定 Proxy 在您的環境的執行個體上使用。

nginx

apache

nginx

Amazon LinuxAMI(Amazon 之前的 Linux 2)平台選項

名稱 描述 預設 有效值

NodeCommand

用於啟動 Node.js 應用程式的命令。若指定空白字串,可依序使用 app.jsserver.jsnpm start

""

NodeVersion

Node.js 版本。例如:4.4.6

支援的 Node.js 版本會依 Node.js 平台版本而有所不同。請參閱「」中的 Node.js AWS Elastic Beanstalk 平台文件以取得目前支援的版本清單。

注意

如果您所使用的 Node.js 版本的支援已從平台移除,您必須在平台更新之前變更或移除版本設定。當發現一個或多個版本的 Node.js 存在安全漏洞時,可能會出現此種狀況。

發生這種情況時,嘗試更新為不支援設定的平台的新版本會NodeVersion失敗。若要避免需要建立新環境,請將NodeVersion組態選項變更為舊平台版本和新版本都支援的 Node.js 版本,或移除選項設定,然後執行平台更新。

各有不同 各有不同

GzipCompression

指定是否啟用 gzip 壓縮。如果設定 ProxyServer 為none,則會停用 gzip 壓縮。

false

true

false

ProxyServer

指定哪些 Web 伺服器應用於 Node.js 的代理連線。如果設定 ProxyServer 為none,則靜態檔案對應不會生效,而且 gzip 壓縮會停用。

nginx

apache

nginx

none

您可以使用以下命名空間,設定代理伺服器以提供靜態檔案。代理伺服器收到位於指定路徑下的檔案請求時,會直接提供檔案而非將請求路由至您的應用程式。這可減少應用程式必須處理的請求數量。

將代理伺服器提供的路徑對應至包含靜態資產之原始程式碼中的資料夾。您在此命名空間中定義的每個選項都會對應至不同路徑。

注意

aws:elasticbeanstalk:container:nodejs::ProxyFiles 設定為 none,則靜態檔案設定不會套用。

名稱 Value

代理伺服器提供檔案的路徑。

範例:/images 將於 subdomain.eleasticbeanstalk.com/images 提供檔案。

內含檔案的資料夾名稱。

範例:staticimages 將自原始碼套件最上層名為 staticimages 的資料夾提供檔案。

PHP 平台選項

命名空間:aws:elasticbeanstalk:container:php:phpini
名稱 描述 預設 有效值

document_root

指定您專案視為公開 Web 根的子目錄。

/

空白字串將視為 /,或以 / 開頭指定字串

memory_limit

分配給PHP環境的記憶體數量。

256M

N/A

zlib.output_compression

指定是否PHP應對輸出使用壓縮。

Off

On

Off

true

false

allow_url_fopen

指定PHP是否允許從遠端位置 (例如網站或FTP伺服器) 擷取資料的檔案功能。

On

On

Off

true

false

display_errors

指定錯誤訊息是否為輸出的一部分。

Off

On

Off

max_execution_time

設定指令碼於環境將其終止前可執行的時間上限 (秒)。

60

09223372036854775807 (PHP_ INT _MAX)

composer_options

設置通過composer.phar install命令使用 Composer 安裝依賴關係時使用的自定義選項。如需詳細資訊,請參閱在 getcomposer .org 網站上安裝

N/A

命名空間:aws:elasticbeanstalk:environment:proxy
名稱 描述 預設 有效值

ProxyServer

設定 Proxy 在您的環境的執行個體上使用。

nginx

apache

nginx

注意

如需PHP平台的詳細資訊,請參閱使用 Elastic Beanstalk PHP 平台

Python 平台選項

命名空間:aws:elasticbeanstalk:application:environment
名稱 描述 預設 有效值

DJANGO_SETTINGS_MODULE

指定欲使用的設定檔案。

如需更多資訊,請參閱環境屬性與其他軟體設定

命名空間:aws:elasticbeanstalk:container:python
名稱 描述 預設 有效值

WSGIPath

包含WSGI應用程式的檔案。此檔案必須擁有可呼叫的 application

在 Amazon Linux 2 Python 平台版本上: application

在 Amazon AMI Python 平台版本上:application.py

N/A

NumProcesses

執行應WSGI用程式時,應為程序群組啟動的協助程式處理作業數目。

1

N/A

NumThreads

執行應用程式時,要建立的執行緒數目,以處理程序群組內每個精靈處理作業中的要WSGI求。

15

N/A

命名空間:aws:elasticbeanstalk:environment:proxy
名稱 描述 預設 有效值

ProxyServer

設定 Proxy 在您的環境的執行個體上使用。

nginx

apache

nginx

Amazon LinuxAMI(Amazon 之前的 Linux 2)平台選項

您可以使用以下命名空間,設定代理伺服器以提供靜態檔案。代理伺服器收到位於指定路徑下的檔案請求時,會直接提供檔案而非將請求路由至您的應用程式。這可減少應用程式必須處理的請求數量。

將代理伺服器提供的路徑對應至包含靜態資產之原始程式碼中的資料夾。您在此命名空間中定義的每個選項都會對應至不同路徑。

根據預設,Python 環境中的代理伺服器會從 static 路徑上名為 /static 的資料夾中提供任何檔案。

命名空間:aws:elasticbeanstalk:container:python:staticfiles
名稱 Value

代理伺服器提供檔案的路徑。

範例:/images 將於 subdomain.eleasticbeanstalk.com/images 提供檔案。

內含檔案的資料夾名稱。

範例:staticimages 將自原始碼套件最上層名為 staticimages 的資料夾提供檔案。

Ruby 平台選項

命名空間:aws:elasticbeanstalk:application:environment
名稱 描述 預設 有效值

RAILS_SKIP_MIGRATIONS

指定是否代表使用者應用程式執行 `rake db:migrate`,或者應略過。僅適用 Rails 3 應用程式。

false

true

false

RAILS_SKIP_ASSET_COMPILATION

指定容器是否應代表使用者應用程式執行 `rake assets:precompile` ,或者應略過。亦僅適用 Rails 3 應用程式。

false

true

false

BUNDLE_WITHOUT

自 Gemfile 安裝依存項目時應忽略的群組清單,以冒號 (:) 分隔。

test:development

RACK_ENV

指定可以執行應用程式的環境階段。常見環境的範例包括開發、生產、測試。

production

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